+incremented. The opposite behavior can be observed when using

+The QtMobility APIs are placed into the \i{QtMobility} namespace. This is done

+to facilitate the future migration of Mobility APIs into Qt. See the

+supported detail definition for that leaf class and modify its behavior

+responsive user interface.

+to fulfill specific use-cases. Please note that certain backends may

+\section3 Symbian Engine

+The Symbian engine identifies itself as the "symbian" engine, and is only available on the

+Symbian S60 3.1, S60 3.2, S60 5.0 and Symbian^3 platforms.

+The Symbian engine supports a modified version of the default schema. The schema supported

+by the Symbian engine depends on which version of the platform is being used.

+The symbian engine allows clients to use both the asynchronous and synchronous interfaces,

+and supports various different relationships, supports setting the self-contact, and

+persists all saved data to the system addressbook.

+\section3 Symbian Sim Engine

+The Symbian Sim engine identifies itself as the "symbiansim" engine, and is only available

+on Symbian platforms. It is an extremely limited engine which supports a very small

+subset of the default schema, and can be constructed with a "store" parameter to set which contact

+store to interact with. The value of the "store" parameter may be either "ADN", "FDN" or "SDN".

+\section3 Windows CE Engine

+The Windows CE engine identifies itself as the "wince" engine, and is only available

+on the Windows Mobile 6.0 platform.

+It supports a subset of the default schema, and supports both the asynchronous and synchronous

+interfaces to the datastore. It persists saved data to the system addressbook.

+of those functions to implement the required behavior.

+can service clients or provide synchronization to other backends, the schema must be

+to perform simple requests where performance or user interface responsiveness is not critical.

+The QContactManager class provides API for accessing the IDs of contacts which are stored in the manager:

+We assume the existence of a specialized leaf-class that allows simple

+definition identified by the "Name" identifier. These specialized leaf

+The client utilizes a default manager and asks for any contacts with a

+\page contactsusage.html

+ \o \l{cameracapture}{Camera Capture}

+ \o \l{streamplayer}{Stream Player}

+ QML and makes QValueSpaceSubscriber available from within QML.

+ The QValueSpaceSubscriber class is available from within QML through the use of a plugin which

+ is parsed by the QML engine. This means that simply using the QML element 'ValueSpaceSubscriber'

+ allows access to the valuespace, which is demonstrated below.

+ Firstly, import the plugin library that provides the ValueSpaceSubscriber QML element.

+

+ \snippet battery-charge/battery-subscriber/battery-subscriber.qml 4

+

+ \snippet battery-charge/battery-subscriber/battery-subscriber.qml 0

+ \snippet battery-charge/battery-subscriber/battery-subscriber.qml 1

+ \snippet battery-charge/battery-subscriber/battery-subscriber.qml 2

+ \snippet battery-charge/battery-subscriber/battery-subscriber.qml 3

+This example should demonstrate how to use the Service Framework to

+access a list of services in a QML context. A library plugin provides QML with elements

+that can reference a single service or a list of services, called 'Service' and

+'ServiceList' respectively.

+

+An example that demonstrates how to connect to a single service object to

+The following steps outline how to make a QML based application using the Service Framework technology.

+It is assumed that Qt Mobility has been successfully built and environment variables have been set

+\bold {Service Framework in QML:}

+To included the Service Framework QML plugin to our QML file we need to import it as follows:

+\snippet declarative-sfw-dialer/declarative-sfw-dialer/content/DialerList.qml 4

+In our example this will be done manually by using the servicefw tool. Refer to the project

+README for further details.

+Service Framework environment.

+The Q_EXPORT_PLUGIN2 macro provides the necessary implementation for a plugin.

+\snippet declarative-sfw-dialer/declarative-sfw-dialer/content/DialerList.qml 5

+\snippet declarative-sfw-dialer/declarative-sfw-dialer/content/DialerList.qml 0

+\snippet declarative-sfw-dialer/declarative-sfw-dialer/content/DialerList.qml 1

+You can access inside of this component the current ListWiew item by using the variable modelData.

+\snippet declarative-sfw-dialer/declarative-sfw-dialer/content/DialerList.qml 2

+\snippet declarative-sfw-dialer/declarative-sfw-dialer/content/DialerList.qml 3

+\snippet declarative-sfw-dialer/declarative-sfw-dialer/declarative-sfw-dialer.qml 0

+The hangup signal will be emitted if the HangUpButton was clicked:

+\snippet declarative-sfw-dialer/declarative-sfw-dialer/content/DialScreen.qml 1

+The dial signal will be emitted if the CallButton was clicked:

+\snippet declarative-sfw-dialer/declarative-sfw-dialer/content/DialScreen.qml 2

+\snippet declarative-sfw-dialer/declarative-sfw-dialer/declarative-sfw-dialer.qml 1

+user-interface tools. See \l{sfw-notes}{Service Framework Notes Manager} for more details.

+The QServiceManager and QServiceInterfaceDescriptor API are provided to QML through the use

+of a plugin-based system. The resulting class is referred to as QDeclarativeService, which

+provides users with the ability of accessing services by loading the interfaces specified

+using the QML element 'Service'.

+application, using a combination of declarative elements and Javascript in the QML file. To run

+the application refer to the README file supplied which

+includes instructions on how to setup and run the QML file demonstrating service framework

+capabilities.

+

+There is also another service framework example that demonstrates how to use the QML library

+plugin browse a list of services to select for dialing usage. See

+The section below explains how QML can be used to emulate to exact functionality of the

+In most cases we will need the service to be available to all parts of the QML file, meaning

+ This example program can act as either a publisher of Value Space content, a subscriber of

+ Value Space content or both. It can also optionally act as the Value Space Manager. The

+ behavior is selected by passing a combination of three optional command line parameters when

+ starting the program. If no parameters are supplied the program defaults to acting as both a

+ publisher and a subscriber.

+ widgets for setting the value of the three fixed attributes 'intValue', 'stringValue' and

+ 'byteArrayValue'.

+ We declare the slots which we will use to respond to user input in the dialog.

+ To publish values in the Value Space we first need to create a QValueSpacePublisher. This is

+ done in the \c {createNewObject()} slot, which is also used to handle changes in the base path.

+ slots.

+ We explicitly call our \c {subscriberChanged()} slot to populate the table with the initial

+ values.

+ \o \l {Sensor API}

+ \o sensors

+\row

+ \o \l {Versit API}{Versit}

+When developing on Symbian we will also need to add the required capabilites to the project file in order to satisfy the Symbian security model.

+This can be achieved with a line such as the following:

+

+\code

+ TARGET.CAPABILITIES = CAPABILITY_A CABAPILITY_B

+\endcode

+

+CAPABILITY_A and CAPABILITY_B are place holders for the appropriate Symbian capabilities. A complete list of all Symbian

+capabilities and their availability to application developers can be found in the

+\l {http://developer.symbian.org/wiki/index.php/Capabilities_(Symbian_Signed)}{Symbian capability documentation}.

+The subsequent table provides an overview of possibily required capabilities for each Mobility library.

+Note that not all capabilities are always required when using a particular API. The exact list depends

+on which parts of an API is utilized by an application.

+ \o ReadUserData WriteUserData

+ \o Capability depends on P&S value being read/written. API itself doesn't require any capability.

+ \o \l {Sensor API}

+ \o ReadDeviceData

+\row

+ \o LocalServices ReadUserData WriteUserData NetworkServices UserEnvironment Location ReadDeviceData

+ \o \l {Versit API}

+ \o No additional capabilities required.

+ asynchronous API is the preferred interface to use as it does not block the GUI while a query

+ \snippet ../../demos/serviceactions/mainwindow.cpp construct-message

+ \snippet ../../demos/serviceactions/mainwindow.cpp send-compose-message

+ \snippet ../../demos/serviceactions/mainwindow.cpp load-message

+ \snippet ../../demos/serviceactions/mainwindow.cpp process-results

+ \snippet ../../demos/serviceactions/mainwindow.cpp process-results2

+ \snippet ../../demos/serviceactions/mainwindow.cpp show-message

+ \snippet ../../demos/serviceactions/mainwindow.cpp partial-message-check

+ \snippet ../../demos/serviceactions/mainwindow.cpp retrieve-message-body

+ \snippet ../../demos/serviceactions/mainwindow.cpp store-signals

+ list of features. When a listed feature is selected the getFeature()

+ the corresponding feature.

+/*

+ Qt Mobility covers a wide range of features and technologies so it best

+ to regard it not as a single API but as a collection of APIs or frameworks.

+

+ These APIs give the developer a range of desirable functions for a

+ mobile platform, but now these functions become possible on platforms not

+

+ The QtMobility APIs are placed into the \i{QtMobility} namespace, with

+ the important exception of Multimedia. This is done to facilitate the

+ future migration of Mobility APIs into Qt.

+

+ See the \l {Quickstart Example}{Quickstart guide} for an example on how

+ the namespace impacts on application development.

+ \section1 Getting Started

+ For a overview of Platform Compatibility see \l {Platform Compatibility}.

+ state of the device to the network. So it does not manage network

+ configurations, which are the role of the platform provider, but it does

+ allow the user to start or stop network interfaces. Some higher level

+ management of the connection session may also be possible as well

+ depending on the platform.

+ The QtMobility APIs are placed into the QtMobility namespace. This is

+ done to facilitate the future migration of Mobility APIs into Qt. See

+ the \l {Quickstart Example}{Quickstart guide} for an example on how

+ \section1 Platform Compatibility

+ <td bgcolor="green"></td>

+ <td>Contacts</td>

+ <td bgcolor="green"></td>

+ <td>Multimedia</td>

+ <td>FINAL</td>

+ <td>Sensors</td>

+ <td bgcolor="green"></td>

+ <td bgcolor="green"></td>

+ <td bgcolor="green"></td>

+ <td bgcolor="green"></td>

+To begin, obtain the most recent distribution package from

+ \o On all platforms, QtMultimediaKit depends on QtGui and QtNetwork.

+ \o The audioengine plugin for Unix depends on QtMultimediaKit.

+ The dsengine plugin for desktop Windows depends on QtMultimediaKit.

+ To enable all mediaservices on Symbian one must download sdk plugins. Sdk plugins are available at \l http://wiki.forum.nokia.com/index.php/SDK_API_Plug-in

+ For 5th edition sdk plugins are installed with installer (all at once), but for FP1 and FP2 devices a zip is provided. You will need following plugins to compile all features:

+ AudioRoutingAPI, Tuner Utility (only for 3rd FP1), Radio Utility API (for 3rd FP2 and 5th ed).

+

+ Multimedia also includes audio and video (from 1.0.1 onwards) and in Symbian we need MMFDevSound API-SDK plugin to compile/link API. This is also available in Forum Nokia as a supplementary pack.

+

+ with older SSDKsbut there will be reduced functionality.

+\bold{Note:} Static builds of Qt are not supported by Qt Mobility.

+ important to run the \c{setcepaths} script from the \c{bin}

+ directory of the Qt for Windows CE installation to ensure that

+The QtMobility APIs are placed into the \i{QtMobility} namespace. This is done

+to facilitate the future migration of Mobility APIs into Qt. See the

+from the \c LogFilePositionSource class. Run the example to see the data

+The QtMobility APIs are placed into the \i{QtMobility} namespace. This is done

+to facilitate the future migration of Mobility APIs into Qt. See the

+QtMultimediaKit module. This API is planned to replace Phonon at a later stage.

+\section1 No Special Namespace

+Unlike the other APIs in Qt Mobility, the Multimedia API is \i not in the

+\i QtMobility namespace.

+This API delivers an easy to use interface to multimedia functions. The

+developer can use the API to display an image, or a video, record sound or play a

+There are several benefits this API brings to Qt. Firstly, the

+deal of flexibility with the media source or the generated multimedia. The

+source file does not need to be local to the device, it could be streamed from a remote location and identified by a URL. Finally, many different codecs are supported 'out

+is immediately available with minimal effort.

+The Audio Recorder example is a good introduction to the basic use of the API. We will use snippets from this example to illustrate how to use the

+API to quickly build functionality.

+The first step is to demonstrate recording audio to a file. When recording from an audio source there are a number of things we may want to control beyond the essential user interface. We may want a particular encoding of the file, MP3 or Ogg Vorbis for instance, or select a different input source. The user may modify the bitrate, number of channels, quality and sample rate. Here the example will only modify the codec and the source device, since they are essential.

+To begin, the developer sets up a source and a recorder object. A

+\l{QAudioCaptureSource} object is created and used to initialize a \l{QMediaRecorder} object. The output file name is then set for the \l{QMediaRecorder} object.

+\code

+ audiosource = new QAudioCaptureSource;

+ capture = new QMediaRecorder(audiosource);

+

+ capture->setOutputLocation(QUrl("test.raw"));

+\endcode

+

+A list of devices is needed so that an input can be selected in the user interface

+

+\code

+ for(int i = 0; i < audiosource->deviceCount(); i++)

+ deviceBox->addItem(audiosource->name(i));

+\endcode

+

+and a list of the supported codecs for the user to select a codec,

+

+\code

+ QStringList codecs = capture->supportedAudioCodecs();

+ for(int i = 0; i < codecs.count(); i++)

+ codecsBox->addItem(codecs.at(i));

+\endcode

+

+To set the selected device or codec just use the index of the device or codec by calling the setter in \i {audiosource} or \i {capture} as appropriate, for example,

+

+\code

+ audiosource->setSelectedDevice(i);

+ ...

+ capture->setAudioCodec(codecIdx);

+\endcode

+

+Now start recording by using the \l {QMediaRecorder}{record()} function from the new \l{QMediaRecorder} object

+

+\code

+ capture->record();

+\endcode

+

+And stop recording by calling the matching function \l {QMediaRecorder::stop()}{stop()} in \l{QMediaRecorder}.

+

+\code

+ capture->stop();

+\endcode

+

+How then would this audio file be played? The \l {QMediaPlayer} class will be

+used as a generic player. Since the player can play both video and audio files the interface will be more complex, but for now the example will concentrate on the audio aspect.

+

+Playing the file is simple: create a player object, pass in the filename, set

+the volume or other parameters, then play. Not forgetting that the code will

+need to be hooked up to the user interface.

+

+\code

+ QMediaPlayer *player = new QMediaPlayer;

+ ...

+ player->setMedia(QUrl::fromLocalFile("test.raw"));

+ player->setVolume(50);

+ player->play();

+\endcode

+

+The filename does not have to be a local file. It could be a URL to a

+remote resource. Also by using the \l{QMediaPlaylist} class from this API

+we can play a list of local or remote files. The \l{QMediaPlaylist}

+class supports constructing, managing and playing playlists.

+

+\code

+ player = new QMediaPlayer;

+

+ playlist = new QMediaPlaylist(player);

+ playlist->append(QUrl("http://example.com/myfile1.mp3"));

+ playlist->append(QUrl("http://example.com/myfile2.mp3"));

+ ...

+ playlist->setCurrentPosition(1);

+ player->play();

+\endcode

+

+To manipulate the playlist there are the usual management functions (which are in fact slots): previous, next, setCurrentPosition and shuffle. Playlists can be built, saved and loaded using the API.

+Continuing with the example discussed for an Audio recorder/player, we can use this to show how to play video files with little change to the code.

+Moving from audio to video requires few changes in the sample code. To play a

+video playlist the code can be changed to include another new Mobility

+Project class: \l{QVideoWidget}. This class enables control of a video

+resource with signals and slots for the control of brightness, contrast,

+hue, saturation and full screen mode.

+\code

+ player = new QMediaPlayer;

+

+ playlist = new QMediaPlaylist(player);

+ playlist->append(QUrl("http://example.com/myclip1.mp4"));

+ playlist->append(QUrl("http://example.com/myclip2.mp4"));

+ ...

+ widget = new QVideoWidget(player);

+ widget->show();

+

+ playlist->setCurrentPosition(1);

+ player->play();

+\endcode

+

+The \l {player}{Player} example does things a bit differently to our sample code. instead of using a QVideoWidget object directly, the Player example has a \i {VideoWidget} class that inherits from QVideoWidget. This means that functions can be added to provide functions such as full screen display, either on a double click or on a particular keypress.

+

+\snippet ../../demos/player/player.cpp 2

+\section1 Extending the API for Symbian and Maemo

+

+\section2 Adding a Media Service Provider

+

+The base class for creating new service providers is \l{QMediaServiceProvider}. The user must implement the \l{QMediaServiceProvider::requestService()}{requestService()} function

+

+\code

+ QMediaService* requestService(const QByteArray &type, const QMediaServiceProviderHint &hint);

+\endcode

+

+The details of implementation will depend on the provider. Looking at the class \l QMediaServiceProvider for the default implementation. Notice that \l {QMediaServiceProvider::requestService()}{requestService()} uses the \l QMediaServiceProviderHint to look for the appropriate plugin and then to insert it into the plugin map. However, for a specific service provider there is probably no need for this approach, it will simply depend on what the developer wants to implement.

+

+Other methods that may be overloaded

+\code

+ void releaseService(QMediaService *service);

+

+ QtMediaServices::SupportEstimate hasSupport(const QByteArray &serviceType,

+ const QString &mimeType,

+ const QStringList& codecs,

+ int flags) const;

+

+ QStringList supportedMimeTypes(const QByteArray &serviceType, int flags) const;

+

+ QList<QByteArray> devices(const QByteArray &serviceType) const;

+

+ QString deviceDescription(const QByteArray &serviceType, const QByteArray &device);

+\endcode

+

+The choice of what needs to be done depends on what the developer wishes to do with the service.

+

+\section2 QML multimedia elements

+\list

+\o \l {SoundEffect}{SoundEffect: Low Latency Sound Effects}

+\o \l {Audio}{Audio: Music playback}

+\o \l {Video}{Video: Video playback}

+\endlist

+

+

+The QtMobility APIs are placed into the \i{QtMobility} namespace. This is done

+to facilitate the future migration of Mobility APIs into Qt. See the

+ <class access="public" threadsafety="unspecified" status="commendable" name="QAudioOutput" href="qaudiooutput.html" location="qaudiooutput.h" bases="QObject" module="QtMultimediaKit">

+ <class access="public" threadsafety="unspecified" status="commendable" name="QAudioDeviceInfo" href="qaudiodeviceinfo.html" location="qaudiodeviceinfo.h" bases="QObject" module="QtMultimediaKit">

+ <class access="public" threadsafety="unspecified" status="commendable" name="QAudioDeviceId" href="qaudiodeviceid.html" location="qaudiodeviceid.h" bases="" module="QtMultimediaKit">

+ <class access="public" threadsafety="unspecified" status="commendable" name="QAudioFormat" href="qaudioformat.html" location="qaudioformat.h" bases="" module="QtMultimediaKit">

+ <class access="public" threadsafety="unspecified" status="commendable" name="QAudioInput" href="qaudioinput.html" location="qaudioinput.h" bases="QObject" module="QtMultimediaKit">

+The new Qt APIs are typically supported by backends for each platform. For overall summary of the completeness/compatibility of support for a given API see \l {Platform Compatibility}.

+ \o Prefixed paths in includes such as \code #include <QtLibrary/MyClass> \endcode or \code #include <QtLibrary/myclass.h> \endcode do not currently work on Symbian.

+ \o Messaging filtering and sorting functions are not fully optimized.

+ \o Fremantle: \c modest process must be restarted before Fremantle backend is fully operational. This can be achieved by restarting the device.

+ \o Fremantle and Windows: \c {QMessageServiceAction::send}: Only queues a message for sending, message may or may not be sent depending on connection status and is at the platform's discretion.

+ \o Symbian^3: \c {QMessageService::retrieveBody} is not supported.

+ \o Windows: \c {QMessageServiceAction::exportUpdates} performs no operation as changes are automatically synchronized with external servers when a connection is available.

+ \o Windows mobile: \c {QMessageServiceAction::retrieve}: Only retrieves content for messages bodies at present. Attachment retrieval

+ ../../plugins/declarative/multimedia \

+ ../../plugins/declarative/multimedia \

+ ../../demos \

+The QtMobility APIs are placed into the \i{QtMobility} namespace. This is done

+to facilitate the future migration of Mobility APIs into Qt. See the

+the screen the values may need to be transformed so that they match the user interface orientation. A sensor

+If you would like to build a backend into a library or application you can use the

+The QtMobility APIs are placed into the \i{QtMobility} namespace. This is done

+to facilitate the future migration of Mobility APIs into Qt. See the

+utilized by introspecting the object, using Qt's meta object system.

+Its disadvantage is that client and service must share the implementation of the service object via a library

+The QtMobility APIs are placed into the \i{QtMobility} namespace. This is done

+to facilitate the future migration of Mobility APIs into Qt. See the

+This lists the supported hardware on the device. Features include items

+such as the camera, bluetooth, GPS, FM radio etc.

+#include <QtMultimediaKit/qaudioformat.h>

+ //qDebug() << "update metadata" << player->metaData(QtMultimediaKit::Title).toString();

+ .arg(player->metaData(QtMultimediaKit::AlbumArtist).toString())

+ .arg(player->metaData(QtMultimediaKit::Title).toString()));

+ QUrl url = player->metaData(QtMultimediaKit::CoverArtUrlLarge).value<QUrl>();

+ //! [Getting all tags]

+ QSet<QString> tags;

+ foreach(const QContactTag& tag, contact.details<QContactTag>()) {

+ tags.insert(tag.tag());

+ }

+ //! [Getting all tags]

+ //! [Checking for a specific tag]

+ if (contact.details<QContactTag>(QContactTag::FieldTag, "MyTag").count() > 0) {

+ // Do something with it

+ }

+ //! [Checking for a specific tag]

+ MyDetailHandler() : detailNumber(0) {}

+ /* eg. a detail with definition name "Detail1" and fields "Field1"="Value1" and

+ * "Field2"="Value2" will be exported to the vCard properties:

+ * G0.DETAIL1-FIELD1:Value1

+ * G0.DETAIL1-FIELD2:Value2

+ * And the next detail (say, "Detail2" with a field "Field3"="Value3" will generate:

+ * G1.DETAIL2-FIELD3:Value3

+ * ie. Different details will have different vCard groups.

+ */

+ Q_UNUSED(contact)

+ // beware: if the base implementation exports some but not all fields, alreadyProcessed

+ // will be true and the unprocessed fields won't be exported

+ if (alreadyProcessed)

+ return false;

+ if (detail.definitionName() == QContactType::DefinitionName)

+ return false; // special case of an unhandled detail that we don't export

+ QVersitProperty property;

+ QVariantMap fields = detail.variantValues();

+ // fields from the same detail have the same group so the importer can collate them

+ QString detailGroup = QLatin1String("G") + QString::number(detailNumber++);

+ for (QVariantMap::const_iterator it = fields.constBegin();

+ it != fields.constEnd();

+ it++) {

+ property.setGroups(QStringList(detailGroup));

+ // beware: detail.definitionName and the field name will be made uppercase on export

+ property.setName(QLatin1String("X-QCONTACTDETAIL-")

+ + detail.definitionName()

+ + QLatin1String("-")

+ + it.key());

+ // beware: this might not handle nonstring values properly:

+ property.setValue(it.value());

+ document->addProperty(property);

+ }

+ return true;

+private:

+ int detailNumber;

+ bool preProcessProperty(const QVersitDocument& document, const QVersitProperty& property,

+ int contactIndex, QContact* contact) {

+ Q_UNUSED(document) Q_UNUSED(property) Q_UNUSED(contactIndex) Q_UNUSED(contact)

+ return false;

+ }

+ /* eg. if the document has the properties:

+ * G0.DETAIL-FIELD1:Value1

+ * G0.DETAIL-FIELD2:Value2

+ * G1.DETAIL-FIELD1:Value3

+ * This will generate two details - the first with fields "FIELD1"="Value1" and

+ * "FIELD2"="Value2" and the second with "FIELD1"="Value3"

+ * ie. the vCard groups determine which properties form a single detail.

+ */

+ bool postProcessProperty(const QVersitDocument& document, const QVersitProperty& property,

+ bool alreadyProcessed, int contactIndex, QContact* contact) {

+ Q_UNUSED(document) Q_UNUSED(contactIndex)

+ const QString prefix = QLatin1String("X-QCONTACTDETAIL-");

+ if (alreadyProcessed)

+ return false;

+ if (!property.name().startsWith(prefix))

+ return false;

+ QString detailAndField = property.name().mid(prefix.size());

+ QStringList detailAndFieldParts = detailAndField.split(QLatin1Char('-'),

+ QString::SkipEmptyParts);

+ if (detailAndFieldParts.size() != 2)

+ return false;

+ QString definitionName = detailAndFieldParts.at(0);

+ QString fieldName = detailAndFieldParts.at(1);

+ if (property.groups().size() != 1)

+ return false;

+ QString group = property.groups().first();

+ // find a detail generated from the a property with the same group

+ QContactDetail detail = handledDetails.value(group);

+ // make sure the the existing detail has the same definition name

+ if (detail.definitionName() != definitionName)

+ detail = QContactDetail(definitionName);

+ detail.setValue(fieldName, property.value());

+ contact->saveDetail(&detail);

+ handledDetails.insert(group, detail);

+ return false;

+ }

+ QMap<QString, QContactDetail> handledDetails; // map from group name to detail

+/****************************************************************************

+**

+** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).

+** All rights reserved.

+** Contact: Nokia Corporation (qt-info@nokia.com)

+**

+** This file is part of the Qt Mobility Components.

+**

+** $QT_BEGIN_LICENSE:LGPL$

+** No Commercial Usage

+** This file contains pre-release code and may not be distributed.

+** You may use this file in accordance with the terms and conditions

+** contained in the Technology Preview License Agreement accompanying

+** this package.

+**

+** GNU Lesser General Public License Usage

+** Alternatively, 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.

+**

+** If you have questions regarding the use of this file, please contact

+** Nokia at qt-info@nokia.com.

+**

+**

+**

+**

+**

+**

+**

+**

+** $QT_END_LICENSE$

+**

+****************************************************************************/

+

+#include <QtCore>

+

+#include "bluetoothtransfer.h"

+

+BluetoothTransfer::BluetoothTransfer(QObject *parent)

+ : QObject(parent)

+{

+}

+

+//! [sendFile]

+void BluetoothTransfer::sendFile(const QString &path)

+{

+ qDebug() << "BluetoothTransfer::sendFile()" << path;

+}

+//! [sendFile]

+/****************************************************************************

+**

+** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).

+** All rights reserved.

+** Contact: Nokia Corporation (qt-info@nokia.com)

+**

+** This file is part of the Qt Mobility Components.

+**

+** $QT_BEGIN_LICENSE:LGPL$

+** No Commercial Usage

+** This file contains pre-release code and may not be distributed.

+** You may use this file in accordance with the terms and conditions

+** contained in the Technology Preview License Agreement accompanying

+** this package.

+**

+** GNU Lesser General Public License Usage

+** Alternatively, 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.

+**

+** If you have questions regarding the use of this file, please contact

+** Nokia at qt-info@nokia.com.

+**

+**

+**

+**

+**

+**

+**

+**

+** $QT_END_LICENSE$

+**

+****************************************************************************/

+

+#ifndef BLUETOOTHTRANSFER_H

+#define BLUETOOTHTRANSFER_H

+

+#include <QObject>

+

+class BluetoothTransfer : public QObject

+{

+ Q_OBJECT

+public:

+ BluetoothTransfer(QObject *parent = 0);

+

+public slots:

+ void sendFile(const QString &path);

+};

+

+

+#endif

+/****************************************************************************

+**

+** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).

+** All rights reserved.

+** Contact: Nokia Corporation (qt-info@nokia.com)

+**

+** This file is part of the Qt Mobility Components.

+**

+** $QT_BEGIN_LICENSE:LGPL$

+** No Commercial Usage

+** This file contains pre-release code and may not be distributed.

+** You may use this file in accordance with the terms and conditions

+** contained in the Technology Preview License Agreement accompanying

+** this package.

+**

+** GNU Lesser General Public License Usage

+** Alternatively, 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.

+**

+** If you have questions regarding the use of this file, please contact

+** Nokia at qt-info@nokia.com.

+**

+**

+**

+**

+**

+**

+**

+**

+** $QT_END_LICENSE$

+**

+****************************************************************************/

+

+#include <qserviceinterfacedescriptor.h>

+#include <qabstractsecuritysession.h>

+#include <qservicecontext.h>

+

+#include "bluetoothtransferplugin.h"

+#include "bluetoothtransfer.h"

+

+QObject* BluetoothTransferPlugin::createInstance(const QServiceInterfaceDescriptor& descriptor, QServiceContext* context, QAbstractSecuritySession* session)

+{

+ Q_UNUSED(descriptor);

+ Q_UNUSED(context);

+ Q_UNUSED(session);

+ //! [createinstance]

+ return new BluetoothTransfer(this);

+ //! [createinstance]

+}

+

+Q_EXPORT_PLUGIN2(serviceframework_bluetoothtransferplugin, BluetoothTransferPlugin)

+/****************************************************************************

+**

+** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).

+** All rights reserved.

+** Contact: Nokia Corporation (qt-info@nokia.com)

+**

+** This file is part of the Qt Mobility Components.

+**

+** $QT_BEGIN_LICENSE:LGPL$

+** No Commercial Usage

+** This file contains pre-release code and may not be distributed.

+** You may use this file in accordance with the terms and conditions

+** contained in the Technology Preview License Agreement accompanying

+** this package.

+**

+** GNU Lesser General Public License Usage

+** Alternatively, 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.

+**

+** If you have questions regarding the use of this file, please contact

+** Nokia at qt-info@nokia.com.

+**

+**

+**

+**

+**

+**

+**

+**

+** $QT_END_LICENSE$

+**

+****************************************************************************/

+

+#ifndef BLUETOOTHTRANSFERPLUGIN_H

+#define BLUETOOTHTRANSFERPLUGIN_H

+

+#include <QObject>

+

+#include <qserviceplugininterface.h>

+

+QTM_USE_NAMESPACE

+

+class BluetoothTransferPlugin : public QObject,

+ public QServicePluginInterface

+{

+ Q_OBJECT

+ Q_INTERFACES(QtMobility::QServicePluginInterface)

+public:

+ QObject* createInstance(const QServiceInterfaceDescriptor& descriptor,

+ QServiceContext* context,

+ QAbstractSecuritySession* session);

+};

+

+#endif

+/****************************************************************************

+**

+** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).

+** All rights reserved.

+** Contact: Nokia Corporation (qt-info@nokia.com)

+**

+** This file is part of the Qt Mobility Components.

+**

+** $QT_BEGIN_LICENSE:LGPL$

+** No Commercial Usage

+** This file contains pre-release code and may not be distributed.

+** You may use this file in accordance with the terms and conditions

+** contained in the Technology Preview License Agreement accompanying

+** this package.

+**

+** GNU Lesser General Public License Usage

+** Alternatively, 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.

+**

+** If you have questions regarding the use of this file, please contact

+** Nokia at qt-info@nokia.com.

+**

+**

+**

+**

+**

+**

+**

+**

+** $QT_END_LICENSE$

+**

+****************************************************************************/

+

+#include <qserviceinterfacedescriptor.h>

+#include <qabstractsecuritysession.h>

+#include <qservicecontext.h>

+

+#include "filemanagerplugin.h"

+#include "filemanagerstorage.h"

+#include "filemanagertransfer.h"

+

+//! [createinstance-sig]

+QObject* FileManagerPlugin::createInstance(const QServiceInterfaceDescriptor& descriptor, QServiceContext* context, QAbstractSecuritySession* session)

+//! [createinstance-sig]

+{

+ Q_UNUSED(context);

+ Q_UNUSED(session);

+//! [createinstance]

+ if (descriptor.interfaceName() == "com.nokia.qt.examples.FileStorage")

+ return new FileManagerStorage(this);

+ else if (descriptor.interfaceName() == "com.nokia.qt.examples.FileTransfer")

+ return new FileManagerTransfer(this);

+ else

+ return 0;

+//! [createinstance]

+}

+

+Q_EXPORT_PLUGIN2(serviceframework_filemanagerplugin, FileManagerPlugin)

+/****************************************************************************

+**

+** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).

+** All rights reserved.

+** Contact: Nokia Corporation (qt-info@nokia.com)

+**

+** This file is part of the Qt Mobility Components.

+**

+** $QT_BEGIN_LICENSE:LGPL$

+** No Commercial Usage

+** This file contains pre-release code and may not be distributed.

+** You may use this file in accordance with the terms and conditions

+** contained in the Technology Preview License Agreement accompanying

+** this package.

+**

+** GNU Lesser General Public License Usage

+** Alternatively, 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.

+**

+** If you have questions regarding the use of this file, please contact

+** Nokia at qt-info@nokia.com.

+**

+**

+**

+**

+**

+**

+**

+**

+** $QT_END_LICENSE$

+**

+****************************************************************************/

+

+#ifndef FILEMANAGERPLUGIN_H

+#define FILEMANAGERPLUGIN_H

+

+#include <QObject>

+

+#include <qserviceplugininterface.h>

+

+QTM_USE_NAMESPACE

+

+class FileManagerPlugin : public QObject,

+ public QServicePluginInterface

+{

+ Q_OBJECT

+ Q_INTERFACES(QtMobility::QServicePluginInterface)

+public:

+ QObject* createInstance(const QServiceInterfaceDescriptor& descriptor,

+ QServiceContext* context,

+ QAbstractSecuritySession* session);

+};

+

+#endif

+/****************************************************************************

+**

+** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).

+** All rights reserved.

+** Contact: Nokia Corporation (qt-info@nokia.com)

+**

+** This file is part of the Qt Mobility Components.

+**

+** $QT_BEGIN_LICENSE:LGPL$

+** No Commercial Usage

+** This file contains pre-release code and may not be distributed.

+** You may use this file in accordance with the terms and conditions

+** contained in the Technology Preview License Agreement accompanying

+** this package.

+**

+** GNU Lesser General Public License Usage

+** Alternatively, 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.

+**

+** If you have questions regarding the use of this file, please contact

+** Nokia at qt-info@nokia.com.

+**

+**

+**

+**

+**

+**

+**

+**

+** $QT_END_LICENSE$

+**

+****************************************************************************/

+

+#include <QtCore>

+

+#include "filemanagerstorage.h"

+

+FileManagerStorage::FileManagerStorage(QObject *parent)

+ : QObject(parent)

+{

+ directory = QCoreApplication::applicationDirPath();

+}

+

+void FileManagerStorage::setWorkingDirectory(const QString &path)

+{

+ directory = path;

+ emit workingDirectoryChanged(path);

+}

+

+QString FileManagerStorage::workingDirectory() const

+{

+ return directory;

+}

+

+void FileManagerStorage::copyFile(const QString &currentPath, const QString &newPath)

+{

+ qDebug() << "FileManagerStorage::copyFile() from" << currentPath << "to" << newPath;

+}

+/****************************************************************************

+**

+** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).

+** All rights reserved.

+** Contact: Nokia Corporation (qt-info@nokia.com)

+**

+** This file is part of the Qt Mobility Components.

+**

+** $QT_BEGIN_LICENSE:LGPL$

+** No Commercial Usage

+** This file contains pre-release code and may not be distributed.

+** You may use this file in accordance with the terms and conditions

+** contained in the Technology Preview License Agreement accompanying

+** this package.

+**

+** GNU Lesser General Public License Usage

+** Alternatively, 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.

+**

+** If you have questions regarding the use of this file, please contact

+** Nokia at qt-info@nokia.com.

+**

+**

+**

+**

+**

+**

+**

+**

+** $QT_END_LICENSE$

+**

+****************************************************************************/

+

+#include <QtCore>

+

+#include "filemanagertransfer.h"

+

+FileManagerTransfer::FileManagerTransfer(QObject *parent)

+ : QObject(parent)

+{

+}

+

+void FileManagerTransfer::invokableMethod()

+{

+ qDebug() << "FileManagerTransfer::invokableMethod()";

+}

+

+void FileManagerTransfer::sendFile(const QString &path)

+{

+ qDebug() << "FileManagerTransfer::sendFile()" << path;

+}

+/****************************************************************************

+**

+** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).

+** All rights reserved.

+** Contact: Nokia Corporation (qt-info@nokia.com)

+**

+** This file is part of the Qt Mobility Components.

+**

+** $QT_BEGIN_LICENSE:LGPL$

+** No Commercial Usage

+** This file contains pre-release code and may not be distributed.

+** You may use this file in accordance with the terms and conditions

+** contained in the Technology Preview License Agreement accompanying

+** this package.

+**

+** GNU Lesser General Public License Usage

+** Alternatively, 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.

+**

+** If you have questions regarding the use of this file, please contact

+** Nokia at qt-info@nokia.com.

+**

+**

+**

+**

+**

+**

+**

+**

+** $QT_END_LICENSE$

+**

+****************************************************************************/

+

+#ifndef FILEMANAGERTRANSFER_H

+#define FILEMANAGERTRANSFER_H

+

+#include <QObject>

+

+class FileManagerTransfer : public QObject

+{

+ Q_OBJECT

+public:

+ FileManagerTransfer(QObject *parent = 0);

+

+ Q_INVOKABLE void invokableMethod();

+

+public slots:

+ void sendFile(const QString &path);

+};

+

+#endif

+/****************************************************************************

+**

+** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).

+** All rights reserved.

+** Contact: Nokia Corporation (qt-info@nokia.com)

+**

+** This file is part of the Qt Mobility Components.

+**

+** $QT_BEGIN_LICENSE:LGPL$

+** No Commercial Usage

+** This file contains pre-release code and may not be distributed.

+** You may use this file in accordance with the terms and conditions

+** contained in the Technology Preview License Agreement accompanying

+** this package.

+**

+** GNU Lesser General Public License Usage

+** Alternatively, 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.

+**

+** If you have questions regarding the use of this file, please contact

+** Nokia at qt-info@nokia.com.

+**

+**

+**

+**

+**

+**

+**

+**

+** $QT_END_LICENSE$

+**

+****************************************************************************/

+

+#include "dialog.h"

+#include <QMessageBox>

+#include <QTimer>

+

+Dialog::Dialog() :

+ QWidget(),

+ saver(NULL), systemInfo(NULL), di(NULL), ni(NULL)

+{

+ setupUi(this);

+ setupGeneral();

+

+ connect(tabWidget,SIGNAL(currentChanged(int)),this,SLOT(tabChanged(int)));

+ connect(versionComboBox,SIGNAL(activated(int)), this,SLOT(getVersion(int)));

+ connect(featureComboBox,SIGNAL(activated(int)), this,SLOT(getFeature(int)));

+ updateDeviceLockedState();

+ QTimer *timer = new QTimer(this);

+ connect(timer, SIGNAL(timeout()), this, SLOT(updateDeviceLockedState()));

+ timer->start(1000);

+}

+

+Dialog::~Dialog()

+{

+ delete systemInfo;

+ delete di;

+ delete saver;

+}

+

+void Dialog::changeEvent(QEvent *e)

+{

+ QWidget::changeEvent(e);

+ switch (e->type()) {

+ case QEvent::LanguageChange:

+ retranslateUi(this);

+ break;

+ default:

+ break;

+ }

+}

+

+void Dialog::tabChanged(int index)

+{

+#ifdef QTM_EXAMPLES_SMALL_SCREEN

+ switch(index) {

+ case 0:

+ setupGeneral();

+ break;

+ case 1:

+ setupGeneral();

+ break;

+ case 2:

+ setupDevice();

+ break;

+ case 3:

+ setupDevice();

+ break;

+ case 4:

+ setupDevice();

+ break;

+ case 5:

+ setupDisplay();

+ break;

+ case 6:

+ setupStorage();

+ break;

+ case 7:

+ setupNetwork();

+ break;

+ case 8:

+ setupNetwork();

+ break;

+ case 9:

+ setupNetwork();

+ break;

+ case 10:

+ setupSaver();

+ break;

+ };

+#else

+ switch(index) {

+ case 0:

+ setupGeneral();

+ break;

+ case 1:

+ setupDevice();

+ break;

+ case 2:

+ setupDisplay();

+ break;

+ case 3:

+ setupStorage();

+ break;

+ case 4:

+ setupNetwork();

+ break;

+ case 5:

+ setupSaver();

+ break;

+ };

+#endif

+}

+

+void Dialog::setupGeneral()

+{

+ delete systemInfo;

+//! [lang]

+ systemInfo = new QSystemInfo(this);

+ curLanguageLineEdit->setText( systemInfo->currentLanguage());

+//! [lang]

+ languagesComboBox->clear();

+ languagesComboBox->insertItems(0,systemInfo->availableLanguages());

+ countryCodeLabel->setText(systemInfo->currentCountryCode());

+}

+

+void Dialog::setupDevice()

+{

+ delete di;

+//! [createdi]

+ di = new QSystemDeviceInfo(this);

+//! [createdi]

+//! [batteryLevel]

+ batteryLevelBar->setValue(di->batteryLevel());

+//! [batteryLevel]

+

+//! [sig batteryLevelChanged]

+ connect(di,SIGNAL(batteryLevelChanged(int)),

+ this,SLOT(updateBatteryStatus(int)));

+//! [sig batteryLevelChanged]

+

+ connect(di,SIGNAL(batteryStatusChanged(QSystemDeviceInfo::BatteryStatus)),

+ this,SLOT(displayBatteryStatus(QSystemDeviceInfo::BatteryStatus)));

+

+ connect(di,SIGNAL(powerStateChanged(QSystemDeviceInfo::PowerState)),

+ this,SLOT(updatePowerState(QSystemDeviceInfo::PowerState)));

+

+ ImeiLabel->setText(di->imei());

+ imsiLabel->setText(di->imsi());

+//! [manuf-id]

+ manufacturerLabel->setText(di->manufacturer());

+//! [manuf-id]

+ modelLabel->setText(di->model());

+//! [productName]

+ productLabel->setText(di->productName());

+//! [productName]

+

+ deviceLockPushButton->setChecked(di->isDeviceLocked());

+

+ updateSimStatus();

+ updateProfile();

+

+ connect(di, SIGNAL(currentProfileChanged(QSystemDeviceInfo::Profile)),

+ this, SLOT(updateProfile(QSystemDeviceInfo::Profile)));

+

+ if(di->currentPowerState() == QSystemDeviceInfo::BatteryPower) {

+ radioButton_2->setChecked(true);

+ } else if(di->currentPowerState() == QSystemDeviceInfo::WallPower) {

+ radioButton_3->setChecked(true);

+ } else if(di->currentPowerState() == QSystemDeviceInfo::WallPowerChargingBattery) {

+ radioButton_4->setChecked(true);

+ } else {

+ radioButton->setChecked(true);

+ }

+

+//! [inputMethod flags]

+ QSystemDeviceInfo::InputMethodFlags methods = di->inputMethodType();

+ QStringList inputs;

+ if((methods & QSystemDeviceInfo::Keys)){

+ inputs << "Keys";

+ }

+ if((methods & QSystemDeviceInfo::Keypad)) {

+ inputs << "Keypad";

+ }

+//! [inputMethod flags]

+ if((methods & QSystemDeviceInfo::Keyboard)) {

+ inputs << "Keyboard";

+ }

+ if((methods & QSystemDeviceInfo::SingleTouch)) {

+ inputs << "Touch Screen";

+ }

+ if((methods & QSystemDeviceInfo::MultiTouch)) {

+ inputs << "Multi touch";

+ }

+ if((methods & QSystemDeviceInfo::Mouse)){

+ inputs << "Mouse";

+ }

+

+ inputMethodLabel->setText(inputs.join(" "));

+}

+

+void Dialog::updateDeviceLockedState()

+{

+ if (di)

+ deviceLockPushButton->setChecked(di->isDeviceLocked());

+}

+

+void Dialog::updateProfile(QSystemDeviceInfo::Profile /*profile*/)

+{

+ updateProfile();

+}

+

+

+void Dialog::setupDisplay()

+{

+ QSystemDisplayInfo di;

+ brightnessLineEdit->setText(QString::number(di.displayBrightness(0)));

+ colorDepthLineEdit->setText(QString::number(di.colorDepth((0))));

+

+}

+

+void Dialog::setupStorage()

+{

+ QSystemStorageInfo mi;

+ storageTreeWidget->clear();

+ storageTreeWidget->header()->setResizeMode(QHeaderView::ResizeToContents);

+

+ QStringList vols = mi.logicalDrives();

+ foreach(QString volName, vols) {

+ QString type;

+ QSystemStorageInfo::DriveType volType;

+ volType = mi.typeForDrive(volName);

+ if(volType == QSystemStorageInfo::InternalDrive) {

+ type = "Internal";

+ }

+

+ if(volType == QSystemStorageInfo::RemovableDrive) {

+ type = "Removable";

+ }

+ if(volType == QSystemStorageInfo::CdromDrive) {

+ type = "Cdrom";

+ }

+ if(volType == QSystemStorageInfo::RemoteDrive) {

+ type = "Network";

+ }

+ QStringList items;

+ items << volName;

+ items << type;

+ items << QString::number(mi.totalDiskSpace(volName));

+ items << QString::number(mi.availableDiskSpace(volName));

+ QTreeWidgetItem *item = new QTreeWidgetItem(items);

+ storageTreeWidget->addTopLevelItem(item);

+ }

+}

+

+void Dialog::setupNetwork()

+{

+ delete ni;

+//! [networkInfo]

+ ni = new QSystemNetworkInfo(this);

+//! [networkInfo]

+

+ connect(netStatusComboBox,SIGNAL(activated(int)),

+ this, SLOT(netStatusComboActivated(int)));

+

+//! [sig strength]

+ connect(ni,SIGNAL(networkSignalStrengthChanged(QSystemNetworkInfo::NetworkMode, int)),

+ this,SLOT(networkSignalStrengthChanged(QSystemNetworkInfo::NetworkMode,int)));

+//! [sig strength]

+

+ connect(ni,SIGNAL(networkNameChanged(QSystemNetworkInfo::NetworkMode,QString)),

+ this,SLOT(networkNameChanged(QSystemNetworkInfo::NetworkMode,QString)));

+

+ connect(ni,SIGNAL(networkStatusChanged(QSystemNetworkInfo::NetworkMode,QSystemNetworkInfo::NetworkStatus)),

+ this,SLOT(networkStatusChanged(QSystemNetworkInfo::NetworkMode,QSystemNetworkInfo::NetworkStatus)));

+

+ connect(ni,SIGNAL(networkModeChanged(QSystemNetworkInfo::NetworkMode)),

+ this,SLOT(networkModeChanged(QSystemNetworkInfo::NetworkMode)));

+

+ cellIdLabel->setText(QString::number(ni->cellId()));

+ locationAreaCodeLabel->setText(QString::number(ni->locationAreaCode()));

+ currentMMCLabel->setText(ni->currentMobileCountryCode());

+ currentMNCLabel->setText(ni->currentMobileNetworkCode());

+

+ homeMMCLabel->setText(ni->homeMobileCountryCode());

+ homeMNCLabel->setText(ni->homeMobileNetworkCode());

+

+ networkModeChanged(ni->currentMode());

+

+}

+void Dialog::netStatusComboActivated(int index)

+{

+ QString status;

+ int reIndex = index;

+

+ displayNetworkStatus(ni->networkStatus((QSystemNetworkInfo::NetworkMode)reIndex));

+

+ macAddressLabel->setText(ni->macAddress((QSystemNetworkInfo::NetworkMode)reIndex));

+

+ int strength = ni->networkSignalStrength((QSystemNetworkInfo::NetworkMode)reIndex);

+ if(strength < 0)

+ strength = 0;

+ signalLevelProgressBar->setValue(strength);

+

+ InterfaceLabel->setText(ni->interfaceForMode((QSystemNetworkInfo::NetworkMode)reIndex).humanReadableName());

+

+ operatorNameLabel->setText(ni->networkName((QSystemNetworkInfo::NetworkMode)reIndex));

+}

+

+void Dialog::getVersion(int index)

+{

+ QSystemInfo::Version version;

+ switch(index) {

+ case 0:

+ versionLineEdit->setText("");

+ break;

+ case 1:

+//! [OS ver]

+ version = QSystemInfo::Os;

+//! [OS ver]

+ break;

+ case 2:

+//! [Qt ver]

+ version = QSystemInfo::QtCore;

+//! [Qt ver]

+ break;

+ case 3:

+//! [Firm ver]

+ version = QSystemInfo::Firmware;

+//! [Firm ver]

+ break;

+ };

+

+ QSystemInfo si;

+ versionLineEdit->setText(si.version(version));

+}

+

+void Dialog::getFeature(int index)

+{

+//! [feature]

+ QSystemInfo::Feature feature;

+ switch(index) {

+//! [feature]

+ case 0:

+ return;

+ break;

+//! [feature-bluetooth]

+ case 1:

+ feature = QSystemInfo::BluetoothFeature;

+//! [feature-bluetooth]

+ break;

+ case 2:

+ feature = QSystemInfo::CameraFeature;

+ break;

+ case 3:

+ feature = QSystemInfo::FmradioFeature;

+ break;

+ case 4:

+ feature = QSystemInfo::IrFeature;

+ break;

+ case 5:

+ feature = QSystemInfo::LedFeature;

+ break;

+ case 6:

+ feature = QSystemInfo::MemcardFeature;

+ break;

+ case 7:

+ feature = QSystemInfo::UsbFeature;

+ break;

+ case 8:

+ feature = QSystemInfo::VibFeature;

+ break;

+ case 9:

+ feature = QSystemInfo::WlanFeature;

+ break;

+ case 10:

+ feature = QSystemInfo::SimFeature;

+ break;

+ case 11:

+ feature = QSystemInfo::LocationFeature;

+ break;

+ case 12:

+ feature = QSystemInfo::VideoOutFeature;

+ break;

+ case 13:

+ feature = QSystemInfo::HapticsFeature;

+ break;

+ };

+//! [feature test]

+ QSystemInfo si;

+ featuresLineEdit->setText((si.hasFeatureSupported(feature) ? "true":"false" ));

+//! [feature test]

+}

+

+void Dialog::setupSaver()

+{

+ if (!saver) {

+ saver = new QSystemScreenSaver(this);

+ }

+

+ bool saverEnabled = saver->screenSaverInhibited();

+

+

+ connect( saverInhibitedCheckBox, SIGNAL(clicked(bool)),

+ this,SLOT(setSaverEnabled(bool)));

+

+ saverInhibitedCheckBox->setChecked(saverEnabled);

+}

+

+

+void Dialog::setSaverEnabled(bool b)

+{

+ if (b) {

+ if (!saver) {

+ saver = new QSystemScreenSaver(this);

+ }

+ if(saver->setScreenSaverInhibit()) {

+ }

+ } else {

+ delete saver;

+ saver = NULL;

+ }

+}

+

+

+void Dialog::updateBatteryStatus(int level)

+{

+ batteryLevelBar->setValue(level);

+}

+

+void Dialog::updatePowerState(QSystemDeviceInfo::PowerState newState)

+{

+

+ switch (newState) {

+ case QSystemDeviceInfo::BatteryPower:

+ {

+ radioButton_2->setChecked(true);

+ }

+ break;

+ case QSystemDeviceInfo::WallPower:

+ {

+ radioButton_3->setChecked(true);

+ }

+ break;

+ case QSystemDeviceInfo::WallPowerChargingBattery:

+ {

+ radioButton_4->setChecked(true);

+ }

+ break;

+ case QSystemDeviceInfo::NoBatteryLevel:

+ {

+ radioButton->setChecked(true);

+ }

+ break;

+ };

+}

+

+void Dialog::displayBatteryStatus(QSystemDeviceInfo::BatteryStatus status)

+{

+ // this wont annoy users will it?

+ QString msg;

+// if(di->isBatteryCharging()) {

+ switch(status) {

+ case QSystemDeviceInfo::BatteryCritical:

+ {

+ msg = " Battery is Critical (4% or less), please save your work or plug in the charger.";

+ QMessageBox::critical(this,"QSystemInfo",msg);

+ }

+ break;

+ case QSystemDeviceInfo::BatteryVeryLow:

+ {

+ msg = "Battery is Very Low (10%), please plug in the charger soon";

+ QMessageBox::warning(this,"QSystemInfo",msg);

+ }

+ break;

+ case QSystemDeviceInfo::BatteryLow:

+ {

+ msg = "Battery is Low (40% or less)";

+ QMessageBox::information(this,"QSystemInfo",msg);

+

+ }

+ break;

+ case QSystemDeviceInfo::BatteryNormal:

+ {

+ msg = "Battery is Normal (greater than 40%)";

+ QMessageBox::information(this,"QSystemInfo",msg);

+ }

+ break;

+ case QSystemDeviceInfo::NoBatteryLevel:

+ {

+

+ }

+ break;

+ };

+ // }

+

+}

+

+void Dialog::networkSignalStrengthChanged(QSystemNetworkInfo::NetworkMode mode , int strength)

+{

+ if(mode == QSystemNetworkInfo::WlanMode) {

+ if(netStatusComboBox->currentText() == "Wlan") {

+ signalLevelProgressBar->setValue(strength);

+ }

+ }

+

+ if(mode == QSystemNetworkInfo::EthernetMode) {

+ if(netStatusComboBox->currentText() == "Ethernet") {

+ signalLevelProgressBar->setValue(strength);

+ }

+ }

+

+ if(mode == QSystemNetworkInfo::GsmMode) {

+ if(netStatusComboBox->currentText() == "Gsm") {

+ signalLevelProgressBar->setValue(strength);

+ }

+ }

+

+ if(mode == QSystemNetworkInfo::CdmaMode) {

+ if(netStatusComboBox->currentText() == "Cdma") {

+ signalLevelProgressBar->setValue(strength);

+ }

+ }

+

+ if(mode == QSystemNetworkInfo::WcdmaMode) {

+ if(netStatusComboBox->currentText() == "Wcdma") {

+ signalLevelProgressBar->setValue(strength);

+ }

+ }

+

+}

+

+void Dialog::networkNameChanged(QSystemNetworkInfo::NetworkMode mode,const QString &text)

+{

+ if(mode == QSystemNetworkInfo::WlanMode) {

+ if(netStatusComboBox->currentText() == "Wlan") {

+ operatorNameLabel->setText(text);

+ }

+ }

+

+ if(mode == QSystemNetworkInfo::EthernetMode) {

+ if(netStatusComboBox->currentText() == "Ethernet") {

+ operatorNameLabel->setText(text);

+ }

+ }

+

+ if(mode == QSystemNetworkInfo::GsmMode) {

+ if(netStatusComboBox->currentText() == "Gsm") {

+ operatorNameLabel->setText(text);

+ }

+ }

+

+ if(mode == QSystemNetworkInfo::CdmaMode) {

+ if(netStatusComboBox->currentText() == "Cdma") {

+ operatorNameLabel->setText(text);

+ }

+ }

+

+ if(mode == QSystemNetworkInfo::WcdmaMode) {

+ if(netStatusComboBox->currentText() == "Wcdma") {

+ operatorNameLabel->setText(text);

+ }

+ }

+

+}

+

+void Dialog::networkStatusChanged(QSystemNetworkInfo::NetworkMode mode , QSystemNetworkInfo::NetworkStatus status)

+{

+ if(mode == QSystemNetworkInfo::WlanMode) {

+ if(netStatusComboBox->currentText() == "Wlan") {

+ displayNetworkStatus(status);

+ }

+ }

+

+ if(mode == QSystemNetworkInfo::EthernetMode) {

+ if(netStatusComboBox->currentText() == "Ethernet") {

+ displayNetworkStatus(status);

+ }

+ }

+

+ if(mode == QSystemNetworkInfo::GsmMode) {

+ if(netStatusComboBox->currentText() == "Gsm") {

+ displayNetworkStatus(status);

+ }

+ }

+

+ if(mode == QSystemNetworkInfo::CdmaMode) {

+ if(netStatusComboBox->currentText() == "Cdma") {

+ displayNetworkStatus(status);

+ }

+ }

+

+ if(mode == QSystemNetworkInfo::WcdmaMode) {

+ if(netStatusComboBox->currentText() == "Wcdma") {

+ displayNetworkStatus(status);

+ }

+ }

+

+}

+

+void Dialog::networkModeChanged(QSystemNetworkInfo::NetworkMode mode)

+{

+ if(mode == QSystemNetworkInfo::WlanMode) {

+ primaryModeLabel->setText("Wlan");

+ }

+

+ if(mode == QSystemNetworkInfo::EthernetMode) {

+ primaryModeLabel->setText("Ethernet");

+ }

+

+ if(mode == QSystemNetworkInfo::GsmMode) {

+ primaryModeLabel->setText("Gsm");

+ }

+

+ if(mode == QSystemNetworkInfo::CdmaMode) {

+ primaryModeLabel->setText("Cdma");

+ }

+

+ if(mode == QSystemNetworkInfo::WcdmaMode) {

+ primaryModeLabel->setText("Wcdma");

+ }

+ if(mode == QSystemNetworkInfo::UnknownMode) {

+ primaryModeLabel->setText("None");

+ }

+}

+

+

+void Dialog::displayNetworkStatus(QSystemNetworkInfo::NetworkStatus status)

+{

+ QString stat;

+ switch(status) {

+ case QSystemNetworkInfo::UndefinedStatus:

+ stat = "Undefined";

+ break;

+ case QSystemNetworkInfo::NoNetworkAvailable:

+ stat = "No Network Available";

+ break;

+ case QSystemNetworkInfo::EmergencyOnly:

+ stat = "Emergency Only";

+ break;

+ case QSystemNetworkInfo::Searching:

+ stat = "Searching or Connecting";

+ break;

+ case QSystemNetworkInfo::Busy:

+ stat = "Busy";

+ break;

+ case QSystemNetworkInfo::Connected:

+ stat = "Connected";

+ break;

+ case QSystemNetworkInfo::HomeNetwork:

+ stat = "Home Network";

+ break;

+ case QSystemNetworkInfo::Denied:

+ stat = "Denied";

+ break;

+ case QSystemNetworkInfo::Roaming:

+ stat = "Roaming";

+ break;

+ };

+ cellNetworkStatusLabel->setText(stat);

+}

+

+void Dialog::updateProfile()

+{

+ if(di) {

+ QString profilestring;

+ switch(di->currentProfile()) {

+ case QSystemDeviceInfo::UnknownProfile:

+ {

+ profilestring = "Unknown";

+ }

+ break;

+ case QSystemDeviceInfo::SilentProfile:

+ {

+ profilestring = "Silent";

+ }

+ break;

+ case QSystemDeviceInfo::NormalProfile:

+ {

+ profilestring = "Normal";

+ }

+ break;

+ case QSystemDeviceInfo::LoudProfile:

+ {

+ profilestring = "Loud";

+ }

+ break;

+ case QSystemDeviceInfo::VibProfile:

+ {

+ profilestring = "Vibrate";

+ }

+ break;

+ case QSystemDeviceInfo::OfflineProfile:

+ {

+ profilestring = "Offline";

+ }

+ break;

+ case QSystemDeviceInfo::PowersaveProfile:

+ {

+ profilestring = "Powersave";

+ }

+ break;

+ case QSystemDeviceInfo::CustomProfile:

+ {

+ profilestring = "custom";

+ }

+ break;

+ };

+ profileLabel->setText(profilestring);

+ }

+}

+

+

+void Dialog::updateSimStatus()

+{

+ if(di) {

+ QString simstring;

+ switch(di->simStatus()) {

+ case QSystemDeviceInfo::SimLocked:

+ {

+ simstring = "Sim Locked";

+ }

+ break;

+ case QSystemDeviceInfo::SimNotAvailable:

+ {

+ simstring = "Sim not available";

+ }

+ break;

+ case QSystemDeviceInfo::SingleSimAvailable:

+ {

+ simstring = "Single Sim Available";

+

+ }

+ break;

+ case QSystemDeviceInfo::DualSimAvailable:

+ {

+ simstring = "Dual Sim available";

+ }

+ break;

+

+ };

+ simStatusLabel->setText(simstring);

+ }

+}

+

+

+/****************************************************************************

+**

+** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).

+** All rights reserved.

+** Contact: Nokia Corporation (qt-info@nokia.com)

+**

+** This file is part of the Qt Mobility Components.

+**

+** $QT_BEGIN_LICENSE:LGPL$

+** No Commercial Usage

+** This file contains pre-release code and may not be distributed.

+** You may use this file in accordance with the terms and conditions

+** contained in the Technology Preview License Agreement accompanying

+** this package.

+**

+** GNU Lesser General Public License Usage

+** Alternatively, 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.

+**

+** If you have questions regarding the use of this file, please contact

+** Nokia at qt-info@nokia.com.

+**

+**

+**

+**

+**

+**

+**

+**

+** $QT_END_LICENSE$

+**

+****************************************************************************/

+

+#ifndef DIALOG_H

+#define DIALOG_H

+

+#include <QWidget>

+#include <qsysteminfo.h>

+

+#ifdef QTM_EXAMPLES_PREFER_LANDSCAPE

+#include "ui_dialog_landscape.h"

+#else //QTM_EXAMPLES_PREFER_LANDSCAPE

+#ifdef Q_OS_SYMBIAN

+#include "ui_dialog_s60.h"

+#else //Q_OS_SYMBIAN

+#include "ui_dialog.h"

+#endif //Q_OS_SYMBIAN

+#endif //QTM_EXAMPLES_PREFER_LANDSCAPE

+QTM_USE_NAMESPACE

+

+class Dialog : public QWidget, public Ui_Dialog

+{

+ Q_OBJECT

+public:

+ Dialog();

+ ~Dialog();

+

+protected:

+ void changeEvent(QEvent *e);

+

+private:

+ void setupGeneral();

+ void setupDevice();

+ void setupDisplay();

+ void setupStorage();

+ void setupNetwork();

+ void setupSaver();

+

+ QSystemScreenSaver *saver;

+ QSystemInfo *systemInfo;

+ QSystemDeviceInfo *di;

+ QSystemNetworkInfo *ni;

+

+private slots:

+ void tabChanged(int index);

+ void getVersion(int index);

+ void getFeature(int index);

+ void setSaverEnabled(bool b);

+ void updateDeviceLockedState();

+

+ void netStatusComboActivated(int);

+ void updateBatteryStatus(int);

+ void updatePowerState(QSystemDeviceInfo::PowerState);

+ void displayBatteryStatus(QSystemDeviceInfo::BatteryStatus);

+ void updateProfile(QSystemDeviceInfo::Profile profile);

+ void updateSimStatus();

+ void updateProfile();

+

+ void displayNetworkStatus(QSystemNetworkInfo::NetworkStatus);

+ void networkStatusChanged(QSystemNetworkInfo::NetworkMode, QSystemNetworkInfo::NetworkStatus);

+ void networkSignalStrengthChanged(QSystemNetworkInfo::NetworkMode, int);

+ void networkNameChanged(QSystemNetworkInfo::NetworkMode,const QString &);

+ void networkModeChanged(QSystemNetworkInfo::NetworkMode);

+

+};

+

+#endif // DIALOG_H

+/****************************************************************************

+**

+** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).

+** All rights reserved.

+** Contact: Nokia Corporation (qt-info@nokia.com)

+**

+** This file is part of the Qt Mobility Components.

+**

+** $QT_BEGIN_LICENSE:LGPL$

+** No Commercial Usage

+** This file contains pre-release code and may not be distributed.

+** You may use this file in accordance with the terms and conditions

+** contained in the Technology Preview License Agreement accompanying

+** this package.

+**

+** GNU Lesser General Public License Usage

+** Alternatively, 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.

+**

+** If you have questions regarding the use of this file, please contact

+** Nokia at qt-info@nokia.com.

+**

+**

+**

+**

+**

+**

+**

+**

+** $QT_END_LICENSE$

+**

+****************************************************************************/

+

+#include <QtGui/QApplication>

+#include "dialog.h"

+

+int main(int argc, char *argv[])

+{

+ QApplication a(argc, argv);

+ Dialog w;

+

+#ifdef Q_OS_SYMBIAN

+ w.showMaximized();

+#else

+ w.show();

+#endif

+

+ return a.exec();

+}

+The QtMobility APIs are placed into the \i{QtMobility} namespace. This is done

+to facilitate the future migration of Mobility APIs into Qt. See the

+\section1 Main Classes