1// Copyright (C) 2016 The Qt Company Ltd.
2// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only
3
4#ifndef QLISTWIDGET_P_H
5#define QLISTWIDGET_P_H
6
7//
8// W A R N I N G
9// -------------
10//
11// This file is not part of the Qt API. This header file may change
12// from version to version without notice, or even be removed.
13//
14// We mean it.
15//
16
17#include <QtWidgets/private/qtwidgetsglobal_p.h>
18#include <QtCore/qabstractitemmodel.h>
19#include <QtWidgets/qabstractitemview.h>
20#include <QtWidgets/qlistwidget.h>
21#include <private/qlistview_p.h>
22#include <private/qwidgetitemdata_p.h>
23
24#include <array>
25
26QT_REQUIRE_CONFIG(listwidget);
27
28QT_BEGIN_NAMESPACE
29
30class QListModelLessThan
31{
32public:
33 inline bool operator()(QListWidgetItem *i1, QListWidgetItem *i2) const
34 { return *i1 < *i2; }
35};
36
37class QListModelGreaterThan
38{
39public:
40 inline bool operator()(QListWidgetItem *i1, QListWidgetItem *i2) const
41 { return *i2 < *i1; }
42};
43
44class Q_AUTOTEST_EXPORT QListModel : public QAbstractListModel
45{
46 Q_OBJECT
47 friend class QListWidget;
48
49public:
50 QListModel(QListWidget *parent);
51 ~QListModel();
52
53 inline QListWidget *view() const { return qobject_cast<QListWidget *>(object: QObject::parent()); }
54
55 void clear();
56 QListWidgetItem *at(int row) const;
57 void insert(int row, QListWidgetItem *item);
58 void insert(int row, const QStringList &items);
59 void remove(QListWidgetItem *item);
60 QListWidgetItem *take(int row);
61 void move(int srcRow, int dstRow);
62
63 int rowCount(const QModelIndex &parent = QModelIndex()) const override;
64
65 QModelIndex index(const QListWidgetItem *item) const;
66 QModelIndex index(int row, int column = 0, const QModelIndex &parent = QModelIndex()) const override;
67
68 QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const override;
69 bool setData(const QModelIndex &index, const QVariant &value, int role) override;
70 bool clearItemData(const QModelIndex &index) override;
71
72 QMap<int, QVariant> itemData(const QModelIndex &index) const override;
73
74 bool insertRows(int row, int count = 1, const QModelIndex &parent = QModelIndex()) override;
75 bool removeRows(int row, int count = 1, const QModelIndex &parent = QModelIndex()) override;
76 bool moveRows(const QModelIndex &sourceParent, int sourceRow, int count, const QModelIndex &destinationParent, int destinationChild) override;
77
78 Qt::ItemFlags flags(const QModelIndex &index) const override;
79
80 void sort(int column, Qt::SortOrder order) override;
81 void ensureSorted(int column, Qt::SortOrder order, int start, int end);
82 static bool itemLessThan(const std::pair<QListWidgetItem*,int> &left,
83 const std::pair<QListWidgetItem*,int> &right);
84 static bool itemGreaterThan(const std::pair<QListWidgetItem*,int> &left,
85 const std::pair<QListWidgetItem*,int> &right);
86 static QList<QListWidgetItem*>::iterator sortedInsertionIterator(
87 const QList<QListWidgetItem*>::iterator &begin,
88 const QList<QListWidgetItem*>::iterator &end,
89 Qt::SortOrder order, QListWidgetItem *item);
90
91 void itemChanged(QListWidgetItem *item, const QList<int> &roles = QList<int>());
92
93 // dnd
94 QStringList mimeTypes() const override;
95 QMimeData *mimeData(const QModelIndexList &indexes) const override;
96#if QT_CONFIG(draganddrop)
97 bool dropMimeData(const QMimeData *data, Qt::DropAction action,
98 int row, int column, const QModelIndex &parent) override;
99 Qt::DropActions supportedDropActions() const override;
100 Qt::DropActions supportedDragActions() const override;
101#endif
102 QMimeData *internalMimeData() const;
103private:
104 QList<QListWidgetItem*> items;
105
106 // A cache must be mutable if get-functions should have const modifiers
107 mutable QModelIndexList cachedIndexes;
108};
109
110
111
112class QListWidgetPrivate : public QListViewPrivate
113{
114 Q_DECLARE_PUBLIC(QListWidget)
115public:
116 QListWidgetPrivate() : QListViewPrivate(), sortOrder(Qt::AscendingOrder), sortingEnabled(false) {}
117 inline QListModel *listModel() const { return qobject_cast<QListModel*>(object: model); }
118 void setup();
119 void clearConnections();
120 void emitItemPressed(const QModelIndex &index);
121 void emitItemClicked(const QModelIndex &index);
122 void emitItemDoubleClicked(const QModelIndex &index);
123 void emitItemActivated(const QModelIndex &index);
124 void emitItemEntered(const QModelIndex &index);
125 void emitItemChanged(const QModelIndex &index);
126 void emitCurrentItemChanged(const QModelIndex &current, const QModelIndex &previous);
127 void sort();
128 void dataChanged(const QModelIndex &topLeft, const QModelIndex &bottomRight);
129
130 Qt::SortOrder sortOrder;
131 bool sortingEnabled;
132 std::optional<Qt::DropActions> supportedDragActions;
133 std::array<QMetaObject::Connection, 8> connections;
134 std::array<QMetaObject::Connection, 2> selectionModelConnections;
135};
136
137class QListWidgetItemPrivate
138{
139public:
140 QListWidgetItemPrivate(QListWidgetItem *item) : q(item), theid(-1) {}
141 QListWidgetItem *q;
142 QList<QWidgetItemData> values;
143 int theid;
144};
145
146QT_END_NAMESPACE
147
148#endif // QLISTWIDGET_P_H
149

source code of qtbase/src/widgets/itemviews/qlistwidget_p.h