Sophie

Sophie

distrib > Mageia > 5 > i586 > media > core-release > by-pkgid > 50facae208d4a6f280e44a513b104320 > files > 1925

qt-mobility-doc-1.2.0-13.mga5.noarch.rpm

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en_US" lang="en_US">
<head>
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<!-- si.qdoc -->
  <title>Qt Mobility 1.2: System Information</title>
  <link rel="stylesheet" type="text/css" href="style/offline.css" />
</head>
<body>
<div class="header" id="qtdocheader">
  <div class="content"> 
    <a href="index.html" class="qtref"><span>QtMobility Reference Documentation</span></a>
  </div>
  <div class="breadcrumb toolblock">
    <ul>
      <li class="first"><a href="index.html">Home</a></li>
      <!--  Breadcrumbs go here -->
<li>System Information</li>
    </ul>
  </div>
</div>
<div class="content mainContent">
<div class="toc">
<h3><a name="toc">Contents</a></h3>
<ul>
<li class="level1"><a href="#namespace">Namespace</a></li>
<li class="level1"><a href="#system-information">System Information</a></li>
<li class="level1"><a href="#overview">Overview</a></li>
<li class="level2"><a href="#information-categories">Information Categories</a></li>
<li class="level3"><a href="#version">Version</a></li>
<li class="level3"><a href="#features-hardware">Features (hardware)</a></li>
<li class="level3"><a href="#network">Network</a></li>
<li class="level3"><a href="#display-information">Display Information</a></li>
<li class="level3"><a href="#storage-information">Storage Information</a></li>
<li class="level3"><a href="#device-information">Device Information</a></li>
<li class="level3"><a href="#screensaver">Screensaver</a></li>
<li class="level1"><a href="#building-and-compiling">Building and compiling</a></li>
<li class="level1"><a href="#main-classes">Main Classes</a></li>
<li class="level1"><a href="#qml-elements">QML Elements</a></li>
<li class="level1"><a href="#examples">Examples</a></li>
<li class="level2"><a href="#system-information-example">System Information Example</a></li>
<li class="level2"><a href="#system-information-qml-example">System Information QML Example</a></li>
</ul>
</div>
<h1 class="title">System Information</h1>
<span class="subtitle"></span>
<!-- $$$systeminfo.html-description -->
<div class="descr"> <a name="details"></a>
<a name="namespace"></a>
<h2>Namespace</h2>
<p>The QtMobility APIs are placed into the <i>QtMobility</i> namespace. This is done to facilitate the future migration of QtMobility APIs into Qt. See the <a href="quickstart.html">Quickstart guide</a> for an example on how the namespace impacts on application development.</p>
<table class="annotated">
<tr class="odd topAlign"><td class="tblName"><p><a href="qsystemdeviceinfo-profiledetails.html">QSystemDeviceInfo::ProfileDetails</a></p></td><td class="tblDescr"><p>Access to details of the currently active phone profile</p></td></tr>
<tr class="even topAlign"><td class="tblName"><p><a href="qsystemalignedtimer.html">QSystemAlignedTimer</a></p></td><td class="tblDescr"><p>Service for applications to synchronize their activity</p></td></tr>
<tr class="odd topAlign"><td class="tblName"><p><a href="qsystembatteryinfo.html">QSystemBatteryInfo</a></p></td><td class="tblDescr"><p>Access to battery and power information from the system</p></td></tr>
<tr class="even topAlign"><td class="tblName"><p><a href="qsystemdeviceinfo.html">QSystemDeviceInfo</a></p></td><td class="tblDescr"><p>Access to device information from the system</p></td></tr>
<tr class="odd topAlign"><td class="tblName"><p><a href="qsystemdisplayinfo.html">QSystemDisplayInfo</a></p></td><td class="tblDescr"><p>Access to display information from the system</p></td></tr>
<tr class="even topAlign"><td class="tblName"><p><a href="qsysteminfo.html">QSystemInfo</a></p></td><td class="tblDescr"><p>Access to various general information from the system</p></td></tr>
<tr class="odd topAlign"><td class="tblName"><p><a href="qsystemnetworkinfo.html">QSystemNetworkInfo</a></p></td><td class="tblDescr"><p>Access to various networking status and signals</p></td></tr>
<tr class="even topAlign"><td class="tblName"><p><a href="qsystemscreensaver.html">QSystemScreenSaver</a></p></td><td class="tblDescr"><p>Access to screen saver and blanking</p></td></tr>
<tr class="odd topAlign"><td class="tblName"><p><a href="qsystemstorageinfo.html">QSystemStorageInfo</a></p></td><td class="tblDescr"><p>Access to disk storage information from the system</p></td></tr>
</table>
<a name="system-information"></a>
<h2>System Information</h2>
<p>The System Information API provides a set of APIs to discover system related information and capabilities.</p>
<a name="overview"></a>
<h2>Overview</h2>
<p>The System Information API returns the system information related to a number of categories.</p>
<a name="information-categories"></a>
<h3>Information Categories</h3>
<a name="version"></a>
<h4>Version</h4>
<p>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.</p>
<a name="features-hardware"></a>
<h4>Features (hardware)</h4>
<p>This lists the supported hardware on the device. Features include items such as the camera, bluetooth, GPS, FM radio etc.</p>
<a name="network"></a>
<h4>Network</h4>
<p>The state of the network connection, and also the type of network e.g&#x2e; gsm, cdma, ethernet etc.</p>
<a name="display-information"></a>
<h4>Display Information</h4>
<p>This provides height, width, contrast, and other information of the display.</p>
<a name="storage-information"></a>
<h4>Storage Information</h4>
<p>The presence of various storage devices. Including: none, internal, removable, cdrom.</p>
<a name="device-information"></a>
<h4>Device Information</h4>
<ul>
<li>Battery Status</li>
<li>Power State</li>
<li>Profile (silent, vibrating, normal etc)</li>
<li>Sim</li>
<li>Input Method (key/buttons, keypad, qwerty, single touch screen, multitouch etc)</li>
</ul>
<a name="screensaver"></a>
<h4>Screensaver</h4>
<p>This provides the access to the information of the screen saver.</p>
<a name="building-and-compiling"></a>
<h2>Building and compiling</h2>
<p>To build the library, run <tt>configure</tt> and <tt>make</tt>.</p>
<p>Linux supports a NetworkManager based backend and generic backend using <a href="http://qt.nokia.com/doc/4.7/qnetworkinterface.html">QNetworkInterface</a> only. By default the generic backend is selected. If the NetworkManager backend is required run qmake as follows:</p>
<pre class="cpp"> qmake BACKEND<span class="operator">=</span>NetworkManager</pre>
<p>The backend selection is expected to disappear once the API is integrated into Qt.</p>
<a name="main-classes"></a>
<h2>Main Classes</h2>
<table class="annotated">
<tr class="odd topAlign"><td class="tblName"><p><a href="qsystemdeviceinfo-profiledetails.html">QSystemDeviceInfo::ProfileDetails</a></p></td><td class="tblDescr"><p>Access to details of the currently active phone profile</p></td></tr>
<tr class="even topAlign"><td class="tblName"><p><a href="qsystemalignedtimer.html">QSystemAlignedTimer</a></p></td><td class="tblDescr"><p>Service for applications to synchronize their activity</p></td></tr>
<tr class="odd topAlign"><td class="tblName"><p><a href="qsystembatteryinfo.html">QSystemBatteryInfo</a></p></td><td class="tblDescr"><p>Access to battery and power information from the system</p></td></tr>
<tr class="even topAlign"><td class="tblName"><p><a href="qsystemdeviceinfo.html">QSystemDeviceInfo</a></p></td><td class="tblDescr"><p>Access to device information from the system</p></td></tr>
<tr class="odd topAlign"><td class="tblName"><p><a href="qsystemdisplayinfo.html">QSystemDisplayInfo</a></p></td><td class="tblDescr"><p>Access to display information from the system</p></td></tr>
<tr class="even topAlign"><td class="tblName"><p><a href="qsysteminfo.html">QSystemInfo</a></p></td><td class="tblDescr"><p>Access to various general information from the system</p></td></tr>
<tr class="odd topAlign"><td class="tblName"><p><a href="qsystemnetworkinfo.html">QSystemNetworkInfo</a></p></td><td class="tblDescr"><p>Access to various networking status and signals</p></td></tr>
<tr class="even topAlign"><td class="tblName"><p><a href="qsystemscreensaver.html">QSystemScreenSaver</a></p></td><td class="tblDescr"><p>Access to screen saver and blanking</p></td></tr>
<tr class="odd topAlign"><td class="tblName"><p><a href="qsystemstorageinfo.html">QSystemStorageInfo</a></p></td><td class="tblDescr"><p>Access to disk storage information from the system</p></td></tr>
</table>
<a name="qml-elements"></a>
<h2>QML Elements</h2>
<p>The Qt SystemInfo offers access to system information through declarative UI by providing systeminfo elements. Detailed information can be found at QML SystemInfo QML Plugin.</p>
<table class="annotated">
<tr class="odd topAlign"><td class="tblName"><p><a href="qml-alignedtimer.html">QML AlignedTimer Element</a></p></td><td class="tblDescr"><p>The AlignedTimer element allows applications to synchronize activity, such as network access, like checking for updates.</p></td></tr>
<tr class="even topAlign"><td class="tblName"><p><a href="qml-batteryinfo.html">QML BatteryInfo Element</a></p></td><td class="tblDescr"><p>The BatteryInfo element allows you to receive battery change notifications from the device.</p></td></tr>
<tr class="odd topAlign"><td class="tblName"><p><a href="qml-deviceinfo.html">QML DeviceInfo Element</a></p></td><td class="tblDescr"><p>The DeviceInfo element allows you to access information anbout the device and receive notifications from the device.</p></td></tr>
<tr class="even topAlign"><td class="tblName"><p><a href="qml-displayinfo.html">QML DisplayInfo Element</a></p></td><td class="tblDescr"><p>The DisplayInfo element allows you to get information and receive notifications about the diplsay.</p></td></tr>
<tr class="odd topAlign"><td class="tblName"><p><a href="qml-generalinfo.html">QML GeneralInfo Element</a></p></td><td class="tblDescr"><p>The GeneralInfo element allows you access to general system information and to receive notifications from the device.</p></td></tr>
<tr class="even topAlign"><td class="tblName"><p><a href="qml-networkinfo.html">QML NetworkInfo Element</a></p></td><td class="tblDescr"><p>The NetworkInfo element allows you to get information and receive notifications from the network.</p></td></tr>
<tr class="odd topAlign"><td class="tblName"><p><a href="qml-screensaver.html">QML ScreenSaver Element</a></p></td><td class="tblDescr"><p>The ScreenSaver element allows you to temporarily suppress and delay the screensaver from turning on or blanking the screen.</p></td></tr>
</table>
<a name="examples"></a>
<h2>Examples</h2>
<a name="system-information-example"></a>
<h3>System Information Example</h3>
<p>The <a href="sysinfo.html">System Information</a> example demonstrates how an application can very easily access the system information of the device.</p>
<a name="system-information-qml-example"></a>
<h3>System Information QML Example</h3>
<p>The System Info QML example demonstrates how an application can very easily access the system information of the device.</p>
</div>
<!-- @@@systeminfo.html -->
  <div class="ft">
    <span></span>
  </div>
</div> 
<div class="footer">
  <p>
     <acronym title="Copyright">&copy;</acronym> 2008-2011 Nokia Corporation and/or its
     subsidiaries. Nokia, Qt and their respective logos are trademarks of Nokia Corporation 
     in Finland and/or other countries worldwide.</p>
  <p>
     All other trademarks are property of their respective owners. <a title="Privacy Policy"
     href="http://qt.nokia.com/about/privacy-policy">Privacy Policy</a></p>
  <br />
  <p>
    Licensees holding valid Qt Commercial licenses may use this document in accordance with the    Qt Commercial License Agreement provided with the Software or, alternatively, in accordance    with the terms contained in a written agreement between you and Nokia.</p>
  <p>
    Alternatively, this document may be used under the terms of the <a href="http://www.gnu.org/licenses/fdl.html">GNU
    Free Documentation License version 1.3</a>
    as published by the Free Software Foundation.</p>
</div>
</body>
</html>