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 ** No Commercial Usage
11 ** This file contains pre-release code and may not be distributed.
12 ** You may use this file in accordance with the terms and conditions
13 ** contained in the Technology Preview License Agreement accompanying
16 ** GNU Lesser General Public License Usage
17 ** Alternatively, this file may be used under the terms of the GNU Lesser
18 ** General Public License version 2.1 as published by the Free Software
19 ** Foundation and appearing in the file LICENSE.LGPL included in the
20 ** packaging of this file. Please review the following information to
21 ** ensure the GNU Lesser General Public License version 2.1 requirements
22 ** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
24 ** In addition, as a special exception, Nokia gives you certain additional
25 ** rights. These rights are described in the Nokia Qt LGPL Exception
26 ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
28 ** If you have questions regarding the use of this file, please contact
29 ** Nokia at qt-info@nokia.com.
40 ****************************************************************************/
42 #ifndef QDECLARATIVECUSTOMPARSER_H
43 #define QDECLARATIVECUSTOMPARSER_H
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.
56 #include "private/qdeclarativemetatype_p.h"
57 #include "qdeclarativeerror.h"
58 #include "private/qdeclarativeparser_p.h"
59 #include "private/qdeclarativebinding_p.h"
61 #include <QtCore/qbytearray.h>
62 #include <QtCore/qxmlstream.h>
68 QT_MODULE(Declarative)
70 class QDeclarativeCompiler;
72 class QDeclarativeCustomParserPropertyPrivate;
73 class Q_DECLARATIVE_EXPORT QDeclarativeCustomParserProperty
76 QDeclarativeCustomParserProperty();
77 QDeclarativeCustomParserProperty(const QDeclarativeCustomParserProperty &);
78 QDeclarativeCustomParserProperty &operator=(const QDeclarativeCustomParserProperty &);
79 ~QDeclarativeCustomParserProperty();
81 QByteArray name() const;
82 QDeclarativeParser::Location location() const;
85 // Will be one of QDeclarativeParser::Variant, QDeclarativeCustomParserProperty or
86 // QDeclarativeCustomParserNode
87 QList<QVariant> assignedValues() const;
90 friend class QDeclarativeCustomParserNodePrivate;
91 friend class QDeclarativeCustomParserPropertyPrivate;
92 QDeclarativeCustomParserPropertyPrivate *d;
95 class QDeclarativeCustomParserNodePrivate;
96 class Q_DECLARATIVE_EXPORT QDeclarativeCustomParserNode
99 QDeclarativeCustomParserNode();
100 QDeclarativeCustomParserNode(const QDeclarativeCustomParserNode &);
101 QDeclarativeCustomParserNode &operator=(const QDeclarativeCustomParserNode &);
102 ~QDeclarativeCustomParserNode();
104 QByteArray name() const;
105 QDeclarativeParser::Location location() const;
107 QList<QDeclarativeCustomParserProperty> properties() const;
110 friend class QDeclarativeCustomParserNodePrivate;
111 QDeclarativeCustomParserNodePrivate *d;
114 class Q_DECLARATIVE_EXPORT QDeclarativeCustomParser
119 AcceptsAttachedProperties = 0x00000001
121 Q_DECLARE_FLAGS(Flags, Flag)
123 QDeclarativeCustomParser() : compiler(0), object(0), m_flags(NoFlag) {}
124 QDeclarativeCustomParser(Flags f) : compiler(0), object(0), m_flags(f) {}
125 virtual ~QDeclarativeCustomParser() {}
128 Flags flags() const { return m_flags; }
130 virtual QByteArray compile(const QList<QDeclarativeCustomParserProperty> &)=0;
131 virtual void setCustomData(QObject *, const QByteArray &)=0;
133 QList<QDeclarativeError> errors() const { return exceptions; }
136 void error(const QString& description);
137 void error(const QDeclarativeCustomParserProperty&, const QString& description);
138 void error(const QDeclarativeCustomParserNode&, const QString& description);
140 int evaluateEnum(const QByteArray&) const;
142 const QMetaObject *resolveType(const QByteArray&) const;
144 QDeclarativeBinding::Identifier rewriteBinding(const QString&, const QByteArray&);
147 QList<QDeclarativeError> exceptions;
148 QDeclarativeCompiler *compiler;
149 QDeclarativeParser::Object *object;
151 friend class QDeclarativeCompiler;
153 Q_DECLARE_OPERATORS_FOR_FLAGS(QDeclarativeCustomParser::Flags);
156 #define QML_REGISTER_CUSTOM_TYPE(URI, VERSION_MAJ, VERSION_MIN, NAME, TYPE, CUSTOMTYPE) \
157 qmlRegisterCustomType<TYPE>(#URI, VERSION_MAJ, VERSION_MIN, #NAME, #TYPE, new CUSTOMTYPE)
162 Q_DECLARE_METATYPE(QDeclarativeCustomParserProperty)
163 Q_DECLARE_METATYPE(QDeclarativeCustomParserNode)