1// Copyright (C) 2017 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 QQUICKTUMBLER_P_H
5#define QQUICKTUMBLER_P_H
6
7//
8// W A R N I N G
9// -------------
10//
11// This file is not part of the Qt API. It exists purely as an
12// implementation detail. This header file may change from version to
13// version without notice, or even be removed.
14//
15// We mean it.
16//
17
18#include <QtCore/qvariant.h>
19#include <QtQml/qqmlcomponent.h>
20#include <QtQuickTemplates2/private/qquickcontrol_p.h>
21
22QT_BEGIN_NAMESPACE
23
24class QQuickTumblerAttached;
25class QQuickTumblerPrivate;
26
27class Q_QUICKTEMPLATES2_EXPORT QQuickTumbler : public QQuickControl
28{
29 Q_OBJECT
30 Q_PROPERTY(QVariant model READ model WRITE setModel NOTIFY modelChanged FINAL)
31 Q_PROPERTY(int count READ count NOTIFY countChanged FINAL)
32 Q_PROPERTY(int currentIndex READ currentIndex WRITE setCurrentIndex NOTIFY currentIndexChanged FINAL)
33 Q_PROPERTY(QQuickItem *currentItem READ currentItem NOTIFY currentItemChanged FINAL)
34 Q_PROPERTY(QQmlComponent *delegate READ delegate WRITE setDelegate NOTIFY delegateChanged FINAL)
35 Q_PROPERTY(int visibleItemCount READ visibleItemCount WRITE setVisibleItemCount NOTIFY visibleItemCountChanged FINAL)
36 // 2.1 (Qt 5.8)
37 Q_PROPERTY(bool wrap READ wrap WRITE setWrap RESET resetWrap NOTIFY wrapChanged FINAL REVISION(2, 1))
38 // 2.2 (Qt 5.9)
39 Q_PROPERTY(bool moving READ isMoving NOTIFY movingChanged FINAL REVISION(2, 2))
40 Q_PROPERTY(qreal flickDeceleration READ flickDeceleration WRITE setFlickDeceleration RESET resetFlickDeceleration NOTIFY flickDecelerationChanged FINAL REVISION(6, 9))
41 QML_NAMED_ELEMENT(Tumbler)
42 QML_ATTACHED(QQuickTumblerAttached)
43 QML_ADDED_IN_VERSION(2, 0)
44
45public:
46 explicit QQuickTumbler(QQuickItem *parent = nullptr);
47 ~QQuickTumbler();
48
49 QVariant model() const;
50 void setModel(const QVariant &model);
51
52 int count() const;
53
54 int currentIndex() const;
55 void setCurrentIndex(int currentIndex);
56 QQuickItem *currentItem() const;
57
58 QQmlComponent *delegate() const;
59 void setDelegate(QQmlComponent *delegate);
60
61 int visibleItemCount() const;
62 void setVisibleItemCount(int visibleItemCount);
63
64 static QQuickTumblerAttached *qmlAttachedProperties(QObject *object);
65
66 // 2.1 (Qt 5.8)
67 bool wrap() const;
68 void setWrap(bool wrap);
69 void resetWrap();
70
71 // 2.2 (Qt 5.9)
72 bool isMoving() const;
73
74 enum PositionMode {
75 Beginning,
76 Center,
77 End,
78 Visible, // ListView-only
79 Contain,
80 SnapPosition
81 };
82 Q_ENUM(PositionMode)
83
84 // 2.5 (Qt 5.12)
85 Q_REVISION(2, 5) Q_INVOKABLE void positionViewAtIndex(int index, PositionMode mode);
86
87 qreal flickDeceleration() const;
88 void setFlickDeceleration(qreal newFlickDeceleration);
89 void resetFlickDeceleration();
90
91Q_SIGNALS:
92 void modelChanged();
93 void countChanged();
94 void currentIndexChanged();
95 void currentItemChanged();
96 void delegateChanged();
97 void visibleItemCountChanged();
98 // 2.1 (Qt 5.8)
99 Q_REVISION(2, 1) void wrapChanged();
100 // 2.2 (Qt 5.9)
101 Q_REVISION(2, 2) void movingChanged();
102 Q_REVISION(6, 9) void flickDecelerationChanged();
103
104protected:
105 void geometryChange(const QRectF &newGeometry, const QRectF &oldGeometry) override;
106 void componentComplete() override;
107 void contentItemChange(QQuickItem *newItem, QQuickItem *oldItem) override;
108 void keyPressEvent(QKeyEvent *event) override;
109 void updatePolish() override;
110
111 QFont defaultFont() const override;
112
113private:
114 Q_DISABLE_COPY(QQuickTumbler)
115 Q_DECLARE_PRIVATE(QQuickTumbler)
116
117 Q_PRIVATE_SLOT(d_func(), void _q_updateItemWidths())
118 Q_PRIVATE_SLOT(d_func(), void _q_updateItemHeights())
119 Q_PRIVATE_SLOT(d_func(), void _q_onViewCurrentIndexChanged())
120 Q_PRIVATE_SLOT(d_func(), void _q_onViewCountChanged())
121 Q_PRIVATE_SLOT(d_func(), void _q_onViewOffsetChanged())
122 Q_PRIVATE_SLOT(d_func(), void _q_onViewContentYChanged())
123};
124
125class QQuickTumblerAttachedPrivate;
126
127class Q_QUICKTEMPLATES2_EXPORT QQuickTumblerAttached : public QObject
128{
129 Q_OBJECT
130 Q_PROPERTY(QQuickTumbler *tumbler READ tumbler CONSTANT FINAL)
131 Q_PROPERTY(qreal displacement READ displacement NOTIFY displacementChanged FINAL)
132
133public:
134 explicit QQuickTumblerAttached(QObject *parent = nullptr);
135
136 QQuickTumbler *tumbler() const;
137 qreal displacement() const;
138
139Q_SIGNALS:
140 void displacementChanged();
141
142private:
143 Q_DISABLE_COPY(QQuickTumblerAttached)
144 Q_DECLARE_PRIVATE(QQuickTumblerAttached)
145};
146
147QT_END_NAMESPACE
148
149#endif // QQUICKTUMBLER_P_H
150

source code of qtdeclarative/src/quicktemplates/qquicktumbler_p.h