"Group by" exists, group sorting rule is separate from sorting rule. Very WIP and...

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

diff --git a/src/kitemviews/kstandarditemlistwidget.h b/src/kitemviews/kstandarditemlistwidget.h
index 1313179c96703b52fdb13e63ebcacd5153781155..35392b42068551ac7c9a7a19d33f1278db64e70f 100644 (file)
--- a/src/kitemviews/kstandarditemlistwidget.h
+++ b/src/kitemviews/kstandarditemlistwidget.h
@@ -11,13 +11,20 @@
 #include "kitemviews/kitemlistwidget.h"
 
 #include <QPixmap>
 #include "kitemviews/kitemlistwidget.h"
 
 #include <QPixmap>

+#include <QPointer>

 #include <QPointF>
 #include <QStaticText>
 
 class KItemListRoleEditor;
 class KItemListStyleOption;
 class KItemListView;
 #include <QPointF>
 #include <QStaticText>
 
 class KItemListRoleEditor;
 class KItemListStyleOption;
 class KItemListView;

+class QVariantAnimation;

 
 

+/**
+ * @brief standard implementation of the ItemList widget informant for use with KStandardItemListView and KStandardItemModel.
+ *
+ * @see KItemListWidgetInformant
+ */

 class DOLPHIN_EXPORT KStandardItemListWidgetInformant : public KItemListWidgetInformant
 {
 public:
 class DOLPHIN_EXPORT KStandardItemListWidgetInformant : public KItemListWidgetInformant
 {
 public:


@@ -67,7 +74,9 @@ protected:
 };
 
 /**
 };
 
 /**

- * @brief ItemList widget implementation for KStandardItemListView and KStandardItemModel.
+ * @brief standard implementation of an ItemList widget for KStandardItemListView and KStandardItemModel.
+ *
+ * @see KItemListWidget

  */
 class DOLPHIN_EXPORT KStandardItemListWidget : public KItemListWidget
 {
  */
 class DOLPHIN_EXPORT KStandardItemListWidget : public KItemListWidget
 {


@@ -80,7 +89,6 @@ public:
     ~KStandardItemListWidget() override;
 
     void setLayout(Layout layout);
     ~KStandardItemListWidget() override;
 
     void setLayout(Layout layout);

-    Layout layout() const;

 
     void setHighlightEntireRow(bool highlightEntireRow);
     bool highlightEntireRow() const;
 
     void setHighlightEntireRow(bool highlightEntireRow);
     bool highlightEntireRow() const;


@@ -97,6 +105,8 @@ public:
     QRectF expansionToggleRect() const override;
     QRectF selectionToggleRect() const override;
     QPixmap createDragPixmap(const QStyleOptionGraphicsItem *option, QWidget *widget = nullptr) override;
     QRectF expansionToggleRect() const override;
     QRectF selectionToggleRect() const override;
     QPixmap createDragPixmap(const QStyleOptionGraphicsItem *option, QWidget *widget = nullptr) override;

+    /** @see KItemListWidget::startActivateSoonAnimation() */
+    void startActivateSoonAnimation(int timeUntilActivation) override;

 
     static KItemListWidgetInformant *createInformant();
 
 
     static KItemListWidgetInformant *createInformant();
 


@@ -208,6 +218,13 @@ private:
 
     QString elideRightKeepExtension(const QString &text, int elidingWidth) const;
 
 
     QString elideRightKeepExtension(const QString &text, int elidingWidth) const;
 

+    /**
+     * Escapes text for display purposes.
+     *
+     * Replaces '\n' with Unicode line break (U+21B5).
+     */
+    QString escapeString(const QString &text) const;
+

     /**
      * Closes the role editor and returns the focus back
      * to the KItemListContainer.
     /**
      * Closes the role editor and returns the focus back
      * to the KItemListContainer.


@@ -229,6 +246,9 @@ private:
      */
     static qreal columnPadding(const KItemListStyleOption &option);
 
      */
     static qreal columnPadding(const KItemListStyleOption &option);
 

+    /** @returns whether the usual icon should be shown or not. */
+    bool isIconControlledByActivateSoonAnimation() const;
+

 protected:
     QHash<QByteArray, TextInfo *> m_textInfo; // PlacesItemListWidget needs to access this
 
 protected:
     QHash<QByteArray, TextInfo *> m_textInfo; // PlacesItemListWidget needs to access this
 


@@ -269,6 +289,9 @@ private:
     KItemListRoleEditor *m_roleEditor;
     KItemListRoleEditor *m_oldRoleEditor;
 
     KItemListRoleEditor *m_roleEditor;
     KItemListRoleEditor *m_oldRoleEditor;
 

+    /** @see startActivateSoonAnimation() */
+    QPointer<QVariantAnimation> m_activateSoonAnimation;
+

     friend class KStandardItemListWidgetInformant; // Accesses private static methods to be able to
                                                    // share a common layout calculation
 };
     friend class KStandardItemListWidgetInformant; // Accesses private static methods to be able to
                                                    // share a common layout calculation
 };