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