src/kitemviews/kstandarditemlistview.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 "kstandarditemlistview.h"
   8
   9 #include "kstandarditemlistwidget.h"
  10
  11 #include <KIconLoader>
  12
  13 KStandardItemListView::KStandardItemListView(QGraphicsWidget *parent)
  14     : KItemListView(parent)
  15     , m_itemLayout(DetailsLayout)
  16 {
  17     setAcceptDrops(true);
  18     setScrollOrientation(Qt::Vertical);
  19     setVisibleRoles({"text"});
  20     setAlternateBackgrounds(true);
  21 }
  22
  23 KStandardItemListView::~KStandardItemListView()
  24 {
  25 }
  26
  27 void KStandardItemListView::setItemLayout(ItemLayout layout)
  28 {
  29     if (m_itemLayout == layout) {
  30         return;
  31     }
  32
  33     beginTransaction();
  34
  35     const ItemLayout previous = m_itemLayout;
  36     m_itemLayout = layout;
  37
  38     // keep the leading padding option unchanged here
  39     setHighlightEntireRow(itemLayoutHighlightEntireRow(layout));
  40     setSupportsItemExpanding(itemLayoutSupportsItemExpanding(layout));
  41     setScrollOrientation(layout == CompactLayout ? Qt::Horizontal : Qt::Vertical);
  42
  43     onItemLayoutChanged(layout, previous);
  44
  45     endTransaction();
  46 }
  47
  48 KStandardItemListView::ItemLayout KStandardItemListView::itemLayout() const
  49 {
  50     return m_itemLayout;
  51 }
  52
  53 KItemListWidgetCreatorBase *KStandardItemListView::defaultWidgetCreator() const
  54 {
  55     return new KItemListWidgetCreator<KStandardItemListWidget>();
  56 }
  57
  58 KItemListGroupHeaderCreatorBase *KStandardItemListView::defaultGroupHeaderCreator() const
  59 {
  60     return new KItemListGroupHeaderCreator<KStandardItemListGroupHeader>();
  61 }
  62
  63 void KStandardItemListView::initializeItemListWidget(KItemListWidget *item)
  64 {
  65     KStandardItemListWidget *standardItemListWidget = qobject_cast<KStandardItemListWidget *>(item);
  66     Q_ASSERT(standardItemListWidget);
  67
  68     switch (itemLayout()) {
  69     case IconsLayout:
  70         standardItemListWidget->setLayout(KStandardItemListWidget::IconsLayout);
  71         break;
  72     case CompactLayout:
  73         standardItemListWidget->setLayout(KStandardItemListWidget::CompactLayout);
  74         break;
  75     case DetailsLayout:
  76         standardItemListWidget->setLayout(KStandardItemListWidget::DetailsLayout);
  77         break;
  78     default:
  79         Q_ASSERT(false);
  80         break;
  81     }
  82
  83     standardItemListWidget->setHighlightEntireRow(highlightEntireRow());
  84     standardItemListWidget->setSupportsItemExpanding(supportsItemExpanding());
  85 }
  86
  87 bool KStandardItemListView::itemSizeHintUpdateRequired(const QSet<QByteArray> &changedRoles) const
  88 {
  89     // The only thing that can modify the item's size hint is the amount of space
  90     // needed to display the text for the visible roles.
  91     // Even if the icons have a different size they are always aligned within
  92     // the area defined by KItemStyleOption.iconSize and hence result in no
  93     // change of the item-size.
  94     const auto roles = visibleRoles();
  95     for (const QByteArray &role : roles) {
  96         if (changedRoles.contains(role)) {
  97             return true;
  98         }
  99     }
 100     return false;
 101 }
 102
 103 bool KStandardItemListView::itemLayoutHighlightEntireRow(ItemLayout layout) const
 104 {
 105     return layout == DetailsLayout;
 106 }
 107
 108 bool KStandardItemListView::itemLayoutSupportsItemExpanding(ItemLayout layout) const
 109 {
 110     return layout == DetailsLayout;
 111 }
 112
 113 void KStandardItemListView::onItemLayoutChanged(ItemLayout current, ItemLayout previous)
 114 {
 115     Q_UNUSED(current)
 116     Q_UNUSED(previous)
 117     updateLayoutOfVisibleItems();
 118 }
 119
 120 void KStandardItemListView::onScrollOrientationChanged(Qt::Orientation current, Qt::Orientation previous)
 121 {
 122     Q_UNUSED(current)
 123     Q_UNUSED(previous)
 124     updateLayoutOfVisibleItems();
 125 }
 126
 127 void KStandardItemListView::onSupportsItemExpandingChanged(bool supportsExpanding)
 128 {
 129     Q_UNUSED(supportsExpanding)
 130     updateLayoutOfVisibleItems();
 131 }
 132
 133 void KStandardItemListView::polishEvent()
 134 {
 135     switch (m_itemLayout) {
 136     case IconsLayout:
 137         applyDefaultStyleOption(style()->pixelMetric(QStyle::PM_LargeIconSize), 2, 4, 8);
 138         break;
 139     case CompactLayout:
 140         applyDefaultStyleOption(style()->pixelMetric(QStyle::PM_SmallIconSize), 2, 8, 0);
 141         break;
 142     case DetailsLayout:
 143         applyDefaultStyleOption(style()->pixelMetric(QStyle::PM_SmallIconSize), 2, 0, 0);
 144         break;
 145     default:
 146         Q_ASSERT(false);
 147         break;
 148     }
 149
 150     QGraphicsWidget::polishEvent();
 151 }
 152
 153 void KStandardItemListView::applyDefaultStyleOption(int iconSize, int padding, int horizontalMargin, int verticalMargin)
 154 {
 155     KItemListStyleOption option = styleOption();
 156
 157     if (option.iconSize < 0) {
 158         option.iconSize = iconSize;
 159     }
 160     if (option.padding < 0) {
 161         option.padding = padding;
 162     }
 163     if (option.horizontalMargin < 0) {
 164         option.horizontalMargin = horizontalMargin;
 165     }
 166     if (option.verticalMargin < 0) {
 167         option.verticalMargin = verticalMargin;
 168     }
 169
 170     setStyleOption(option);
 171 }
 172
 173 void KStandardItemListView::updateLayoutOfVisibleItems()
 174 {
 175     if (model()) {
 176         const auto widgets = visibleItemListWidgets();
 177         for (KItemListWidget *widget : widgets) {
 178             initializeItemListWidget(widget);
 179         }
 180     }
 181 }
 182
 183 #include "moc_kstandarditemlistview.cpp"