Skip to content
GitLab
Select Git revision
  • dev default
  • 6.2
  • 6.2.2
  • 6.2.1
  • 6.1
  • 6.2.0
  • 5.12
  • 5.12.12
  • 6.1.3
  • wip/qtquickcontrols2
  • 6.0
  • 6.1.2
  • 6.1.1
  • 6.1.0
  • 5.12.11
  • wip/qquickdeliveryagent
  • 5.15
  • 6.0.0
  • 5.15.2
  • 5.12.10
  • v5.15.0-alpha1
  • v5.12.7
  • v5.14.1
  • v5.9.9
  • v5.14.0
  • v5.14.0-rc2
  • v5.14.0-rc1
  • v5.12.6
  • v5.14.0-beta3
  • v5.13.2
  • v5.14.0-beta2
  • v5.14.0-beta1
  • v5.14.0-alpha1
  • v5.12.5
  • v5.13.1
  • v5.13.0
  • v5.13.0-rc3
  • v5.12.4
  • v5.13.0-rc2
  • v5.13.0-rc1
Find file BlameHistoryPermalink
qquickitemview_p.h 13.15 KiB
1 
/****************************************************************************
2 
**
3 
** Copyright (C) 2013 Digia Plc and/or its subsidiary(-ies).
4 
** Contact: http://www.qt-project.org/legal
5 
**
6 
** This file is part of the QtQml module of the Qt Toolkit.
7 
**
8 
** $QT_BEGIN_LICENSE:LGPL$
9 
** Commercial License Usage
10 
** Licensees holding valid commercial Qt licenses may use this file in
11 
** accordance with the commercial license agreement provided with the
12 
** Software or, alternatively, in accordance with the terms contained in
13 
** a written agreement between you and Digia.  For licensing terms and
14 
** conditions see http://qt.digia.com/licensing.  For further information
15 
** use the contact form at http://qt.digia.com/contact-us.
16 
**
17 
** GNU Lesser General Public License Usage
18 
** Alternatively, this file may be used under the terms of the GNU Lesser
19 
** General Public License version 2.1 as published by the Free Software
20 
** Foundation and appearing in the file LICENSE.LGPL included in the
21 
** packaging of this file.  Please review the following information to
22 
** ensure the GNU Lesser General Public License version 2.1 requirements
23 
** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
24 
**
25 
** In addition, as a special exception, Digia gives you certain additional
26 
** rights.  These rights are described in the Digia Qt LGPL Exception
27 
** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
28 
**
29 
** GNU General Public License Usage
30 
** Alternatively, this file may be used under the terms of the GNU
31 
** General Public License version 3.0 as published by the Free Software
32 
** Foundation and appearing in the file LICENSE.GPL included in the
33 
** packaging of this file.  Please review the following information to
34 
** ensure the GNU General Public License version 3.0 requirements will be
35 
** met: http://www.gnu.org/copyleft/gpl.html.
36 
**
37 
**
38 
** $QT_END_LICENSE$
39 
**
40 
****************************************************************************/
41
42 
#ifndef QQUICKITEMVIEW_P_H
43 
#define QQUICKITEMVIEW_P_H
44
45 
#include "qquickflickable_p.h"
46
47 
QT_BEGIN_NAMESPACE
48
49 
class QQmlChangeSet;
50
51 
class QQuickItemViewPrivate;
52
53 
class Q_AUTOTEST_EXPORT QQuickItemView : public QQuickFlickable
54 
{
55 
    Q_OBJECT
56
57 
    Q_PROPERTY(QVariant model READ model WRITE setModel NOTIFY modelChanged)
58 
    Q_PROPERTY(QQmlComponent *delegate READ delegate WRITE setDelegate NOTIFY delegateChanged)
59 
    Q_PROPERTY(int count READ count NOTIFY countChanged)
60
61 
    Q_PROPERTY(int currentIndex READ currentIndex WRITE setCurrentIndex NOTIFY currentIndexChanged)
62 
    Q_PROPERTY(QQuickItem *currentItem READ currentItem NOTIFY currentItemChanged)
63
64 
    Q_PROPERTY(bool keyNavigationWraps READ isWrapEnabled WRITE setWrapEnabled NOTIFY keyNavigationWrapsChanged)
65 
    Q_PROPERTY(int cacheBuffer READ cacheBuffer WRITE setCacheBuffer NOTIFY cacheBufferChanged)
66
67 
    Q_PROPERTY(Qt::LayoutDirection layoutDirection READ layoutDirection WRITE setLayoutDirection NOTIFY layoutDirectionChanged)
68 
    Q_PROPERTY(Qt::LayoutDirection effectiveLayoutDirection READ effectiveLayoutDirection NOTIFY effectiveLayoutDirectionChanged)
69 
    Q_PROPERTY(VerticalLayoutDirection verticalLayoutDirection READ verticalLayoutDirection WRITE setVerticalLayoutDirection NOTIFY verticalLayoutDirectionChanged)
70
7172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140
Q_PROPERTY(QQmlComponent *header READ header WRITE setHeader NOTIFY headerChanged) Q_PROPERTY(QQuickItem *headerItem READ headerItem NOTIFY headerItemChanged) Q_PROPERTY(QQmlComponent *footer READ footer WRITE setFooter NOTIFY footerChanged) Q_PROPERTY(QQuickItem *footerItem READ footerItem NOTIFY footerItemChanged) Q_PROPERTY(QQuickTransition *populate READ populateTransition WRITE setPopulateTransition NOTIFY populateTransitionChanged) Q_PROPERTY(QQuickTransition *add READ addTransition WRITE setAddTransition NOTIFY addTransitionChanged) Q_PROPERTY(QQuickTransition *addDisplaced READ addDisplacedTransition WRITE setAddDisplacedTransition NOTIFY addDisplacedTransitionChanged) Q_PROPERTY(QQuickTransition *move READ moveTransition WRITE setMoveTransition NOTIFY moveTransitionChanged) Q_PROPERTY(QQuickTransition *moveDisplaced READ moveDisplacedTransition WRITE setMoveDisplacedTransition NOTIFY moveDisplacedTransitionChanged) Q_PROPERTY(QQuickTransition *remove READ removeTransition WRITE setRemoveTransition NOTIFY removeTransitionChanged) Q_PROPERTY(QQuickTransition *removeDisplaced READ removeDisplacedTransition WRITE setRemoveDisplacedTransition NOTIFY removeDisplacedTransitionChanged) Q_PROPERTY(QQuickTransition *displaced READ displacedTransition WRITE setDisplacedTransition NOTIFY displacedTransitionChanged) Q_PROPERTY(QQmlComponent *highlight READ highlight WRITE setHighlight NOTIFY highlightChanged) Q_PROPERTY(QQuickItem *highlightItem READ highlightItem NOTIFY highlightItemChanged) Q_PROPERTY(bool highlightFollowsCurrentItem READ highlightFollowsCurrentItem WRITE setHighlightFollowsCurrentItem NOTIFY highlightFollowsCurrentItemChanged) Q_PROPERTY(HighlightRangeMode highlightRangeMode READ highlightRangeMode WRITE setHighlightRangeMode NOTIFY highlightRangeModeChanged) Q_PROPERTY(qreal preferredHighlightBegin READ preferredHighlightBegin WRITE setPreferredHighlightBegin NOTIFY preferredHighlightBeginChanged RESET resetPreferredHighlightBegin) Q_PROPERTY(qreal preferredHighlightEnd READ preferredHighlightEnd WRITE setPreferredHighlightEnd NOTIFY preferredHighlightEndChanged RESET resetPreferredHighlightEnd) Q_PROPERTY(int highlightMoveDuration READ highlightMoveDuration WRITE setHighlightMoveDuration NOTIFY highlightMoveDurationChanged) Q_ENUMS(HighlightRangeMode) Q_ENUMS(PositionMode) Q_ENUMS(VerticalLayoutDirection) Q_ENUMS(LayoutDirection) public: // this holds all layout enum values so they can be referred to by other enums // to ensure consistent values - e.g. QML references to GridView.TopToBottom flow // and GridView.TopToBottom vertical layout direction should have same value enum LayoutDirection { LeftToRight = Qt::LeftToRight, RightToLeft = Qt::RightToLeft, VerticalTopToBottom, VerticalBottomToTop }; enum VerticalLayoutDirection { TopToBottom = VerticalTopToBottom, BottomToTop = VerticalBottomToTop }; QQuickItemView(QQuickFlickablePrivate &dd, QQuickItem *parent = 0); ~QQuickItemView(); QVariant model() const; void setModel(const QVariant &); QQmlComponent *delegate() const; void setDelegate(QQmlComponent *); int count() const; int currentIndex() const; void setCurrentIndex(int idx); QQuickItem *currentItem() const; bool isWrapEnabled() const; void setWrapEnabled(bool); int cacheBuffer() const; void setCacheBuffer(int); Qt::LayoutDirection layoutDirection() const; void setLayoutDirection(Qt::LayoutDirection); Qt::LayoutDirection effectiveLayoutDirection() const; VerticalLayoutDirection verticalLayoutDirection() const;
141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210
void setVerticalLayoutDirection(VerticalLayoutDirection layoutDirection); QQmlComponent *footer() const; void setFooter(QQmlComponent *); QQuickItem *footerItem() const; QQmlComponent *header() const; void setHeader(QQmlComponent *); QQuickItem *headerItem() const; QQuickTransition *populateTransition() const; void setPopulateTransition(QQuickTransition *transition); QQuickTransition *addTransition() const; void setAddTransition(QQuickTransition *transition); QQuickTransition *addDisplacedTransition() const; void setAddDisplacedTransition(QQuickTransition *transition); QQuickTransition *moveTransition() const; void setMoveTransition(QQuickTransition *transition); QQuickTransition *moveDisplacedTransition() const; void setMoveDisplacedTransition(QQuickTransition *transition); QQuickTransition *removeTransition() const; void setRemoveTransition(QQuickTransition *transition); QQuickTransition *removeDisplacedTransition() const; void setRemoveDisplacedTransition(QQuickTransition *transition); QQuickTransition *displacedTransition() const; void setDisplacedTransition(QQuickTransition *transition); QQmlComponent *highlight() const; void setHighlight(QQmlComponent *); QQuickItem *highlightItem() const; bool highlightFollowsCurrentItem() const; virtual void setHighlightFollowsCurrentItem(bool); enum HighlightRangeMode { NoHighlightRange, ApplyRange, StrictlyEnforceRange }; HighlightRangeMode highlightRangeMode() const; void setHighlightRangeMode(HighlightRangeMode mode); qreal preferredHighlightBegin() const; void setPreferredHighlightBegin(qreal); void resetPreferredHighlightBegin(); qreal preferredHighlightEnd() const; void setPreferredHighlightEnd(qreal); void resetPreferredHighlightEnd(); int highlightMoveDuration() const; virtual void setHighlightMoveDuration(int); enum PositionMode { Beginning, Center, End, Visible, Contain, SnapPosition }; Q_INVOKABLE void positionViewAtIndex(int index, int mode); Q_INVOKABLE int indexAt(qreal x, qreal y) const; Q_INVOKABLE QQuickItem *itemAt(qreal x, qreal y) const; Q_INVOKABLE void positionViewAtBeginning(); Q_INVOKABLE void positionViewAtEnd(); virtual void setContentX(qreal pos); virtual void setContentY(qreal pos); virtual qreal originX() const; virtual qreal originY() const;
211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280
signals: void modelChanged(); void delegateChanged(); void countChanged(); void currentIndexChanged(); void currentItemChanged(); void keyNavigationWrapsChanged(); void cacheBufferChanged(); void layoutDirectionChanged(); void effectiveLayoutDirectionChanged(); void verticalLayoutDirectionChanged(); void headerChanged(); void footerChanged(); void headerItemChanged(); void footerItemChanged(); void populateTransitionChanged(); void addTransitionChanged(); void addDisplacedTransitionChanged(); void moveTransitionChanged(); void moveDisplacedTransitionChanged(); void removeTransitionChanged(); void removeDisplacedTransitionChanged(); void displacedTransitionChanged(); void highlightChanged(); void highlightItemChanged(); void highlightFollowsCurrentItemChanged(); void highlightRangeModeChanged(); void preferredHighlightBeginChanged(); void preferredHighlightEndChanged(); void highlightMoveDurationChanged(); protected: virtual void updatePolish(); virtual void componentComplete(); virtual void geometryChanged(const QRectF &newGeometry, const QRectF &oldGeometry); virtual qreal minYExtent() const; virtual qreal maxYExtent() const; virtual qreal minXExtent() const; virtual qreal maxXExtent() const; protected slots: void destroyRemoved(); void createdItem(int index, QObject *item); virtual void initItem(int index, QObject *item); void modelUpdated(const QQmlChangeSet &changeSet, bool reset); void destroyingItem(QObject *item); void animStopped(); void trackedPositionChanged(); private: Q_DECLARE_PRIVATE(QQuickItemView) }; class Q_AUTOTEST_EXPORT QQuickItemViewAttached : public QObject { Q_OBJECT Q_PROPERTY(bool isCurrentItem READ isCurrentItem NOTIFY currentItemChanged) Q_PROPERTY(bool delayRemove READ delayRemove WRITE setDelayRemove NOTIFY delayRemoveChanged) Q_PROPERTY(QString section READ section NOTIFY sectionChanged) Q_PROPERTY(QString previousSection READ prevSection NOTIFY prevSectionChanged) Q_PROPERTY(QString nextSection READ nextSection NOTIFY nextSectionChanged)
281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350
public: QQuickItemViewAttached(QObject *parent) : QObject(parent), m_isCurrent(false), m_delayRemove(false) {} ~QQuickItemViewAttached() {} bool isCurrentItem() const { return m_isCurrent; } void setIsCurrentItem(bool c) { if (m_isCurrent != c) { m_isCurrent = c; emit currentItemChanged(); } } bool delayRemove() const { return m_delayRemove; } void setDelayRemove(bool delay) { if (m_delayRemove != delay) { m_delayRemove = delay; emit delayRemoveChanged(); } } QString section() const { return m_section; } void setSection(const QString &sect) { if (m_section != sect) { m_section = sect; emit sectionChanged(); } } QString prevSection() const { return m_prevSection; } void setPrevSection(const QString &sect) { if (m_prevSection != sect) { m_prevSection = sect; emit prevSectionChanged(); } } QString nextSection() const { return m_nextSection; } void setNextSection(const QString &sect) { if (m_nextSection != sect) { m_nextSection = sect; emit nextSectionChanged(); } } void emitAdd() { emit add(); } void emitRemove() { emit remove(); } signals: void currentItemChanged(); void delayRemoveChanged(); void add(); void remove(); void sectionChanged(); void prevSectionChanged(); void nextSectionChanged(); public: bool m_isCurrent : 1; bool m_delayRemove : 1; // current only used by list view mutable QString m_section; QString m_prevSection; QString m_nextSection; };
351352353354355
QT_END_NAMESPACE #endif // QQUICKITEMVIEW_P_H