qquickpathview_p.h 9.65 KiB
/****************************************************************************
**
** Copyright (C) 2012 Digia Plc and/or its subsidiary(-ies).
** Contact: http://www.qt-project.org/legal
**
** This file is part of the QtQml module of the Qt Toolkit.
**
** $QT_BEGIN_LICENSE:LGPL$
** Commercial License Usage
** Licensees holding valid commercial Qt licenses may use this file in
** accordance with the commercial license agreement provided with the
** Software or, alternatively, in accordance with the terms contained in
** a written agreement between you and Digia.  For licensing terms and
** conditions see http://qt.digia.com/licensing.  For further information
** use the contact form at http://qt.digia.com/contact-us.
** GNU Lesser General Public License Usage
** Alternatively, this file may be used under the terms of the GNU Lesser
** General Public License version 2.1 as published by the Free Software
** Foundation and appearing in the file LICENSE.LGPL included in the
** packaging of this file.  Please review the following information to
** ensure the GNU Lesser General Public License version 2.1 requirements
** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
** In addition, as a special exception, Digia gives you certain additional
** rights.  These rights are described in the Digia Qt LGPL Exception
** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
** GNU General Public License Usage
** Alternatively, this file may be used under the terms of the GNU
** General Public License version 3.0 as published by the Free Software
** Foundation and appearing in the file LICENSE.GPL included in the
** packaging of this file.  Please review the following information to
** ensure the GNU General Public License version 3.0 requirements will be
** met: http://www.gnu.org/copyleft/gpl.html.
** $QT_END_LICENSE$
****************************************************************************/
#ifndef QQUICKPATHVIEW_P_H
#define QQUICKPATHVIEW_P_H
#include "qquickitem.h"
#include <private/qquickpath_p.h>
QT_BEGIN_HEADER
QT_BEGIN_NAMESPACE
class QQuickChangeSet;
class QQuickPathViewPrivate;
class QQuickPathViewAttached;
class Q_AUTOTEST_EXPORT QQuickPathView : public QQuickItem
    Q_OBJECT
    Q_PROPERTY(QVariant model READ model WRITE setModel NOTIFY modelChanged)
    Q_PROPERTY(QQuickPath *path READ path WRITE setPath NOTIFY pathChanged)
    Q_PROPERTY(int currentIndex READ currentIndex WRITE setCurrentIndex NOTIFY currentIndexChanged)
    Q_PROPERTY(QQuickItem *currentItem READ currentItem NOTIFY currentItemChanged)
    Q_PROPERTY(qreal offset READ offset WRITE setOffset NOTIFY offsetChanged)
    Q_PROPERTY(QQmlComponent *highlight READ highlight WRITE setHighlight NOTIFY highlightChanged)
    Q_PROPERTY(QQuickItem *highlightItem READ highlightItem NOTIFY highlightItemChanged)
    Q_PROPERTY(qreal preferredHighlightBegin READ preferredHighlightBegin WRITE setPreferredHighlightBegin NOTIFY preferredHighlightBeginChanged)
7172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140
Q_PROPERTY(qreal preferredHighlightEnd READ preferredHighlightEnd WRITE setPreferredHighlightEnd NOTIFY preferredHighlightEndChanged) Q_PROPERTY(HighlightRangeMode highlightRangeMode READ highlightRangeMode WRITE setHighlightRangeMode NOTIFY highlightRangeModeChanged) Q_PROPERTY(int highlightMoveDuration READ highlightMoveDuration WRITE setHighlightMoveDuration NOTIFY highlightMoveDurationChanged) Q_PROPERTY(qreal dragMargin READ dragMargin WRITE setDragMargin NOTIFY dragMarginChanged) Q_PROPERTY(qreal maximumFlickVelocity READ maximumFlickVelocity WRITE setMaximumFlickVelocity NOTIFY maximumFlickVelocityChanged) Q_PROPERTY(qreal flickDeceleration READ flickDeceleration WRITE setFlickDeceleration NOTIFY flickDecelerationChanged) Q_PROPERTY(bool interactive READ isInteractive WRITE setInteractive NOTIFY interactiveChanged) Q_PROPERTY(bool moving READ isMoving NOTIFY movingChanged) Q_PROPERTY(bool flicking READ isFlicking NOTIFY flickingChanged) Q_PROPERTY(bool dragging READ isDragging NOTIFY draggingChanged) Q_PROPERTY(int count READ count NOTIFY countChanged) Q_PROPERTY(QQmlComponent *delegate READ delegate WRITE setDelegate NOTIFY delegateChanged) Q_PROPERTY(int pathItemCount READ pathItemCount WRITE setPathItemCount RESET resetPathItemCount NOTIFY pathItemCountChanged) Q_PROPERTY(SnapMode snapMode READ snapMode WRITE setSnapMode NOTIFY snapModeChanged) Q_PROPERTY(int cacheItemCount READ cacheItemCount WRITE setCacheItemCount NOTIFY cacheItemCountChanged) Q_ENUMS(HighlightRangeMode) Q_ENUMS(SnapMode) Q_ENUMS(PositionMode) public: QQuickPathView(QQuickItem *parent=0); virtual ~QQuickPathView(); QVariant model() const; void setModel(const QVariant &); QQuickPath *path() const; void setPath(QQuickPath *); int currentIndex() const; void setCurrentIndex(int idx); QQuickItem *currentItem() const; qreal offset() const; void setOffset(qreal offset); QQmlComponent *highlight() const; void setHighlight(QQmlComponent *highlight); QQuickItem *highlightItem(); enum HighlightRangeMode { NoHighlightRange, ApplyRange, StrictlyEnforceRange }; HighlightRangeMode highlightRangeMode() const; void setHighlightRangeMode(HighlightRangeMode mode); qreal preferredHighlightBegin() const; void setPreferredHighlightBegin(qreal); qreal preferredHighlightEnd() const; void setPreferredHighlightEnd(qreal); int highlightMoveDuration() const; void setHighlightMoveDuration(int); qreal dragMargin() const; void setDragMargin(qreal margin); qreal flickDeceleration() const; void setFlickDeceleration(qreal dec); qreal maximumFlickVelocity() const; void setMaximumFlickVelocity(qreal); bool isInteractive() const; void setInteractive(bool);
141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210
bool isMoving() const; bool isFlicking() const; bool isDragging() const; int count() const; QQmlComponent *delegate() const; void setDelegate(QQmlComponent *); int pathItemCount() const; void setPathItemCount(int); void resetPathItemCount(); int cacheItemCount() const; void setCacheItemCount(int); enum SnapMode { NoSnap, SnapToItem, SnapOneItem }; SnapMode snapMode() const; void setSnapMode(SnapMode mode); enum PositionMode { Beginning, Center, End, Contain=4, SnapPosition }; // 3 == Visible in other views 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; static QQuickPathViewAttached *qmlAttachedProperties(QObject *); public Q_SLOTS: void incrementCurrentIndex(); void decrementCurrentIndex(); Q_SIGNALS: void currentIndexChanged(); void currentItemChanged(); void offsetChanged(); void modelChanged(); void countChanged(); void pathChanged(); void preferredHighlightBeginChanged(); void preferredHighlightEndChanged(); void highlightRangeModeChanged(); void dragMarginChanged(); void snapPositionChanged(); void delegateChanged(); void pathItemCountChanged(); void maximumFlickVelocityChanged(); void flickDecelerationChanged(); void interactiveChanged(); void movingChanged(); void flickingChanged(); void draggingChanged(); void highlightChanged(); void highlightItemChanged(); void highlightMoveDurationChanged(); void movementStarted(); void movementEnded(); void flickStarted(); void flickEnded(); void dragStarted(); void dragEnded(); void snapModeChanged(); void cacheItemCountChanged(); protected: virtual void updatePolish(); void mousePressEvent(QMouseEvent *event); void mouseMoveEvent(QMouseEvent *event); void mouseReleaseEvent(QMouseEvent *); bool sendMouseEvent(QMouseEvent *event);
211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280
bool childMouseEventFilter(QQuickItem *, QEvent *); void mouseUngrabEvent(); void componentComplete(); private Q_SLOTS: void refill(); void ticked(); void movementEnding(); void modelUpdated(const QQuickChangeSet &changeSet, bool reset); void createdItem(int index, QQuickItem *item); void initItem(int index, QQuickItem *item); void destroyingItem(QQuickItem *item); void pathUpdated(); private: friend class QQuickPathViewAttached; Q_DISABLE_COPY(QQuickPathView) Q_DECLARE_PRIVATE(QQuickPathView) }; class QQmlOpenMetaObject; class QQuickPathViewAttached : public QObject { Q_OBJECT Q_PROPERTY(QQuickPathView *view READ view CONSTANT) Q_PROPERTY(bool isCurrentItem READ isCurrentItem NOTIFY currentItemChanged) Q_PROPERTY(bool onPath READ isOnPath NOTIFY pathChanged) public: QQuickPathViewAttached(QObject *parent); ~QQuickPathViewAttached(); QQuickPathView *view() { return m_view; } bool isCurrentItem() const { return m_isCurrent; } void setIsCurrentItem(bool c) { if (m_isCurrent != c) { m_isCurrent = c; emit currentItemChanged(); } } QVariant value(const QByteArray &name) const; void setValue(const QByteArray &name, const QVariant &val); bool isOnPath() const { return m_onPath; } void setOnPath(bool on) { if (on != m_onPath) { m_onPath = on; emit pathChanged(); } } qreal m_percent; Q_SIGNALS: void currentItemChanged(); void pathChanged(); private: friend class QQuickPathViewPrivate; friend class QQuickPathView; QQuickPathView *m_view; QQmlOpenMetaObject *m_metaobject; bool m_onPath : 1; bool m_isCurrent : 1; }; QT_END_NAMESPACE
281282283284285286287
QML_DECLARE_TYPE(QQuickPathView) QML_DECLARE_TYPEINFO(QQuickPathView, QML_HAS_ATTACHED_PROPERTIES) QT_END_HEADER #endif // QQUICKPATHVIEW_P_H