X-Git-Url: https://cloud.milkyroute.net/gitweb/dolphin.git/blobdiff_plain/f23e9496f303995557b744c03178f5dbd9b35016..20e13c31df64f5fe3dfd410a1b0a0bd78c07ba32:/src/kitemviews/kitemlistwidget.h diff --git a/src/kitemviews/kitemlistwidget.h b/src/kitemviews/kitemlistwidget.h index eb2ebf455..c086ee6d3 100644 --- a/src/kitemviews/kitemlistwidget.h +++ b/src/kitemviews/kitemlistwidget.h @@ -27,10 +27,35 @@ #include +#include #include +#include +class KItemListSelectionToggle; +class KItemListView; class QPropertyAnimation; +/** + * @brief Provides information for creating an instance of KItemListWidget. + * + * KItemListView only creates KItemListWidget instances for the visible + * area. For calculating the required size of all items the expected + * size for the invisible items must be accessible. KItemListWidgetInformant + * provides this information. + */ +class LIBDOLPHINPRIVATE_EXPORT KItemListWidgetInformant +{ +public: + KItemListWidgetInformant(); + virtual ~KItemListWidgetInformant(); + + virtual void calculateItemSizeHints(QVector& logicalHeightHints, qreal& logicalWidthHint, const KItemListView* view) const = 0; + + virtual qreal preferredRoleColumnWidth(const QByteArray& role, + int index, + const KItemListView* view) const = 0; +}; + /** * @brief Widget that shows a visible item from the model. * @@ -43,7 +68,7 @@ class LIBDOLPHINPRIVATE_EXPORT KItemListWidget : public QGraphicsWidget Q_OBJECT public: - KItemListWidget(QGraphicsItem* parent); + KItemListWidget(KItemListWidgetInformant* informant, QGraphicsItem* parent); virtual ~KItemListWidget(); void setIndex(int index); @@ -53,37 +78,95 @@ public: QHash data() const; /** - * Draws the hover-bounding-rectangle if the item is hovered. Overwrite this method + * Draws the hover-rectangle if the item is hovered. Overwrite this method * to show the data of the custom model provided by KItemListWidget::data(). * @reimp */ virtual void paint(QPainter* painter, const QStyleOptionGraphicsItem* option, QWidget* widget = 0); + void setVisibleRoles(const QList& roles); + QList visibleRoles() const; + /** - * Sets the visible roles to \p roles. The integer-value defines - * the order of the visible role: Smaller values are ordered first. + * Sets the width of a role that should be used if the alignment of the content + * should be done in columns. */ - void setVisibleRoles(const QHash& roles); - QHash visibleRoles() const; - - void setVisibleRolesSizes(const QHash rolesSizes); - QHash visibleRolesSizes() const; + void setColumnWidth(const QByteArray& role, qreal width); + qreal columnWidth(const QByteArray& role) const; void setStyleOption(const KItemListStyleOption& option); const KItemListStyleOption& styleOption() const; + // TODO: Hides QGraphicsItem::setSelected()/isSelected(). Replace + // this by using the default mechanism. + void setSelected(bool selected); + bool isSelected() const; + + void setCurrent(bool current); + bool isCurrent() const; + + void setHovered(bool hovered); + bool isHovered() const; + + void setHoverPosition(const QPointF& pos); + + void setAlternateBackground(bool enable); + bool alternateBackground() const; + + void setEnabledSelectionToggle(bool enabled); + bool enabledSelectionToggle() const; + /** - * @return True if \a point is inside KItemListWidget::hoverBoundingRect(), - * KItemListWidget::selectionToggleRect() or KItemListWidget::expansionToggleRect(). + * Sets the sibling information for the item and all of its parents. + * The sibling information of the upper most parent is represented by + * the first bit, the sibling information of the item by the last bit. + * The sibling information is useful for drawing the branches in + * tree views. + */ + void setSiblingsInformation(const QBitArray& siblings); + QBitArray siblingsInformation() const; + + /** + * Allows the user to edit the role \a role. The signals + * roleEditingCanceled() or roleEditingFinished() will be + * emitted after editing. An ongoing editing gets canceled if + * the role is empty. Derived classes must implement + * editedRoleChanged(). + */ + void setEditedRole(const QByteArray& role); + QByteArray editedRole() const; + + /** + * @return True if \a point is inside KItemListWidget::hoverRect(), + * KItemListWidget::textRect(), KItemListWidget::selectionToggleRect() + * or KItemListWidget::expansionToggleRect(). * @reimp */ virtual bool contains(const QPointF& point) const; /** - * @return Bounding rectangle for the area that acts as hovering-area. Per default - * the bounding rectangle of the KItemListWidget is returned. + * @return Rectangle for the area that shows the icon. + */ + virtual QRectF iconRect() const = 0; + + /** + * @return Rectangle for the area that contains the text-properties. */ - virtual QRectF hoverBoundingRect() const; + virtual QRectF textRect() const = 0; + + /** + * @return Focus rectangle for indicating the current item. Per default + * textRect() will be returned. Overwrite this method if textRect() + * provides a larger rectangle than the actual text (e.g. to + * be aligned with the iconRect()). The textFocusRect() may not be + * outside the boundaries of textRect(). + */ + virtual QRectF textFocusRect() const; + + /** + * @return Rectangle around which a selection box should be drawn if the item is selected. + */ + virtual QRectF selectionRect() const = 0; /** * @return Rectangle for the selection-toggle that is used to select or deselect an item. @@ -99,11 +182,27 @@ public: */ virtual QRectF expansionToggleRect() const; + /** + * @return Pixmap that is used when dragging an item. Per default the current state of the + * widget is returned as pixmap. + */ + virtual QPixmap createDragPixmap(const QStyleOptionGraphicsItem* option, QWidget* widget = 0); + +signals: + void roleEditingCanceled(int index, const QByteArray& role, const QVariant& value); + void roleEditingFinished(int index, const QByteArray& role, const QVariant& value); + protected: virtual void dataChanged(const QHash& current, const QSet& roles = QSet()); - virtual void visibleRolesChanged(const QHash& current, const QHash& previous); - virtual void visibleRolesSizesChanged(const QHash& current, const QHash& previous); + virtual void visibleRolesChanged(const QList& current, const QList& previous); + virtual void columnWidthChanged(const QByteArray& role, qreal current, qreal previous); virtual void styleOptionChanged(const KItemListStyleOption& current, const KItemListStyleOption& previous); + virtual void currentChanged(bool current); + virtual void selectedChanged(bool selected); + virtual void hoveredChanged(bool hovered); + virtual void alternateBackgroundChanged(bool enabled); + virtual void siblingsInformationChanged(const QBitArray& current, const QBitArray& previous); + virtual void editedRoleChanged(const QByteArray& current, const QByteArray& previous); virtual void resizeEvent(QGraphicsSceneResizeEvent* event); /** @@ -112,23 +211,47 @@ protected: */ qreal hoverOpacity() const; + const KItemListWidgetInformant* informant() const; + +private slots: + void slotHoverAnimationFinished(); + private: + void initializeSelectionToggle(); void setHoverOpacity(qreal opacity); - void clearCache(); + void clearHoverCache(); + void drawItemStyleOption(QPainter* painter, QWidget* widget, QStyle::State styleState); private: Q_PROPERTY(qreal hoverOpacity READ hoverOpacity WRITE setHoverOpacity) + KItemListWidgetInformant* m_informant; int m_index; + bool m_selected; + bool m_current; + bool m_hovered; + bool m_alternateBackground; + bool m_enabledSelectionToggle; QHash m_data; - QHash m_visibleRoles; - QHash m_visibleRolesSizes; + QList m_visibleRoles; + QHash m_columnWidths; KItemListStyleOption m_styleOption; + QBitArray m_siblingsInfo; qreal m_hoverOpacity; mutable QPixmap* m_hoverCache; QPropertyAnimation* m_hoverAnimation; + + KItemListSelectionToggle* m_selectionToggle; + + QByteArray m_editedRole; }; + +inline const KItemListWidgetInformant* KItemListWidget::informant() const +{ + return m_informant; +} + #endif