X-Git-Url: https://cloud.milkyroute.net/gitweb/dolphin.git/blobdiff_plain/258a29f61fb379b6a259070213cd68ffa56d6d2d..a1c5c5cf81b5d1f6b7a0aa10b8a981cb70c5b26c:/src/kitemviews/kitemlistselectionmanager.h diff --git a/src/kitemviews/kitemlistselectionmanager.h b/src/kitemviews/kitemlistselectionmanager.h index 9de4c66b2..ba9dd538a 100644 --- a/src/kitemviews/kitemlistselectionmanager.h +++ b/src/kitemviews/kitemlistselectionmanager.h @@ -1,97 +1,87 @@ -/*************************************************************************** - * Copyright (C) 2011 by Peter Penz * - * * - * Based on the Itemviews NG project from Trolltech Labs: * - * http://qt.gitorious.org/qt-labs/itemviews-ng * - * * - * 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 + * + * Based on the Itemviews NG project from Trolltech Labs + * + * SPDX-License-Identifier: GPL-2.0-or-later + */ #ifndef KITEMLISTSELECTIONMANAGER_H #define KITEMLISTSELECTIONMANAGER_H -#include - -#include +#include "dolphin_export.h" +#include "kitemviews/kitemmodelbase.h" +#include "kitemviews/kitemset.h" #include -#include class KItemModelBase; /** * @brief Allows to select and deselect items of a KItemListView. */ -class LIBDOLPHINPRIVATE_EXPORT KItemListSelectionManager : public QObject +class DOLPHIN_EXPORT KItemListSelectionManager : public QObject { Q_OBJECT + enum RangesRemovingBehaviour { DiscardRemovedIndex, AdjustRemovedIndex }; + public: - enum SelectionMode { - Select, - Deselect, - Toggle - }; + enum SelectionMode { Select, Deselect, Toggle }; - KItemListSelectionManager(QObject* parent = 0); - virtual ~KItemListSelectionManager(); + explicit KItemListSelectionManager(QObject *parent = nullptr); + ~KItemListSelectionManager() override; void setCurrentItem(int current); int currentItem() const; - void setSelectedItems(const QSet& items); - QSet selectedItems() const; + void setSelectedItems(const KItemSet &items); + KItemSet selectedItems() const; + bool isSelected(int index) const; bool hasSelection() const; void setSelected(int index, int count = 1, SelectionMode mode = Select); + /** + * Equivalent to: + * clearSelection(); + * setSelected(index, count); + * but emitting once only selectionChanged signal + */ + void replaceSelection(int index, int count = 1); void clearSelection(); - void beginAnchoredSelection(int anchor, SelectionMode mode = Select); + void beginAnchoredSelection(int anchor); void endAnchoredSelection(); - void setAnchorItem(int anchor); - int anchorItem() const; - bool isAnchoredSelectionActive() const; - void setAnchoredSelectionActive(bool active); - SelectionMode anchoredSelectionMode() const; - void setAnchoredSelectionMode(SelectionMode mode); - KItemModelBase* model() const; + KItemModelBase *model() const; -signals: +Q_SIGNALS: void currentChanged(int current, int previous); - void selectionChanged(const QSet& current, const QSet& previous); - void anchorChanged(int anchor, int previous); + void selectionChanged(const KItemSet ¤t, const KItemSet &previous); private: - void setModel(KItemModelBase* model); - void itemsInserted(const KItemRangeList& itemRanges); - void itemsRemoved(const KItemRangeList& itemRanges); + void setModel(KItemModelBase *model); + void itemsInserted(const KItemRangeList &itemRanges); + void itemsRemoved(const KItemRangeList &itemRanges); + void itemsMoved(const KItemRange &itemRange, const QList &movedToIndexes); + + /** + * Helper method for itemsRemoved. Returns the changed index after removing + * the given range. If the index is part of the range, -1 will be returned. + */ + int indexAfterRangesRemoving(int index, const KItemRangeList &itemRanges, const RangesRemovingBehaviour behaviour) const; private: int m_currentItem; int m_anchorItem; - QSet m_selectedItems; + KItemSet m_selectedItems; bool m_isAnchoredSelectionActive; - SelectionMode m_anchoredSelectionMode; - KItemModelBase* m_model; + KItemModelBase *m_model; friend class KItemListController; // Calls setModel() - friend class KItemListView; // Calls itemsInserted() and itemsRemoved() + friend class KItemListView; // Calls itemsInserted(), itemsRemoved() and itemsMoved() friend class KItemListSelectionManagerTest; };