Merge remote-tracking branch 'fork/work/zakharafoniam/useful-groups'

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

diff --git a/src/kitemviews/kstandarditemlistwidget.h b/src/kitemviews/kstandarditemlistwidget.h
index 35392b42068551ac7c9a7a19d33f1278db64e70f..cabe3a8c963a0aa24c1a28803deb92610f054bf6 100644 (file)
--- a/src/kitemviews/kstandarditemlistwidget.h
+++ b/src/kitemviews/kstandarditemlistwidget.h
@@ -54,12 +54,19 @@ protected:
      */
     virtual bool itemIsLink(int index, const KItemListView *view) const;
 
      */
     virtual bool itemIsLink(int index, const KItemListView *view) const;
 

+    /** Configure whether the requested text should be optimized for viewing on a screen or for being read out aloud by a text-to-speech engine. */
+    enum class ForUsageAs { DisplayedText, SpokenText };
+

     /**
     /**

+     * @param role          The role the text is being requested for.
+     * @param values        The data of the item. All the data is passed because the text might depend on multiple data points.
+     * @param forUsageAs    Whether the roleText should be optimized for displaying (i.e. kept somewhat short) or optimized for speaking e.g. by screen readers
+     *                      or text-to-speech in general (i.e. by prefering announcing a month as July instead of as the number 7).

      * @return String representation of the role \a role. The representation of
      *         a role might depend on other roles, so the values of all roles
      *         are passed as parameter.
      */
      * @return String representation of the role \a role. The representation of
      *         a role might depend on other roles, so the values of all roles
      *         are passed as parameter.
      */

-    virtual QString roleText(const QByteArray &role, const QHash<QByteArray, QVariant> &values) const;
+    virtual QString roleText(const QByteArray &role, const QHash<QByteArray, QVariant> &values, ForUsageAs forUsageAs = ForUsageAs::DisplayedText) const;

 
     /**
     * @return A font based on baseFont which is customized for symlinks.
 
     /**
     * @return A font based on baseFont which is customized for symlinks.


@@ -98,10 +105,10 @@ public:
 
     void paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget = nullptr) override;
 
 
     void paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget = nullptr) override;
 

-    QRectF iconRect() const override;

     QRectF textRect() const override;
     QRectF textFocusRect() const override;
     QRectF textRect() const override;
     QRectF textFocusRect() const override;

-    QRectF selectionRect() const override;
+    QRectF selectionRectFull() const override;
+    QRectF selectionRectCore() const override;

     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;


@@ -151,31 +158,25 @@ protected:
     void setTextColor(const QColor &color);
     QColor textColor(const QWidget &widget) const;
 
     void setTextColor(const QColor &color);
     QColor textColor(const QWidget &widget) const;
 

-    void setOverlay(const QPixmap &overlay);
-    QPixmap overlay() const;
+    void setOverlays(QHash<Qt::Corner, QString> &overlay);
+    QHash<Qt::Corner, QString> overlays() const;

 
     /**
      * @see KStandardItemListWidgetInformant::roleText().
      */
     QString roleText(const QByteArray &role, const QHash<QByteArray, QVariant> &values) const;
 
 
     /**
      * @see KStandardItemListWidgetInformant::roleText().
      */
     QString roleText(const QByteArray &role, const QHash<QByteArray, QVariant> &values) const;
 

+    static int numberOfUnicodeCharactersIn(const QString &text);
+

     /**
     /**

-     * Fixes:
-     * Select the text without MIME-type extension
-     * This is file-item-specific and should be moved
-     * into KFileItemListWidget.
-     *
-     * Inherited classes can define, if the MIME-type extension
-     * should be selected or not.
-     *
-     * @return Selection length (with or without MIME-type extension)
+     * @return Selection length (with or without MIME-type extension) in number of unicode characters, which might be different from number of QChars.

      */
     virtual int selectionLength(const QString &text) const;
 
     void dataChanged(const QHash<QByteArray, QVariant> &current, const QSet<QByteArray> &roles = QSet<QByteArray>()) override;
     void visibleRolesChanged(const QList<QByteArray> &current, const QList<QByteArray> &previous) override;
     void columnWidthChanged(const QByteArray &role, qreal current, qreal previous) override;
      */
     virtual int selectionLength(const QString &text) const;
 
     void dataChanged(const QHash<QByteArray, QVariant> &current, const QSet<QByteArray> &roles = QSet<QByteArray>()) override;
     void visibleRolesChanged(const QList<QByteArray> &current, const QList<QByteArray> &previous) override;
     void columnWidthChanged(const QByteArray &role, qreal current, qreal previous) override;

-    void sidePaddingChanged(qreal width) override;
+    void sidePaddingChanged(qreal leftPaddingWidth, qreal rightPaddingWidth) override;

     void styleOptionChanged(const KItemListStyleOption &current, const KItemListStyleOption &previous) override;
     void hoveredChanged(bool hovered) override;
     void selectedChanged(bool selected) override;
     void styleOptionChanged(const KItemListStyleOption &current, const KItemListStyleOption &previous) override;
     void hoveredChanged(bool hovered) override;
     void selectedChanged(bool selected) override;


@@ -211,12 +212,19 @@ private:
     void updateCompactLayoutTextCache();
     void updateDetailsLayoutTextCache();
 
     void updateCompactLayoutTextCache();
     void updateDetailsLayoutTextCache();
 

+    QPixmap addOverlays(const QPixmap &pixmap,
+                        const QHash<Qt::Corner, QString> &overlays,
+                        const QSize &size,
+                        qreal devicePixelRatioF,
+                        QIcon::Mode mode = QIcon::Normal) const;
+

     void drawPixmap(QPainter *painter, const QPixmap &pixmap);
     void drawPixmap(QPainter *painter, const QPixmap &pixmap);

+    /** Draw the lines and arrows that visualize the expanded state and level of this row. */

     void drawSiblingsInformation(QPainter *painter);
 
     QRectF roleEditingRect(const QByteArray &role) const;
 
     void drawSiblingsInformation(QPainter *painter);
 
     QRectF roleEditingRect(const QByteArray &role) const;
 

-    QString elideRightKeepExtension(const QString &text, int elidingWidth) const;
+    QString elideText(QString text, qreal elidingWidth) const;

 
     /**
      * Escapes text for display purposes.
 
     /**
      * Escapes text for display purposes.


@@ -231,7 +239,7 @@ private:
      */
     void closeRoleEditor();
 
      */
     void closeRoleEditor();
 

-    QPixmap pixmapForIcon(const QString &name, const QStringList &overlays, int size, QIcon::Mode mode) const;
+    QPixmap pixmapForIcon(const QString &name, const QSize &size, QIcon::Mode mode) const;

 
     /**
      * @return Preferred size of the rating-image based on the given
 
     /**
      * @return Preferred size of the rating-image based on the given


@@ -272,7 +280,6 @@ private:
 
     qreal m_columnWidthSum;
     QRectF m_iconRect; // Cache for KItemListWidget::iconRect()
 
     qreal m_columnWidthSum;
     QRectF m_iconRect; // Cache for KItemListWidget::iconRect()

-    QPixmap m_hoverPixmap; // Cache for modified m_pixmap when hovering the item

 
     QRectF m_textRect;
 
 
     QRectF m_textRect;
 


@@ -283,7 +290,7 @@ private:
     QColor m_customTextColor;
     QColor m_additionalInfoTextColor;
 
     QColor m_customTextColor;
     QColor m_additionalInfoTextColor;
 

-    QPixmap m_overlay;
+    QHash<Qt::Corner, QString> m_overlays;

     QPixmap m_rating;
 
     KItemListRoleEditor *m_roleEditor;
     QPixmap m_rating;
 
     KItemListRoleEditor *m_roleEditor;