aboutsummaryrefslogtreecommitdiffstats
path: root/src/qml/qml/qqmlparserstatus.cpp
diff options
context:
space:
mode:
Diffstat (limited to 'src/qml/qml/qqmlparserstatus.cpp')
-rw-r--r--src/qml/qml/qqmlparserstatus.cpp107
1 files changed, 107 insertions, 0 deletions
diff --git a/src/qml/qml/qqmlparserstatus.cpp b/src/qml/qml/qqmlparserstatus.cpp
new file mode 100644
index 0000000000..d4e415a069
--- /dev/null
+++ b/src/qml/qml/qqmlparserstatus.cpp
@@ -0,0 +1,107 @@
+/****************************************************************************
+**
+** Copyright (C) 2012 Nokia Corporation and/or its subsidiary(-ies).
+** Contact: http://www.qt-project.org/
+**
+** This file is part of the QtQml module of the Qt Toolkit.
+**
+** $QT_BEGIN_LICENSE:LGPL$
+** GNU Lesser General Public License Usage
+** 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, Nokia gives you certain additional
+** rights. These rights are described in the Nokia 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.
+**
+** Other Usage
+** Alternatively, this file may be used in accordance with the terms and
+** conditions contained in a signed written agreement between you and Nokia.
+**
+**
+**
+**
+**
+**
+** $QT_END_LICENSE$
+**
+****************************************************************************/
+
+#include "qqmlparserstatus.h"
+
+QT_BEGIN_NAMESPACE
+
+/*!
+ \class QQmlParserStatus
+ \since 4.7
+ \brief The QQmlParserStatus class provides updates on the QML parser state.
+
+ QQmlParserStatus provides a mechanism for classes instantiated by
+ a QQmlEngine to receive notification at key points in their creation.
+
+ This class is often used for optimization purposes, as it allows you to defer an
+ expensive operation until after all the properties have been set on an
+ object. For example, QML's \l {Text} element uses the parser status
+ to defer text layout until all of its properties have been set (we
+ don't want to layout when the \c text is assigned, and then relayout
+ when the \c font is assigned, and relayout again when the \c width is assigned,
+ and so on).
+
+ To use QQmlParserStatus, you must inherit both a QObject-derived class
+ and QQmlParserStatus, and use the Q_INTERFACES() macro.
+
+ \code
+ class MyObject : public QObject, public QQmlParserStatus
+ {
+ Q_OBJECT
+ Q_INTERFACES(QQmlParserStatus)
+
+ public:
+ MyObject(QObject *parent = 0);
+ ...
+ void classBegin();
+ void componentComplete();
+ }
+ \endcode
+*/
+
+/*! \internal */
+QQmlParserStatus::QQmlParserStatus()
+: d(0)
+{
+}
+
+/*! \internal */
+QQmlParserStatus::~QQmlParserStatus()
+{
+ if(d)
+ (*d) = 0;
+}
+
+/*!
+ \fn void QQmlParserStatus::classBegin()
+
+ Invoked after class creation, but before any properties have been set.
+*/
+
+/*!
+ \fn void QQmlParserStatus::componentComplete()
+
+ Invoked after the root component that caused this instantiation has
+ completed construction. At this point all static values and binding values
+ have been assigned to the class.
+*/
+
+QT_END_NAMESPACE