summaryrefslogtreecommitdiffstats
path: root/doc/src/examples/qml-examples.qdoc
diff options
context:
space:
mode:
Diffstat (limited to 'doc/src/examples/qml-examples.qdoc')
-rw-r--r--doc/src/examples/qml-examples.qdoc194
1 files changed, 142 insertions, 52 deletions
diff --git a/doc/src/examples/qml-examples.qdoc b/doc/src/examples/qml-examples.qdoc
index a910266..bde2ed7 100644
--- a/doc/src/examples/qml-examples.qdoc
+++ b/doc/src/examples/qml-examples.qdoc
@@ -29,7 +29,7 @@
\title Animation: Basics Example
\example declarative/animation/basics
- This example shows how to create and combine \l{QML Animation and Transitions}{animations} in QML.
+ \brief This example shows how to create and combine \l{QML Animation}{animations} in QML.
\table
\row
@@ -38,6 +38,12 @@
\o color-animation.qml
\endtable
+/*!
+ \title Animation: Basics Property Animation Example
+ \example declarative/animation/basics/property-animation
+
+ \brief This example shows how to create and combine \l{QML Animation}{animations} in QML.
+
\table
\row
\o \image qml-propertyanim-example.png
@@ -50,7 +56,7 @@
\title Animation: Behavior Examples
\example declarative/animation/behaviors
- This example shows how to use QML behaviors.
+ \brief This example shows how to use QML behaviors.
\image qml-behaviors-example.png
*/
@@ -59,7 +65,7 @@
\title Animation: Easing Example
\example declarative/animation/easing
- This example shows the different easing modes available for \l{QML Animation and Transitions}{animations}.
+ \brief This example shows the different easing modes available for \l{QML Animation}{animations}.
\image qml-easing-example.png
*/
@@ -68,7 +74,7 @@
\title Animation: States Example
\example declarative/animation/states
- These examples show how to use \l{State}{states} and \l{Transition}{transitions}.
+ \brief These examples show how to use \l{States}{states} and \l{Transitions}{transitions}.
The \c states.qml example shows how an item can change between states, and \c transitions.qml
shows how these state changes can be animated.
@@ -92,7 +98,7 @@
\title Image Elements: Border Image Example
\example declarative/imageelements/borderimage
- These examples show how to use the BorderImage element.
+ \brief These examples show how to use the BorderImage element.
\table
\row
@@ -101,6 +107,12 @@
\o borderimage.qml
\endtable
+/*!
+ \title Image Elements: Shadows Image Example
+ \example declarative/imageelements/shadows
+
+ \brief This example shows how to use the BorderImage element.
+
\table
\row
\o \image qml-borderimage-shadows-example.png
@@ -113,7 +125,7 @@
\title Image Elements: Image Example
\example declarative/imageelements/image
- This example shows how to use the \l Image element and its \l{Image::fillMode}{fillModes}.
+ \brief This example shows how to use the \l Image element and its \l{Image::fillMode}{fillModes}.
\image qml-image-example.png
*/
@@ -122,8 +134,8 @@
\page declarative-cppextensions-reference.html
\title C++ Extensions: Reference examples
- These examples show how QML can be extended from C++ in various ways.
-
+ \brief These examples show how QML can be extended from C++ in various ways.
+
The code for these examples is used throughout the \l {Extending QML Functionalities using C++} reference
documentation, which highlights the main principles demonstrated in each example.
@@ -151,7 +163,7 @@
\title C++ Extensions: Plugins Example
\example declarative/cppextensions/plugins
- This example shows how to create a C++ plugin extension by subclassing QDeclarativeExtensionPlugin.
+ \brief This example shows how to create a C++ plugin extension by subclassing QDeclarativeExtensionPlugin.
\image qml-plugins-example.png
*/
@@ -160,7 +172,7 @@
\title LayoutItem Example
\example declarative/cppextensions/qgraphicslayouts/layoutitem
- This example show how to use the LayoutItem element to integrate QML items into an existing
+ \brief This example show how to use the LayoutItem element to integrate QML items into an existing
\l{Graphics View Framework}{Graphics View}-based application.
\image qml-layoutitem-example.png
@@ -169,7 +181,7 @@
\title QGraphicsGridLayout Example
\example declarative/cppextensions/qgraphicslayouts/qgraphicsgridlayout
- This example shows how to use QGraphicsGridLayout to lay out QML items. This is
+ \brief This example shows how to use QGraphicsGridLayout to lay out QML items. This is
useful if you need to integrate Qt \l{Graphics View Framework}{Graphics View} layouts with
QML.
@@ -179,7 +191,7 @@
\title QGraphicsLinearLayout Example
\example declarative/cppextensions/qgraphicslayouts/qgraphicslinearlayout
- This example shows how to use QGraphicsLinearLayout to lay out QML items. This is
+ \brief This example shows how to use QGraphicsLinearLayout to lay out QML items. This is
useful if you need to integrate Qt \l{Graphics View Framework}{Graphics View} layouts with
QML.
@@ -189,7 +201,7 @@
\title C++ Extensions: QGraphicsLayouts examples
\page declarative-cppextensions-qgraphicslayouts.html
- These examples show how to integrate \l{Graphics View Framework}{Graphics View}
+ \brief These examples show how to integrate \l{Graphics View Framework}{Graphics View}
layout components with QML:
\list
@@ -206,7 +218,7 @@
\title C++ Extensions: QWidgets Example
\example declarative/cppextensions/qwidgets
- This example shows how to embed QWidget-based objects into QML using QGraphicsProxyWidget.
+ \brief This example shows how to embed QWidget-based objects into QML using QGraphicsProxyWidget.
\image qml-qwidgets-example.png
*/
@@ -215,7 +227,7 @@
\title C++ Extensions: Image Provider Example
\example declarative/cppextensions/imageprovider
- This examples shows how to use QDeclarativeImageProvider to serve images
+ \brief This examples shows how to use QDeclarativeImageProvider to serve images
to QML image elements.
\image qml-imageprovider-example.png
@@ -225,7 +237,7 @@
\title C++ Extensions: Network Access Manager Factory Example
\example declarative/cppextensions/networkaccessmanagerfactory
- This example shows how to use QDeclarativeNetworkAccessManagerFactory to create a QNetworkAccessManager
+ \brief This example shows how to use QDeclarativeNetworkAccessManagerFactory to create a QNetworkAccessManager
with a proxy.
*/
@@ -234,7 +246,7 @@
\example declarative/i18n
\ingroup internationalization
- This example shows how to enable text translation in QML.
+ \brief This example shows how to enable text translation in QML.
\image qml-i18n-example.png
@@ -316,7 +328,7 @@
\title Positioners Example
\example declarative/positioners
- This example shows how to use the positioner elements such as \l Row, \l Column,
+ \brief This example shows how to use positioner elements such as \l Row, \l Column,
\l Grid and \l Flow.
\image qml-positioners-example.png
@@ -326,7 +338,7 @@
\title Key Interaction: Focus Example
\example declarative/keyinteraction/focus
- This example shows how to handle keyboard input and focus in QML.
+ \brief This example shows how to handle keyboard input and focus in QML.
\image qml-focus-example.png
*/
@@ -335,7 +347,7 @@
\title Models and Views: AbstractItemModel Example
\example declarative/modelviews/abstractitemmodel
- This example shows how to use a QAbstractItemModel subclass as a model in QML.
+ \brief This example shows how to use a QAbstractItemModel subclass as a model in QML.
\image qml-abstractitemmodel-example.png
*/
@@ -344,7 +356,7 @@
\title Models and Views: GridView Example
\example declarative/modelviews/gridview
- This example shows how to use the GridView element.
+ \brief This example shows how to use the GridView element.
\image qml-gridview-example.png
*/
@@ -353,7 +365,9 @@
\title Models and Views: ListView Example
\example declarative/modelviews/listview
- These examples show how to use the ListView element.
+ \brief This example shows how items can be dynamically added to
+ and removed from a ListModel, and how these list
+ modifications can be animated.
\table
\row
@@ -362,6 +376,13 @@
\o dynamiclist.qml
\endtable
+/*!
+ \title Models and Views: Expanding Delegate ListView Example
+ \example declarative/modelviews/listview/expandingdelegates
+
+ \brief This example shows how to create a dynamic delegate, which
+ expands when selected.
+
\table
\row
\o \image qml-listview-expandingdelegates-example.png
@@ -369,6 +390,13 @@
\o expandingdelegates.qml
\endtable
+/*!
+ \title Models and Views: Highlight ListView Example
+ \example declarative/modelviews/listview/highlight
+
+ \brief This example shows how to highlight one item
+ inside a ListView element.
+
\table
\row
\o \image qml-listview-highlight-example.png
@@ -376,6 +404,13 @@
\o highlight.qml
\endtable
+/*!
+ \title Models and Views: Highlight Ranges ListView Example
+ \example declarative/modelviews/listview/highlightranges
+
+ \brief This example shows how to highlight ranges within a
+ ListView element.
+
\table
\row
\o \image qml-listview-highlightranges-example.png
@@ -383,6 +418,12 @@
\o highlightranges.qml
\endtable
+/*!
+ \title Models and Views: Sections ListView Example
+ \example declarative/modelviews/listview/sections
+
+ \brief This example shows how to use the ListView element.
+
\table
\row
\o \image qml-listview-sections-example.png
@@ -395,7 +436,7 @@
\title Models and Views: PathView Example
\example declarative/modelviews/pathview
- This example shows how to use the PathView element.
+ \brief This example shows how to use the PathView element.
\image qml-pathview-example.png
*/
@@ -404,7 +445,7 @@
\title Models and Views: Object ListModel Example
\example declarative/modelviews/objectlistmodel
- This example shows how to use a QList<QObject*> as a model in QML.
+ \brief This example shows how to use a QList<QObject*> as a model in QML.
\image qml-objectlistmodel-example.png
*/
@@ -413,7 +454,7 @@
\title Models and Views: Package Example
\example declarative/modelviews/package
- This example shows how to use the \l Package element.
+ \brief This example shows how to use the \l Package element.
\image qml-package-example.png
*/
@@ -422,7 +463,7 @@
\title Models and Views: Parallax Example
\example declarative/modelviews/parallax
- This example shows how to combine and switch between views.
+ \brief This example shows how to combine and switch between views.
\image qml-parallax-example.png
*/
@@ -431,7 +472,7 @@
\title Models and Views: String ListModel Example
\example declarative/modelviews/stringlistmodel
- This example shows how to use a QStringList as a model in QML.
+ \brief This example shows how to use a QStringList as a model in QML.
\image qml-stringlistmodel-example.png
*/
@@ -440,7 +481,7 @@
\title Models and Views: VisualItemModel Example
\example declarative/modelviews/visualitemmodel
- This example shows how to use the VisualItemModel element.
+ \brief This example shows how to use the VisualItemModel element.
\image qml-visualitemmodel-example.png
*/
@@ -449,7 +490,7 @@
\title Models and Views: WebView Example
\example declarative/modelviews/webview
- These examples show how to use the WebView element.
+ \brief These examples show how to use the WebView element.
\table
\row
@@ -458,6 +499,12 @@
\o alert.qml
\endtable
+/*!
+ \title Models and Views: Autosize WebView Example
+ \example declarative/modelviews/webview/autosize
+
+ \brief These examples show how to use the WebView element.
+
\table
\row
\o \image qml-webview-autosize-example.png
@@ -465,6 +512,12 @@
\o autosize.qml
\endtable
+/*!
+ \title Models and Views: GoogleMaps WebView Example
+ \example declarative/modelviews/webview/googlemaps
+
+ \brief These examples show how to use the WebView element.
+
\table
\row
\o \image qml-webview-googlemaps-example.png
@@ -472,6 +525,12 @@
\o googlemaps.qml
\endtable
+/*!
+ \title Models and Views: Inline HTML WebView Example
+ \example declarative/modelviews/webview/inlinehtml
+
+ \brief These examples show how to use the WebView element.
+
\table
\row
\o \image qml-webview-inlinehtml-example.png
@@ -479,6 +538,12 @@
\o inlinehtml.qml
\endtable
+/*!
+ \title Models and Views: New Windows WebView Example
+ \example declarative/modelviews/webview/newwindows
+
+ \brief These examples show how to use the WebView element.
+
\table
\row
\o \image qml-webview-newwindows-example.png
@@ -492,22 +557,21 @@
\title Screen Orientation
\example declarative/screenorientation
- This example shows how to implement screen orientation support for your application.
+ \brief This example shows how to implement screen orientation support for your application.
*/
/*!
\title SQL Local Storage Example
\example declarative/sqllocalstorage
- This example shows how to use the SQL Local Storage API in QML.
+ \brief This example shows how to use the SQL Local Storage API in QML.
*/
/*!
\title Text: Fonts Example
\example declarative/text/fonts
- These examples show how to discover available fonts from QML and manipulate
- text in various ways.
+ \brief These examples show how to discover available fonts from QML.
\table
\row
@@ -516,6 +580,12 @@
\o availableFonts.qml
\endtable
+/*!
+ \title Text: Banner Fonts Example
+ \example declarative/text/fonts/banner
+
+ \brief These example shows how to manipulate text in various ways.
+
\table
\row
\o \image qml-fonts-banner-example.png
@@ -523,6 +593,12 @@
\o banner.qml
\endtable
+/*!
+ \title Text: Fonts Example
+ \example declarative/text/fonts/fonts
+
+ \brief These examples shows how to display a text with multiple fonts.
+
\table
\row
\o \image qml-fonts-fonts-example.png
@@ -530,6 +606,12 @@
\o fonts.qml
\endtable
+/*!
+ \title Text: Hello Fonts Example
+ \example declarative/text/fonts/hello
+
+ \brief This example shows how to manipulate text in various ways.
+
\table
\row
\o \image qml-fonts-hello-example.png
@@ -542,7 +624,7 @@
\title Text: Text Selection Example
\example declarative/text/textselection
- This example shows how text selection, copy and paste operations
+ \brief This example shows how text selection, copy and paste operations
can be implemented on top of the TextEdit element.
\image qml-textselection-example.png
@@ -552,7 +634,7 @@
\title Threading: Threaded ListModel Example
\example declarative/threading/threadedlistmodel
- This example shows how to use a ListModel from multiple threads using
+ \brief This example shows how to use a ListModel from multiple threads using
WorkerScript.
*/
@@ -560,15 +642,16 @@
\title Threading: WorkerScript Example
\example declarative/threading/workerscript
- This example shows how to use the WorkerScript element for threading in QML.
+ \brief This example shows how to use the WorkerScript element for threading in QML.
*/
/*!
\title Toys: Clocks Example
\example declarative/toys/clocks
- This example displays a set of clocks with different times for different cities.
- Each clock is created by combining \l Image elements with \l Rotation transforms
+ \brief This example displays a set of clocks with different times for different cities.
+
+ Each clock is created by combining \l Image elements with \l Rotation transforms
and \l SpringAnimation behaviors.
\image qml-clocks-example.png
@@ -578,7 +661,7 @@
\title Toys: Corkboards Example
\example declarative/toys/corkboards
- This example presents a flickable set of interactive corkboards. It is created
+ \brief This example presents a flickable set of interactive corkboards. It is created
through a combination of elements like \l ListModel, \l Repeater and \l TextEdit
together with rotation and scaling transforms, animation and mouse interaction.
@@ -589,7 +672,7 @@
\title Toys: Dynamic Scene Example
\example declarative/toys/dynamicscene
- This example presents an interactive drag-and-drop scene. It demonstrates
+ \brief This example presents an interactive drag-and-drop scene. It demonstrates
how to use QML's \l{Dynamic Object Creation} support to dynamically create and
destroy objects.
@@ -600,7 +683,7 @@
\title Toys: Tic-Tac-Toe Example
\example declarative/toys/tic-tac-toe
- This example presents a simple implementation of Tic Tac Toe.
+ \brief This example presents a simple implementation of Tic Tac Toe.
\image qml-tic-tac-toe-example.png
*/
@@ -609,17 +692,24 @@
\title Toys: TV Tennis Example
\example declarative/toys/tvtennis
- This example shows how to use animation components such as \l SpringAnimation,
+ \brief This example shows how to use animation components such as \l SpringAnimation,
\l SequentialAnimation and \l PropertyAction to create a game of TV tennis.
\image qml-tvtennis-example.png
*/
/*!
+ \title Touch Interaction: Gestures Example
+ \example declarative/touchinteraction/gestures
+
+ \brief This example shows how to use the GestureArea element.
+*/
+
+/*!
\title Touch Interaction: MouseArea Example
\example declarative/touchinteraction/mousearea
- This example shows how to use the MouseArea element to access information
+ \brief This example shows how to use the MouseArea element to access information
about mouse input.
\image qml-mousearea-example.png
@@ -629,7 +719,7 @@
\title UI Components: Dial Control Example
\example declarative/ui-components/dialcontrol
- This example shows how to create a dial-type control. It combines
+ \brief This example shows how to create a dial-type control. It combines
\l Image elements with \l Rotation transforms and \l SpringAnimation behaviors
to produce an interactive speedometer-type dial.
@@ -641,7 +731,7 @@
\title UI Components: Flipable Example
\example declarative/ui-components/flipable
- This example shows how to use the \l Flipable element.
+ \brief This example shows how to use the \l Flipable element.
\image qml-flipable-example.png
*/
@@ -650,7 +740,7 @@
\title UI Components: Progress Bars Example
\example declarative/ui-components/progressbar
- This example shows how to create a progress bar.
+ \brief This example shows how to create a progress bar.
\image qml-progressbar-example.png
*/
@@ -659,7 +749,7 @@
\title UI Components: Scroll Bar Example
\example declarative/ui-components/scrollbar
- This example shows how to create scroll bars for a \l Flickable element
+ \brief This example shows how to create scroll bars for a \l Flickable element
using the \l {Flickable::visibleArea.xPosition}{Flickable::visibleArea}
properties.
@@ -670,7 +760,7 @@
\title UI Components: Search Box Example
\example declarative/ui-components/searchbox
- This example shows how to combine TextInput, FocusScope and BorderImage
+ \brief This example shows how to combine TextInput, FocusScope and BorderImage
elements to display multiple text input fields.
\image qml-searchbox-example.png
@@ -680,7 +770,7 @@
\title UI Components: Slide Switch Example
\example declarative/ui-components/slideswitch
- This example shows how to create a slide switch control.
+ \brief This example shows how to create a slide switch control.
\image qml-slideswitch-example.png
*/
@@ -689,7 +779,7 @@
\title UI Components: Spinner Example
\example declarative/ui-components/spinner
- This example shows how to create a spinner-type component using the PathView element.
+ \brief This example shows how to create a spinner-type component using the PathView element.
\image qml-spinner-example.png
*/
@@ -698,7 +788,7 @@
\title UI Components: Tab Widget Example
\example declarative/ui-components/tabwidget
- This example shows how to create a tab widget. It also demonstrates how
+ \brief This example shows how to create a tab widget. It also demonstrates how
\l {Property aliases}{property aliases} and
\l {Introduction to the QML Language#Default Properties}{default properties} can be used to collect and
assemble the child items declared within an \l Item.
@@ -710,7 +800,7 @@
\title XML: XMLHttpRequest Example
\example declarative/xml/xmlhttprequest
- This example shows how to use the \l XmlHttpRequest API in QML.
+ \brief This example shows how to use the \l XmlHttpRequest API in QML.
\image qml-xmlhttprequest-example.png
*/