src/kitemviews/kstandarditemlistwidget.cpp

   1 /*
   2  * SPDX-FileCopyrightText: 2012 Peter Penz <peter.penz19@gmail.com>
   3  *
   4  * SPDX-License-Identifier: GPL-2.0-or-later
   5  */
   6
   7 #include "kstandarditemlistwidget.h"
   8
   9 #include "kfileitemlistview.h"
  10 #include "kfileitemmodel.h"
  11 #include "private/kfileitemclipboard.h"
  12 #include "private/kitemlistroleeditor.h"
  13 #include "private/kitemviewsutils.h"
  14 #include "private/kpixmapmodifier.h"
  15
  16 #include <KIconEffect>
  17 #include <KIconLoader>
  18 #include <KIconUtils>
  19 #include <KRatingPainter>
  20 #include <KStringHandler>
  21
  22 #include <QApplication>
  23 #include <QGraphicsScene>
  24 #include <QGraphicsSceneResizeEvent>
  25 #include <QGraphicsView>
  26 #include <QPixmapCache>
  27 #include <QStyleOption>
  28 #include <QTextBoundaryFinder>
  29 #include <QVariantAnimation>
  30
  31 // #define KSTANDARDITEMLISTWIDGET_DEBUG
  32
  33 KStandardItemListWidgetInformant::KStandardItemListWidgetInformant()
  34     : KItemListWidgetInformant()
  35 {
  36 }
  37
  38 KStandardItemListWidgetInformant::~KStandardItemListWidgetInformant()
  39 {
  40 }
  41
  42 void KStandardItemListWidgetInformant::calculateItemSizeHints(QVector<std::pair<qreal, bool>> &logicalHeightHints,
  43                                                               qreal &logicalWidthHint,
  44                                                               const KItemListView *view) const
  45 {
  46     switch (static_cast<const KStandardItemListView *>(view)->itemLayout()) {
  47     case KStandardItemListView::IconsLayout:
  48         calculateIconsLayoutItemSizeHints(logicalHeightHints, logicalWidthHint, view);
  49         break;
  50
  51     case KStandardItemListView::CompactLayout:
  52         calculateCompactLayoutItemSizeHints(logicalHeightHints, logicalWidthHint, view);
  53         break;
  54
  55     case KStandardItemListView::DetailsLayout:
  56         calculateDetailsLayoutItemSizeHints(logicalHeightHints, logicalWidthHint, view);
  57         break;
  58
  59     default:
  60         Q_ASSERT(false);
  61         break;
  62     }
  63 }
  64
  65 qreal KStandardItemListWidgetInformant::preferredRoleColumnWidth(const QByteArray &role, int index, const KItemListView *view) const
  66 {
  67     const QHash<QByteArray, QVariant> values = view->model()->data(index);
  68     const KItemListStyleOption &option = view->styleOption();
  69
  70     const QString text = roleText(role, values);
  71     qreal width = KStandardItemListWidget::columnPadding(option);
  72
  73     const QFontMetrics &normalFontMetrics = option.fontMetrics;
  74     const QFontMetrics linkFontMetrics(customizedFontForLinks(option.font));
  75
  76     if (role == "rating") {
  77         width += KStandardItemListWidget::preferredRatingSize(option).width();
  78     } else {
  79         // If current item is a link, we use the customized link font metrics instead of the normal font metrics.
  80         const QFontMetrics &fontMetrics = itemIsLink(index, view) ? linkFontMetrics : normalFontMetrics;
  81
  82         width += fontMetrics.horizontalAdvance(text);
  83
  84         if (role == "text") {
  85             if (view->supportsItemExpanding()) {
  86                 // Increase the width by the expansion-toggle and the current expansion level
  87                 const int expandedParentsCount = values.value("expandedParentsCount", 0).toInt();
  88                 const qreal height = option.padding * 2 + qMax(option.iconSize, fontMetrics.height());
  89                 width += (expandedParentsCount + 1) * height;
  90             }
  91
  92             // Increase the width by the required space for the icon
  93             width += option.padding * 2 + option.iconSize;
  94         }
  95     }
  96
  97     return width;
  98 }
  99
 100 QString KStandardItemListWidgetInformant::itemText(int index, const KItemListView *view) const
 101 {
 102     return view->model()->data(index).value("text").toString();
 103 }
 104
 105 bool KStandardItemListWidgetInformant::itemIsLink(int index, const KItemListView *view) const
 106 {
 107     Q_UNUSED(index)
 108     Q_UNUSED(view)
 109     return false;
 110 }
 111
 112 QString KStandardItemListWidgetInformant::roleText(const QByteArray &role, const QHash<QByteArray, QVariant> &values) const
 113 {
 114     if (role == "rating") {
 115         // Always use an empty text, as the rating is shown by the image m_rating.
 116         return QString();
 117     }
 118     return values.value(role).toString();
 119 }
 120
 121 QFont KStandardItemListWidgetInformant::customizedFontForLinks(const QFont &baseFont) const
 122 {
 123     return baseFont;
 124 }
 125
 126 void KStandardItemListWidgetInformant::calculateIconsLayoutItemSizeHints(QVector<std::pair<qreal, bool>> &logicalHeightHints,
 127                                                                          qreal &logicalWidthHint,
 128                                                                          const KItemListView *view) const
 129 {
 130     const KItemListStyleOption &option = view->styleOption();
 131     const QFont &normalFont = option.font;
 132     const int additionalRolesCount = qMax(view->visibleRoles().count() - 1, 0);
 133
 134     const qreal itemWidth = view->itemSize().width();
 135     const qreal maxWidth = itemWidth - 2 * option.padding;
 136     const qreal additionalRolesSpacing = additionalRolesCount * option.fontMetrics.lineSpacing();
 137     const qreal spacingAndIconHeight = option.iconSize + option.padding * 3;
 138
 139     const QFont linkFont = customizedFontForLinks(normalFont);
 140
 141     QTextOption textOption(Qt::AlignHCenter);
 142     textOption.setWrapMode(QTextOption::WrapAtWordBoundaryOrAnywhere);
 143
 144     for (int index = 0; index < logicalHeightHints.count(); ++index) {
 145         if (logicalHeightHints.at(index).first > 0.0) {
 146             continue;
 147         }
 148
 149         // If the current item is a link, we use the customized link font instead of the normal font.
 150         const QFont &font = itemIsLink(index, view) ? linkFont : normalFont;
 151
 152         const QString &text = KStringHandler::preProcessWrap(itemText(index, view));
 153
 154         // Calculate the number of lines required for wrapping the name
 155         qreal textHeight = 0;
 156         QTextLayout layout(text, font);
 157         layout.setTextOption(textOption);
 158         layout.beginLayout();
 159         QTextLine line;
 160         int lineCount = 0;
 161         bool isElided = false;
 162         while ((line = layout.createLine()).isValid()) {
 163             line.setLineWidth(maxWidth);
 164             line.naturalTextWidth();
 165             textHeight += line.height();
 166
 167             ++lineCount;
 168             if (lineCount == option.maxTextLines) {
 169                 isElided = layout.createLine().isValid();
 170                 break;
 171             }
 172         }
 173         layout.endLayout();
 174
 175         // Add one line for each additional information
 176         textHeight += additionalRolesSpacing;
 177
 178         logicalHeightHints[index].first = textHeight + spacingAndIconHeight;
 179         logicalHeightHints[index].second = isElided;
 180     }
 181
 182     logicalWidthHint = itemWidth;
 183 }
 184
 185 void KStandardItemListWidgetInformant::calculateCompactLayoutItemSizeHints(QVector<std::pair<qreal, bool>> &logicalHeightHints,
 186                                                                            qreal &logicalWidthHint,
 187                                                                            const KItemListView *view) const
 188 {
 189     const KItemListStyleOption &option = view->styleOption();
 190     const QFontMetrics &normalFontMetrics = option.fontMetrics;
 191     const int additionalRolesCount = qMax(view->visibleRoles().count() - 1, 0);
 192
 193     const QList<QByteArray> &visibleRoles = view->visibleRoles();
 194     const bool showOnlyTextRole = (visibleRoles.count() == 1) && (visibleRoles.first() == "text");
 195     const qreal maxWidth = option.maxTextWidth;
 196     const qreal paddingAndIconWidth = option.padding * 4 + option.iconSize;
 197     const qreal height = option.padding * 2 + qMax(option.iconSize, (1 + additionalRolesCount) * normalFontMetrics.lineSpacing());
 198
 199     const QFontMetrics linkFontMetrics(customizedFontForLinks(option.font));
 200
 201     for (int index = 0; index < logicalHeightHints.count(); ++index) {
 202         if (logicalHeightHints.at(index).first > 0.0) {
 203             continue;
 204         }
 205
 206         // If the current item is a link, we use the customized link font metrics instead of the normal font metrics.
 207         const QFontMetrics &fontMetrics = itemIsLink(index, view) ? linkFontMetrics : normalFontMetrics;
 208
 209         // For each row exactly one role is shown. Calculate the maximum required width that is necessary
 210         // to show all roles without horizontal clipping.
 211         qreal maximumRequiredWidth = 0.0;
 212
 213         if (showOnlyTextRole) {
 214             maximumRequiredWidth = fontMetrics.horizontalAdvance(itemText(index, view));
 215         } else {
 216             const QHash<QByteArray, QVariant> &values = view->model()->data(index);
 217             for (const QByteArray &role : visibleRoles) {
 218                 const QString &text = roleText(role, values);
 219                 const qreal requiredWidth = fontMetrics.horizontalAdvance(text);
 220                 maximumRequiredWidth = qMax(maximumRequiredWidth, requiredWidth);
 221             }
 222         }
 223
 224         qreal width = paddingAndIconWidth + maximumRequiredWidth;
 225         if (maxWidth > 0 && width > maxWidth) {
 226             width = maxWidth;
 227         }
 228
 229         logicalHeightHints[index].first = width;
 230     }
 231
 232     logicalWidthHint = height;
 233 }
 234
 235 void KStandardItemListWidgetInformant::calculateDetailsLayoutItemSizeHints(QVector<std::pair<qreal, bool>> &logicalHeightHints,
 236                                                                            qreal &logicalWidthHint,
 237                                                                            const KItemListView *view) const
 238 {
 239     const KItemListStyleOption &option = view->styleOption();
 240     const qreal height = option.padding * 2 + qMax(option.iconSize, option.fontMetrics.height());
 241     logicalHeightHints.fill(std::make_pair(height, false));
 242     logicalWidthHint = -1.0;
 243 }
 244
 245 KStandardItemListWidget::KStandardItemListWidget(KItemListWidgetInformant *informant, QGraphicsItem *parent)
 246     : KItemListWidget(informant, parent)
 247     , m_textInfo()
 248     , m_isCut(false)
 249     , m_isHidden(false)
 250     , m_customizedFont()
 251     , m_customizedFontMetrics(m_customizedFont)
 252     , m_isExpandable(false)
 253     , m_highlightEntireRow(false)
 254     , m_supportsItemExpanding(false)
 255     , m_dirtyLayout(true)
 256     , m_dirtyContent(true)
 257     , m_dirtyContentRoles()
 258     , m_layout(IconsLayout)
 259     , m_pixmapPos()
 260     , m_pixmap()
 261     , m_scaledPixmapSize()
 262     , m_columnWidthSum()
 263     , m_iconRect()
 264     , m_hoverPixmap()
 265     , m_textRect()
 266     , m_sortedVisibleRoles()
 267     , m_expansionArea()
 268     , m_customTextColor()
 269     , m_additionalInfoTextColor()
 270     , m_overlay()
 271     , m_rating()
 272     , m_roleEditor(nullptr)
 273     , m_oldRoleEditor(nullptr)
 274 {
 275 }
 276
 277 KStandardItemListWidget::~KStandardItemListWidget()
 278 {
 279     qDeleteAll(m_textInfo);
 280     m_textInfo.clear();
 281
 282     if (m_roleEditor) {
 283         m_roleEditor->deleteLater();
 284     }
 285
 286     if (m_oldRoleEditor) {
 287         m_oldRoleEditor->deleteLater();
 288     }
 289 }
 290
 291 void KStandardItemListWidget::setLayout(Layout layout)
 292 {
 293     if (m_layout != layout) {
 294         m_layout = layout;
 295         m_dirtyLayout = true;
 296         updateAdditionalInfoTextColor();
 297         update();
 298     }
 299 }
 300
 301 void KStandardItemListWidget::setHighlightEntireRow(bool highlightEntireRow)
 302 {
 303     if (m_highlightEntireRow != highlightEntireRow) {
 304         m_highlightEntireRow = highlightEntireRow;
 305         m_dirtyLayout = true;
 306         update();
 307     }
 308 }
 309
 310 bool KStandardItemListWidget::highlightEntireRow() const
 311 {
 312     return m_highlightEntireRow;
 313 }
 314
 315 void KStandardItemListWidget::setSupportsItemExpanding(bool supportsItemExpanding)
 316 {
 317     if (m_supportsItemExpanding != supportsItemExpanding) {
 318         m_supportsItemExpanding = supportsItemExpanding;
 319         m_dirtyLayout = true;
 320         update();
 321     }
 322 }
 323
 324 bool KStandardItemListWidget::supportsItemExpanding() const
 325 {
 326     return m_supportsItemExpanding;
 327 }
 328
 329 void KStandardItemListWidget::paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget)
 330 {
 331     const_cast<KStandardItemListWidget *>(this)->triggerCacheRefreshing();
 332
 333     KItemListWidget::paint(painter, option, widget);
 334
 335     if (!m_expansionArea.isEmpty()) {
 336         drawSiblingsInformation(painter);
 337     }
 338
 339     const KItemListStyleOption &itemListStyleOption = styleOption();
 340     if (isHovered() && !m_pixmap.isNull()) {
 341         if (hoverOpacity() < 1.0) {
 342             /*
 343              * Linear interpolation between m_pixmap and m_hoverPixmap.
 344              *
 345              * Note that this cannot be achieved by painting m_hoverPixmap over
 346              * m_pixmap, even if the opacities are adjusted. For details see
 347              * https://git.reviewboard.kde.org/r/109614/
 348              */
 349             // Paint pixmap1 so that pixmap1 = m_pixmap * (1.0 - hoverOpacity())
 350             QPixmap pixmap1(m_pixmap.size());
 351             pixmap1.setDevicePixelRatio(m_pixmap.devicePixelRatio());
 352             pixmap1.fill(Qt::transparent);
 353             {
 354                 QPainter p(&pixmap1);
 355                 p.setOpacity(1.0 - hoverOpacity());
 356                 p.drawPixmap(0, 0, m_pixmap);
 357             }
 358
 359             // Paint pixmap2 so that pixmap2 = m_hoverPixmap * hoverOpacity()
 360             QPixmap pixmap2(pixmap1.size());
 361             pixmap2.setDevicePixelRatio(pixmap1.devicePixelRatio());
 362             pixmap2.fill(Qt::transparent);
 363             {
 364                 QPainter p(&pixmap2);
 365                 p.setOpacity(hoverOpacity());
 366                 p.drawPixmap(0, 0, m_hoverPixmap);
 367             }
 368
 369             // Paint pixmap2 on pixmap1 using CompositionMode_Plus
 370             // Now pixmap1 = pixmap2 + m_pixmap * (1.0 - hoverOpacity())
 371             //             = m_hoverPixmap * hoverOpacity() + m_pixmap * (1.0 - hoverOpacity())
 372             {
 373                 QPainter p(&pixmap1);
 374                 p.setCompositionMode(QPainter::CompositionMode_Plus);
 375                 p.drawPixmap(0, 0, pixmap2);
 376             }
 377
 378             // Finally paint pixmap1 on the widget
 379             drawPixmap(painter, pixmap1);
 380         } else {
 381             drawPixmap(painter, m_hoverPixmap);
 382         }
 383     } else if (!m_pixmap.isNull()) {
 384         drawPixmap(painter, m_pixmap);
 385     }
 386
 387     painter->setFont(m_customizedFont);
 388     painter->setPen(textColor(*widget));
 389     const TextInfo *textInfo = m_textInfo.value("text");
 390
 391     if (!textInfo) {
 392         // It seems that we can end up here even if m_textInfo does not contain
 393         // the key "text", see bug 306167. According to triggerCacheRefreshing(),
 394         // this can only happen if the index is negative. This can happen when
 395         // the item is about to be removed, see KItemListView::slotItemsRemoved().
 396         // TODO: try to reproduce the crash and find a better fix.
 397         return;
 398     }
 399
 400     painter->drawStaticText(textInfo->pos, textInfo->staticText);
 401
 402     bool clipAdditionalInfoBounds = false;
 403     if (m_supportsItemExpanding) {
 404         // Prevent a possible overlapping of the additional-information texts
 405         // with the icon. This can happen if the user has minimized the width
 406         // of the name-column to a very small value.
 407         const qreal minX = m_pixmapPos.x() + m_pixmap.width() + 4 * itemListStyleOption.padding;
 408         if (textInfo->pos.x() + columnWidth("text") > minX) {
 409             clipAdditionalInfoBounds = true;
 410             painter->save();
 411             painter->setClipRect(minX, 0, size().width() - minX, size().height(), Qt::IntersectClip);
 412         }
 413     }
 414
 415     painter->setPen(m_additionalInfoTextColor);
 416     painter->setFont(m_customizedFont);
 417
 418     for (int i = 1; i < m_sortedVisibleRoles.count(); ++i) {
 419         const TextInfo *textInfo = m_textInfo.value(m_sortedVisibleRoles[i]);
 420         painter->drawStaticText(textInfo->pos, textInfo->staticText);
 421     }
 422
 423     if (!m_rating.isNull()) {
 424         const TextInfo *ratingTextInfo = m_textInfo.value("rating");
 425         QPointF pos = ratingTextInfo->pos;
 426         const Qt::Alignment align = ratingTextInfo->staticText.textOption().alignment();
 427         if (align & Qt::AlignHCenter) {
 428             pos.rx() += (size().width() - m_rating.width() / m_rating.devicePixelRatioF()) / 2 - 2;
 429         }
 430         painter->drawPixmap(pos, m_rating);
 431     }
 432
 433     if (clipAdditionalInfoBounds) {
 434         painter->restore();
 435     }
 436
 437 #ifdef KSTANDARDITEMLISTWIDGET_DEBUG
 438     painter->setBrush(Qt::NoBrush);
 439     painter->setPen(Qt::green);
 440     painter->drawRect(m_iconRect);
 441
 442     painter->setPen(Qt::blue);
 443     painter->drawRect(m_textRect);
 444
 445     painter->setPen(Qt::red);
 446     painter->drawText(QPointF(0, m_customizedFontMetrics.height()), QString::number(index()));
 447     painter->drawRect(rect());
 448 #endif
 449 }
 450
 451 QRectF KStandardItemListWidget::iconRect() const
 452 {
 453     const_cast<KStandardItemListWidget *>(this)->triggerCacheRefreshing();
 454     return m_iconRect;
 455 }
 456
 457 QRectF KStandardItemListWidget::textRect() const
 458 {
 459     const_cast<KStandardItemListWidget *>(this)->triggerCacheRefreshing();
 460     return m_textRect;
 461 }
 462
 463 QRectF KStandardItemListWidget::textFocusRect() const
 464 {
 465     // In the compact- and details-layout a larger textRect() is returned to be aligned
 466     // with the iconRect(). This is useful to have a larger selection/hover-area
 467     // when having a quite large icon size but only one line of text. Still the
 468     // focus rectangle should be shown as narrow as possible around the text.
 469
 470     const_cast<KStandardItemListWidget *>(this)->triggerCacheRefreshing();
 471
 472     switch (m_layout) {
 473     case CompactLayout: {
 474         QRectF rect = m_textRect;
 475         const TextInfo *topText = m_textInfo.value(m_sortedVisibleRoles.first());
 476         const TextInfo *bottomText = m_textInfo.value(m_sortedVisibleRoles.last());
 477         rect.setTop(topText->pos.y());
 478         rect.setBottom(bottomText->pos.y() + bottomText->staticText.size().height());
 479         return rect;
 480     }
 481
 482     case DetailsLayout: {
 483         QRectF rect = m_textRect;
 484         const TextInfo *textInfo = m_textInfo.value(m_sortedVisibleRoles.first());
 485         rect.setTop(textInfo->pos.y());
 486         rect.setBottom(textInfo->pos.y() + textInfo->staticText.size().height());
 487
 488         const KItemListStyleOption &option = styleOption();
 489         if (option.extendedSelectionRegion) {
 490             const QString text = textInfo->staticText.text();
 491             rect.setWidth(m_customizedFontMetrics.horizontalAdvance(text) + 2 * option.padding);
 492         }
 493
 494         return rect;
 495     }
 496
 497     default:
 498         break;
 499     }
 500
 501     return m_textRect;
 502 }
 503
 504 QRectF KStandardItemListWidget::selectionRect() const
 505 {
 506     const_cast<KStandardItemListWidget *>(this)->triggerCacheRefreshing();
 507
 508     switch (m_layout) {
 509     case IconsLayout:
 510         return m_textRect;
 511
 512     case CompactLayout:
 513     case DetailsLayout: {
 514         const int padding = styleOption().padding;
 515         QRectF adjustedIconRect = iconRect().adjusted(-padding, -padding, padding, padding);
 516         QRectF result = adjustedIconRect | m_textRect;
 517         if (m_highlightEntireRow) {
 518             result.setRight(m_columnWidthSum + sidePadding());
 519         }
 520         return result;
 521     }
 522
 523     default:
 524         Q_ASSERT(false);
 525         break;
 526     }
 527
 528     return m_textRect;
 529 }
 530
 531 QRectF KStandardItemListWidget::expansionToggleRect() const
 532 {
 533     const_cast<KStandardItemListWidget *>(this)->triggerCacheRefreshing();
 534     return m_isExpandable ? m_expansionArea : QRectF();
 535 }
 536
 537 QRectF KStandardItemListWidget::selectionToggleRect() const
 538 {
 539     const_cast<KStandardItemListWidget *>(this)->triggerCacheRefreshing();
 540
 541     const QRectF widgetIconRect = iconRect();
 542     const int widgetIconSize = iconSize();
 543     int toggleSize = KIconLoader::SizeSmall;
 544     if (widgetIconSize >= KIconLoader::SizeEnormous) {
 545         toggleSize = KIconLoader::SizeMedium;
 546     } else if (widgetIconSize >= KIconLoader::SizeLarge) {
 547         toggleSize = KIconLoader::SizeSmallMedium;
 548     }
 549
 550     QPointF pos = widgetIconRect.topLeft();
 551
 552     // If the selection toggle has a very small distance to the
 553     // widget borders, the size of the selection toggle will get
 554     // increased to prevent an accidental clicking of the item
 555     // when trying to hit the toggle.
 556     const int widgetHeight = size().height();
 557     const int widgetWidth = size().width();
 558     const int minMargin = 2;
 559
 560     if (toggleSize + minMargin * 2 >= widgetHeight) {
 561         pos.rx() -= (widgetHeight - toggleSize) / 2;
 562         toggleSize = widgetHeight;
 563         pos.setY(0);
 564     }
 565     if (toggleSize + minMargin * 2 >= widgetWidth) {
 566         pos.ry() -= (widgetWidth - toggleSize) / 2;
 567         toggleSize = widgetWidth;
 568         pos.setX(0);
 569     }
 570
 571     if (QApplication::isRightToLeft()) {
 572         pos.setX(widgetIconRect.right() - (pos.x() + toggleSize - widgetIconRect.left()));
 573     }
 574
 575     return QRectF(pos, QSizeF(toggleSize, toggleSize));
 576 }
 577
 578 QPixmap KStandardItemListWidget::createDragPixmap(const QStyleOptionGraphicsItem *option, QWidget *widget)
 579 {
 580     QPixmap pixmap = KItemListWidget::createDragPixmap(option, widget);
 581     if (m_layout != DetailsLayout) {
 582         return pixmap;
 583     }
 584
 585     // Only return the content of the text-column as pixmap
 586     const int leftClip = m_pixmapPos.x();
 587
 588     const TextInfo *textInfo = m_textInfo.value("text");
 589     const int rightClip = textInfo->pos.x() + textInfo->staticText.size().width() + 2 * styleOption().padding;
 590
 591     QPixmap clippedPixmap(rightClip - leftClip + 1, pixmap.height());
 592     clippedPixmap.fill(Qt::transparent);
 593
 594     QPainter painter(&clippedPixmap);
 595     painter.drawPixmap(-leftClip, 0, pixmap);
 596
 597     return clippedPixmap;
 598 }
 599
 600 void KStandardItemListWidget::startActivateSoonAnimation(int timeUntilActivation)
 601 {
 602     if (m_activateSoonAnimation) {
 603         m_activateSoonAnimation->stop(); // automatically DeleteWhenStopped
 604     }
 605
 606     m_activateSoonAnimation = new QVariantAnimation{this};
 607     m_activateSoonAnimation->setStartValue(0.0);
 608     m_activateSoonAnimation->setEndValue(1.0);
 609     m_activateSoonAnimation->setDuration(timeUntilActivation);
 610
 611     const QVariant originalIconName{data()["iconName"]};
 612     connect(m_activateSoonAnimation, &QVariantAnimation::valueChanged, this, [originalIconName, this](const QVariant &value) {
 613         auto progress = value.toFloat();
 614
 615         QVariant wantedIconName;
 616         if (progress < 0.333) {
 617             wantedIconName = "folder-open";
 618         } else if (progress < 0.666) {
 619             wantedIconName = originalIconName;
 620         } else {
 621             wantedIconName = "folder-open";
 622         }
 623
 624         QHash<QByteArray, QVariant> itemData{data()};
 625         if (itemData["iconName"] != wantedIconName) {
 626             itemData.insert("iconName", wantedIconName);
 627             setData(itemData);
 628             invalidateIconCache();
 629         }
 630     });
 631
 632     connect(m_activateSoonAnimation, &QObject::destroyed, this, [originalIconName, this]() {
 633         QHash<QByteArray, QVariant> itemData{data()};
 634         if (itemData["iconName"] == "folder-open") {
 635             itemData.insert("iconName", originalIconName);
 636             setData(itemData);
 637             invalidateIconCache();
 638         }
 639     });
 640
 641     m_activateSoonAnimation->start(QAbstractAnimation::DeleteWhenStopped);
 642 }
 643
 644 bool KStandardItemListWidget::isIconControlledByActivateSoonAnimation() const
 645 {
 646     return m_activateSoonAnimation && data()["iconName"] == "folder-open";
 647 }
 648
 649 KItemListWidgetInformant *KStandardItemListWidget::createInformant()
 650 {
 651     return new KStandardItemListWidgetInformant();
 652 }
 653
 654 void KStandardItemListWidget::invalidateCache()
 655 {
 656     m_dirtyLayout = true;
 657     m_dirtyContent = true;
 658 }
 659
 660 void KStandardItemListWidget::invalidateIconCache()
 661 {
 662     m_dirtyContent = true;
 663     m_dirtyContentRoles.insert("iconPixmap");
 664     m_dirtyContentRoles.insert("iconOverlays");
 665 }
 666
 667 void KStandardItemListWidget::refreshCache()
 668 {
 669 }
 670
 671 bool KStandardItemListWidget::isRoleRightAligned(const QByteArray &role) const
 672 {
 673     Q_UNUSED(role)
 674     return false;
 675 }
 676
 677 bool KStandardItemListWidget::isHidden() const
 678 {
 679     return false;
 680 }
 681
 682 QFont KStandardItemListWidget::customizedFont(const QFont &baseFont) const
 683 {
 684     return baseFont;
 685 }
 686
 687 QPalette::ColorRole KStandardItemListWidget::normalTextColorRole() const
 688 {
 689     return QPalette::Text;
 690 }
 691
 692 void KStandardItemListWidget::setTextColor(const QColor &color)
 693 {
 694     if (color != m_customTextColor) {
 695         m_customTextColor = color;
 696         updateAdditionalInfoTextColor();
 697         update();
 698     }
 699 }
 700
 701 QColor KStandardItemListWidget::textColor(const QWidget &widget) const
 702 {
 703     if (!isSelected()) {
 704         if (m_isHidden) {
 705             return m_additionalInfoTextColor;
 706         } else if (m_customTextColor.isValid()) {
 707             return m_customTextColor;
 708         }
 709     }
 710
 711     const QPalette::ColorGroup group = isActiveWindow() && widget.hasFocus() ? QPalette::Active : QPalette::Inactive;
 712     const QPalette::ColorRole role = isSelected() ? QPalette::HighlightedText : normalTextColorRole();
 713     return styleOption().palette.color(group, role);
 714 }
 715
 716 void KStandardItemListWidget::setOverlay(const QPixmap &overlay)
 717 {
 718     m_overlay = overlay;
 719     m_dirtyContent = true;
 720     update();
 721 }
 722
 723 QPixmap KStandardItemListWidget::overlay() const
 724 {
 725     return m_overlay;
 726 }
 727
 728 QString KStandardItemListWidget::roleText(const QByteArray &role, const QHash<QByteArray, QVariant> &values) const
 729 {
 730     return static_cast<const KStandardItemListWidgetInformant *>(informant())->roleText(role, values);
 731 }
 732
 733 void KStandardItemListWidget::dataChanged(const QHash<QByteArray, QVariant> &current, const QSet<QByteArray> &roles)
 734 {
 735     Q_UNUSED(current)
 736
 737     m_dirtyContent = true;
 738
 739     QSet<QByteArray> dirtyRoles;
 740     if (roles.isEmpty()) {
 741         const auto visibleRoles = this->visibleRoles();
 742         dirtyRoles = QSet<QByteArray>(visibleRoles.constBegin(), visibleRoles.constEnd());
 743     } else {
 744         dirtyRoles = roles;
 745     }
 746
 747     // The URL might have changed (i.e., if the sort order of the items has
 748     // been changed). Therefore, the "is cut" state must be updated.
 749     KFileItemClipboard *clipboard = KFileItemClipboard::instance();
 750     const QUrl itemUrl = data().value("url").toUrl();
 751     m_isCut = clipboard->isCut(itemUrl);
 752
 753     // The icon-state might depend from other roles and hence is
 754     // marked as dirty whenever a role has been changed
 755     dirtyRoles.insert("iconPixmap");
 756     dirtyRoles.insert("iconName");
 757
 758     QSetIterator<QByteArray> it(dirtyRoles);
 759     while (it.hasNext()) {
 760         const QByteArray &role = it.next();
 761         m_dirtyContentRoles.insert(role);
 762     }
 763 }
 764
 765 void KStandardItemListWidget::visibleRolesChanged(const QList<QByteArray> &current, const QList<QByteArray> &previous)
 766 {
 767     Q_UNUSED(previous)
 768     m_sortedVisibleRoles = current;
 769     m_dirtyLayout = true;
 770 }
 771
 772 void KStandardItemListWidget::columnWidthChanged(const QByteArray &role, qreal current, qreal previous)
 773 {
 774     Q_UNUSED(role)
 775     Q_UNUSED(current)
 776     Q_UNUSED(previous)
 777     m_dirtyLayout = true;
 778 }
 779
 780 void KStandardItemListWidget::sidePaddingChanged(qreal padding)
 781 {
 782     Q_UNUSED(padding)
 783     m_dirtyLayout = true;
 784 }
 785
 786 void KStandardItemListWidget::styleOptionChanged(const KItemListStyleOption &current, const KItemListStyleOption &previous)
 787 {
 788     KItemListWidget::styleOptionChanged(current, previous);
 789
 790     updateAdditionalInfoTextColor();
 791     m_dirtyLayout = true;
 792 }
 793
 794 void KStandardItemListWidget::hoveredChanged(bool hovered)
 795 {
 796     if (!hovered && m_activateSoonAnimation) {
 797         m_activateSoonAnimation->stop(); // automatically DeleteWhenStopped
 798     }
 799     m_dirtyLayout = true;
 800 }
 801
 802 void KStandardItemListWidget::selectedChanged(bool selected)
 803 {
 804     Q_UNUSED(selected)
 805     updateAdditionalInfoTextColor();
 806     m_dirtyContent = true;
 807 }
 808
 809 void KStandardItemListWidget::siblingsInformationChanged(const QBitArray &current, const QBitArray &previous)
 810 {
 811     Q_UNUSED(current)
 812     Q_UNUSED(previous)
 813     m_dirtyLayout = true;
 814 }
 815
 816 int KStandardItemListWidget::numberOfUnicodeCharactersIn(const QString &text)
 817 {
 818     int count = 0;
 819     QTextBoundaryFinder boundaryFinder(QTextBoundaryFinder::Grapheme, text);
 820     while (boundaryFinder.toNextBoundary() != -1) {
 821         ++count;
 822     }
 823     return count;
 824 }
 825
 826 int KStandardItemListWidget::selectionLength(const QString &text) const
 827 {
 828     return numberOfUnicodeCharactersIn(text);
 829 }
 830
 831 void KStandardItemListWidget::editedRoleChanged(const QByteArray &current, const QByteArray &previous)
 832 {
 833     Q_UNUSED(previous)
 834
 835     QGraphicsView *parent = scene()->views()[0];
 836     if (current.isEmpty() || !parent || current != "text") {
 837         if (m_roleEditor) {
 838             Q_EMIT roleEditingCanceled(index(), current, data().value(current));
 839
 840             disconnect(m_roleEditor, &KItemListRoleEditor::roleEditingCanceled, this, &KStandardItemListWidget::slotRoleEditingCanceled);
 841             disconnect(m_roleEditor, &KItemListRoleEditor::roleEditingFinished, this, &KStandardItemListWidget::slotRoleEditingFinished);
 842
 843             if (m_oldRoleEditor) {
 844                 m_oldRoleEditor->deleteLater();
 845             }
 846             m_oldRoleEditor = m_roleEditor;
 847             m_roleEditor->hide();
 848             m_roleEditor = nullptr;
 849         }
 850         return;
 851     }
 852
 853     Q_ASSERT(!m_roleEditor);
 854
 855     const TextInfo *textInfo = m_textInfo.value("text");
 856
 857     m_roleEditor = new KItemListRoleEditor(parent);
 858     m_roleEditor->setRole(current);
 859     m_roleEditor->setAllowUpDownKeyChainEdit(m_layout != IconsLayout);
 860     m_roleEditor->setFont(styleOption().font);
 861
 862     const QString text = data().value(current).toString();
 863     m_roleEditor->setPlainText(text);
 864
 865     QTextOption textOption = textInfo->staticText.textOption();
 866     m_roleEditor->document()->setDefaultTextOption(textOption);
 867
 868     const int textSelectionLength = selectionLength(text);
 869
 870     if (textSelectionLength > 0) {
 871         QTextCursor cursor = m_roleEditor->textCursor();
 872         cursor.movePosition(QTextCursor::StartOfBlock);
 873         cursor.movePosition(QTextCursor::NextCharacter, QTextCursor::KeepAnchor, textSelectionLength);
 874         m_roleEditor->setTextCursor(cursor);
 875     }
 876
 877     connect(m_roleEditor, &KItemListRoleEditor::roleEditingCanceled, this, &KStandardItemListWidget::slotRoleEditingCanceled);
 878     connect(m_roleEditor, &KItemListRoleEditor::roleEditingFinished, this, &KStandardItemListWidget::slotRoleEditingFinished);
 879
 880     // Adjust the geometry of the editor
 881     QRectF rect = roleEditingRect(current);
 882     const int frameWidth = m_roleEditor->frameWidth();
 883     rect.adjust(-frameWidth, -frameWidth, frameWidth, frameWidth);
 884     rect.translate(pos());
 885     if (rect.right() > parent->width()) {
 886         rect.setWidth(parent->width() - rect.left());
 887     }
 888     m_roleEditor->setGeometry(rect.toRect());
 889     m_roleEditor->autoAdjustSize();
 890     m_roleEditor->show();
 891     m_roleEditor->setFocus();
 892 }
 893
 894 void KStandardItemListWidget::iconSizeChanged(int current, int previous)
 895 {
 896     KItemListWidget::iconSizeChanged(current, previous);
 897
 898     invalidateIconCache();
 899     triggerCacheRefreshing();
 900     update();
 901 }
 902
 903 void KStandardItemListWidget::resizeEvent(QGraphicsSceneResizeEvent *event)
 904 {
 905     if (m_roleEditor) {
 906         setEditedRole(QByteArray());
 907         Q_ASSERT(!m_roleEditor);
 908     }
 909
 910     KItemListWidget::resizeEvent(event);
 911
 912     m_dirtyLayout = true;
 913 }
 914
 915 void KStandardItemListWidget::showEvent(QShowEvent *event)
 916 {
 917     KItemListWidget::showEvent(event);
 918
 919     // Listen to changes of the clipboard to mark the item as cut/uncut
 920     KFileItemClipboard *clipboard = KFileItemClipboard::instance();
 921
 922     const QUrl itemUrl = data().value("url").toUrl();
 923     m_isCut = clipboard->isCut(itemUrl);
 924
 925     connect(clipboard, &KFileItemClipboard::cutItemsChanged, this, &KStandardItemListWidget::slotCutItemsChanged);
 926 }
 927
 928 void KStandardItemListWidget::hideEvent(QHideEvent *event)
 929 {
 930     disconnect(KFileItemClipboard::instance(), &KFileItemClipboard::cutItemsChanged, this, &KStandardItemListWidget::slotCutItemsChanged);
 931
 932     KItemListWidget::hideEvent(event);
 933 }
 934
 935 bool KStandardItemListWidget::event(QEvent *event)
 936 {
 937     if (event->type() == QEvent::WindowDeactivate || event->type() == QEvent::WindowActivate || event->type() == QEvent::PaletteChange) {
 938         m_dirtyContent = true;
 939     }
 940
 941     return KItemListWidget::event(event);
 942 }
 943
 944 void KStandardItemListWidget::finishRoleEditing()
 945 {
 946     if (!editedRole().isEmpty() && m_roleEditor) {
 947         slotRoleEditingFinished(editedRole(), KIO::encodeFileName(m_roleEditor->toPlainText()));
 948     }
 949 }
 950
 951 void KStandardItemListWidget::slotCutItemsChanged()
 952 {
 953     const QUrl itemUrl = data().value("url").toUrl();
 954     const bool isCut = KFileItemClipboard::instance()->isCut(itemUrl);
 955     if (m_isCut != isCut) {
 956         m_isCut = isCut;
 957         m_pixmap = QPixmap();
 958         m_dirtyContent = true;
 959         update();
 960     }
 961 }
 962
 963 void KStandardItemListWidget::slotRoleEditingCanceled(const QByteArray &role, const QVariant &value)
 964 {
 965     closeRoleEditor();
 966     Q_EMIT roleEditingCanceled(index(), role, value);
 967     setEditedRole(QByteArray());
 968 }
 969
 970 void KStandardItemListWidget::slotRoleEditingFinished(const QByteArray &role, const QVariant &value)
 971 {
 972     closeRoleEditor();
 973     Q_EMIT roleEditingFinished(index(), role, value);
 974     setEditedRole(QByteArray());
 975 }
 976
 977 void KStandardItemListWidget::triggerCacheRefreshing()
 978 {
 979     if ((!m_dirtyContent && !m_dirtyLayout) || index() < 0) {
 980         return;
 981     }
 982
 983     refreshCache();
 984
 985     const QHash<QByteArray, QVariant> values = data();
 986     m_isExpandable = m_supportsItemExpanding && values["isExpandable"].toBool();
 987     m_isHidden = isHidden();
 988     m_customizedFont = customizedFont(styleOption().font);
 989     m_customizedFontMetrics = QFontMetrics(m_customizedFont);
 990     m_columnWidthSum = std::accumulate(m_sortedVisibleRoles.begin(), m_sortedVisibleRoles.end(), qreal(), [this](qreal sum, const auto &role) {
 991         return sum + columnWidth(role);
 992     });
 993
 994     updateExpansionArea();
 995     updateTextsCache();
 996     updatePixmapCache();
 997     clearHoverCache();
 998
 999     m_dirtyLayout = false;
1000     m_dirtyContent = false;
1001     m_dirtyContentRoles.clear();
1002 }
1003
1004 void KStandardItemListWidget::updateExpansionArea()
1005 {
1006     if (m_supportsItemExpanding) {
1007         const QHash<QByteArray, QVariant> values = data();
1008         const int expandedParentsCount = values.value("expandedParentsCount", 0).toInt();
1009         if (expandedParentsCount >= 0) {
1010             const int widgetIconSize = iconSize();
1011             const qreal widgetHeight = size().height();
1012             const qreal inc = (widgetHeight - widgetIconSize) / 2;
1013             const qreal x = expandedParentsCount * widgetHeight + inc;
1014             const qreal y = inc;
1015             const qreal xPadding = m_highlightEntireRow ? sidePadding() : 0;
1016             m_expansionArea = QRectF(xPadding + x, y, widgetIconSize, widgetIconSize);
1017             return;
1018         }
1019     }
1020
1021     m_expansionArea = QRectF();
1022 }
1023
1024 void KStandardItemListWidget::updatePixmapCache()
1025 {
1026     // Precondition: Requires already updated m_textPos values to calculate
1027     // the remaining height when the alignment is vertical.
1028
1029     const QSizeF widgetSize = size();
1030     const bool iconOnTop = (m_layout == IconsLayout);
1031     const KItemListStyleOption &option = styleOption();
1032     const qreal padding = option.padding;
1033     const qreal dpr = KItemViewsUtils::devicePixelRatio(this);
1034
1035     const int widgetIconSize = iconSize();
1036     const int maxIconWidth = iconOnTop ? widgetSize.width() - 2 * padding : widgetIconSize;
1037     const int maxIconHeight = widgetIconSize;
1038
1039     const QHash<QByteArray, QVariant> values = data();
1040
1041     bool updatePixmap = (m_pixmap.width() != maxIconWidth || m_pixmap.height() != maxIconHeight);
1042     if (!updatePixmap && m_dirtyContent) {
1043         updatePixmap = m_dirtyContentRoles.isEmpty() || m_dirtyContentRoles.contains("iconPixmap") || m_dirtyContentRoles.contains("iconName")
1044             || m_dirtyContentRoles.contains("iconOverlays");
1045     }
1046
1047     if (updatePixmap) {
1048         m_pixmap = QPixmap();
1049
1050         int sequenceIndex = hoverSequenceIndex();
1051
1052         if (values.contains("hoverSequencePixmaps") && !isIconControlledByActivateSoonAnimation()) {
1053             // Use one of the hover sequence pixmaps instead of the default
1054             // icon pixmap.
1055
1056             const QVector<QPixmap> pixmaps = values["hoverSequencePixmaps"].value<QVector<QPixmap>>();
1057
1058             if (values.contains("hoverSequenceWraparoundPoint")) {
1059                 const float wap = values["hoverSequenceWraparoundPoint"].toFloat();
1060                 if (wap >= 1.0f) {
1061                     sequenceIndex %= static_cast<int>(wap);
1062                 }
1063             }
1064
1065             const int loadedIndex = qMax(qMin(sequenceIndex, pixmaps.size() - 1), 0);
1066
1067             if (loadedIndex != 0) {
1068                 m_pixmap = pixmaps[loadedIndex];
1069             }
1070         }
1071
1072         if (m_pixmap.isNull() && !isIconControlledByActivateSoonAnimation()) {
1073             m_pixmap = values["iconPixmap"].value<QPixmap>();
1074         }
1075
1076         if (m_pixmap.isNull()) {
1077             // Use the icon that fits to the MIME-type
1078             QString iconName = values["iconName"].toString();
1079             if (iconName.isEmpty()) {
1080                 // The icon-name has not been not resolved by KFileItemModelRolesUpdater,
1081                 // use a generic icon as fallback
1082                 iconName = QStringLiteral("unknown");
1083             }
1084             const QStringList overlays = values["iconOverlays"].toStringList();
1085             const bool hasFocus = scene()->views()[0]->parentWidget()->hasFocus();
1086             m_pixmap = pixmapForIcon(iconName,
1087                                      overlays,
1088                                      maxIconHeight,
1089                                      m_layout != IconsLayout && isActiveWindow() && isSelected() && hasFocus ? QIcon::Selected : QIcon::Normal);
1090
1091         } else if (m_pixmap.width() / m_pixmap.devicePixelRatio() != maxIconWidth || m_pixmap.height() / m_pixmap.devicePixelRatio() != maxIconHeight) {
1092             // A custom pixmap has been applied. Assure that the pixmap
1093             // is scaled to the maximum available size.
1094             KPixmapModifier::scale(m_pixmap, QSize(maxIconWidth, maxIconHeight) * dpr);
1095         }
1096
1097         if (m_pixmap.isNull()) {
1098             m_hoverPixmap = QPixmap();
1099             return;
1100         }
1101
1102         if (m_isCut) {
1103 #if KICONTHEMES_VERSION >= QT_VERSION_CHECK(6, 5, 0)
1104             KIconEffect::toDisabled(m_pixmap);
1105 #else
1106             QImage img = m_pixmap.toImage();
1107             KIconEffect::toGray(img, 1);
1108             KIconEffect::semiTransparent(img);
1109             m_pixmap = QPixmap::fromImage(img);
1110 #endif
1111         }
1112
1113         if (m_isHidden) {
1114             KIconEffect::semiTransparent(m_pixmap);
1115         }
1116
1117         if (m_layout == IconsLayout && isSelected()) {
1118             const QColor color = palette().brush(QPalette::Normal, QPalette::Highlight).color();
1119             QImage image = m_pixmap.toImage();
1120             if (image.isNull()) {
1121                 m_hoverPixmap = QPixmap();
1122                 return;
1123             }
1124             KIconEffect::colorize(image, color, 0.8f);
1125             m_pixmap = QPixmap::fromImage(image);
1126         }
1127     }
1128
1129     if (!m_overlay.isNull()) {
1130         QPainter painter(&m_pixmap);
1131         painter.drawPixmap(0, (m_pixmap.height() - m_overlay.height()) / m_pixmap.devicePixelRatio(), m_overlay);
1132     }
1133
1134     int scaledIconSize = 0;
1135     if (iconOnTop) {
1136         const TextInfo *textInfo = m_textInfo.value("text");
1137         scaledIconSize = static_cast<int>(textInfo->pos.y() - 2 * padding);
1138     } else {
1139         const int textRowsCount = (m_layout == CompactLayout) ? visibleRoles().count() : 1;
1140         const qreal requiredTextHeight = textRowsCount * m_customizedFontMetrics.height();
1141         scaledIconSize = (requiredTextHeight < maxIconHeight) ? widgetSize.height() - 2 * padding : maxIconHeight;
1142     }
1143
1144     const int maxScaledIconWidth = iconOnTop ? widgetSize.width() - 2 * padding : scaledIconSize;
1145     const int maxScaledIconHeight = scaledIconSize;
1146
1147     m_scaledPixmapSize = m_pixmap.size();
1148     m_scaledPixmapSize.scale(maxScaledIconWidth * dpr, maxScaledIconHeight * dpr, Qt::KeepAspectRatio);
1149     m_scaledPixmapSize = m_scaledPixmapSize / dpr;
1150
1151     if (iconOnTop) {
1152         // Center horizontally and align on bottom within the icon-area
1153         m_pixmapPos.setX((widgetSize.width() - m_scaledPixmapSize.width()) / 2.0);
1154         m_pixmapPos.setY(padding + scaledIconSize - m_scaledPixmapSize.height());
1155     } else {
1156         // Center horizontally and vertically within the icon-area
1157         const TextInfo *textInfo = m_textInfo.value("text");
1158         if (QApplication::isRightToLeft() && m_layout == CompactLayout) {
1159             m_pixmapPos.setX(size().width() - padding - (scaledIconSize + m_scaledPixmapSize.width()) / 2.0);
1160         } else {
1161             m_pixmapPos.setX(textInfo->pos.x() - 2.0 * padding - (scaledIconSize + m_scaledPixmapSize.width()) / 2.0);
1162         }
1163
1164         // Derive icon's vertical center from the center of the text frame, including
1165         // any necessary adjustment if the font's midline is offset from the frame center
1166         const qreal midlineShift = m_customizedFontMetrics.height() / 2.0 - m_customizedFontMetrics.descent() - m_customizedFontMetrics.capHeight() / 2.0;
1167         m_pixmapPos.setY(m_textRect.center().y() + midlineShift - m_scaledPixmapSize.height() / 2.0);
1168     }
1169
1170     if (m_layout == IconsLayout) {
1171         m_iconRect = QRectF(m_pixmapPos, QSizeF(m_scaledPixmapSize));
1172     } else {
1173         const qreal widthOffset = widgetIconSize - m_scaledPixmapSize.width();
1174         const qreal heightOffset = widgetIconSize - m_scaledPixmapSize.height();
1175         const QPointF squareIconPos(m_pixmapPos.x() - 0.5 * widthOffset, m_pixmapPos.y() - 0.5 * heightOffset);
1176         const QSizeF squareIconSize(widgetIconSize, widgetIconSize);
1177         m_iconRect = QRectF(squareIconPos, squareIconSize);
1178     }
1179
1180     // Prepare the pixmap that is used when the item gets hovered
1181     if (isHovered()) {
1182         m_hoverPixmap = m_pixmap;
1183 #if KICONTHEMES_VERSION >= QT_VERSION_CHECK(6, 5, 0)
1184         KIconEffect::toActive(m_hoverPixmap);
1185 #else
1186         QImage img = m_pixmap.toImage();
1187         KIconEffect::toGamma(img, 0.7);
1188         m_hoverPixmap = QPixmap::fromImage(img);
1189 #endif
1190     } else if (hoverOpacity() <= 0.0) {
1191         // No hover animation is ongoing. Clear m_hoverPixmap to save memory.
1192         m_hoverPixmap = QPixmap();
1193     }
1194 }
1195
1196 void KStandardItemListWidget::updateTextsCache()
1197 {
1198     QTextOption textOption;
1199     switch (m_layout) {
1200     case IconsLayout:
1201         textOption.setWrapMode(QTextOption::WrapAtWordBoundaryOrAnywhere);
1202         textOption.setAlignment(Qt::AlignHCenter);
1203         break;
1204     case CompactLayout:
1205         textOption.setAlignment(QApplication::isRightToLeft() ? Qt::AlignRight : Qt::AlignLeft);
1206         textOption.setWrapMode(QTextOption::NoWrap);
1207         break;
1208     case DetailsLayout:
1209         textOption.setAlignment(Qt::AlignLeft);
1210         textOption.setWrapMode(QTextOption::NoWrap);
1211         break;
1212     default:
1213         Q_ASSERT(false);
1214         break;
1215     }
1216
1217     qDeleteAll(m_textInfo);
1218     m_textInfo.clear();
1219     for (int i = 0; i < m_sortedVisibleRoles.count(); ++i) {
1220         TextInfo *textInfo = new TextInfo();
1221         textInfo->staticText.setTextFormat(Qt::PlainText);
1222         textInfo->staticText.setPerformanceHint(QStaticText::AggressiveCaching);
1223         textInfo->staticText.setTextOption(textOption);
1224         m_textInfo.insert(m_sortedVisibleRoles[i], textInfo);
1225     }
1226
1227     switch (m_layout) {
1228     case IconsLayout:
1229         updateIconsLayoutTextCache();
1230         break;
1231     case CompactLayout:
1232         updateCompactLayoutTextCache();
1233         break;
1234     case DetailsLayout:
1235         updateDetailsLayoutTextCache();
1236         break;
1237     default:
1238         Q_ASSERT(false);
1239         break;
1240     }
1241
1242     const TextInfo *ratingTextInfo = m_textInfo.value("rating");
1243     if (ratingTextInfo) {
1244         // The text of the rating-role has been set to empty to get
1245         // replaced by a rating-image showing the rating as stars.
1246         const KItemListStyleOption &option = styleOption();
1247         QSizeF ratingSize = preferredRatingSize(option);
1248
1249         const qreal availableWidth = (m_layout == DetailsLayout) ? columnWidth("rating") - columnPadding(option) : size().width();
1250         if (ratingSize.width() > availableWidth) {
1251             ratingSize.rwidth() = availableWidth;
1252         }
1253         const qreal dpr = KItemViewsUtils::devicePixelRatio(this);
1254         m_rating = QPixmap(ratingSize.toSize() * dpr);
1255         m_rating.setDevicePixelRatio(dpr);
1256         m_rating.fill(Qt::transparent);
1257
1258         QPainter painter(&m_rating);
1259         const QRect rect(QPoint(0, 0), ratingSize.toSize());
1260         const int rating = data().value("rating").toInt();
1261         KRatingPainter::paintRating(&painter, rect, Qt::AlignJustify | Qt::AlignVCenter, rating);
1262     } else if (!m_rating.isNull()) {
1263         m_rating = QPixmap();
1264     }
1265 }
1266
1267 QString KStandardItemListWidget::elideRightKeepExtension(const QString &text, int elidingWidth) const
1268 {
1269     const auto extensionIndex = text.lastIndexOf('.');
1270     if (extensionIndex != -1) {
1271         // has file extension
1272         const auto extensionLength = text.length() - extensionIndex;
1273         const auto extensionWidth = m_customizedFontMetrics.horizontalAdvance(text.right(extensionLength));
1274         if (elidingWidth > extensionWidth && extensionLength < 6 && (float(extensionWidth) / float(elidingWidth)) < 0.3) {
1275             // if we have room to display the file extension and the extension is not too long
1276             QString ret = m_customizedFontMetrics.elidedText(text.chopped(extensionLength), Qt::ElideRight, elidingWidth - extensionWidth);
1277             ret.append(QStringView(text).right(extensionLength));
1278             return ret;
1279         }
1280     }
1281     return m_customizedFontMetrics.elidedText(text, Qt::ElideRight, elidingWidth);
1282 }
1283
1284 QString KStandardItemListWidget::escapeString(const QString &text) const
1285 {
1286     QString escaped(text);
1287
1288     const QChar returnSymbol(0x21b5);
1289     escaped.replace('\n', returnSymbol);
1290
1291     return escaped;
1292 }
1293
1294 void KStandardItemListWidget::updateIconsLayoutTextCache()
1295 {
1296     //      +------+
1297     //      | Icon |
1298     //      +------+
1299     //
1300     //    Name role that
1301     // might get wrapped above
1302     //    several lines.
1303     //  Additional role 1
1304     //  Additional role 2
1305
1306     const QHash<QByteArray, QVariant> values = data();
1307
1308     const KItemListStyleOption &option = styleOption();
1309     const qreal padding = option.padding;
1310     const qreal maxWidth = size().width() - 2 * padding;
1311     const qreal lineSpacing = m_customizedFontMetrics.lineSpacing();
1312
1313     // Initialize properties for the "text" role. It will be used as anchor
1314     // for initializing the position of the other roles.
1315     TextInfo *nameTextInfo = m_textInfo.value("text");
1316     const QString nameText = KStringHandler::preProcessWrap(escapeString(values["text"].toString()));
1317     nameTextInfo->staticText.setText(nameText);
1318
1319     // Calculate the number of lines required for the name and the required width
1320     qreal nameWidth = 0;
1321     qreal nameHeight = 0;
1322     QTextLine line;
1323
1324     QTextLayout layout(nameTextInfo->staticText.text(), m_customizedFont);
1325     layout.setTextOption(nameTextInfo->staticText.textOption());
1326     layout.beginLayout();
1327     int nameLineIndex = 0;
1328     while ((line = layout.createLine()).isValid()) {
1329         line.setLineWidth(maxWidth);
1330         nameWidth = qMax(nameWidth, line.naturalTextWidth());
1331         nameHeight += line.height();
1332
1333         ++nameLineIndex;
1334         if (nameLineIndex == option.maxTextLines) {
1335             // The maximum number of textlines has been reached. If this is
1336             // the case provide an elided text if necessary.
1337             const int textLength = line.textStart() + line.textLength();
1338             if (textLength < nameText.length()) {
1339                 // Elide the last line of the text
1340                 qreal elidingWidth = maxWidth;
1341                 qreal lastLineWidth;
1342                 do {
1343                     QString lastTextLine = nameText.mid(line.textStart());
1344                     lastTextLine = elideRightKeepExtension(lastTextLine, elidingWidth);
1345                     const QString elidedText = nameText.left(line.textStart()) + lastTextLine;
1346                     nameTextInfo->staticText.setText(elidedText);
1347
1348                     lastLineWidth = m_customizedFontMetrics.horizontalAdvance(lastTextLine);
1349
1350                     // We do the text eliding in a loop with decreasing width (1 px / iteration)
1351                     // to avoid problems related to different width calculation code paths
1352                     // within Qt. (see bug 337104)
1353                     elidingWidth -= 1.0;
1354                 } while (lastLineWidth > maxWidth);
1355
1356                 nameWidth = qMax(nameWidth, lastLineWidth);
1357             }
1358             break;
1359         }
1360     }
1361     layout.endLayout();
1362
1363     // Use one line for each additional information
1364     nameTextInfo->staticText.setTextWidth(maxWidth);
1365     nameTextInfo->pos = QPointF(padding, iconSize() + 2 * padding);
1366     m_textRect = QRectF(padding + (maxWidth - nameWidth) / 2, nameTextInfo->pos.y(), nameWidth, nameHeight);
1367
1368     // Calculate the position for each additional information
1369     qreal y = nameTextInfo->pos.y() + nameHeight;
1370     for (const QByteArray &role : std::as_const(m_sortedVisibleRoles)) {
1371         if (role == "text") {
1372             continue;
1373         }
1374
1375         const QString text = roleText(role, values);
1376         TextInfo *textInfo = m_textInfo.value(role);
1377         textInfo->staticText.setText(text);
1378
1379         qreal requiredWidth = 0;
1380
1381         QTextLayout layout(text, m_customizedFont);
1382         QTextOption textOption;
1383         textOption.setWrapMode(QTextOption::NoWrap);
1384         layout.setTextOption(textOption);
1385
1386         layout.beginLayout();
1387         QTextLine textLine = layout.createLine();
1388         if (textLine.isValid()) {
1389             textLine.setLineWidth(maxWidth);
1390             requiredWidth = textLine.naturalTextWidth();
1391             if (requiredWidth > maxWidth) {
1392                 const QString elidedText = elideRightKeepExtension(text, maxWidth);
1393                 textInfo->staticText.setText(elidedText);
1394                 requiredWidth = m_customizedFontMetrics.horizontalAdvance(elidedText);
1395             } else if (role == "rating") {
1396                 // Use the width of the rating pixmap, because the rating text is empty.
1397                 requiredWidth = m_rating.width() / m_rating.devicePixelRatioF();
1398             }
1399         }
1400         layout.endLayout();
1401
1402         textInfo->pos = QPointF(padding, y);
1403         textInfo->staticText.setTextWidth(maxWidth);
1404
1405         const QRectF textRect(padding + (maxWidth - requiredWidth) / 2, y, requiredWidth, lineSpacing);
1406
1407         // Ignore empty roles. Avoids a text rect taller than the area that actually contains text.
1408         if (!textRect.isEmpty()) {
1409             m_textRect |= textRect;
1410         }
1411
1412         y += lineSpacing;
1413     }
1414
1415     // Add a padding to the text rectangle
1416     m_textRect.adjust(-padding, -padding, padding, padding);
1417 }
1418
1419 void KStandardItemListWidget::updateCompactLayoutTextCache()
1420 {
1421     // +------+  Name role
1422     // | Icon |  Additional role 1
1423     // +------+  Additional role 2
1424
1425     const QHash<QByteArray, QVariant> values = data();
1426
1427     const KItemListStyleOption &option = styleOption();
1428     const qreal widgetHeight = size().height();
1429     const qreal lineSpacing = m_customizedFontMetrics.lineSpacing();
1430     const qreal textLinesHeight = qMax(visibleRoles().count(), 1) * lineSpacing;
1431
1432     qreal maximumRequiredTextWidth = 0;
1433     const qreal x = QApplication::isRightToLeft() ? option.padding : option.padding * 3 + iconSize();
1434     qreal y = qRound((widgetHeight - textLinesHeight) / 2);
1435     const qreal maxWidth = size().width() - iconSize() - 4 * option.padding;
1436     for (const QByteArray &role : std::as_const(m_sortedVisibleRoles)) {
1437         const QString text = escapeString(roleText(role, values));
1438         TextInfo *textInfo = m_textInfo.value(role);
1439         textInfo->staticText.setText(text);
1440
1441         qreal requiredWidth = m_customizedFontMetrics.horizontalAdvance(text);
1442         if (requiredWidth > maxWidth) {
1443             requiredWidth = maxWidth;
1444             const QString elidedText = elideRightKeepExtension(text, maxWidth);
1445             textInfo->staticText.setText(elidedText);
1446         }
1447
1448         textInfo->pos = QPointF(x, y);
1449         textInfo->staticText.setTextWidth(maxWidth);
1450
1451         maximumRequiredTextWidth = qMax(maximumRequiredTextWidth, requiredWidth);
1452
1453         y += lineSpacing;
1454     }
1455
1456     m_textRect = QRectF(x - option.padding, 0, maximumRequiredTextWidth + 2 * option.padding, widgetHeight);
1457 }
1458
1459 void KStandardItemListWidget::updateDetailsLayoutTextCache()
1460 {
1461     // Precondition: Requires already updated m_expansionArea
1462     // to determine the left position.
1463
1464     // +------+
1465     // | Icon |  Name role   Additional role 1   Additional role 2
1466     // +------+
1467     m_textRect = QRectF();
1468
1469     const KItemListStyleOption &option = styleOption();
1470     const QHash<QByteArray, QVariant> values = data();
1471
1472     const qreal widgetHeight = size().height();
1473     const int fontHeight = m_customizedFontMetrics.height();
1474
1475     const qreal columnWidthInc = columnPadding(option);
1476     qreal firstColumnInc = iconSize();
1477     if (m_supportsItemExpanding) {
1478         firstColumnInc += (m_expansionArea.left() + m_expansionArea.right() + widgetHeight) / 2;
1479     } else {
1480         firstColumnInc += option.padding + sidePadding();
1481     }
1482
1483     qreal x = firstColumnInc;
1484     const qreal y = qMax(qreal(option.padding), (widgetHeight - fontHeight) / 2);
1485
1486     for (const QByteArray &role : std::as_const(m_sortedVisibleRoles)) {
1487         QString text = roleText(role, values);
1488
1489         // Elide the text in case it does not fit into the available column-width
1490         qreal requiredWidth = m_customizedFontMetrics.horizontalAdvance(text);
1491         const qreal roleWidth = columnWidth(role);
1492         qreal availableTextWidth = roleWidth - columnWidthInc;
1493
1494         const bool isTextRole = (role == "text");
1495         if (isTextRole) {
1496             text = escapeString(text);
1497             availableTextWidth -= firstColumnInc - sidePadding();
1498         }
1499
1500         if (requiredWidth > availableTextWidth) {
1501             text = elideRightKeepExtension(text, availableTextWidth);
1502             requiredWidth = m_customizedFontMetrics.horizontalAdvance(text);
1503         }
1504
1505         TextInfo *textInfo = m_textInfo.value(role);
1506         textInfo->staticText.setText(text);
1507         textInfo->pos = QPointF(x + columnWidthInc / 2, y);
1508         x += roleWidth;
1509
1510         if (isTextRole) {
1511             const qreal textWidth = option.extendedSelectionRegion ? size().width() - textInfo->pos.x() : requiredWidth + 2 * option.padding;
1512             m_textRect = QRectF(textInfo->pos.x() - option.padding, 0, textWidth, size().height());
1513
1514             // The column after the name should always be aligned on the same x-position independent
1515             // from the expansion-level shown in the name column
1516             x -= firstColumnInc - sidePadding();
1517         } else if (isRoleRightAligned(role)) {
1518             textInfo->pos.rx() += roleWidth - requiredWidth - columnWidthInc;
1519         }
1520     }
1521 }
1522
1523 void KStandardItemListWidget::updateAdditionalInfoTextColor()
1524 {
1525     QColor c1;
1526     const bool hasFocus = scene()->views()[0]->parentWidget()->hasFocus();
1527     if (m_customTextColor.isValid()) {
1528         c1 = m_customTextColor;
1529     } else if (isSelected() && hasFocus && (m_layout != DetailsLayout || m_highlightEntireRow)) {
1530         // The detail text color needs to match the main text (HighlightedText) for the same level
1531         // of readability. We short circuit early here to avoid interpolating with another color.
1532         m_additionalInfoTextColor = styleOption().palette.color(QPalette::HighlightedText);
1533         return;
1534     } else {
1535         c1 = styleOption().palette.text().color();
1536     }
1537
1538     // For the color of the additional info the inactive text color
1539     // is not used as this might lead to unreadable text for some color schemes. Instead
1540     // the text color c1 is slightly mixed with the background color.
1541     const QColor c2 = styleOption().palette.base().color();
1542     const int p1 = 70;
1543     const int p2 = 100 - p1;
1544     m_additionalInfoTextColor =
1545         QColor((c1.red() * p1 + c2.red() * p2) / 100, (c1.green() * p1 + c2.green() * p2) / 100, (c1.blue() * p1 + c2.blue() * p2) / 100);
1546 }
1547
1548 void KStandardItemListWidget::drawPixmap(QPainter *painter, const QPixmap &pixmap)
1549 {
1550     if (m_scaledPixmapSize != pixmap.size() / pixmap.devicePixelRatio()) {
1551         const qreal dpr = KItemViewsUtils::devicePixelRatio(this);
1552         QPixmap scaledPixmap = pixmap;
1553         KPixmapModifier::scale(scaledPixmap, m_scaledPixmapSize * dpr);
1554         scaledPixmap.setDevicePixelRatio(dpr);
1555         painter->drawPixmap(m_pixmapPos, scaledPixmap);
1556
1557 #ifdef KSTANDARDITEMLISTWIDGET_DEBUG
1558         painter->setPen(Qt::blue);
1559         painter->drawRect(QRectF(m_pixmapPos, QSizeF(m_scaledPixmapSize)));
1560 #endif
1561     } else {
1562         painter->drawPixmap(m_pixmapPos, pixmap);
1563     }
1564 }
1565
1566 void KStandardItemListWidget::drawSiblingsInformation(QPainter *painter)
1567 {
1568     const int siblingSize = size().height();
1569     const int x = (m_expansionArea.left() + m_expansionArea.right() - siblingSize) / 2;
1570     QRect siblingRect(x, 0, siblingSize, siblingSize);
1571
1572     bool isItemSibling = true;
1573
1574     const QBitArray siblings = siblingsInformation();
1575     QStyleOption option;
1576     const auto normalColor = option.palette.color(normalTextColorRole());
1577     const auto highlightColor = option.palette.color(expansionAreaHovered() ? QPalette::Highlight : normalTextColorRole());
1578     for (int i = siblings.count() - 1; i >= 0; --i) {
1579         option.rect = siblingRect;
1580         option.state = siblings.at(i) ? QStyle::State_Sibling : QStyle::State_None;
1581         if (isItemSibling) {
1582             option.state |= QStyle::State_Item;
1583             if (m_isExpandable) {
1584                 option.state |= QStyle::State_Children;
1585             }
1586             if (data().value("isExpanded").toBool()) {
1587                 option.state |= QStyle::State_Open;
1588             }
1589             option.palette.setColor(QPalette::Text, highlightColor);
1590             isItemSibling = false;
1591         } else {
1592             option.palette.setColor(QPalette::Text, normalColor);
1593         }
1594
1595         style()->drawPrimitive(QStyle::PE_IndicatorBranch, &option, painter);
1596
1597         siblingRect.translate(-siblingRect.width(), 0);
1598     }
1599 }
1600
1601 QRectF KStandardItemListWidget::roleEditingRect(const QByteArray &role) const
1602 {
1603     const TextInfo *textInfo = m_textInfo.value(role);
1604     if (!textInfo) {
1605         return QRectF();
1606     }
1607
1608     QRectF rect(textInfo->pos, textInfo->staticText.size());
1609     if (m_layout == DetailsLayout) {
1610         rect.setWidth(columnWidth(role) - rect.x());
1611     }
1612
1613     return rect;
1614 }
1615
1616 void KStandardItemListWidget::closeRoleEditor()
1617 {
1618     disconnect(m_roleEditor, &KItemListRoleEditor::roleEditingCanceled, this, &KStandardItemListWidget::slotRoleEditingCanceled);
1619     disconnect(m_roleEditor, &KItemListRoleEditor::roleEditingFinished, this, &KStandardItemListWidget::slotRoleEditingFinished);
1620
1621     if (m_roleEditor->hasFocus()) {
1622         // If the editing was not ended by a FocusOut event, we have
1623         // to transfer the keyboard focus back to the KItemListContainer.
1624         scene()->views()[0]->parentWidget()->setFocus();
1625     }
1626
1627     if (m_oldRoleEditor) {
1628         m_oldRoleEditor->deleteLater();
1629     }
1630     m_oldRoleEditor = m_roleEditor;
1631     m_roleEditor->hide();
1632     m_roleEditor = nullptr;
1633 }
1634
1635 QPixmap KStandardItemListWidget::pixmapForIcon(const QString &name, const QStringList &overlays, int size, QIcon::Mode mode) const
1636 {
1637     static const QIcon fallbackIcon = QIcon::fromTheme(QStringLiteral("unknown"));
1638     const qreal dpr = KItemViewsUtils::devicePixelRatio(this);
1639
1640     size *= dpr;
1641
1642     const QString key = "KStandardItemListWidget:" % name % ":" % overlays.join(QLatin1Char(':')) % ":" % QString::number(size) % "@" % QString::number(dpr)
1643         % ":" % QString::number(mode);
1644     QPixmap pixmap;
1645
1646     if (!QPixmapCache::find(key, &pixmap)) {
1647         QIcon icon = QIcon::fromTheme(name);
1648         if (icon.isNull()) {
1649             icon = QIcon(name);
1650         }
1651         if (icon.isNull() || icon.pixmap(size / dpr, size / dpr, mode).isNull()) {
1652             icon = fallbackIcon;
1653         }
1654
1655         pixmap = icon.pixmap(QSize(size / dpr, size / dpr), dpr, mode);
1656         if (pixmap.width() != size || pixmap.height() != size) {
1657             KPixmapModifier::scale(pixmap, QSize(size, size));
1658         }
1659
1660         // Strangely KFileItem::overlays() returns empty string-values, so
1661         // we need to check first whether an overlay must be drawn at all.
1662         for (const QString &overlay : overlays) {
1663             if (!overlay.isEmpty()) {
1664                 // There is at least one overlay, draw all overlays above m_pixmap
1665                 // and cancel the check
1666                 const QSize size = pixmap.size();
1667                 pixmap = KIconUtils::addOverlays(pixmap, overlays).pixmap(size, mode);
1668                 break;
1669             }
1670         }
1671
1672         QPixmapCache::insert(key, pixmap);
1673     }
1674     pixmap.setDevicePixelRatio(dpr);
1675
1676     return pixmap;
1677 }
1678
1679 QSizeF KStandardItemListWidget::preferredRatingSize(const KItemListStyleOption &option)
1680 {
1681     const qreal height = option.fontMetrics.ascent();
1682     return QSizeF(height * 5, height);
1683 }
1684
1685 qreal KStandardItemListWidget::columnPadding(const KItemListStyleOption &option)
1686 {
1687     return option.padding * 6;
1688 }
1689
1690 #include "moc_kstandarditemlistwidget.cpp"