Working with QSystemNetworkInfo - System Information API - Part 2
somnathbanik
(Talk | contribs) |
somnathbanik
(Talk | contribs) |
||
| Line 28: | Line 28: | ||
| − | = 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'''''.}} | {{Abstract|This is a part 2 of the {{Icode|QSystemNetworkInfo}} API which is a part of the '''''System Information API''''' from '''''Qt Mobility project'''''.}} | ||
| Line 54: | Line 56: | ||
== Project configuration file (.Pro file) == | == Project configuration file (.Pro file) == | ||
| − | * Add the Qt Mobility project configuration option in the . | + | * Add the Qt Mobility project configuration option in the '''.pro''' file as shown below |
<code cpp> | <code cpp> | ||
CONFIG += mobility | CONFIG += mobility | ||
| Line 61: | Line 63: | ||
| − | * Add required capability in .pro file as shown below: | + | * Add required capability in '''.pro''' file as shown below: |
<code cpp> | <code cpp> | ||
symbian:TARGET.CAPABILITY = ReadDeviceData | symbian:TARGET.CAPABILITY = ReadDeviceData | ||
| Line 218: | Line 220: | ||
| − | == | + | == Useful functions == |
| − | Useful functions == | + | |
* {{Icode|QString macAddress(QSystemNetworkInfo::NetworkMode mode);}} | * {{Icode|QString macAddress(QSystemNetworkInfo::NetworkMode mode);}} | ||
| Line 228: | Line 229: | ||
==Headers== | ==Headers== | ||
| − | * #include <qsysteminfo.h> | + | * <code cpp>#include <qsysteminfo.h></code> |
==Classes== | ==Classes== | ||
| − | * QSystemNetworkInfo | + | * {{Icode|QSystemNetworkInfo}} |
| − | * QString | + | *{{Icode| QString}} |
| − | * QButton | + | *{{Icode| QButton}} |
| − | * QLabel | + | *{{Icode| QLabel}} |
| − | * QComboBox | + | *{{Icode| QComboBox}} |
Revision as of 09:47, 29 April 2011
| ID | Creation date | 15-March-2010 | |
| Platform | S60 3rd Edition, FP1, FP2
S60 5th Edition |
Tested on devices | Nokia 5800 xPressMusic |
| Category | Qt for Symbian | Subcategory | Qt Mobility API |
| Keywords (APIs, classes, methods, functions): QSystemNetworkInfo, QString, QButton, QLabel, QComboBox |
Tip:
- Please read this article before moving forward: 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.
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
- 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
