Working with QSystemNetworkInfo - System Information API - Part 2
girishpadia
(Talk | contribs) (→Overview) |
hamishwillee
(Talk | contribs) m (Text replace - "<code cpp>" to "<code cpp-qt>") |
||
| (5 intermediate revisions by one user not shown) | |||
| Line 1: | Line 1: | ||
| + | {{ArticleMetaData <!-- v1.2 --> | ||
| + | |sourcecode= [[Media:SystemNetworkInfo2.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= 20100315 | ||
| + | |author= [[User:Kiran10182]] | ||
| + | }} | ||
[[Category:Qt Mobility]] | [[Category:Qt Mobility]] | ||
{|style="background:#eceff2" width="660px" border="1" cellpadding="5" cellspacing="0" | {|style="background:#eceff2" width="660px" border="1" cellpadding="5" cellspacing="0" | ||
| Line 9: | Line 31: | ||
|'''Tested on devices''' || Nokia 5800 xPressMusic | |'''Tested on devices''' || Nokia 5800 xPressMusic | ||
|- | |- | ||
| − | |'''Category''' || Qt | + | |'''Category''' || Qt |
|'''Subcategory''' || Qt Mobility API | |'''Subcategory''' || Qt Mobility API | ||
|- | |- | ||
| Line 23: | Line 45: | ||
{{Tip|<b></b> | {{Tip|<b></b> | ||
| − | * Please 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]] | * Setup Carbide.c++ IDE as explained in this article: [[Working with Carbide.c++ IDE for Qt Mobility APIs]] | ||
}} | }} | ||
| Line 31: | Line 53: | ||
== Overview == | == Overview == | ||
| − | {{Abstract|This is a part 2 of the {{Icode|QSystemNetworkInfo}} API which is a part of the '''''System Information API''''' from '''''Qt Mobility project'''''. The part 1 of this article can be read from [ | + | {{Abstract|This is a part 2 of the {{Icode|QSystemNetworkInfo}} API which is a part of the '''''System Information API''''' from '''''Qt Mobility project'''''. The part 1 of this article can be read from [[Working with QSystemNetworkInfo - System Information API - Part 1|Here]] }} |
= What is covered in {{Icode|QSystemNetworkInfo}} API Part 2 = | = What is covered in {{Icode|QSystemNetworkInfo}} API Part 2 = | ||
| Line 49: | Line 71: | ||
== UI design (.ui file) == | == UI design (.ui file) == | ||
| − | [[File:QSystemNetworkInfo- | + | [[File:QSystemNetworkInfo-2 UI.PNG]] |
| Line 57: | Line 79: | ||
* Add the Qt Mobility project configuration option in the '''.pro''' file as shown below | * Add the Qt Mobility project configuration option in the '''.pro''' file as shown below | ||
| − | <code cpp> | + | <code cpp-qt> |
CONFIG += mobility | CONFIG += mobility | ||
MOBILITY += systeminfo | MOBILITY += systeminfo | ||
| Line 64: | Line 86: | ||
* Add required capability in '''.pro''' file as shown below: | * Add required capability in '''.pro''' file as shown below: | ||
| − | <code cpp> | + | <code cpp-qt> |
symbian:TARGET.CAPABILITY = ReadDeviceData | symbian:TARGET.CAPABILITY = ReadDeviceData | ||
</code> | </code> | ||
| Line 73: | Line 95: | ||
* {{Icode|QSystemNetworkInfo}} API is a part of the {{Icode|QtMobility}} namespace. So declare the {{Icode|QtMobility}} namespace as shown below: | * {{Icode|QSystemNetworkInfo}} API is a part of the {{Icode|QtMobility}} namespace. So declare the {{Icode|QtMobility}} namespace as shown below: | ||
| − | <code cpp> | + | <code cpp-qt> |
using namespace QtMobility; | using namespace QtMobility; | ||
</code> | </code> | ||
== Header file== | == Header file== | ||
| − | <code cpp> | + | <code cpp-qt> |
#ifndef SYSTEMNETWORKINFO2_H | #ifndef SYSTEMNETWORKINFO2_H | ||
#define SYSTEMNETWORKINFO2_H | #define SYSTEMNETWORKINFO2_H | ||
| Line 112: | Line 134: | ||
== Source file == | == Source file == | ||
| − | <code cpp> | + | <code cpp-qt> |
#include "SystemNetworkInfo2.h" | #include "SystemNetworkInfo2.h" | ||
| Line 217: | Line 239: | ||
== Output == | == Output == | ||
| − | [[File:QSystemNetworkInfo- | + | [[File:QSystemNetworkInfo-2 device.jpg]] |
| Line 229: | Line 251: | ||
==Headers== | ==Headers== | ||
| − | <code cpp>#include <qsysteminfo.h></code> | + | <code cpp-qt>#include <qsysteminfo.h></code> |
==Classes== | ==Classes== | ||
| Line 247: | Line 269: | ||
= Related articles = | = Related articles = | ||
* [[Getting started with Qt Mobility APIs]] | * [[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 Carbide.c++ IDE for Qt Mobility APIs]] | ||
* [[Working with QSystemInfo - System Information API - Part 1]] | * [[Working with QSystemInfo - System Information API - Part 1]] | ||
| Line 259: | Line 281: | ||
* [http://qt.nokia.com/ Qt - cross-platform application and UI framework] | * [http://qt.nokia.com/ Qt - cross-platform application and UI framework] | ||
* [http://labs.trolltech.com/page/Projects/QtMobility Qt Mobility API] | * [http://labs.trolltech.com/page/Projects/QtMobility Qt Mobility API] | ||
| − | * [http://qt.nokia.com/developer/ | + | * [http://qt.nokia.com/developer/qt-roadmap New Qt APIs Beta - Mobility Project] |
| − | * SDK help[[Category:Code Examples]] | + | * SDK help[[Category:Code Examples]][[Category:MeeGo Harmattan]] [[Category:Symbian]] |
Latest revision as of 04:23, 11 October 2012
Article Metadata
Code Example
Source file: Media:SystemNetworkInfo2.zip
Article
Created: kiran10182
(15 Mar 2010)
Last edited: hamishwillee
(11 Oct 2012)
| ID | Creation date | 15-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): QSystemNetworkInfo, QString, 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
Contents |
Overview
This is a part 2 of the QSystemNetworkInfo API which is a part of the System Information API from Qt Mobility project. The part 1 of this article can be read from Here
What is covered in QSystemNetworkInfo API Part 2
- It is a part of the System Information API.
- This article covers information about
- MAC address of the specified network mode
- Network status of the specified network mode
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 required capability in .pro file as shown below:
symbian:TARGET.CAPABILITY = ReadDeviceData
Implementing QSystemNetworkInfo API
- QSystemNetworkInfo API is a part of the QtMobility namespace. So declare the QtMobility namespace as shown below:
using namespace QtMobility;
Header file
#ifndef SYSTEMNETWORKINFO2_H
#define SYSTEMNETWORKINFO2_H
#include <QtGui/QWidget>
#include "ui_SystemNetworkInfo2.h"
#include <qsysteminfo.h>
using namespace QtMobility;
class SystemNetworkInfo2 : public QWidget
{
Q_OBJECT
public:
SystemNetworkInfo2(QWidget *parent = 0);
~SystemNetworkInfo2();
public slots:
void displayNetworkInfo(int aIndex);
void resetAllFields();
private:
QString getNetworkStatusString(QSystemNetworkInfo::NetworkStatus aIndex);
private:
Ui::SystemNetworkInfo2 ui;
QSystemNetworkInfo* networkInfo;
};
#endif // SYSTEMNETWORKINFO2_H
Source file
#include "SystemNetworkInfo2.h"
SystemNetworkInfo2::SystemNetworkInfo2(QWidget *parent)
: QWidget(parent), networkInfo(NULL)
{
ui.setupUi(this);
networkInfo = new QSystemNetworkInfo();
QObject::connect(ui.comboBox,
SIGNAL(currentIndexChanged(int)),
this,
SLOT(displayNetworkInfo(int)));
QObject::connect(ui.resetButton,
SIGNAL(clicked()),
this,
SLOT(resetAllFields()));
}
SystemNetworkInfo2::~SystemNetworkInfo2()
{
delete networkInfo;
networkInfo = NULL;
}
void SystemNetworkInfo2::displayNetworkInfo(int aIndex)
{
if(! aIndex)
{
resetAllFields();
return;
}
QString macAddress = networkInfo->macAddress((QSystemNetworkInfo::NetworkMode)aIndex);
if(! macAddress.length())
{
ui.macLabel->setText("Not applicable");
}
else
{
ui.macLabel->setText(macAddress);
}
ui.statusLabel->setText(getNetworkStatusString(
networkInfo->networkStatus(
(QSystemNetworkInfo::NetworkMode)aIndex)));
}
QString SystemNetworkInfo2::getNetworkStatusString(QSystemNetworkInfo::NetworkStatus aIndex)
{
switch(aIndex)
{
case QSystemNetworkInfo::UndefinedStatus:
{
return "Undefined";
}
case QSystemNetworkInfo::NoNetworkAvailable:
{
return "Unavailable";
}
case QSystemNetworkInfo::EmergencyOnly:
{
return "Emergency";
}
case QSystemNetworkInfo::Searching:
{
return "Searching";
}
case QSystemNetworkInfo::Busy:
{
return "Busy";
}
case QSystemNetworkInfo::Connected:
{
return "Connected";
}
case QSystemNetworkInfo::HomeNetwork:
{
return "On home n/w";
}
case QSystemNetworkInfo::Denied:
{
return "Access denied";
}
case QSystemNetworkInfo::Roaming:
{
return "On Roaming";
}
default:
{
return "Error";
}
}
}
void SystemNetworkInfo2::resetAllFields()
{
ui.macLabel->clear();
ui.statusLabel->clear();
ui.comboBox->setCurrentIndex(0);
}
Output
Useful functions
- QString macAddress(QSystemNetworkInfo::NetworkMode mode);
- QSystemNetworkInfo::NetworkStatus networkStatus(QSystemNetworkInfo::NetworkMode mode);
Keywords
Headers
#include <qsysteminfo.h>Classes
- QSystemNetworkInfo
- QString
- QButton
- QLabel
- QComboBox
Example Application
- A working example application is available to download from here: QSystemNetworkInfo part2.zip
Related articles
- Getting started with Qt Mobility APIs
- 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
- Working with QSystemInfo - System Information API - Part 2
- Working with QSystemDeviceInfo - System Information API - Part 1
- Working with QSystemStorageInfo - System Information API
- Working with QSystemDisplayInfo - System Information API
- Working with QSystemNetworkInfo - System Information API - Part 1
