summaryrefslogtreecommitdiffstats
path: root/doc/src/examples/sysinfo.qdoc
blob: f86db956f46ded8e15e704792193f462a93740e7 (plain)
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
/****************************************************************************
**
** Copyright (C) 2012 Digia Plc and/or its subsidiary(-ies).
** Contact: http://www.qt-project.org/legal
**
** This file is part of the documentation of the Qt Toolkit.
**
** $QT_BEGIN_LICENSE:FDL$
** Commercial License Usage
** Licensees holding valid commercial Qt licenses may use this file in
** accordance with the commercial license agreement provided with the
** Software or, alternatively, in accordance with the terms contained in
** a written agreement between you and Digia.  For licensing terms and
** conditions see http://qt.digia.com/licensing.  For further information
** use the contact form at http://qt.digia.com/contact-us.
**
** GNU Free Documentation License Usage
** 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.  Please review the following information to ensure
** the GNU Free Documentation License version 1.3 requirements
** will be met: http://www.gnu.org/copyleft/fdl.html.
** $QT_END_LICENSE$
**
****************************************************************************/

/*!
    \example sysinfo
    \title System Information Example


    \image sysinfo.png


    The System Information example uses a tabbed dialog, with each tab
    representing a particular type of data: versions, network and so on.

    To access the information, the example creates objects belonging to the System Information classes

    \annotatedlist systeminfo

    Here are some examples that show how the example application reads the
    device information.

    The current language

    \snippet ../../examples/sysinfo/dialog.cpp  lang

    Device information, starting with the battery level

    \snippet ../../examples/sysinfo/dialog.cpp  batterystatus1

    \dots

    \snippet ../../examples/sysinfo/dialog.cpp  batterystatus2

    The battery status is an enum, \l {QSystemBatteryInfo::BatteryStatus}, that indicates
    various battery levels and their significance, e.g., QSystemBatteryInfo::BatteryVeryLow.

    The manufacturer id and the product name

    \snippet ../../examples/sysinfo/dialog.cpp  manuf-id
    \dots
    \snippet ../../examples/sysinfo/dialog.cpp  productName

    Other information is stored as bitwise flags. The following code shows
    the input methods being determined using flags.

    \snippet ../../examples/sysinfo/dialog.cpp  inputMethod flags

    Various capabilities of the device can be found by testing for features.
    In the example a Feature combo box, on the General tab, has a hard coded
    list of features. When a listed feature is selected the getFeature()
    function is called with the index which is handled by applying a test to
    the corresponding feature.

    \snippet ../../examples/sysinfo/dialog.cpp  feature
    \dots
    \snippet ../../examples/sysinfo/dialog.cpp  feature-bluetooth
    \dots
    \snippet ../../examples/sysinfo/dialog.cpp  feature test


*/