New selection effects

[dolphin.git] / src / kitemviews / kitemlistwidget.h

diff --git a/src/kitemviews/kitemlistwidget.h b/src/kitemviews/kitemlistwidget.h
index 517f7e04986d66ec633321345237ff2b2ebd2586..b87a3b34e65f98e78c0bbcf6609a55953981c5ee 100644 (file)
--- a/src/kitemviews/kitemlistwidget.h
+++ b/src/kitemviews/kitemlistwidget.h
@@ -22,7 +22,8 @@ class KItemListView;
 class QPropertyAnimation;
 
 /**
 class QPropertyAnimation;
 
 /**

- * @brief Provides information for creating an instance of KItemListWidget.
+ * @brief Provides generic information for all KItemListWidgets
+ * for which the construction of any specific KItemListWidget isn't required.

  *
  * KItemListView only creates KItemListWidget instances for the visible
  * area. For calculating the required size of all items the expected
  *
  * KItemListView only creates KItemListWidget instances for the visible
  * area. For calculating the required size of all items the expected


@@ -35,11 +36,9 @@ public:
     KItemListWidgetInformant();
     virtual ~KItemListWidgetInformant();
 
     KItemListWidgetInformant();
     virtual ~KItemListWidgetInformant();
 

-    virtual void calculateItemSizeHints(QVector<std::pair<qreal, bool>>& logicalHeightHints, qreal& logicalWidthHint, const KItemListView* view) const = 0;
+    virtual void calculateItemSizeHints(QVector<std::pair<qreal, bool>> &logicalHeightHints, qreal &logicalWidthHint, const KItemListView *view) const = 0;

 
 

-    virtual qreal preferredRoleColumnWidth(const QByteArray& role,
-                                           int index,
-                                           const KItemListView* view) const = 0;
+    virtual qreal preferredRoleColumnWidth(const QByteArray &role, int index, const KItemListView *view) const = 0;

 };
 
 /**
 };
 
 /**


@@ -53,40 +52,40 @@ class DOLPHIN_EXPORT KItemListWidget : public QGraphicsWidget
 {
     Q_OBJECT
 
 {
     Q_OBJECT
 

-    Q_PROPERTY(int iconSize READ iconSize WRITE setIconSize)
-

 public:
 public:

-    KItemListWidget(KItemListWidgetInformant* informant, QGraphicsItem* parent);
+    KItemListWidget(KItemListWidgetInformant *informant, QGraphicsItem *parent);

     ~KItemListWidget() override;
 
     void setIndex(int index);
     int index() const;
 
     ~KItemListWidget() override;
 
     void setIndex(int index);
     int index() const;
 

-    void setData(const QHash<QByteArray, QVariant>& data, const QSet<QByteArray>& roles = QSet<QByteArray>());
+    void setData(const QHash<QByteArray, QVariant> &data, const QSet<QByteArray> &roles = QSet<QByteArray>());

     QHash<QByteArray, QVariant> data() const;
     QHash<QByteArray, QVariant> data() const;

+    QVariant value(const QByteArray &key) const;

 
     /**
      * 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
      */
 
     /**
      * 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
      */

-    void paint(QPainter* painter, const QStyleOptionGraphicsItem* option, QWidget* widget = nullptr) override;
+    void paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget = nullptr) override;

 
 

-    void setVisibleRoles(const QList<QByteArray>& roles);
+    void setVisibleRoles(const QList<QByteArray> &roles);

     QList<QByteArray> visibleRoles() const;
 
     /**
      * Sets the width of a role that should be used if the alignment of the content
      * should be done in columns.
      */
     QList<QByteArray> visibleRoles() const;
 
     /**
      * Sets the width of a role that should be used if the alignment of the content
      * should be done in columns.
      */

-    void setColumnWidth(const QByteArray& role, qreal width);
-    qreal columnWidth(const QByteArray& role) const;
+    void setColumnWidth(const QByteArray &role, qreal width);
+    qreal columnWidth(const QByteArray &role) const;

 
 

-    void setLeadingPadding(qreal width);
-    qreal leadingPadding() const;
+    void setSidePadding(qreal leftPaddingWidth, qreal rightPaddingWidth);
+    qreal leftPadding() const;
+    qreal rightPadding() const;

 
 

-    void setStyleOption(const KItemListStyleOption& option);
-    const KItemListStyleOption& styleOption() const;
+    void setStyleOption(const KItemListStyleOption &option);
+    const KItemListStyleOption &styleOption() const;

 
     // TODO: Hides QGraphicsItem::setSelected()/isSelected(). Replace
     // this by using the default mechanism.
 
     // TODO: Hides QGraphicsItem::setSelected()/isSelected(). Replace
     // this by using the default mechanism.


@@ -99,10 +98,14 @@ public:
     void setHovered(bool hovered);
     bool isHovered() const;
 
     void setHovered(bool hovered);
     bool isHovered() const;
 

+    /** Sets a purely visual pressed highlight effect. */
+    void setPressed(bool enabled);
+    bool isPressed() const;
+

     void setExpansionAreaHovered(bool hover);
     bool expansionAreaHovered() const;
 
     void setExpansionAreaHovered(bool hover);
     bool expansionAreaHovered() const;
 

-    void setHoverPosition(const QPointF& pos);
+    void setHoverPosition(const QPointF &pos);

 
     void setAlternateBackground(bool enable);
     bool alternateBackground() const;
 
     void setAlternateBackground(bool enable);
     bool alternateBackground() const;


@@ -117,7 +120,7 @@ public:
      * The sibling information is useful for drawing the branches in
      * tree views.
      */
      * The sibling information is useful for drawing the branches in
      * tree views.
      */

-    void setSiblingsInformation(const QBitArray& siblings);
+    void setSiblingsInformation(const QBitArray &siblings);

     QBitArray siblingsInformation() const;
 
     /**
     QBitArray siblingsInformation() const;
 
     /**


@@ -127,7 +130,7 @@ public:
      * the role is empty. Derived classes must implement
      * editedRoleChanged().
      */
      * the role is empty. Derived classes must implement
      * editedRoleChanged().
      */

-    void setEditedRole(const QByteArray& role);
+    void setEditedRole(const QByteArray &role);

     QByteArray editedRole() const;
 
     /**
     QByteArray editedRole() const;
 
     /**


@@ -138,17 +141,12 @@ public:
     int iconSize() const;
 
     /**
     int iconSize() const;
 
     /**

-     * @return True if \a point is inside KItemListWidget::hoverRect(),
-     *         KItemListWidget::textRect(), KItemListWidget::selectionToggleRect()
+     * @return True if \a point is inside KItemListWidget::selectionRectFull(),
+     *         KItemListWidget::selectionToggleRect()

      *         or KItemListWidget::expansionToggleRect().
      * @reimp
      */
      *         or KItemListWidget::expansionToggleRect().
      * @reimp
      */

-    bool contains(const QPointF& point) const override;
-
-    /**
-     * @return Rectangle for the area that shows the icon.
-     */
-    virtual QRectF iconRect() const = 0;
+    bool contains(const QPointF &point) const override;

 
     /**
      * @return Rectangle for the area that contains the text-properties.
 
     /**
      * @return Rectangle for the area that contains the text-properties.


@@ -165,9 +163,17 @@ public:
     virtual QRectF textFocusRect() const;
 
     /**
     virtual QRectF textFocusRect() const;
 
     /**

-     * @return Rectangle around which a selection box should be drawn if the item is selected.
+     * Used for drawing the visuals, and situations where we want the behavior of the
+     * selection to match the visuals.
+     *
+     * @return The rectangle around selection.

      */
      */

-    virtual QRectF selectionRect() const = 0;
+    virtual QRectF selectionRectFull() const = 0;
+
+    /**
+     * @return The core area of the item. All of it reacts exactly the same way to mouse clicks.
+     */
+    virtual QRectF selectionRectCore() const = 0;

 
     /**
      * @return Rectangle for the selection-toggle that is used to select or deselect an item.
 
     /**
      * @return Rectangle for the selection-toggle that is used to select or deselect an item.


@@ -187,26 +193,32 @@ public:
      * @return Pixmap that is used when dragging an item. Per default the current state of the
      *         widget is returned as pixmap.
      */
      * @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 = nullptr);
+    virtual QPixmap createDragPixmap(const QStyleOptionGraphicsItem *option, QWidget *widget = nullptr);
+
+    /**
+     * Starts an animation that makes clear that the item will be activated soon.
+     * @param timeUntilActivation time in milliseconds until the item will activate
+     */
+    virtual void startActivateSoonAnimation(int timeUntilActivation);

 
 Q_SIGNALS:
 
 Q_SIGNALS:

-    void roleEditingCanceled(int index, const QByteArray& role, const QVariant& value);
-    void roleEditingFinished(int index, const QByteArray& role, const QVariant& value);
+    void roleEditingCanceled(int index, const QByteArray &role, const QVariant &value);
+    void roleEditingFinished(int index, const QByteArray &role, const QVariant &value);

 
 protected:
 
 protected:

-    virtual void dataChanged(const QHash<QByteArray, QVariant>& current, const QSet<QByteArray>& roles = QSet<QByteArray>());
-    virtual void visibleRolesChanged(const QList<QByteArray>& current, const QList<QByteArray>& previous);
-    virtual void columnWidthChanged(const QByteArray& role, qreal current, qreal previous);
-    virtual void leadingPaddingChanged(qreal width);
-    virtual void styleOptionChanged(const KItemListStyleOption& current, const KItemListStyleOption& previous);
+    virtual void dataChanged(const QHash<QByteArray, QVariant> &current, const QSet<QByteArray> &roles = QSet<QByteArray>());
+    virtual void visibleRolesChanged(const QList<QByteArray> &current, const QList<QByteArray> &previous);
+    virtual void columnWidthChanged(const QByteArray &role, qreal current, qreal previous);
+    virtual void sidePaddingChanged(qreal leftPaddingWidth, qreal rightPaddingWidth);
+    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 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 siblingsInformationChanged(const QBitArray &current, const QBitArray &previous);
+    virtual void editedRoleChanged(const QByteArray &current, const QByteArray &previous);

     virtual void iconSizeChanged(int current, int previous);
     virtual void iconSizeChanged(int current, int previous);

-    void resizeEvent(QGraphicsSceneResizeEvent* event) override;
+    void resizeEvent(QGraphicsSceneResizeEvent *event) override;

     void clearHoverCache();
 
     /**
     void clearHoverCache();
 
     /**


@@ -234,21 +246,18 @@ protected:
 
     int hoverSequenceIndex() const;
 
 
     int hoverSequenceIndex() const;
 

-    const KItemListWidgetInformant* informant() const;
+    const KItemListWidgetInformant *informant() const;

 
 private Q_SLOTS:
 
 private Q_SLOTS:

-    void slotHoverAnimationFinished();

     void slotHoverSequenceTimerTimeout();
 
 private:
     void initializeSelectionToggle();
     void setHoverOpacity(qreal opacity);
     void slotHoverSequenceTimerTimeout();
 
 private:
     void initializeSelectionToggle();
     void setHoverOpacity(qreal opacity);

-    void drawItemStyleOption(QPainter* painter, QWidget* widget, QStyle::State styleState);
+    void drawItemStyleOption(QPainter *painter, QWidget *widget, QStyle::State styleState);

 
 private:
 
 private:

-    Q_PROPERTY(qreal hoverOpacity READ hoverOpacity WRITE setHoverOpacity)
-
-    KItemListWidgetInformant* m_informant;
+    KItemListWidgetInformant *m_informant;

     int m_index;
     bool m_selected;
     bool m_current;
     int m_index;
     bool m_selected;
     bool m_current;


@@ -256,31 +265,30 @@ private:
     bool m_expansionAreaHovered;
     bool m_alternateBackground;
     bool m_enabledSelectionToggle;
     bool m_expansionAreaHovered;
     bool m_alternateBackground;
     bool m_enabledSelectionToggle;

+    bool m_clickHighlighted;

     QHash<QByteArray, QVariant> m_data;
     QList<QByteArray> m_visibleRoles;
     QHash<QByteArray, qreal> m_columnWidths;
     QHash<QByteArray, QVariant> m_data;
     QList<QByteArray> m_visibleRoles;
     QHash<QByteArray, qreal> m_columnWidths;

-    qreal m_leadingPadding;
+    qreal m_leftPadding;
+    qreal m_rightPadding;

     KItemListStyleOption m_styleOption;
     QBitArray m_siblingsInfo;
 
     qreal m_hoverOpacity;
     KItemListStyleOption m_styleOption;
     QBitArray m_siblingsInfo;
 
     qreal m_hoverOpacity;

-    mutable QPixmap* m_hoverCache;
-    QPropertyAnimation* m_hoverAnimation;
+    mutable QPixmap *m_hoverCache;

 
     int m_hoverSequenceIndex;
     QTimer m_hoverSequenceTimer;
 
 
     int m_hoverSequenceIndex;
     QTimer m_hoverSequenceTimer;
 

-    KItemListSelectionToggle* m_selectionToggle;
+    KItemListSelectionToggle *m_selectionToggle;

 
     QByteArray m_editedRole;
     int m_iconSize;
 };
 
 
     QByteArray m_editedRole;
     int m_iconSize;
 };
 

-inline const KItemListWidgetInformant* KItemListWidget::informant() const
+inline const KItemListWidgetInformant *KItemListWidget::informant() const

 {
     return m_informant;
 }
 
 #endif
 {
     return m_informant;
 }
 
 #endif

-
-