summaryrefslogtreecommitdiffstats
path: root/doc/src/declarative/qtdeclarative.qdoc
diff options
context:
space:
mode:
Diffstat (limited to 'doc/src/declarative/qtdeclarative.qdoc')
-rw-r--r--doc/src/declarative/qtdeclarative.qdoc104
1 files changed, 57 insertions, 47 deletions
diff --git a/doc/src/declarative/qtdeclarative.qdoc b/doc/src/declarative/qtdeclarative.qdoc
index fa5c0e6..549330b 100644
--- a/doc/src/declarative/qtdeclarative.qdoc
+++ b/doc/src/declarative/qtdeclarative.qdoc
@@ -40,58 +40,68 @@
****************************************************************************/
/*!
- \module QtDeclarative
- \title QtDeclarative Module
- \ingroup modules
+\module QtDeclarative
+\title QtDeclarative Module
+\ingroup modules
- \brief The Qt Declarative module provides a declarative framework for building
- highly dynamic, custom UIs
+\brief The Qt Declarative module provides a declarative framework for building
+highly dynamic, custom UIs
- Qt Declarative is targetted at the sorts of user
- interface (and the sorts of hardware) in embedded devices such as phones, media
- players, and set-top boxes. It is also appropriate for highly custom desktop
- user interfaces, or special elements in more traditional desktop
- user interfaces.
+Qt Declarative aids programmers and designers in building the animation rich,
+highly fluid user interfaces that are becoming common in portable consumer
+electronics devices, such as mobile phones, media players, set-top boxes and
+netbooks. The Qt Declarative module provides an engine for interpreting the
+declarative QML language, and a rich set of \l {QML Elements} that can be used
+from QML.
- Building fluid applications is done declaratively, rather than procedurally.
- That is, you specify \e what the UI should look like and how it should behave
- in an declarative format called QML, rather than specifying step-by-step \e how to
- build it in a language like C++ or JavaScript. Specifying a UI declaratively
- does not just include the layout of the interface items, but also the way each
- individual item looks and behaves and the overall flow of the application.
+QML is an extension to \l {http://www.ecma-international.org/publications/standards/Ecma-262.htm}
+{ECMAScript}, that provides a mechanism to declaratively build an object tree
+of \l {QML Elements}. QML improves the integration between ECMAScript and Qt's
+existing QObject based type system, adds support for automatic
+\l {Property Binding}s and provides \l {Network Transparency} at the language
+level.
- Getting Started:
- \list
- \o \l {Introduction to the QML language}
- \o \l {tutorial}{Tutorial: 'Hello World'}
- \o \l {tutorials-declarative-contacts.html}{Tutorial: 'Introduction to QML'}
- \o \l {advtutorial.html}{Advanced Tutorial: 'Same Game'}
- \o \l {qmlexamples}{Examples}
- \endlist
+The \l {QML Elements} are a sophisticated set of graphical and behavioral building
+blocks. \l {QML Elements} are combined together in QML files to build components
+ranging in complexity from simple pushbuttons and sliders, to complete
+internet-enabled applications like a \l {http://www.flickr.com}{flickr} photo browser.
- Core QML Features:
- \list
- \o \l {Anatomy of a QML Document}
- \o \l {Property Binding}
- \o \l {ECMAScript Blocks}
- \o \l {Network Transparency}
- \o \l {qmlmodels}{Data Models}
- \o \l {anchor-layout}{Anchor-based Layout}
- \o \l {qmlanimation}{Animation}
- \o \l {qmlmodules}{Modules}
- \o \l {qmlfocus}{Keyboard Focus}
- \o \l {Extending types from QML}
- \endlist
+Qt Declarative builds on \l {QML for Qt programmers}{Qt's existing strengths}.
+QML can be be used to incrementally extend an existing application or to build
+completely new applications. QML is fully \l {Extending QML}{extensible from C++}.
- QML Reference:
- \list
- \o \l {QML Format Reference}
- \o \l {QML Elements}
- \endlist
+\section1 Getting Started:
+\list
+\o \l {Introduction to the QML language}
+\o \l {tutorial}{Tutorial: 'Hello World'}
+\o \l {tutorials-declarative-contacts.html}{Tutorial: 'Introduction to QML'}
+\o \l {advtutorial.html}{Advanced Tutorial: 'Same Game'}
+\o \l {qmlexamples}{Examples}
+\endlist
- C++ Reference:
- \list
- \o \l {Extending QML}
- \o \l {qtbinding}{QML/C++ Data Binding}
- \endlist
+\section1 Core QML Features:
+\list
+\o \l {Anatomy of a QML Document}
+\o \l {Property Binding}
+\o \l {ECMAScript Blocks}
+\o \l {Network Transparency}
+\o \l {qmlmodels}{Data Models}
+\o \l {anchor-layout}{Anchor-based Layout}
+\o \l {qmlanimation}{Animation}
+\o \l {qmlmodules}{Modules}
+\o \l {qmlfocus}{Keyboard Focus}
+\o \l {Extending types from QML}
+\endlist
+
+\section1 QML Reference:
+\list
+\o \l {QML Format Reference}
+\o \l {QML Elements}
+\endlist
+
+\section1 C++ Reference:
+\list
+\o \l {Extending QML}
+\o \l {qtbinding}{QML/C++ Data Binding}
+\endlist
*/