Merge branch 'Applications/16.04'

[dolphin.git] / src / kitemviews / kitemlistselectionmanager.h

diff --git a/src/kitemviews/kitemlistselectionmanager.h b/src/kitemviews/kitemlistselectionmanager.h
index 5c8e846142e8eaedf60b740d48a17be77c4d238f..16761428bb632608234a285a4667ac60f99ba6ec 100644 (file)
--- a/src/kitemviews/kitemlistselectionmanager.h
+++ b/src/kitemviews/kitemlistselectionmanager.h
@@ -23,47 +23,82 @@
 #ifndef KITEMLISTSELECTIONMANAGER_H
 #define KITEMLISTSELECTIONMANAGER_H
 
-#include <libdolphin_export.h>
+#include "dolphin_export.h"
+
+#include <kitemviews/kitemmodelbase.h>
+#include <kitemviews/kitemset.h>
 
 #include <QObject>
 
 class KItemModelBase;
 
-class LIBDOLPHINPRIVATE_EXPORT KItemListSelectionManager : public QObject
+/**
+ * @brief Allows to select and deselect items of a KItemListView.
+ */
+class DOLPHIN_EXPORT KItemListSelectionManager : public QObject
 {
     Q_OBJECT
 
+    enum RangesRemovingBehaviour {
+        DiscardRemovedIndex,
+        AdjustRemovedIndex
+    };
+
 public:
     enum SelectionMode {
         Select,
         Deselect,
         Toggle
     };
-    
+
     KItemListSelectionManager(QObject* parent = 0);
     virtual ~KItemListSelectionManager();
 
     void setCurrentItem(int current);
     int currentItem() const;
 
-    void setAnchorItem(int anchor);
-    int anchorItem() 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);
+    void clearSelection();
+
+    void beginAnchoredSelection(int anchor);
+    void endAnchoredSelection();
+    bool isAnchoredSelectionActive() const;
 
     KItemModelBase* model() const;
 
 signals:
     void currentChanged(int current, int previous);
-    void anchorChanged(int anchor, int previous);
+    void selectionChanged(const KItemSet& current, const KItemSet& previous);
 
-protected:
+private:
     void setModel(KItemModelBase* model);
+    void itemsInserted(const KItemRangeList& itemRanges);
+    void itemsRemoved(const KItemRangeList& itemRanges);
+    void itemsMoved(const KItemRange& itemRange, const QList<int>& 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;
+    KItemSet m_selectedItems;
+    bool m_isAnchoredSelectionActive;
+
     KItemModelBase* m_model;
 
-    friend class KItemListController;
+    friend class KItemListController; // Calls setModel()
+    friend class KItemListView;       // Calls itemsInserted(), itemsRemoved() and itemsMoved()
+    friend class KItemListSelectionManagerTest;
 };
 
 #endif