1
/****************************************************************************
3
** Copyright (C) 2011 Nokia Corporation and/or its subsidiary(-ies).
4
** All rights reserved.
5
** Contact: Nokia Corporation (qt-info@nokia.com)
7
** This file is part of the QtDeclarative module of the Qt Toolkit.
9
** $QT_BEGIN_LICENSE:LGPL$
10
** GNU Lesser General Public License Usage
11
** This file may be used under the terms of the GNU Lesser General Public
12
** License version 2.1 as published by the Free Software Foundation and
13
** appearing in the file LICENSE.LGPL included in the packaging of this
14
** file. Please review the following information to ensure the GNU Lesser
15
** General Public License version 2.1 requirements will be met:
16
** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
18
** In addition, as a special exception, Nokia gives you certain additional
19
** rights. These rights are described in the Nokia Qt LGPL Exception
20
** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
22
** GNU General Public License Usage
23
** Alternatively, this file may be used under the terms of the GNU General
24
** Public License version 3.0 as published by the Free Software Foundation
25
** and appearing in the file LICENSE.GPL included in the packaging of this
26
** file. Please review the following information to ensure the GNU General
27
** Public License version 3.0 requirements will be met:
28
** http://www.gnu.org/copyleft/gpl.html.
31
** Alternatively, this file may be used in accordance with the terms and
32
** conditions contained in a signed written agreement between you and Nokia.
40
****************************************************************************/
42
#ifndef QDECLARATIVEITEM_H
43
#define QDECLARATIVEITEM_H
45
#include <QtDeclarative/qdeclarative.h>
46
#include <QtDeclarative/qdeclarativecomponent.h>
48
#include <QtCore/QObject>
49
#include <QtCore/QList>
50
#include <QtGui/qgraphicsitem.h>
51
#include <QtGui/qgraphicstransform.h>
52
#include <QtGui/qfont.h>
53
#include <QtGui/qaction.h>
59
QT_MODULE(Declarative)
61
class QDeclarativeState;
62
class QDeclarativeAnchorLine;
63
class QDeclarativeTransition;
64
class QDeclarativeKeyEvent;
65
class QDeclarativeAnchors;
66
class QDeclarativeItemPrivate;
67
class Q_DECLARATIVE_EXPORT QDeclarativeItem : public QGraphicsObject, public QDeclarativeParserStatus
70
Q_INTERFACES(QDeclarativeParserStatus)
72
Q_PROPERTY(QDeclarativeItem * parent READ parentItem WRITE setParentItem NOTIFY parentChanged DESIGNABLE false FINAL)
73
Q_PRIVATE_PROPERTY(QDeclarativeItem::d_func(), QDeclarativeListProperty<QObject> data READ data DESIGNABLE false)
74
Q_PRIVATE_PROPERTY(QDeclarativeItem::d_func(), QDeclarativeListProperty<QObject> resources READ resources DESIGNABLE false)
75
Q_PRIVATE_PROPERTY(QDeclarativeItem::d_func(), QDeclarativeListProperty<QDeclarativeState> states READ states DESIGNABLE false)
76
Q_PRIVATE_PROPERTY(QDeclarativeItem::d_func(), QDeclarativeListProperty<QDeclarativeTransition> transitions READ transitions DESIGNABLE false)
77
Q_PRIVATE_PROPERTY(QDeclarativeItem::d_func(), QString state READ state WRITE setState NOTIFY stateChanged)
78
Q_PROPERTY(QRectF childrenRect READ childrenRect NOTIFY childrenRectChanged DESIGNABLE false FINAL)
79
Q_PRIVATE_PROPERTY(QDeclarativeItem::d_func(), QDeclarativeAnchors * anchors READ anchors DESIGNABLE false CONSTANT FINAL)
80
Q_PRIVATE_PROPERTY(QDeclarativeItem::d_func(), QDeclarativeAnchorLine left READ left CONSTANT FINAL)
81
Q_PRIVATE_PROPERTY(QDeclarativeItem::d_func(), QDeclarativeAnchorLine right READ right CONSTANT FINAL)
82
Q_PRIVATE_PROPERTY(QDeclarativeItem::d_func(), QDeclarativeAnchorLine horizontalCenter READ horizontalCenter CONSTANT FINAL)
83
Q_PRIVATE_PROPERTY(QDeclarativeItem::d_func(), QDeclarativeAnchorLine top READ top CONSTANT FINAL)
84
Q_PRIVATE_PROPERTY(QDeclarativeItem::d_func(), QDeclarativeAnchorLine bottom READ bottom CONSTANT FINAL)
85
Q_PRIVATE_PROPERTY(QDeclarativeItem::d_func(), QDeclarativeAnchorLine verticalCenter READ verticalCenter CONSTANT FINAL)
86
Q_PRIVATE_PROPERTY(QDeclarativeItem::d_func(), QDeclarativeAnchorLine baseline READ baseline CONSTANT FINAL)
87
Q_PROPERTY(qreal baselineOffset READ baselineOffset WRITE setBaselineOffset NOTIFY baselineOffsetChanged)
88
Q_PROPERTY(bool clip READ clip WRITE setClip NOTIFY clipChanged) // ### move to QGI/QGO, NOTIFY
89
Q_PROPERTY(bool focus READ hasFocus WRITE setFocus NOTIFY focusChanged FINAL)
90
Q_PROPERTY(bool activeFocus READ hasActiveFocus NOTIFY activeFocusChanged)
91
Q_PROPERTY(QDeclarativeListProperty<QGraphicsTransform> transform READ transform DESIGNABLE false FINAL)
92
Q_PROPERTY(TransformOrigin transformOrigin READ transformOrigin WRITE setTransformOrigin NOTIFY transformOriginChanged)
93
Q_PROPERTY(QPointF transformOriginPoint READ transformOriginPoint) // transformOriginPoint is read-only for Item
94
Q_PROPERTY(bool smooth READ smooth WRITE setSmooth NOTIFY smoothChanged)
95
Q_PROPERTY(qreal implicitWidth READ implicitWidth WRITE setImplicitWidth NOTIFY implicitWidthChanged REVISION 1)
96
Q_PROPERTY(qreal implicitHeight READ implicitHeight WRITE setImplicitHeight NOTIFY implicitHeightChanged REVISION 1)
98
Q_ENUMS(TransformOrigin)
99
Q_CLASSINFO("DefaultProperty", "data")
102
enum TransformOrigin {
103
TopLeft, Top, TopRight,
105
BottomLeft, Bottom, BottomRight
108
QDeclarativeItem(QDeclarativeItem *parent = 0);
109
virtual ~QDeclarativeItem();
111
QDeclarativeItem *parentItem() const;
112
void setParentItem(QDeclarativeItem *parent);
114
QRectF childrenRect();
119
qreal baselineOffset() const;
120
void setBaselineOffset(qreal);
122
QDeclarativeListProperty<QGraphicsTransform> transform();
125
void setWidth(qreal);
127
qreal implicitWidth() const;
129
qreal height() const;
130
void setHeight(qreal);
132
qreal implicitHeight() const;
134
void setSize(const QSizeF &size);
136
TransformOrigin transformOrigin() const;
137
void setTransformOrigin(TransformOrigin);
140
void setSmooth(bool);
142
QRectF boundingRect() const;
143
virtual void paint(QPainter *, const QStyleOptionGraphicsItem *, QWidget *);
145
bool hasActiveFocus() const;
146
bool hasFocus() const;
149
bool keepMouseGrab() const;
150
void setKeepMouseGrab(bool);
152
Q_INVOKABLE QScriptValue mapFromItem(const QScriptValue &item, qreal x, qreal y) const;
153
Q_INVOKABLE QScriptValue mapToItem(const QScriptValue &item, qreal x, qreal y) const;
154
Q_INVOKABLE void forceActiveFocus();
155
Q_INVOKABLE QDeclarativeItem *childAt(qreal x, qreal y) const;
158
void childrenRectChanged(const QRectF &);
159
void baselineOffsetChanged(qreal);
160
void stateChanged(const QString &);
161
void focusChanged(bool);
162
void activeFocusChanged(bool);
163
void parentChanged(QDeclarativeItem *);
164
void transformOriginChanged(TransformOrigin);
165
void smoothChanged(bool);
166
void clipChanged(bool);
167
Q_REVISION(1) void implicitWidthChanged();
168
Q_REVISION(1) void implicitHeightChanged();
171
bool isComponentComplete() const;
172
virtual bool sceneEvent(QEvent *);
173
virtual bool event(QEvent *);
174
virtual QVariant itemChange(GraphicsItemChange, const QVariant &);
176
void setImplicitWidth(qreal);
177
bool widthValid() const; // ### better name?
178
void setImplicitHeight(qreal);
179
bool heightValid() const; // ### better name?
181
virtual void classBegin();
182
virtual void componentComplete();
183
virtual void keyPressEvent(QKeyEvent *event);
184
virtual void keyReleaseEvent(QKeyEvent *event);
185
virtual void inputMethodEvent(QInputMethodEvent *);
186
virtual QVariant inputMethodQuery(Qt::InputMethodQuery query) const;
187
void keyPressPreHandler(QKeyEvent *);
188
void keyReleasePreHandler(QKeyEvent *);
189
void inputMethodPreHandler(QInputMethodEvent *);
191
virtual void geometryChanged(const QRectF &newGeometry,
192
const QRectF &oldGeometry);
195
QDeclarativeItem(QDeclarativeItemPrivate &dd, QDeclarativeItem *parent = 0);
198
Q_DISABLE_COPY(QDeclarativeItem)
199
Q_DECLARE_PRIVATE_D(QGraphicsItem::d_ptr.data(), QDeclarativeItem)
203
T qobject_cast(QGraphicsObject *o)
206
return qobject_cast<T>(obj);
211
T qobject_cast(QGraphicsItem *item)
214
QObject *o = item->toGraphicsObject();
215
return qobject_cast<T>(o);
218
#ifndef QT_NO_DEBUG_STREAM
219
QDebug Q_DECLARATIVE_EXPORT operator<<(QDebug debug, QDeclarativeItem *item);
224
QML_DECLARE_TYPE(QDeclarativeItem)
225
QML_DECLARE_TYPE(QGraphicsObject)
226
QML_DECLARE_TYPE(QGraphicsTransform)
227
QML_DECLARE_TYPE(QGraphicsScale)
228
QML_DECLARE_TYPE(QGraphicsRotation)
229
QML_DECLARE_TYPE(QGraphicsWidget)
230
QML_DECLARE_TYPE(QAction)
234
#endif // QDECLARATIVEITEM_H