-/***************************************************************************
- * Copyright (C) 2011 by Peter Penz <peter.penz19@gmail.com> *
- * *
- * This program is free software; you can redistribute it and/or modify *
- * it under the terms of the GNU General Public License as published by *
- * the Free Software Foundation; either version 2 of the License, or *
- * (at your option) any later version. *
- * *
- * This program is distributed in the hope that it will be useful, *
- * but WITHOUT ANY WARRANTY; without even the implied warranty of *
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
- * GNU General Public License for more details. *
- * *
- * You should have received a copy of the GNU General Public License *
- * along with this program; if not, write to the *
- * Free Software Foundation, Inc., *
- * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA *
- ***************************************************************************/
+/*
+ * SPDX-FileCopyrightText: 2011 Peter Penz <peter.penz19@gmail.com>
+ *
+ * SPDX-License-Identifier: GPL-2.0-or-later
+ */
#ifndef KFILEITEMLISTVIEW_H
#define KFILEITEMLISTVIEW_H
-#include <libdolphin_export.h>
+#include "dolphin_export.h"
+#include "kitemviews/kstandarditemlistview.h"
-#include <kitemviews/kitemlistview.h>
+#include <KFileItem>
class KFileItemModelRolesUpdater;
class QTimer;
* KItemListView::setWidgetCreator() and KItemListView::setGroupHeaderCreator()
* to apply customized generators.
*/
-class LIBDOLPHINPRIVATE_EXPORT KFileItemListView : public KItemListView
+class DOLPHIN_EXPORT KFileItemListView : public KStandardItemListView
{
Q_OBJECT
public:
- enum Layout
- {
- IconsLayout,
- CompactLayout,
- DetailsLayout
- };
-
- KFileItemListView(QGraphicsWidget* parent = 0);
- virtual ~KFileItemListView();
+ explicit KFileItemListView(QGraphicsWidget *parent = nullptr);
+ ~KFileItemListView() override;
void setPreviewsShown(bool show);
bool previewsShown() const;
- void setItemLayout(Layout layout);
- Layout itemLayout() const;
+ /**
+ * If enabled a small preview gets upscaled to the icon size in case where
+ * the icon size is larger than the preview. Per default enlarging is
+ * enabled.
+ */
+ void setEnlargeSmallPreviews(bool enlarge);
+ bool enlargeSmallPreviews() const;
/**
* Sets the list of enabled thumbnail plugins that are used for previews.
* Per default all plugins enabled in the KConfigGroup "PreviewSettings"
* are used.
*
- * For a list of available plugins, call KServiceTypeTrader::self()->query("ThumbCreator").
+ * For a list of available plugins, call KIO::PreviewJob::availableThumbnailerPlugins().
*
* @see enabledPlugins
*/
- void setEnabledPlugins(const QStringList& list);
+ void setEnabledPlugins(const QStringList &list);
/**
* Returns the list of enabled thumbnail plugins.
*/
QStringList enabledPlugins() const;
- /** @reimp */
- virtual QSizeF itemSizeHint(int index) const;
-
- /** @reimp */
- virtual QHash<QByteArray, QSizeF> visibleRolesSizes(const KItemRangeList& itemRanges) const;
+ /**
+ * Sets the maximum file size of local files for which
+ * previews will be generated (if enabled). A value of 0
+ * indicates no file size limit.
+ * Per default the value from KConfigGroup "PreviewSettings"
+ * MaximumSize is used, 0 otherwise.
+ * @param size
+ */
+ void setLocalFileSizePreviewLimit(qlonglong size);
+ qlonglong localFileSizePreviewLimit() const;
- /** @reimp */
- virtual bool supportsItemExpanding() const;
+ QPixmap createDragPixmap(const KItemSet &indexes) const override;
- /** @reimp */
- virtual QPixmap createDragPixmap(const QSet<int>& indexes) const;
+ /**
+ * Notifies the view of a change in the hover state on an item.
+ *
+ * @param itemUrl URL of the item that is hovered, or an empty URL if no item is hovered.
+ * @param seqIdx The current hover sequence index. While an item is hovered,
+ * this method will be called repeatedly with increasing values
+ * for this parameter.
+ */
+ void setHoverSequenceState(const QUrl &itemUrl, int seqIdx);
protected:
- virtual void initializeItemListWidget(KItemListWidget* item);
- virtual bool itemSizeHintUpdateRequired(const QSet<QByteArray>& changedRoles) const;
- virtual void onModelChanged(KItemModelBase* current, KItemModelBase* previous);
- virtual void onScrollOrientationChanged(Qt::Orientation current, Qt::Orientation previous);
- virtual void onItemSizeChanged(const QSizeF& current, const QSizeF& previous);
- virtual void onScrollOffsetChanged(qreal current, qreal previous);
- virtual void onVisibleRolesChanged(const QList<QByteArray>& current, const QList<QByteArray>& previous);
- virtual void onStyleOptionChanged(const KItemListStyleOption& current, const KItemListStyleOption& previous);
- virtual void onTransactionBegin();
- virtual void onTransactionEnd();
- virtual void resizeEvent(QGraphicsSceneResizeEvent* event);
-
-protected slots:
- virtual void slotItemsRemoved(const KItemRangeList& itemRanges);
- virtual void slotSortRoleChanged(const QByteArray& current, const QByteArray& previous);
-
-private slots:
+ KItemListWidgetCreatorBase *defaultWidgetCreator() const override;
+ void initializeItemListWidget(KItemListWidget *item) override;
+ virtual void onPreviewsShownChanged(bool shown);
+ void onItemLayoutChanged(ItemLayout current, ItemLayout previous) override;
+ void onModelChanged(KItemModelBase *current, KItemModelBase *previous) override;
+ void onScrollOrientationChanged(Qt::Orientation current, Qt::Orientation previous) override;
+ void onItemSizeChanged(const QSizeF ¤t, const QSizeF &previous) override;
+ void onScrollOffsetChanged(qreal current, qreal previous) override;
+ void onVisibleRolesChanged(const QList<QByteArray> ¤t, const QList<QByteArray> &previous) override;
+ void onStyleOptionChanged(const KItemListStyleOption ¤t, const KItemListStyleOption &previous) override;
+ void onSupportsItemExpandingChanged(bool supportsExpanding) override;
+ void onTransactionBegin() override;
+ void onTransactionEnd() override;
+ void resizeEvent(QGraphicsSceneResizeEvent *event) override;
+ void focusInEvent(QFocusEvent *event) override;
+ void focusOutEvent(QFocusEvent *event) override;
+
+protected Q_SLOTS:
+ void slotItemsRemoved(const KItemRangeList &itemRanges) override;
+ void slotSortRoleChanged(const QByteArray ¤t, const QByteArray &previous) override;
+
+private Q_SLOTS:
void triggerVisibleIndexRangeUpdate();
void updateVisibleIndexRange();
void updateIconSize();
private:
- QSizeF visibleRoleSizeHint(int index, const QByteArray& role) const;
- void updateLayoutOfVisibleItems();
- void updateTimersInterval();
- void updateMinimumRolesWidths();
-
/**
* Applies the roles defined by KItemListView::visibleRoles() to the
* KFileItemModel and KFileItemModelRolesUpdater. As the model does not
QSize availableIconSize() const;
private:
- Layout m_itemLayout;
+ void updateSelectedWidgets();
- KFileItemModelRolesUpdater* m_modelRolesUpdater;
- QTimer* m_updateVisibleIndexRangeTimer;
- QTimer* m_updateIconSizeTimer;
-
- // Cache for calculating visibleRoleSizes() in a fast way
- QHash<QByteArray, int> m_minimumRolesWidths;
+ KFileItemModelRolesUpdater *m_modelRolesUpdater;
+ QTimer *m_updateVisibleIndexRangeTimer;
+ QTimer *m_updateIconSizeTimer;
friend class KFileItemListViewTest; // For unit testing
+ friend class DolphinMainWindowTest; // For unit testing
};
#endif
-
-