forked from qt-creator/qt-creator
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:
@@ -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
|
||||||
|
|||||||
@@ -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]
|
||||||
|
|
||||||
|
|||||||
@@ -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
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user