Doc: update example to use Qt Mobility API 1.2

Task-number: QTCREATORBUG-6270
Change-Id: I2c65d7ec2df856ed0145468be1497b7dc5ac76a1
Reviewed-by: Alessandro Portale <alessandro.portale@nokia.com>
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@nokia.com>
This commit is contained in:
Leena Miettinen
2011-11-01 13:27:03 +01:00
parent 1d97b604c0
commit 37720c4008
3 changed files with 53 additions and 65 deletions

View File

@@ -1,40 +1,37 @@
/***************************************************************************
** # Copyright (C) 2011 Nokia Corporation and/or its subsidiary(-ies).
** Copyright (C) 2011 Nokia Corporation and/or its subsidiary(-ies). # All rights reserved.
** All rights reserved. # Contact: Nokia Corporation (info@qt.nokia.com)
** Contact: Nokia Corporation (info@qt.nokia.com) #
** # This file is part of the documentation of Qt Creator.
** This file is part of the documentation of Qt Creator. #
** # You may use this file under the terms of the BSD license as follows:
** You may use this file under the terms of the BSD license as follows: #
** # "Redistribution and use in source and binary forms, with or without
** "Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are
** modification, are permitted provided that the following conditions are # met:
** met: # * Redistributions of source code must retain the above copyright
** * Redistributions of source code must retain the above copyright # notice, this list of conditions and the following disclaimer.
** notice, this list of conditions and the following disclaimer. # * Redistributions in binary form must reproduce the above copyright
** * Redistributions in binary form must reproduce the above copyright # notice, this list of conditions and the following disclaimer in
** notice, this list of conditions and the following disclaimer in # the documentation and/or other materials provided with the
** the documentation and/or other materials provided with the # distribution.
** distribution. # * Neither the name of Nokia Corporation and its Subsidiary(-ies) nor
** * Neither the name of Nokia Corporation and its Subsidiary(-ies) nor # the names of its contributors may be used to endorse or promote
** the names of its contributors may be used to endorse or promote # products derived from this software without specific prior written
** products derived from this software without specific prior written # permission.
** permission. #
** # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS # "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT # LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR # A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT # OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, # SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT # LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, # DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY # THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT # (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE # OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE."
** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE."
**
****************************************************************************/
# Add more folders to ship with the application, here # Add more folders to ship with the application, here
folder_01.source = qml/BatteryStatus folder_01.source = qml/BatteryStatus

View File

@@ -35,10 +35,14 @@
** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE." ** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE."
** **
****************************************************************************/ ****************************************************************************/
//! [3]
import QtQuick 1.1
import com.nokia.symbian 1.1
//! [3]
import QtQuick 1.0 //! [4]
import com.nokia.symbian 1.0 import QtMobility.systeminfo 1.2
import QtMobility.systeminfo 1.1 //! [4]
//! [0] //! [0]
Page { Page {
@@ -46,13 +50,7 @@ Page {
DeviceInfo { DeviceInfo {
id: deviceinfo id: deviceinfo
monitorBatteryLevelChanges: true
Component.onCompleted: {
deviceinfo.startBatteryLevelChanged();
}
onBatteryLevelChanged: {
progressbar1.value = batteryLevel
}
} }
//! [0] //! [0]

View File

@@ -34,7 +34,7 @@
\title Creating a Qt Quick Application Using Qt Quick Components \title Creating a Qt Quick Application Using Qt Quick Components
\note To complete this tutorial, you must install the Qt Quick Components \note To complete this tutorial, you must install the Qt Quick Components
for Symbian and the Symbian^3 tool chain as part of the \QSDK. In addition, for Symbian and the Symbian Anna target as part of the \QSDK. In addition,
you must install the Qt Quick Components on the test device. you must install the Qt Quick Components on the test device.
This tutorial describes how to use Qt Creator to create a small Qt This tutorial describes how to use Qt Creator to create a small Qt
@@ -44,7 +44,7 @@
\image qtcreator-symbian-components-example.png "Mobile example" \image qtcreator-symbian-components-example.png "Mobile example"
The user interface for the application is designed using Qt Quick Components The user interface for the application is designed using Qt Quick Components
for Symbian. This enforces a platform look and feel for Symbian^3 devices. for Symbian. This enforces a platform look and feel for Symbian Anna devices.
\section1 Creating the Project \section1 Creating the Project
@@ -59,7 +59,7 @@
For example, \c {C:\Qt\examples}, and then click \gui{Next}. For example, \c {C:\Qt\examples}, and then click \gui{Next}.
\o In the \gui {Application Type} dialog, select \gui {Qt Quick \o In the \gui {Application Type} dialog, select \gui {Qt Quick
Components (Symbian Applications)}, and then click \gui{Next}. Components for Symbian}, and then click \gui{Next}.
\o Select \gui {Symbian Device} and \gui {Qt Simulator} targets, and \o Select \gui {Symbian Device} and \gui {Qt Simulator} targets, and
then click \gui{Next}. then click \gui{Next}.
@@ -83,7 +83,7 @@
Qt Creator generates the necessary files that contain boiler plate code. The Qt Creator generates the necessary files that contain boiler plate code. The
wizard creates an application that uses wizard creates an application that uses
\l{http://doc.qt.nokia.com/qt-components-symbian-1.0/qt-components-pages-and-navigation-overview.html} \l{http://doc.qt.nokia.com/qt-components-symbian/qt-components-pages-and-navigation-overview.html}
{page-based application navigation}. {page-based application navigation}.
Modify the files as described in the following sections. Modify the files as described in the following sections.
@@ -113,18 +113,13 @@
The wizard adds the import statements for Qt Quick and the Qt Quick The wizard adds the import statements for Qt Quick and the Qt Quick
Components for Symbian to the MainPage.qml file: Components for Symbian to the MainPage.qml file:
\code \snippet examples/batterystatus/qml/BatteryStatus/MainPage.qml 3
import QtQuick 1.0
import com.nokia.symbian 1.0
\endcode
To use the Qt Mobility APIs, you must add the import statements for the To use the Qt Mobility APIs, you must add the import statements for the
Qt Mobility APIs that you use. This example uses the System Info API, so you Qt Mobility APIs that you use. This example uses the System Info API, so you
must import it, as illustrated by the following code snippet: must import it, as illustrated by the following code snippet:
\code \snippet examples/batterystatus/qml/BatteryStatus/MainPage.qml 4
import QtMobility.systeminfo 1.1
\endcode
Use the values as you can assign to MOBILITY also to construct import Use the values as you can assign to MOBILITY also to construct import
statements. statements.
@@ -182,13 +177,11 @@
\o Add an invisible \o Add an invisible
\l{http://doc.qt.nokia.com/qtmobility/qml-deviceinfo.html} \l{http://doc.qt.nokia.com/qtmobility/qml-deviceinfo.html}
{DeviceInfo element} that contains two signals. The {DeviceInfo element} that sets the
\l{http://doc.qt.nokia.com/4.7/qml-component.html#onCompleted-signal} \l{http://doc.qt.nokia.com/qtmobility/qml-deviceinfo.html}
{onCompleted} signal starts battery level notification when the {monitorBatteryLevelChanges} property to true. It uses the
component is initialized. The \c monitorBatteryLevelChanges signal to keep up with changes in the
\l{http://doc.qt.nokia.com/qtmobility/qml-deviceinfo.html#batteryLevelChanged-signal} battery level.
{batteryLevelChanged} signal is called when the battery level
changes.
\snippet examples/batterystatus/qml/BatteryStatus/MainPage.qml 0 \snippet examples/batterystatus/qml/BatteryStatus/MainPage.qml 0