Docs - add missing images and code, clean up sections
[profile/ivi/qtdeclarative.git] / src / qml / qml / qqmlexpression_p.h
1 /****************************************************************************
2 **
3 ** Copyright (C) 2012 Nokia Corporation and/or its subsidiary(-ies).
4 ** Contact: http://www.qt-project.org/
5 **
6 ** This file is part of the QtQml module of the Qt Toolkit.
7 **
8 ** $QT_BEGIN_LICENSE:LGPL$
9 ** GNU Lesser General Public License Usage
10 ** This file may be used under the terms of the GNU Lesser General Public
11 ** License version 2.1 as published by the Free Software Foundation and
12 ** appearing in the file LICENSE.LGPL included in the packaging of this
13 ** file. Please review the following information to ensure the GNU Lesser
14 ** General Public License version 2.1 requirements will be met:
15 ** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
16 **
17 ** In addition, as a special exception, Nokia gives you certain additional
18 ** rights. These rights are described in the Nokia Qt LGPL Exception
19 ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
20 **
21 ** GNU General Public License Usage
22 ** Alternatively, this file may be used under the terms of the GNU General
23 ** Public License version 3.0 as published by the Free Software Foundation
24 ** and appearing in the file LICENSE.GPL included in the packaging of this
25 ** file. Please review the following information to ensure the GNU General
26 ** Public License version 3.0 requirements will be met:
27 ** http://www.gnu.org/copyleft/gpl.html.
28 **
29 ** Other Usage
30 ** Alternatively, this file may be used in accordance with the terms and
31 ** conditions contained in a signed written agreement between you and Nokia.
32 **
33 **
34 **
35 **
36 **
37 **
38 ** $QT_END_LICENSE$
39 **
40 ****************************************************************************/
41
42 #ifndef QQMLEXPRESSION_P_H
43 #define QQMLEXPRESSION_P_H
44
45 //
46 //  W A R N I N G
47 //  -------------
48 //
49 // This file is not part of the Qt API.  It exists purely as an
50 // implementation detail.  This header file may change from version to
51 // version without notice, or even be removed.
52 //
53 // We mean it.
54 //
55
56 #include "qqmlexpression.h"
57
58 #include <private/qv8engine_p.h>
59 #include <private/qqmlguard_p.h>
60 #include <private/qqmlengine_p.h>
61 #include <private/qfieldlist_p.h>
62 #include <private/qflagpointer_p.h>
63 #include <private/qdeletewatcher_p.h>
64 #include <private/qpointervaluepair_p.h>
65 #include <private/qqmlabstractexpression_p.h>
66 #include <private/qqmljavascriptexpression_p.h>
67
68 QT_BEGIN_NAMESPACE
69
70 class QQmlExpression;
71 class QString;
72 class QQmlExpressionPrivate : public QObjectPrivate,
73                               public QQmlJavaScriptExpression,
74                               public QQmlAbstractExpression
75 {
76     Q_DECLARE_PUBLIC(QQmlExpression)
77 public:
78     QQmlExpressionPrivate();
79     ~QQmlExpressionPrivate();
80
81     void init(QQmlContextData *, const QString &, QObject *);
82     void init(QQmlContextData *, const QString &, bool, QObject *, const QString &, quint16, quint16);
83     void init(QQmlContextData *, const QByteArray &, bool, QObject *, const QString &, quint16, quint16);
84
85     QVariant value(bool *isUndefined = 0);
86
87     v8::Local<v8::Value> v8value(bool *isUndefined = 0);
88
89     static inline QQmlExpressionPrivate *get(QQmlExpression *expr);
90     static inline QQmlExpression *get(QQmlExpressionPrivate *expr);
91
92     void _q_notify();
93
94     static QQmlExpression *create(QQmlContextData *, QObject *, const QString &, bool,
95                                   const QString &, quint16, quint16);
96
97     bool expressionFunctionValid:1;
98     bool expressionFunctionRewritten:1;
99
100     // "Inherited" from QQmlJavaScriptExpression
101     static QString expressionIdentifier(QQmlJavaScriptExpression *);
102     static void expressionChanged(QQmlJavaScriptExpression *);
103     virtual void expressionChanged();
104
105     QString expression;
106     QByteArray expressionUtf8;
107
108     v8::Persistent<v8::Object> v8qmlscope;
109     v8::Persistent<v8::Function> v8function;
110
111     QString url; // This is a QString for a reason.  QUrls are slooooooow...
112     quint16 line;
113     quint16 column;
114     QString name; //function name, hint for the debugger
115 };
116
117 QQmlExpressionPrivate *QQmlExpressionPrivate::get(QQmlExpression *expr)
118 {
119     return static_cast<QQmlExpressionPrivate *>(QObjectPrivate::get(expr));
120 }
121
122 QQmlExpression *QQmlExpressionPrivate::get(QQmlExpressionPrivate *expr)
123 {
124     return expr->q_func();
125 }
126
127
128 QT_END_NAMESPACE
129
130 #endif // QQMLEXPRESSION_P_H