]> cloud.milkyroute.net Git - dolphin.git/blob - src/kitemviews/kstandarditemlistwidget.cpp
Removed unused list iterators
[dolphin.git] / src / kitemviews / kstandarditemlistwidget.cpp
1 /***************************************************************************
2 * Copyright (C) 2012 by Peter Penz <peter.penz19@gmail.com> *
3 * *
4 * This program is free software; you can redistribute it and/or modify *
5 * it under the terms of the GNU General Public License as published by *
6 * the Free Software Foundation; either version 2 of the License, or *
7 * (at your option) any later version. *
8 * *
9 * This program is distributed in the hope that it will be useful, *
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of *
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
12 * GNU General Public License for more details. *
13 * *
14 * You should have received a copy of the GNU General Public License *
15 * along with this program; if not, write to the *
16 * Free Software Foundation, Inc., *
17 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA *
18 ***************************************************************************/
19
20 #include "kstandarditemlistwidget.h"
21
22 #include "kfileitemlistview.h"
23 #include "kfileitemmodel.h"
24
25 #include <KIcon>
26 #include <KIconEffect>
27 #include <KIconLoader>
28 #include <KLocale>
29 #include <kratingpainter.h>
30 #include <KStringHandler>
31 #include <KDebug>
32
33 #include "private/kfileitemclipboard.h"
34 #include "private/kitemlistroleeditor.h"
35 #include "private/kpixmapmodifier.h"
36
37 #include <QFontMetricsF>
38 #include <QGraphicsScene>
39 #include <QGraphicsSceneResizeEvent>
40 #include <QGraphicsView>
41 #include <QPainter>
42 #include <QStyleOption>
43 #include <QTextLayout>
44 #include <QTextLine>
45
46 // #define KSTANDARDITEMLISTWIDGET_DEBUG
47
48 KStandardItemListWidgetInformant::KStandardItemListWidgetInformant() :
49 KItemListWidgetInformant()
50 {
51 }
52
53 KStandardItemListWidgetInformant::~KStandardItemListWidgetInformant()
54 {
55 }
56
57 QSizeF KStandardItemListWidgetInformant::itemSizeHint(int index, const KItemListView* view) const
58 {
59 const QHash<QByteArray, QVariant> values = view->model()->data(index);
60 const KItemListStyleOption& option = view->styleOption();
61 const int additionalRolesCount = qMax(view->visibleRoles().count() - 1, 0);
62
63 switch (static_cast<const KStandardItemListView*>(view)->itemLayout()) {
64 case KStandardItemListWidget::IconsLayout: {
65 const QString text = KStringHandler::preProcessWrap(values["text"].toString());
66
67 const qreal itemWidth = view->itemSize().width();
68 const qreal maxWidth = itemWidth - 2 * option.padding;
69 QTextLine line;
70
71 // Calculate the number of lines required for wrapping the name
72 QTextOption textOption(Qt::AlignHCenter);
73 textOption.setWrapMode(QTextOption::WrapAtWordBoundaryOrAnywhere);
74
75 qreal textHeight = 0;
76 QTextLayout layout(text, option.font);
77 layout.setTextOption(textOption);
78 layout.beginLayout();
79 while ((line = layout.createLine()).isValid()) {
80 line.setLineWidth(maxWidth);
81 line.naturalTextWidth();
82 textHeight += line.height();
83 }
84 layout.endLayout();
85
86 // Add one line for each additional information
87 textHeight += additionalRolesCount * option.fontMetrics.lineSpacing();
88
89 const qreal maxTextHeight = option.maxTextSize.height();
90 if (maxTextHeight > 0 && textHeight > maxTextHeight) {
91 textHeight = maxTextHeight;
92 }
93
94 return QSizeF(itemWidth, textHeight + option.iconSize + option.padding * 3);
95 }
96
97 case KStandardItemListWidget::CompactLayout: {
98 // For each row exactly one role is shown. Calculate the maximum required width that is necessary
99 // to show all roles without horizontal clipping.
100 qreal maximumRequiredWidth = 0.0;
101
102 foreach (const QByteArray& role, view->visibleRoles()) {
103 const QString text = roleText(role, values);
104 const qreal requiredWidth = option.fontMetrics.width(text);
105 maximumRequiredWidth = qMax(maximumRequiredWidth, requiredWidth);
106 }
107
108 qreal width = option.padding * 4 + option.iconSize + maximumRequiredWidth;
109 const qreal maxWidth = option.maxTextSize.width();
110 if (maxWidth > 0 && width > maxWidth) {
111 width = maxWidth;
112 }
113 const qreal height = option.padding * 2 + qMax(option.iconSize, (1 + additionalRolesCount) * option.fontMetrics.lineSpacing());
114 return QSizeF(width, height);
115 }
116
117 case KStandardItemListWidget::DetailsLayout: {
118 const qreal height = option.padding * 2 + qMax(option.iconSize, option.fontMetrics.height());
119 return QSizeF(-1, height);
120 }
121
122 default:
123 Q_ASSERT(false);
124 break;
125 }
126
127 return QSize();
128 }
129
130 qreal KStandardItemListWidgetInformant::preferredRoleColumnWidth(const QByteArray& role,
131 int index,
132 const KItemListView* view) const
133 {
134 const QHash<QByteArray, QVariant> values = view->model()->data(index);
135 const KItemListStyleOption& option = view->styleOption();
136
137 const QString text = roleText(role, values);
138 qreal width = KStandardItemListWidget::columnPadding(option);
139
140 if (role == "rating") {
141 width += KStandardItemListWidget::preferredRatingSize(option).width();
142 } else {
143 width += option.fontMetrics.width(text);
144
145 if (role == "text") {
146 if (view->supportsItemExpanding()) {
147 // Increase the width by the expansion-toggle and the current expansion level
148 const int expandedParentsCount = values.value("expandedParentsCount", 0).toInt();
149 const qreal height = option.padding * 2 + qMax(option.iconSize, option.fontMetrics.height());
150 width += (expandedParentsCount + 1) * height;
151 }
152
153 // Increase the width by the required space for the icon
154 width += option.padding * 2 + option.iconSize;
155 }
156 }
157
158 return width;
159 }
160
161 QString KStandardItemListWidgetInformant::roleText(const QByteArray& role,
162 const QHash<QByteArray, QVariant>& values) const
163 {
164 if (role == "rating") {
165 // Always use an empty text, as the rating is shown by the image m_rating.
166 return QString();
167 }
168 return values.value(role).toString();
169 }
170
171 KStandardItemListWidget::KStandardItemListWidget(KItemListWidgetInformant* informant, QGraphicsItem* parent) :
172 KItemListWidget(informant, parent),
173 m_isCut(false),
174 m_isHidden(false),
175 m_isExpandable(false),
176 m_supportsItemExpanding(false),
177 m_dirtyLayout(true),
178 m_dirtyContent(true),
179 m_dirtyContentRoles(),
180 m_layout(IconsLayout),
181 m_pixmapPos(),
182 m_pixmap(),
183 m_scaledPixmapSize(),
184 m_iconRect(),
185 m_hoverPixmap(),
186 m_textInfo(),
187 m_textRect(),
188 m_sortedVisibleRoles(),
189 m_expansionArea(),
190 m_customTextColor(),
191 m_additionalInfoTextColor(),
192 m_overlay(),
193 m_rating(),
194 m_roleEditor(0)
195 {
196 }
197
198 KStandardItemListWidget::~KStandardItemListWidget()
199 {
200 qDeleteAll(m_textInfo);
201 m_textInfo.clear();
202
203 delete m_roleEditor;
204 }
205
206 void KStandardItemListWidget::setLayout(Layout layout)
207 {
208 if (m_layout != layout) {
209 m_layout = layout;
210 m_dirtyLayout = true;
211 updateAdditionalInfoTextColor();
212 update();
213 }
214 }
215
216 KStandardItemListWidget::Layout KStandardItemListWidget::layout() const
217 {
218 return m_layout;
219 }
220
221 void KStandardItemListWidget::setSupportsItemExpanding(bool supportsItemExpanding)
222 {
223 if (m_supportsItemExpanding != supportsItemExpanding) {
224 m_supportsItemExpanding = supportsItemExpanding;
225 m_dirtyLayout = true;
226 update();
227 }
228 }
229
230 bool KStandardItemListWidget::supportsItemExpanding() const
231 {
232 return m_supportsItemExpanding;
233 }
234
235 void KStandardItemListWidget::paint(QPainter* painter, const QStyleOptionGraphicsItem* option, QWidget* widget)
236 {
237 const_cast<KStandardItemListWidget*>(this)->triggerCacheRefreshing();
238
239 KItemListWidget::paint(painter, option, widget);
240
241 if (!m_expansionArea.isEmpty()) {
242 drawSiblingsInformation(painter);
243 }
244
245 const KItemListStyleOption& itemListStyleOption = styleOption();
246 if (isHovered()) {
247 // Blend the unhovered and hovered pixmap if the hovering
248 // animation is ongoing
249 if (hoverOpacity() < 1.0) {
250 drawPixmap(painter, m_pixmap);
251 }
252
253 const qreal opacity = painter->opacity();
254 painter->setOpacity(hoverOpacity() * opacity);
255 drawPixmap(painter, m_hoverPixmap);
256 painter->setOpacity(opacity);
257 } else {
258 drawPixmap(painter, m_pixmap);
259 }
260
261 painter->setFont(itemListStyleOption.font);
262 painter->setPen(m_isHidden ? m_additionalInfoTextColor : textColor());
263 const TextInfo* textInfo = m_textInfo.value("text");
264 painter->drawStaticText(textInfo->pos, textInfo->staticText);
265
266 bool clipAdditionalInfoBounds = false;
267 if (m_supportsItemExpanding) {
268 // Prevent a possible overlapping of the additional-information texts
269 // with the icon. This can happen if the user has minimized the width
270 // of the name-column to a very small value.
271 const qreal minX = m_pixmapPos.x() + m_pixmap.width() + 4 * itemListStyleOption.padding;
272 if (textInfo->pos.x() + columnWidth("text") > minX) {
273 clipAdditionalInfoBounds = true;
274 painter->save();
275 painter->setClipRect(minX, 0, size().width() - minX, size().height(), Qt::IntersectClip);
276 }
277 }
278
279 painter->setPen(m_additionalInfoTextColor);
280 painter->setFont(itemListStyleOption.font);
281
282 for (int i = 1; i < m_sortedVisibleRoles.count(); ++i) {
283 const TextInfo* textInfo = m_textInfo.value(m_sortedVisibleRoles[i]);
284 painter->drawStaticText(textInfo->pos, textInfo->staticText);
285 }
286
287 if (!m_rating.isNull()) {
288 const TextInfo* ratingTextInfo = m_textInfo.value("rating");
289 QPointF pos = ratingTextInfo->pos;
290 const Qt::Alignment align = ratingTextInfo->staticText.textOption().alignment();
291 if (align & Qt::AlignHCenter) {
292 pos.rx() += (size().width() - m_rating.width()) / 2;
293 }
294 painter->drawPixmap(pos, m_rating);
295 }
296
297 if (clipAdditionalInfoBounds) {
298 painter->restore();
299 }
300
301 #ifdef KSTANDARDITEMLISTWIDGET_DEBUG
302 painter->setBrush(Qt::NoBrush);
303 painter->setPen(Qt::green);
304 painter->drawRect(m_iconRect);
305
306 painter->setPen(Qt::red);
307 painter->drawText(QPointF(0, itemListStyleOption.fontMetrics.height()), QString::number(index()));
308 painter->drawRect(rect());
309 #endif
310 }
311
312 QRectF KStandardItemListWidget::iconRect() const
313 {
314 const_cast<KStandardItemListWidget*>(this)->triggerCacheRefreshing();
315 return m_iconRect;
316 }
317
318 QRectF KStandardItemListWidget::textRect() const
319 {
320 const_cast<KStandardItemListWidget*>(this)->triggerCacheRefreshing();
321 return m_textRect;
322 }
323
324 QRectF KStandardItemListWidget::textFocusRect() const
325 {
326 // In the compact- and details-layout a larger textRect() is returned to be aligned
327 // with the iconRect(). This is useful to have a larger selection/hover-area
328 // when having a quite large icon size but only one line of text. Still the
329 // focus rectangle should be shown as narrow as possible around the text.
330
331 const_cast<KStandardItemListWidget*>(this)->triggerCacheRefreshing();
332
333 switch (m_layout) {
334 case CompactLayout: {
335 QRectF rect = m_textRect;
336 const TextInfo* topText = m_textInfo.value(m_sortedVisibleRoles.first());
337 const TextInfo* bottomText = m_textInfo.value(m_sortedVisibleRoles.last());
338 rect.setTop(topText->pos.y());
339 rect.setBottom(bottomText->pos.y() + bottomText->staticText.size().height());
340 return rect;
341 }
342
343 case DetailsLayout: {
344 QRectF rect = m_textRect;
345 const TextInfo* textInfo = m_textInfo.value(m_sortedVisibleRoles.first());
346 rect.setTop(textInfo->pos.y());
347 rect.setBottom(textInfo->pos.y() + textInfo->staticText.size().height());
348
349 const KItemListStyleOption& option = styleOption();
350 if (option.extendedSelectionRegion) {
351 const QString text = textInfo->staticText.text();
352 rect.setWidth(option.fontMetrics.width(text) + 2 * option.padding);
353 }
354
355 return rect;
356 }
357
358 default:
359 break;
360 }
361
362 return m_textRect;
363 }
364
365 QRectF KStandardItemListWidget::expansionToggleRect() const
366 {
367 const_cast<KStandardItemListWidget*>(this)->triggerCacheRefreshing();
368 return m_isExpandable ? m_expansionArea : QRectF();
369 }
370
371 QRectF KStandardItemListWidget::selectionToggleRect() const
372 {
373 const_cast<KStandardItemListWidget*>(this)->triggerCacheRefreshing();
374
375 const int iconHeight = styleOption().iconSize;
376
377 int toggleSize = KIconLoader::SizeSmall;
378 if (iconHeight >= KIconLoader::SizeEnormous) {
379 toggleSize = KIconLoader::SizeMedium;
380 } else if (iconHeight >= KIconLoader::SizeLarge) {
381 toggleSize = KIconLoader::SizeSmallMedium;
382 }
383
384 QPointF pos = iconRect().topLeft();
385
386 // If the selection toggle has a very small distance to the
387 // widget borders, the size of the selection toggle will get
388 // increased to prevent an accidental clicking of the item
389 // when trying to hit the toggle.
390 const int widgetHeight = size().height();
391 const int widgetWidth = size().width();
392 const int minMargin = 2;
393
394 if (toggleSize + minMargin * 2 >= widgetHeight) {
395 pos.rx() -= (widgetHeight - toggleSize) / 2;
396 toggleSize = widgetHeight;
397 pos.setY(0);
398 }
399 if (toggleSize + minMargin * 2 >= widgetWidth) {
400 pos.ry() -= (widgetWidth - toggleSize) / 2;
401 toggleSize = widgetWidth;
402 pos.setX(0);
403 }
404
405 return QRectF(pos, QSizeF(toggleSize, toggleSize));
406 }
407
408 QPixmap KStandardItemListWidget::createDragPixmap(const QStyleOptionGraphicsItem* option,
409 QWidget* widget)
410 {
411 QPixmap pixmap = KItemListWidget::createDragPixmap(option, widget);
412 if (m_layout != DetailsLayout || styleOption().extendedSelectionRegion) {
413 return pixmap;
414 }
415
416 // Only return the content of the text-column as pixmap
417 const int leftClip = m_pixmapPos.x();
418
419 const TextInfo* textInfo = m_textInfo.value("text");
420 const int rightClip = textInfo->pos.x() +
421 textInfo->staticText.size().width() +
422 2 * styleOption().padding;
423
424 QPixmap clippedPixmap(rightClip - leftClip + 1, pixmap.height());
425 clippedPixmap.fill(Qt::transparent);
426
427 QPainter painter(&clippedPixmap);
428 painter.drawPixmap(-leftClip, 0, pixmap);
429
430 return clippedPixmap;
431 }
432
433
434 KItemListWidgetInformant* KStandardItemListWidget::createInformant()
435 {
436 return new KStandardItemListWidgetInformant();
437 }
438
439 void KStandardItemListWidget::invalidateCache()
440 {
441 m_dirtyLayout = true;
442 m_dirtyContent = true;
443 }
444
445 void KStandardItemListWidget::refreshCache()
446 {
447 }
448
449 bool KStandardItemListWidget::isRoleRightAligned(const QByteArray& role) const
450 {
451 Q_UNUSED(role);
452 return false;
453 }
454
455 bool KStandardItemListWidget::isHidden() const
456 {
457 return false;
458 }
459
460 void KStandardItemListWidget::setTextColor(const QColor& color)
461 {
462 if (color != m_customTextColor) {
463 m_customTextColor = color;
464 updateAdditionalInfoTextColor();
465 update();
466 }
467 }
468
469 QColor KStandardItemListWidget::textColor() const
470 {
471 if (m_customTextColor.isValid() && !isSelected()) {
472 return m_customTextColor;
473 }
474
475 const QPalette::ColorGroup group = isActiveWindow() ? QPalette::Active : QPalette::Inactive;
476 const QPalette::ColorRole role = isSelected() ? QPalette::HighlightedText : QPalette::Text;
477 return styleOption().palette.brush(group, role).color();
478 }
479
480 void KStandardItemListWidget::setOverlay(const QPixmap& overlay)
481 {
482 m_overlay = overlay;
483 m_dirtyContent = true;
484 update();
485 }
486
487 QPixmap KStandardItemListWidget::overlay() const
488 {
489 return m_overlay;
490 }
491
492
493 QString KStandardItemListWidget::roleText(const QByteArray& role,
494 const QHash<QByteArray, QVariant>& values) const
495 {
496 return static_cast<const KStandardItemListWidgetInformant*>(informant())->roleText(role, values);
497 }
498
499 void KStandardItemListWidget::dataChanged(const QHash<QByteArray, QVariant>& current,
500 const QSet<QByteArray>& roles)
501 {
502 Q_UNUSED(current);
503
504 m_dirtyContent = true;
505
506 QSet<QByteArray> dirtyRoles;
507 if (roles.isEmpty()) {
508 dirtyRoles = visibleRoles().toSet();
509 } else {
510 dirtyRoles = roles;
511 }
512
513 // The icon-state might depend from other roles and hence is
514 // marked as dirty whenever a role has been changed
515 dirtyRoles.insert("iconPixmap");
516 dirtyRoles.insert("iconName");
517
518 QSetIterator<QByteArray> it(dirtyRoles);
519 while (it.hasNext()) {
520 const QByteArray& role = it.next();
521 m_dirtyContentRoles.insert(role);
522 }
523 }
524
525 void KStandardItemListWidget::visibleRolesChanged(const QList<QByteArray>& current,
526 const QList<QByteArray>& previous)
527 {
528 Q_UNUSED(previous);
529 m_sortedVisibleRoles = current;
530 m_dirtyLayout = true;
531 }
532
533 void KStandardItemListWidget::columnWidthChanged(const QByteArray& role,
534 qreal current,
535 qreal previous)
536 {
537 Q_UNUSED(role);
538 Q_UNUSED(current);
539 Q_UNUSED(previous);
540 m_dirtyLayout = true;
541 }
542
543 void KStandardItemListWidget::styleOptionChanged(const KItemListStyleOption& current,
544 const KItemListStyleOption& previous)
545 {
546 Q_UNUSED(current);
547 Q_UNUSED(previous);
548 updateAdditionalInfoTextColor();
549 m_dirtyLayout = true;
550 }
551
552 void KStandardItemListWidget::hoveredChanged(bool hovered)
553 {
554 Q_UNUSED(hovered);
555 m_dirtyLayout = true;
556 }
557
558 void KStandardItemListWidget::selectedChanged(bool selected)
559 {
560 Q_UNUSED(selected);
561 updateAdditionalInfoTextColor();
562 m_dirtyContent = true;
563 }
564
565 void KStandardItemListWidget::siblingsInformationChanged(const QBitArray& current, const QBitArray& previous)
566 {
567 Q_UNUSED(current);
568 Q_UNUSED(previous);
569 m_dirtyLayout = true;
570 }
571
572 void KStandardItemListWidget::editedRoleChanged(const QByteArray& current, const QByteArray& previous)
573 {
574 Q_UNUSED(previous);
575
576 QGraphicsView* parent = scene()->views()[0];
577 if (current.isEmpty() || !parent || current != "text") {
578 if (m_roleEditor) {
579 emit roleEditingCanceled(index(), current, data().value(current));
580 m_roleEditor->deleteLater();
581 m_roleEditor = 0;
582 }
583 return;
584 }
585
586 Q_ASSERT(!m_roleEditor);
587
588 const TextInfo* textInfo = m_textInfo.value("text");
589
590 m_roleEditor = new KItemListRoleEditor(parent);
591 m_roleEditor->setIndex(index());
592 m_roleEditor->setRole(current);
593
594 const QString text = data().value(current).toString();
595 m_roleEditor->setPlainText(text);
596
597 QTextOption textOption = textInfo->staticText.textOption();
598 m_roleEditor->document()->setDefaultTextOption(textOption);
599
600 // Select the text without MIME-type extension
601 int selectionLength = text.length();
602
603 const QString extension = KMimeType::extractKnownExtension(text);
604 if (!extension.isEmpty()) {
605 selectionLength -= extension.length() + 1;
606 }
607
608 if (selectionLength > 0) {
609 QTextCursor cursor = m_roleEditor->textCursor();
610 cursor.movePosition(QTextCursor::StartOfBlock);
611 cursor.movePosition(QTextCursor::NextCharacter, QTextCursor::KeepAnchor, selectionLength);
612 m_roleEditor->setTextCursor(cursor);
613 }
614
615 connect(m_roleEditor, SIGNAL(roleEditingCanceled(int,QByteArray,QVariant)),
616 this, SLOT(slotRoleEditingCanceled(int,QByteArray,QVariant)));
617 connect(m_roleEditor, SIGNAL(roleEditingFinished(int,QByteArray,QVariant)),
618 this, SLOT(slotRoleEditingFinished(int,QByteArray,QVariant)));
619
620 // Adjust the geometry of the editor
621 QRectF rect = roleEditingRect(current);
622 const int frameWidth = m_roleEditor->frameWidth();
623 rect.adjust(-frameWidth, -frameWidth, frameWidth, frameWidth);
624 rect.translate(pos());
625 if (rect.right() > parent->width()) {
626 rect.setWidth(parent->width() - rect.left());
627 }
628 m_roleEditor->setGeometry(rect.toRect());
629 m_roleEditor->show();
630 m_roleEditor->setFocus();
631 }
632
633 void KStandardItemListWidget::resizeEvent(QGraphicsSceneResizeEvent* event)
634 {
635 if (m_roleEditor) {
636 setEditedRole(QByteArray());
637 Q_ASSERT(!m_roleEditor);
638 }
639
640 KItemListWidget::resizeEvent(event);
641
642 m_dirtyLayout = true;
643 }
644
645 void KStandardItemListWidget::showEvent(QShowEvent* event)
646 {
647 KItemListWidget::showEvent(event);
648
649 // Listen to changes of the clipboard to mark the item as cut/uncut
650 KFileItemClipboard* clipboard = KFileItemClipboard::instance();
651
652 const KUrl itemUrl = data().value("url").value<KUrl>();
653 m_isCut = clipboard->isCut(itemUrl);
654
655 connect(clipboard, SIGNAL(cutItemsChanged()),
656 this, SLOT(slotCutItemsChanged()));
657 }
658
659 void KStandardItemListWidget::hideEvent(QHideEvent* event)
660 {
661 disconnect(KFileItemClipboard::instance(), SIGNAL(cutItemsChanged()),
662 this, SLOT(slotCutItemsChanged()));
663
664 KItemListWidget::hideEvent(event);
665 }
666
667 void KStandardItemListWidget::slotCutItemsChanged()
668 {
669 const KUrl itemUrl = data().value("url").value<KUrl>();
670 const bool isCut = KFileItemClipboard::instance()->isCut(itemUrl);
671 if (m_isCut != isCut) {
672 m_isCut = isCut;
673 m_pixmap = QPixmap();
674 m_dirtyContent = true;
675 update();
676 }
677 }
678
679 void KStandardItemListWidget::slotRoleEditingCanceled(int index,
680 const QByteArray& role,
681 const QVariant& value)
682 {
683 m_roleEditor->deleteLater();
684 m_roleEditor = 0;
685 emit roleEditingCanceled(index, role, value);
686 setEditedRole(QByteArray());
687 }
688
689 void KStandardItemListWidget::slotRoleEditingFinished(int index,
690 const QByteArray& role,
691 const QVariant& value)
692 {
693 m_roleEditor->deleteLater();
694 m_roleEditor = 0;
695 emit roleEditingFinished(index, role, value);
696 setEditedRole(QByteArray());
697 }
698
699 void KStandardItemListWidget::triggerCacheRefreshing()
700 {
701 if ((!m_dirtyContent && !m_dirtyLayout) || index() < 0) {
702 return;
703 }
704
705 refreshCache();
706
707 const QHash<QByteArray, QVariant> values = data();
708 m_isExpandable = m_supportsItemExpanding && values["isExpandable"].toBool();
709 m_isHidden = isHidden();
710
711 updateExpansionArea();
712 updateTextsCache();
713 updatePixmapCache();
714
715 m_dirtyLayout = false;
716 m_dirtyContent = false;
717 m_dirtyContentRoles.clear();
718 }
719
720 void KStandardItemListWidget::updateExpansionArea()
721 {
722 if (m_supportsItemExpanding) {
723 const QHash<QByteArray, QVariant> values = data();
724 Q_ASSERT(values.contains("expandedParentsCount"));
725 const int expandedParentsCount = values.value("expandedParentsCount", 0).toInt();
726 if (expandedParentsCount >= 0) {
727 const qreal widgetHeight = size().height();
728 const qreal inc = (widgetHeight - KIconLoader::SizeSmall) / 2;
729 const qreal x = expandedParentsCount * widgetHeight + inc;
730 const qreal y = inc;
731 m_expansionArea = QRectF(x, y, KIconLoader::SizeSmall, KIconLoader::SizeSmall);
732 return;
733 }
734 }
735
736 m_expansionArea = QRectF();
737 }
738
739 void KStandardItemListWidget::updatePixmapCache()
740 {
741 // Precondition: Requires already updated m_textPos values to calculate
742 // the remaining height when the alignment is vertical.
743
744 const QSizeF widgetSize = size();
745 const bool iconOnTop = (m_layout == IconsLayout);
746 const KItemListStyleOption& option = styleOption();
747 const qreal padding = option.padding;
748
749 const int maxIconWidth = iconOnTop ? widgetSize.width() - 2 * padding : option.iconSize;
750 const int maxIconHeight = option.iconSize;
751
752 const QHash<QByteArray, QVariant> values = data();
753
754 bool updatePixmap = (m_pixmap.width() != maxIconWidth || m_pixmap.height() != maxIconHeight);
755 if (!updatePixmap && m_dirtyContent) {
756 updatePixmap = m_dirtyContentRoles.isEmpty()
757 || m_dirtyContentRoles.contains("iconPixmap")
758 || m_dirtyContentRoles.contains("iconName")
759 || m_dirtyContentRoles.contains("iconOverlays");
760 }
761
762 if (updatePixmap) {
763 m_pixmap = values["iconPixmap"].value<QPixmap>();
764 if (m_pixmap.isNull()) {
765 // Use the icon that fits to the MIME-type
766 QString iconName = values["iconName"].toString();
767 if (iconName.isEmpty()) {
768 // The icon-name has not been not resolved by KFileItemModelRolesUpdater,
769 // use a generic icon as fallback
770 iconName = QLatin1String("unknown");
771 }
772 m_pixmap = pixmapForIcon(iconName, maxIconHeight);
773 } else if (m_pixmap.width() != maxIconWidth || m_pixmap.height() != maxIconHeight) {
774 // A custom pixmap has been applied. Assure that the pixmap
775 // is scaled to the maximum available size.
776 KPixmapModifier::scale(m_pixmap, QSize(maxIconWidth, maxIconHeight));
777 }
778
779 const QStringList overlays = values["iconOverlays"].toStringList();
780
781 // Strangely KFileItem::overlays() returns empty string-values, so
782 // we need to check first whether an overlay must be drawn at all.
783 // It is more efficient to do it here, as KIconLoader::drawOverlays()
784 // assumes that an overlay will be drawn and has some additional
785 // setup time.
786 foreach (const QString& overlay, overlays) {
787 if (!overlay.isEmpty()) {
788 // There is at least one overlay, draw all overlays above m_pixmap
789 // and cancel the check
790 KIconLoader::global()->drawOverlays(overlays, m_pixmap, KIconLoader::Desktop);
791 break;
792 }
793 }
794
795 if (m_isCut) {
796 KIconEffect* effect = KIconLoader::global()->iconEffect();
797 m_pixmap = effect->apply(m_pixmap, KIconLoader::Desktop, KIconLoader::DisabledState);
798 }
799
800 if (m_isHidden) {
801 KIconEffect::semiTransparent(m_pixmap);
802 }
803
804 if (isSelected()) {
805 const QColor color = palette().brush(QPalette::Normal, QPalette::Highlight).color();
806 QImage image = m_pixmap.toImage();
807 KIconEffect::colorize(image, color, 1.0f);
808 m_pixmap = QPixmap::fromImage(image);
809 }
810 }
811
812 if (!m_overlay.isNull()) {
813 QPainter painter(&m_pixmap);
814 painter.drawPixmap(0, m_pixmap.height() - m_overlay.height(), m_overlay);
815 }
816
817 int scaledIconSize = 0;
818 if (iconOnTop) {
819 const TextInfo* textInfo = m_textInfo.value("text");
820 scaledIconSize = static_cast<int>(textInfo->pos.y() - 2 * padding);
821 } else {
822 const int textRowsCount = (m_layout == CompactLayout) ? visibleRoles().count() : 1;
823 const qreal requiredTextHeight = textRowsCount * option.fontMetrics.height();
824 scaledIconSize = (requiredTextHeight < maxIconHeight) ?
825 widgetSize.height() - 2 * padding : maxIconHeight;
826 }
827
828 const int maxScaledIconWidth = iconOnTop ? widgetSize.width() - 2 * padding : scaledIconSize;
829 const int maxScaledIconHeight = scaledIconSize;
830
831 m_scaledPixmapSize = m_pixmap.size();
832 m_scaledPixmapSize.scale(maxScaledIconWidth, maxScaledIconHeight, Qt::KeepAspectRatio);
833
834 if (iconOnTop) {
835 // Center horizontally and align on bottom within the icon-area
836 m_pixmapPos.setX((widgetSize.width() - m_scaledPixmapSize.width()) / 2);
837 m_pixmapPos.setY(padding + scaledIconSize - m_scaledPixmapSize.height());
838 } else {
839 // Center horizontally and vertically within the icon-area
840 const TextInfo* textInfo = m_textInfo.value("text");
841 m_pixmapPos.setX(textInfo->pos.x() - 2 * padding
842 - (scaledIconSize + m_scaledPixmapSize.width()) / 2);
843 m_pixmapPos.setY(padding
844 + (scaledIconSize - m_scaledPixmapSize.height()) / 2);
845 }
846
847 m_iconRect = QRectF(m_pixmapPos, QSizeF(m_scaledPixmapSize));
848
849 // Prepare the pixmap that is used when the item gets hovered
850 if (isHovered()) {
851 m_hoverPixmap = m_pixmap;
852 KIconEffect* effect = KIconLoader::global()->iconEffect();
853 // In the KIconLoader terminology, active = hover.
854 if (effect->hasEffect(KIconLoader::Desktop, KIconLoader::ActiveState)) {
855 m_hoverPixmap = effect->apply(m_pixmap, KIconLoader::Desktop, KIconLoader::ActiveState);
856 } else {
857 m_hoverPixmap = m_pixmap;
858 }
859 } else if (hoverOpacity() <= 0.0) {
860 // No hover animation is ongoing. Clear m_hoverPixmap to save memory.
861 m_hoverPixmap = QPixmap();
862 }
863 }
864
865 void KStandardItemListWidget::updateTextsCache()
866 {
867 QTextOption textOption;
868 switch (m_layout) {
869 case IconsLayout:
870 textOption.setWrapMode(QTextOption::WrapAtWordBoundaryOrAnywhere);
871 textOption.setAlignment(Qt::AlignHCenter);
872 break;
873 case CompactLayout:
874 case DetailsLayout:
875 textOption.setAlignment(Qt::AlignLeft);
876 textOption.setWrapMode(QTextOption::NoWrap);
877 break;
878 default:
879 Q_ASSERT(false);
880 break;
881 }
882
883 qDeleteAll(m_textInfo);
884 m_textInfo.clear();
885 for (int i = 0; i < m_sortedVisibleRoles.count(); ++i) {
886 TextInfo* textInfo = new TextInfo();
887 textInfo->staticText.setTextFormat(Qt::PlainText);
888 textInfo->staticText.setPerformanceHint(QStaticText::AggressiveCaching);
889 textInfo->staticText.setTextOption(textOption);
890 m_textInfo.insert(m_sortedVisibleRoles[i], textInfo);
891 }
892
893 switch (m_layout) {
894 case IconsLayout: updateIconsLayoutTextCache(); break;
895 case CompactLayout: updateCompactLayoutTextCache(); break;
896 case DetailsLayout: updateDetailsLayoutTextCache(); break;
897 default: Q_ASSERT(false); break;
898 }
899
900 const TextInfo* ratingTextInfo = m_textInfo.value("rating");
901 if (ratingTextInfo) {
902 // The text of the rating-role has been set to empty to get
903 // replaced by a rating-image showing the rating as stars.
904 const KItemListStyleOption& option = styleOption();
905 QSizeF ratingSize = preferredRatingSize(option);
906
907 const qreal availableWidth = (m_layout == DetailsLayout)
908 ? columnWidth("rating") - columnPadding(option)
909 : m_textRect.width();
910 if (ratingSize.width() > availableWidth) {
911 ratingSize.rwidth() = availableWidth;
912 }
913 m_rating = QPixmap(ratingSize.toSize());
914 m_rating.fill(Qt::transparent);
915
916 QPainter painter(&m_rating);
917 const QRect rect(0, 0, m_rating.width(), m_rating.height());
918 const int rating = data().value("rating").toInt();
919 KRatingPainter::paintRating(&painter, rect, Qt::AlignJustify | Qt::AlignVCenter, rating);
920 } else if (!m_rating.isNull()) {
921 m_rating = QPixmap();
922 }
923 }
924
925 void KStandardItemListWidget::updateIconsLayoutTextCache()
926 {
927 // +------+
928 // | Icon |
929 // +------+
930 //
931 // Name role that
932 // might get wrapped above
933 // several lines.
934 // Additional role 1
935 // Additional role 2
936
937 const QHash<QByteArray, QVariant> values = data();
938
939 const KItemListStyleOption& option = styleOption();
940 const qreal padding = option.padding;
941 const qreal maxWidth = size().width() - 2 * padding;
942 const qreal widgetHeight = size().height();
943 const qreal lineSpacing = option.fontMetrics.lineSpacing();
944
945 // Initialize properties for the "text" role. It will be used as anchor
946 // for initializing the position of the other roles.
947 TextInfo* nameTextInfo = m_textInfo.value("text");
948 const QString nameText = KStringHandler::preProcessWrap(values["text"].toString());
949 nameTextInfo->staticText.setText(nameText);
950
951 // Calculate the number of lines required for the name and the required width
952 qreal nameWidth = 0;
953 qreal nameHeight = 0;
954 QTextLine line;
955
956 const int additionalRolesCount = qMax(visibleRoles().count() - 1, 0);
957 const int maxNameLines = (option.maxTextSize.height() / int(lineSpacing)) - additionalRolesCount;
958
959 QTextLayout layout(nameTextInfo->staticText.text(), option.font);
960 layout.setTextOption(nameTextInfo->staticText.textOption());
961 layout.beginLayout();
962 int nameLineIndex = 0;
963 while ((line = layout.createLine()).isValid()) {
964 line.setLineWidth(maxWidth);
965 nameWidth = qMax(nameWidth, line.naturalTextWidth());
966 nameHeight += line.height();
967
968 ++nameLineIndex;
969 if (nameLineIndex == maxNameLines) {
970 // The maximum number of textlines has been reached. If this is
971 // the case provide an elided text if necessary.
972 const int textLength = line.textStart() + line.textLength();
973 if (textLength < nameText.length()) {
974 // Elide the last line of the text
975 QString lastTextLine = nameText.mid(line.textStart(), line.textLength());
976 lastTextLine = option.fontMetrics.elidedText(lastTextLine,
977 Qt::ElideRight,
978 line.naturalTextWidth() - 1);
979 const QString elidedText = nameText.left(line.textStart()) + lastTextLine;
980 nameTextInfo->staticText.setText(elidedText);
981 }
982 break;
983 }
984 }
985 layout.endLayout();
986
987 // Use one line for each additional information
988 nameTextInfo->staticText.setTextWidth(maxWidth);
989 nameTextInfo->pos = QPointF(padding, widgetHeight -
990 nameHeight -
991 additionalRolesCount * lineSpacing -
992 padding);
993 m_textRect = QRectF(padding + (maxWidth - nameWidth) / 2,
994 nameTextInfo->pos.y(),
995 nameWidth,
996 nameHeight);
997
998 // Calculate the position for each additional information
999 qreal y = nameTextInfo->pos.y() + nameHeight;
1000 foreach (const QByteArray& role, m_sortedVisibleRoles) {
1001 if (role == "text") {
1002 continue;
1003 }
1004
1005 const QString text = roleText(role, values);
1006 TextInfo* textInfo = m_textInfo.value(role);
1007 textInfo->staticText.setText(text);
1008
1009 qreal requiredWidth = 0;
1010
1011 QTextLayout layout(text, option.font);
1012 QTextOption textOption;
1013 textOption.setWrapMode(QTextOption::NoWrap);
1014 layout.setTextOption(textOption);
1015
1016 layout.beginLayout();
1017 QTextLine textLine = layout.createLine();
1018 if (textLine.isValid()) {
1019 textLine.setLineWidth(maxWidth);
1020 requiredWidth = textLine.naturalTextWidth();
1021 if (requiredWidth > maxWidth) {
1022 const QString elidedText = option.fontMetrics.elidedText(text, Qt::ElideRight, maxWidth);
1023 textInfo->staticText.setText(elidedText);
1024 requiredWidth = option.fontMetrics.width(elidedText);
1025 }
1026 }
1027 layout.endLayout();
1028
1029 textInfo->pos = QPointF(padding, y);
1030 textInfo->staticText.setTextWidth(maxWidth);
1031
1032 const QRectF textRect(padding + (maxWidth - requiredWidth) / 2, y, requiredWidth, lineSpacing);
1033 m_textRect |= textRect;
1034
1035 y += lineSpacing;
1036 }
1037
1038 // Add a padding to the text rectangle
1039 m_textRect.adjust(-padding, -padding, padding, padding);
1040 }
1041
1042 void KStandardItemListWidget::updateCompactLayoutTextCache()
1043 {
1044 // +------+ Name role
1045 // | Icon | Additional role 1
1046 // +------+ Additional role 2
1047
1048 const QHash<QByteArray, QVariant> values = data();
1049
1050 const KItemListStyleOption& option = styleOption();
1051 const qreal widgetHeight = size().height();
1052 const qreal lineSpacing = option.fontMetrics.lineSpacing();
1053 const qreal textLinesHeight = qMax(visibleRoles().count(), 1) * lineSpacing;
1054 const int scaledIconSize = (textLinesHeight < option.iconSize) ? widgetHeight - 2 * option.padding : option.iconSize;
1055
1056 qreal maximumRequiredTextWidth = 0;
1057 const qreal x = option.padding * 3 + scaledIconSize;
1058 qreal y = qRound((widgetHeight - textLinesHeight) / 2);
1059 const qreal maxWidth = size().width() - x - option.padding;
1060 foreach (const QByteArray& role, m_sortedVisibleRoles) {
1061 const QString text = roleText(role, values);
1062 TextInfo* textInfo = m_textInfo.value(role);
1063 textInfo->staticText.setText(text);
1064
1065 qreal requiredWidth = option.fontMetrics.width(text);
1066 if (requiredWidth > maxWidth) {
1067 requiredWidth = maxWidth;
1068 const QString elidedText = option.fontMetrics.elidedText(text, Qt::ElideRight, maxWidth);
1069 textInfo->staticText.setText(elidedText);
1070 }
1071
1072 textInfo->pos = QPointF(x, y);
1073 textInfo->staticText.setTextWidth(maxWidth);
1074
1075 maximumRequiredTextWidth = qMax(maximumRequiredTextWidth, requiredWidth);
1076
1077 y += lineSpacing;
1078 }
1079
1080 m_textRect = QRectF(x - option.padding, 0, maximumRequiredTextWidth + 2 * option.padding, widgetHeight);
1081 }
1082
1083 void KStandardItemListWidget::updateDetailsLayoutTextCache()
1084 {
1085 // Precondition: Requires already updated m_expansionArea
1086 // to determine the left position.
1087
1088 // +------+
1089 // | Icon | Name role Additional role 1 Additional role 2
1090 // +------+
1091 m_textRect = QRectF();
1092
1093 const KItemListStyleOption& option = styleOption();
1094 const QHash<QByteArray, QVariant> values = data();
1095
1096 const qreal widgetHeight = size().height();
1097 const int scaledIconSize = widgetHeight - 2 * option.padding;
1098 const int fontHeight = option.fontMetrics.height();
1099
1100 const qreal columnWidthInc = columnPadding(option);
1101 qreal firstColumnInc = scaledIconSize;
1102 if (m_supportsItemExpanding) {
1103 firstColumnInc += (m_expansionArea.left() + m_expansionArea.right() + widgetHeight) / 2;
1104 } else {
1105 firstColumnInc += option.padding;
1106 }
1107
1108 qreal x = firstColumnInc;
1109 const qreal y = qMax(qreal(option.padding), (widgetHeight - fontHeight) / 2);
1110
1111 foreach (const QByteArray& role, m_sortedVisibleRoles) {
1112 QString text = roleText(role, values);
1113
1114 // Elide the text in case it does not fit into the available column-width
1115 qreal requiredWidth = option.fontMetrics.width(text);
1116 const qreal roleWidth = columnWidth(role);
1117 qreal availableTextWidth = roleWidth - columnWidthInc;
1118
1119 const bool isTextRole = (role == "text");
1120 if (isTextRole) {
1121 availableTextWidth -= firstColumnInc;
1122 }
1123
1124 if (requiredWidth > availableTextWidth) {
1125 text = option.fontMetrics.elidedText(text, Qt::ElideRight, availableTextWidth);
1126 requiredWidth = option.fontMetrics.width(text);
1127 }
1128
1129 TextInfo* textInfo = m_textInfo.value(role);
1130 textInfo->staticText.setText(text);
1131 textInfo->pos = QPointF(x + columnWidthInc / 2, y);
1132 x += roleWidth;
1133
1134 if (isTextRole) {
1135 const qreal textWidth = option.extendedSelectionRegion
1136 ? size().width() - textInfo->pos.x()
1137 : requiredWidth + 2 * option.padding;
1138 m_textRect = QRectF(textInfo->pos.x() - option.padding, 0,
1139 textWidth, size().height());
1140
1141 // The column after the name should always be aligned on the same x-position independent
1142 // from the expansion-level shown in the name column
1143 x -= firstColumnInc;
1144 } else if (isRoleRightAligned(role)) {
1145 textInfo->pos.rx() += roleWidth - requiredWidth - columnWidthInc;
1146 }
1147 }
1148 }
1149
1150 void KStandardItemListWidget::updateAdditionalInfoTextColor()
1151 {
1152 QColor c1;
1153 if (m_customTextColor.isValid()) {
1154 c1 = m_customTextColor;
1155 } else if (isSelected() && m_layout != DetailsLayout) {
1156 c1 = styleOption().palette.highlightedText().color();
1157 } else {
1158 c1 = styleOption().palette.text().color();
1159 }
1160
1161 // For the color of the additional info the inactive text color
1162 // is not used as this might lead to unreadable text for some color schemes. Instead
1163 // the text color c1 is slightly mixed with the background color.
1164 const QColor c2 = styleOption().palette.base().color();
1165 const int p1 = 70;
1166 const int p2 = 100 - p1;
1167 m_additionalInfoTextColor = QColor((c1.red() * p1 + c2.red() * p2) / 100,
1168 (c1.green() * p1 + c2.green() * p2) / 100,
1169 (c1.blue() * p1 + c2.blue() * p2) / 100);
1170 }
1171
1172 void KStandardItemListWidget::drawPixmap(QPainter* painter, const QPixmap& pixmap)
1173 {
1174 if (m_scaledPixmapSize != pixmap.size()) {
1175 QPixmap scaledPixmap = pixmap;
1176 KPixmapModifier::scale(scaledPixmap, m_scaledPixmapSize);
1177 painter->drawPixmap(m_pixmapPos, scaledPixmap);
1178
1179 #ifdef KSTANDARDITEMLISTWIDGET_DEBUG
1180 painter->setPen(Qt::blue);
1181 painter->drawRect(QRectF(m_pixmapPos, QSizeF(m_scaledPixmapSize)));
1182 #endif
1183 } else {
1184 painter->drawPixmap(m_pixmapPos, pixmap);
1185 }
1186 }
1187
1188 void KStandardItemListWidget::drawSiblingsInformation(QPainter* painter)
1189 {
1190 const int siblingSize = size().height();
1191 const int x = (m_expansionArea.left() + m_expansionArea.right() - siblingSize) / 2;
1192 QRect siblingRect(x, 0, siblingSize, siblingSize);
1193
1194 QStyleOption option;
1195 bool isItemSibling = true;
1196
1197 const QBitArray siblings = siblingsInformation();
1198 for (int i = siblings.count() - 1; i >= 0; --i) {
1199 option.rect = siblingRect;
1200 option.state = siblings.at(i) ? QStyle::State_Sibling : QStyle::State_None;
1201
1202 if (isItemSibling) {
1203 option.state |= QStyle::State_Item;
1204 if (m_isExpandable) {
1205 option.state |= QStyle::State_Children;
1206 }
1207 if (data()["isExpanded"].toBool()) {
1208 option.state |= QStyle::State_Open;
1209 }
1210 isItemSibling = false;
1211 }
1212
1213 style()->drawPrimitive(QStyle::PE_IndicatorBranch, &option, painter);
1214
1215 siblingRect.translate(-siblingRect.width(), 0);
1216 }
1217 }
1218
1219 QRectF KStandardItemListWidget::roleEditingRect(const QByteArray& role) const
1220 {
1221 const TextInfo* textInfo = m_textInfo.value(role);
1222 if (!textInfo) {
1223 return QRectF();
1224 }
1225
1226 QRectF rect(textInfo->pos, textInfo->staticText.size());
1227 if (m_layout == DetailsLayout) {
1228 rect.setWidth(columnWidth(role) - rect.x());
1229 }
1230
1231 return rect;
1232 }
1233
1234 QPixmap KStandardItemListWidget::pixmapForIcon(const QString& name, int size)
1235 {
1236 const KIcon icon(name);
1237
1238 int requestedSize;
1239 if (size <= KIconLoader::SizeSmall) {
1240 requestedSize = KIconLoader::SizeSmall;
1241 } else if (size <= KIconLoader::SizeSmallMedium) {
1242 requestedSize = KIconLoader::SizeSmallMedium;
1243 } else if (size <= KIconLoader::SizeMedium) {
1244 requestedSize = KIconLoader::SizeMedium;
1245 } else if (size <= KIconLoader::SizeLarge) {
1246 requestedSize = KIconLoader::SizeLarge;
1247 } else if (size <= KIconLoader::SizeHuge) {
1248 requestedSize = KIconLoader::SizeHuge;
1249 } else if (size <= KIconLoader::SizeEnormous) {
1250 requestedSize = KIconLoader::SizeEnormous;
1251 } else if (size <= KIconLoader::SizeEnormous * 2) {
1252 requestedSize = KIconLoader::SizeEnormous * 2;
1253 } else {
1254 requestedSize = size;
1255 }
1256
1257 QPixmap pixmap = icon.pixmap(requestedSize, requestedSize);
1258 if (requestedSize != size) {
1259 KPixmapModifier::scale(pixmap, QSize(size, size));
1260 }
1261
1262 return pixmap;
1263 }
1264
1265 QSizeF KStandardItemListWidget::preferredRatingSize(const KItemListStyleOption& option)
1266 {
1267 const qreal height = option.fontMetrics.ascent();
1268 return QSizeF(height * 5, height);
1269 }
1270
1271 qreal KStandardItemListWidget::columnPadding(const KItemListStyleOption& option)
1272 {
1273 return option.padding * 6;
1274 }
1275
1276 #include "kstandarditemlistwidget.moc"