Jump to: navigation, search

Latest revision as of 04:23, 11 October 2012

Article Metadata

Code Example

Source file: Media:SystemFeatureInfo.zip

Article

Created: kiran10182 (08 Mar 2010)

Last edited: hamishwillee (11 Oct 2012)

ID		Creation date	8-March-2010
Platform	S60 3rd Edition, FP1, FP2 S60 5th Edition	Tested on devices	Nokia 5800 xPressMusic
Category	Qt	Subcategory	Qt Mobility API

Keywords (APIs, classes, methods, functions): QSystemInfo, QString, QStringList, QButton, QLabel, QComboBox,

Tip: 
 Please read this article before moving forward: Archived:Setting up environment for Qt Mobility API
 Setup Carbide.c++ IDE as explained in this article: Working with Carbide.c++ IDE for Qt Mobility APIs

1 Overview
2 What is covered in QSystemInfo API Part 2
3 Capabilities required
4 UI design (.ui file)
5 Project configuration file (.Pro file)
6 Implementing QSystemInfo API
- 6.1 Header file
- 6.2 Source file
7 Output
8 Useful functions
9 Keywords
- 9.1 Headers
- 9.2 Classes
10 Example Application
11 Related articles
12 Reference links

Overview

This is a part 2 of the QSystemInfo API which is a part of the System Information API from Qt Mobility project.

What is covered in QSystemInfo API Part 2

It is a part of the System Information API.
This article covers information about
- Available features of the device
- Version information of the OS
- Current firmware information of the device

Capabilities required

ReadDeviceData

UI design (.ui file)

Project configuration file (.Pro file)

Add the Qt Mobility project configuration option in the .Pro file as shown below

CONFIG += mobility
MOBILITY += systeminfo

Add Qt-specific configuration options in .pro file as shown below

QT += network

Add required capability in .pro file as shown below:

symbian:TARGET.CAPABILITY = ReadDeviceData

Implementing QSystemInfo API

QSystemInfo API is a part of the QtMobility namespace. So declare the QtMobility namespace as shown below:

using namespace QtMobility;

Header file

#ifndef SYSTEMFEATUREINFO_H
#define SYSTEMFEATUREINFO_H
 
#include <QtGui/QWidget>
#include "ui_SystemFeatureInfo.h"
#include <qsysteminfo.h>
 
using namespace QtMobility;
class SystemFeatureInfo : public QWidget
{
    Q_OBJECT
 
public:
	SystemFeatureInfo(QWidget *parent = 0);
    ~SystemFeatureInfo();
 
public slots:
	void checkFeatureAvailability(int aIndex);
	void listFirmwareInformation();
	void resetAllFields();
 
private:
    Ui::SystemFeatureInfo ui;
    QSystemInfo* sysInfo;
};
 
#endif // SYSTEMFEATUREINFO_H

Source file

#include "SystemFeatureInfo.h"
 
SystemFeatureInfo::SystemFeatureInfo(QWidget *parent)
    : QWidget(parent), sysInfo(NULL)
{
	ui.setupUi(this);
	sysInfo = new QSystemInfo();
 
	QObject::connect(ui.featureComboBox, 
					SIGNAL(currentIndexChanged(int)),
					this, 
					SLOT(checkFeatureAvailability(int)));
	QObject::connect(ui.listVersionInfoButton, 
					SIGNAL(clicked()),
					this, 
					SLOT(listFirmwareInformation()));	
	QObject::connect(ui.resetButton, 
					SIGNAL(clicked()),
					this, 
					SLOT(resetAllFields()));	
}
 
SystemFeatureInfo::~SystemFeatureInfo()
{
	delete sysInfo;
	sysInfo = NULL;
}
 
void SystemFeatureInfo::checkFeatureAvailability(int aIndex)
{
	ASSERT(aIndex >=0 && aIndex <=13);
 
	if(! aIndex)
	{
		ui.label->clear();
		return;
	}
 
	bool val = sysInfo->hasFeatureSupported((QSystemInfo::Feature)(aIndex-1));
	if(val)
	{
		ui.label->setText("Available");
	}
	else
	{
		ui.label->setText("Not available");
	}
}
 
void SystemFeatureInfo::listFirmwareInformation()
{
	if(sysInfo)
	{
		QString os = sysInfo->version(QSystemInfo::Os);
		ui.OSlabel->setText(sysInfo->version(QSystemInfo::Os));
		ui.qtLabel->setText(sysInfo->version(QSystemInfo::QtCore));
		ui.firmwareLabel->setText(sysInfo->version(QSystemInfo::Firmware));
	}
}
void SystemFeatureInfo::resetAllFields()
{
	ui.featureComboBox->setCurrentIndex(0);
	ui.label->clear();
	ui.OSlabel->clear();
	ui.qtLabel->clear();
	ui.firmwareLabel->clear();
}

Output

Useful functions

bool hasFeatureSupported(QSystemInfo::Feature feature);
QString version(QSystemInfo::Version type, const QString & parameter = QString());

Keywords

Headers

#include <qsysteminfo.h>

Classes

QSystemInfo
QString
QStringList
QButton
QLabel
QComboBox

Example Application

A working example application is available to download from here: QSystemInfo part2.zip

Reference links

@@ Line 1: / Line 1: @@
-[[Category:Qt]][[Category:Qt for Symbian]][[Category:Code Examples]]
+{{ArticleMetaData <!-- v1.2 -->
+|sourcecode= [[Media:SystemFeatureInfo.zip]]
+|installfile= <!-- Link to installation file (e.g. [[Media:The Installation File.sis]]) -->
+|devices= <!-- Devices tested against - e.g. ''devices=Nokia 6131 NFC, Nokia C7-00'') -->
+|sdk= <!-- SDK(s) built and tested against (e.g. [http://linktosdkdownload/ Qt SDK 1.1.4]) -->
+|platform= <!-- Compatible platforms - e.g. Symbian^1 and later, Qt 4.6 and later -->
+|devicecompatability= <!-- Compatible devices e.g.: All* (must have internal GPS) -->
+|dependencies= <!-- Any other/external dependencies e.g.: Google Maps Api v1.0 -->
+|signing= <!-- Signing requirements - empty or one of: Self-Signed, DevCert, Manufacturer -->
+|capabilities= <!-- Capabilities required by the article/code example (e.g. Location, NetworkServices. -->
+|keywords= <!-- APIs, classes and methods (e.g. QSystemScreenSaver, QList, CBase -->
+|language= <!-- Language category code for non-English topics - e.g. Lang-Chinese -->
+|translated-by= <!-- [[User:XXXX]] -->
+|translated-from-title= <!-- Title only -->
+|translated-from-id= <!-- Id of translated revision -->
+|review-by= <!-- After re-review: [[User:username]] -->
+|review-timestamp= <!-- After re-review: YYYYMMDD -->
+|update-by= <!-- After significant update: [[User:username]]-->
+|update-timestamp= <!-- After significant update: YYYYMMDD -->
+|creationdate= 20100308
+|author= [[User:Kiran10182]]
+}}
+[[Category:Qt Mobility]]
 {|style="background:#eceff2" width="660px" border="1" cellpadding="5" cellspacing="0"
 |-
@@ Line 9: / Line 31: @@
 |'''Tested on devices''' || Nokia 5800 xPressMusic
 |-
-|'''Category''' || Qt for Symbian
+|'''Category''' || Qt
 |'''Subcategory''' || Qt Mobility API
 |-
@@ Line 23: / Line 45: @@
 {{Tip|<b></b>
-* Read this article before moving forward: [[Setting up environment for Qt Mobility API]]
+* Please read this article before moving forward: [[Archived:Setting up environment for Qt Mobility API]]
 * Setup Carbide.c++ IDE as explained in this article: [[Working with Carbide.c++ IDE for Qt Mobility APIs]]
 }}
 = Overview =
@@ Line 50: / Line 73: @@
 = Project configuration file (.Pro file) =
 * Add the Qt Mobility project configuration option in the .Pro file as shown below
-<code cpp>
+<code cpp-qt>
 CONFIG += mobility
 MOBILITY += systeminfo
@@ Line 56: / Line 79: @@
 * Add Qt-specific configuration options in .pro file as shown below
-<code cpp>
+<code cpp-qt>
 QT += network
 </code>
 * Add required capability in .pro file as shown below:
-<code cpp>
+<code cpp-qt>
 symbian:TARGET.CAPABILITY = ReadDeviceData
 </code>
@@ Line 68: / Line 91: @@
 = Implementing QSystemInfo API =
 * QSystemInfo API is a part of the QtMobility namespace. So declare the QtMobility namespace as shown below:
-<code cpp>
+<code cpp-qt>
 using namespace QtMobility;
 </code>
 == Header file==
-<code cpp>
+<code cpp-qt>
 #ifndef SYSTEMFEATUREINFO_H
 #define SYSTEMFEATUREINFO_H
@@ Line 105: / Line 128: @@
 == Source file ==
-<code cpp>
+<code cpp-qt>
 #include "SystemFeatureInfo.h"
@@ Line 174: / Line 197: @@
 }
 </code>
 = Output =
 [[File:SystemFeatureInfo device.jpg]]
 = Useful functions =
+* bool hasFeatureSupported(QSystemInfo::Feature feature);
+* QString version(QSystemInfo::Version type, const QString & parameter  = QString());
+= Keywords =
 ==Headers==
 * #include <qsysteminfo.h>
 ==Classes==
 * QSystemInfo
+* QString
+* QStringList
+* QButton
+* QLabel
+* QComboBox
 = Example Application =
@@ Line 197: / Line 225: @@
 = Related articles =
 * [[Getting started with Qt Mobility APIs]]
-* [[Setting up environment for Qt Mobility API]]
+* [[Archived:Setting up environment for Qt Mobility API]]
 * [[Working with Carbide.c++ IDE for Qt Mobility APIs]]
 * [[Working with QSystemInfo - System Information API - Part 1]]
@@ Line 208: / Line 236: @@
 = Reference links=
 * [http://qt.nokia.com/ Qt - cross-platform application and UI framework]
-* [http://labs.trolltech.com/page/Projects/QtMobility Qt Mobility API]
+* [http://developer.qt.nokia.com/wiki/Category:Qt_Labs_Projects Qt Mobility API]
-* [http://qt.nokia.com/developer/new-qt-apis New Qt APIs Beta - Mobility Project]
+* [http://qt.nokia.com/developer/qt-roadmap New Qt APIs Beta - Mobility Project]
-* SDK help
+* SDK help[[Category:Code Examples]][[Category:MeeGo Harmattan]] [[Category:Symbian]]

Wiki

Wiki Resources

Main Platforms

Other

Natural Languages

Toolbox

Namespaces

Variants

Views

Actions

Contents

Working with QSystemInfo - System Information API - Part 2