1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
|
/****************************************************************************
**
** Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies).
** All rights reserved.
** Contact: Nokia Corporation (qt-info@nokia.com)
**
** This file is part of the documentation of the Qt Toolkit.
**
** $QT_BEGIN_LICENSE:FDL$
** 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 Free Documentation License
** Alternatively, this file may be used under the terms of the GNU Free
** Documentation License version 1.3 as published by the Free Software
** Foundation and appearing in the file included in the packaging of this
** file.
**
** If you have questions regarding the use of this file, please contact
** Nokia at qt-info@nokia.com.
** $QT_END_LICENSE$
**
****************************************************************************/
/*!
\group systeminfo
\title System Information Classes
A set of APIs that supplies that supplies system information.
*/
/*!
\page systeminfo.html
\title System Information
\brief A set of APIs to discover system related information and capabilities.
\ingroup mobility
\tableofcontents
\section1 Namespace
The QtMobility APIs are placed into the \i{QtMobility} namespace. This is done
to facilitate the future migration of QtMobility APIs into Qt. See the
\l {Quickstart guide} for an example on how the
namespace impacts on application development.
\annotatedlist systeminfo
\section1 System Information
The System Information API provides a set of APIs to discover system
related information and capabilities.
\section1 Overview
The System Information API returns the system information related to a
number of categories.
\section2 Information Categories
\section3 \bold{Version}
Contains version information for a range of supporting software on the
device. For example, from the Operating System and Firmware to the version
of WebKit, Qt and the Service Framework.
\section3 \bold{Features (hardware)}
This lists the supported hardware on the device. Features include items
such as the camera, bluetooth, GPS, FM radio etc.
\section3 \bold{Network}
The state of the network connection, and also the type of network e.g.
gsm, cdma, ethernet etc.
\section3 \bold{Display Information}
This provides height, width, contrast, and other information of the display.
\section3 \bold{Storage Information}
The presence of various storage devices. Including: none, internal,
removable, cdrom.
\section3 \bold{Device Information}
\list
\o Battery Status
\o Power State
\o Profile (silent, vibrating, normal etc)
\o Sim
\o Input Method (key/buttons, keypad, qwerty, single touch screen,
multitouch etc)
\endlist
\section3 \bold{Screensaver}
This provides the access to the information of the screen saver.
\section1 Building and compiling
To build the library, run \tt configure and \tt make.
Linux supports a NetworkManager based backend and generic backend using
QNetworkInterface only. By default the generic backend is selected.
If the NetworkManager backend is required run qmake as follows:
\code
qmake BACKEND=NetworkManager
\endcode
The backend selection is expected to disappear once the API is integrated into Qt.
\section1 Main Classes
\annotatedlist systeminfo
\section1 QML Elements
The Qt SystemInfo offers access to system information through declarative
UI by providing systeminfo elements. Detailed information can be found
at \l{QML System Information Plugin}.
\annotatedlist qml-systeminfo
\section1 Examples
\section2 System Information Example
The \l{sysinfo}{System Information} example demonstrates how an application can very easily access the system information of the device.
\section2 System Information QML Example
The System Info QML example demonstrates how an application can very easily access the system information of the device.
*/
|
