src/kitemviews/kfileitemlistwidget.h

   1 /***************************************************************************
   2  *   Copyright (C) 2011 by Peter Penz <peter.penz19@gmail.com>             *
   3  *                                                                         *
   4  *   This program is free software; you can redistribute it and/or modify  *
   5  *   it under the terms of the GNU General Public License as published by  *
   6  *   the Free Software Foundation; either version 2 of the License, or     *
   7  *   (at your option) any later version.                                   *
   8  *                                                                         *
   9  *   This program is distributed in the hope that it will be useful,       *
  10  *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
  11  *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
  12  *   GNU General Public License for more details.                          *
  13  *                                                                         *
  14  *   You should have received a copy of the GNU General Public License     *
  15  *   along with this program; if not, write to the                         *
  16  *   Free Software Foundation, Inc.,                                       *
  17  *   51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA            *
  18  ***************************************************************************/
  19
  20 #ifndef KFILEITEMLISTWIDGET_H
  21 #define KFILEITEMLISTWIDGET_H
  22
  23 #include <libdolphin_export.h>
  24
  25 #include <kitemviews/kitemlistwidget.h>
  26
  27 #include <QPixmap>
  28 #include <QPointF>
  29 #include <QStaticText>
  30
  31 class KItemListView;
  32 class KItemListStyleOption;
  33
  34 class LIBDOLPHINPRIVATE_EXPORT KFileItemListWidget : public KItemListWidget
  35 {
  36     Q_OBJECT
  37
  38 public:
  39     enum Layout
  40     {
  41         IconsLayout,
  42         CompactLayout,
  43         DetailsLayout
  44     };
  45
  46     KFileItemListWidget(QGraphicsItem* parent);
  47     virtual ~KFileItemListWidget();
  48
  49     void setLayout(Layout layout);
  50     Layout layout() const;
  51
  52     void setSupportsItemExpanding(bool supportsItemExpanding);
  53     bool supportsItemExpanding() const;
  54
  55     virtual void paint(QPainter* painter, const QStyleOptionGraphicsItem* option, QWidget* widget = 0);
  56
  57     virtual QRectF iconRect() const;
  58     virtual QRectF textRect() const;
  59     virtual QRectF textFocusRect() const;
  60     virtual QRectF expansionToggleRect() const;
  61     virtual QRectF selectionToggleRect() const;
  62
  63     /**
  64      * Implementation of KItemListWidgetCreatorBase::itemSizeHint() when
  65      * using the KItemListWidgetCreator-template.
  66      *
  67      * @see KItemListView
  68      */
  69     static QSizeF itemSizeHint(int index, const KItemListView* view);
  70
  71     /**
  72      * Implementation of KItemListWidgetCreatorBase::preferredRoleColumnWidth() when
  73      * using the KItemListWidgetCreator-template.
  74      *
  75      * @see KItemListView
  76      */
  77     static qreal preferredRoleColumnWidth(const QByteArray& role, int index, const KItemListView* view);
  78
  79 protected:
  80     /**
  81      * Invalidates the cache which results in calling KFileItemListWidget::refreshCache() as
  82      * soon as the item need to gets repainted.
  83      */
  84     void invalidateCache();
  85
  86     /**
  87      * Is called if the cache got invalidated by KFileItemListWidget::invalidateCache().
  88      * The default implementation is empty.
  89      */
  90     virtual void refreshCache();
  91
  92     void setTextColor(const QColor& color);
  93     QColor textColor() const;
  94
  95     void setOverlay(const QPixmap& overlay);
  96     QPixmap overlay() const;
  97
  98     virtual void dataChanged(const QHash<QByteArray, QVariant>& current, const QSet<QByteArray>& roles = QSet<QByteArray>());
  99     virtual void visibleRolesChanged(const QList<QByteArray>& current, const QList<QByteArray>& previous);
 100     virtual void columnWidthChanged(const QByteArray& role, qreal current, qreal previous);
 101     virtual void styleOptionChanged(const KItemListStyleOption& current, const KItemListStyleOption& previous);
 102     virtual void hoveredChanged(bool hovered);
 103     virtual void selectedChanged(bool selected);
 104     virtual void siblingsInformationChanged(const QBitArray& current, const QBitArray& previous);
 105     virtual void resizeEvent(QGraphicsSceneResizeEvent* event);
 106     virtual void showEvent(QShowEvent* event);
 107     virtual void hideEvent(QHideEvent* event);
 108
 109 private slots:
 110     void slotCutItemsChanged();
 111
 112 private:
 113     enum RoleType {
 114         Name,
 115         Size,
 116         Date,
 117         Generic  // Mandatory last entry
 118     };
 119
 120     void triggerCacheRefreshing();
 121     void updateExpansionArea();
 122     void updatePixmapCache();
 123
 124     void updateTextsCache();
 125     void updateIconsLayoutTextCache();
 126     void updateCompactLayoutTextCache();
 127     void updateDetailsLayoutTextCache();
 128
 129     void updateAdditionalInfoTextColor();
 130
 131     void drawPixmap(QPainter* painter, const QPixmap& pixmap);
 132     void drawSiblingsInformation(QPainter* painter);
 133
 134     static QPixmap pixmapForIcon(const QString& name, int size);
 135     static void applyCutEffect(QPixmap& pixmap);
 136     static void applyHiddenEffect(QPixmap& pixmap);
 137     static RoleType roleType(const QByteArray& role);
 138
 139     /**
 140      * @return Shown string for the role \p role of the item with the values \p values.
 141      */
 142     static QString roleText(const QByteArray& role, const QHash<QByteArray, QVariant>& values);
 143
 144 private:
 145     bool m_isCut;
 146     bool m_isHidden;
 147     bool m_isExpandable;
 148     bool m_supportsItemExpanding;
 149
 150     bool m_dirtyLayout;
 151     bool m_dirtyContent;
 152     QSet<QByteArray> m_dirtyContentRoles;
 153
 154     Layout m_layout;
 155     QPointF m_pixmapPos;
 156     QPixmap m_pixmap;
 157     QSize m_scaledPixmapSize;
 158
 159     QRectF m_iconRect;          // Cache for KItemListWidget::iconRect()
 160     QPixmap m_hoverPixmap;      // Cache for modified m_pixmap when hovering the item
 161
 162     struct TextInfo
 163     {
 164         QPointF pos;
 165         QStaticText staticText;
 166     };
 167     QHash<QByteArray, TextInfo*> m_textInfo;
 168
 169     QRectF m_textRect;
 170
 171     QList<QByteArray> m_sortedVisibleRoles;
 172
 173     QRectF m_expansionArea;
 174
 175     QColor m_customTextColor;
 176     QColor m_additionalInfoTextColor;
 177
 178     QPixmap m_overlay;
 179 };
 180
 181 #endif
 182
 183