Home · All Classes · All Functions ·

QSystemNetworkInfo Class Reference

The QSystemNetworkInfo class provides access to network information from the system. More...

    #include <QSystemNetworkInfo>

Inherits QObject.


Public Types

enum NetworkMode { UnknownMode, GsmMode, CdmaMode, WcdmaMode, ..., WimaxMode }
flags NetworkModes
enum NetworkStatus { UndefinedStatus, NoNetworkAvailable, EmergencyOnly, Searching, ..., Roaming }

Properties


Public Functions

QSystemNetworkInfo ( QObject * parent = 0 )
~QSystemNetworkInfo ()
QNetworkInterface interfaceForMode ( QSystemNetworkInfo::NetworkMode mode )
QString macAddress ( QSystemNetworkInfo::NetworkMode mode )
QSystemNetworkInfo::NetworkStatus networkStatus ( QSystemNetworkInfo::NetworkMode mode )

Signals

void currentMobileCountryCodeChanged ( const QString & mcc )
void currentMobileNetworkCodeChanged ( const QString & mnc )
void networkModeChanged ( QSystemNetworkInfo::NetworkMode mode )
void networkNameChanged ( QSystemNetworkInfo::NetworkMode mode, const QString & netName )
void networkSignalStrengthChanged ( QSystemNetworkInfo::NetworkMode mode, int strength )
void networkStatusChanged ( QSystemNetworkInfo::NetworkMode mode, QSystemNetworkInfo::NetworkStatus status )

Static Public Members

int cellId ()
QString currentMobileCountryCode ()
QString currentMobileNetworkCode ()
QString homeMobileCountryCode ()
QString homeMobileNetworkCode ()
int locationAreaCode ()
QString networkName ( QSystemNetworkInfo::NetworkMode mode )
int networkSignalStrength ( QSystemNetworkInfo::NetworkMode mode )

Additional Inherited Members


Detailed Description

The QSystemNetworkInfo class provides access to network information from the system.


Member Type Documentation

enum QSystemNetworkInfo::NetworkMode
flags QSystemNetworkInfo::NetworkModes

This enum describes the type of network:

ConstantValueDescription
QSystemNetworkInfo::UnknownMode0Unknown network, or network error.
QSystemNetworkInfo::GsmMode1Global System for Mobile (GSM) network.
QSystemNetworkInfo::CdmaMode2Code division multiple access (CDMA) network.
QSystemNetworkInfo::WcdmaMode3Wideband Code Division Multiple Access (W-CDMA) network.
QSystemNetworkInfo::WlanMode4Wireless Local Area Network (WLAN) network.
QSystemNetworkInfo::EthernetMode5Wired Local Area network.
QSystemNetworkInfo::BluetoothMode6Bluetooth network.
QSystemNetworkInfo::WimaxMode7Wimax network.

The NetworkModes type is a typedef for QFlags<NetworkMode>. It stores an OR combination of NetworkMode values.

enum QSystemNetworkInfo::NetworkStatus

This enum describes the status of the network connection:

ConstantValueDescription
QSystemNetworkInfo::UndefinedStatus0There is no network device, or error.
QSystemNetworkInfo::NoNetworkAvailable1There is no network available.
QSystemNetworkInfo::EmergencyOnly2Emergency calls only.
QSystemNetworkInfo::Searching3Searching for or connecting with the network.
QSystemNetworkInfo::Busy4Network is busy.
QSystemNetworkInfo::Connected5Connected to newtwork.
QSystemNetworkInfo::HomeNetwork6On Home Network.
QSystemNetworkInfo::Denied7Network access denied.
QSystemNetworkInfo::Roaming8On Roaming network.


Property Documentation

cellId : const int

This property holds the devices Cell ID Returns the Cell ID of the connected tower or based station.

Access functions:

int cellId ()

currentMobileCountryCode : const QString

This property holds the current MCC.

Returns the current Mobile Country Code. In the case of none such as a Desktop, an empty string. /

Access functions:

QString currentMobileCountryCode ()

currentMobileNetworkCode : const QString

This property holds the current MNC.

Returns the current Mobile Network Code. In the case of none such as a Desktop, an empty string.

Access functions:

QString currentMobileNetworkCode ()

homeMobileCountryCode : const QString

This property holds the home MNC.

Returns the home Mobile Network Code. In the case of none such as a Desktop, an empty string.

Access functions:

QString homeMobileCountryCode ()

homeMobileNetworkCode : const QString

This property holds the home MCC.

Returns the home Mobile Country Code. In the case of none such as a Desktop, an empty string.

Access functions:

QString homeMobileNetworkCode ()

locationAreaCode : const int

This property holds the LAC.

Returns the Location Area Code. In the case of none such as a Desktop, an empty string.

Access functions:

int locationAreaCode ()

Member Function Documentation

QSystemNetworkInfo::QSystemNetworkInfo ( QObject * parent = 0 )

Constructs a QSystemNetworkInfo object with the given parent.

QSystemNetworkInfo::~QSystemNetworkInfo ()

Destroys the QSystemNetworkInfo object.

void QSystemNetworkInfo::currentMobileCountryCodeChanged ( const QString & mcc )   [signal]

This signal is emitted whenever the Mobile Country Code changes, specified by mcc.

void QSystemNetworkInfo::currentMobileNetworkCodeChanged ( const QString & mnc )   [signal]

This signal is emitted whenever the network Mobile Network Code changes, specified by mnc.

QNetworkInterface QSystemNetworkInfo::interfaceForMode ( QSystemNetworkInfo::NetworkMode mode )

Returns the first found QNetworkInterface for type mode.

QString QSystemNetworkInfo::macAddress ( QSystemNetworkInfo::NetworkMode mode )

Returns the MAC address for the interface servicing the network mode.

void QSystemNetworkInfo::networkModeChanged ( QSystemNetworkInfo::NetworkMode mode )   [signal]

This signal is emitted whenever the network mode changes, specified by mode.

QString QSystemNetworkInfo::networkName ( QSystemNetworkInfo::NetworkMode mode )   [static]

Returns the name of the operator for the network mode. For wlan this returns the network's current SSID. In the case of no network such as a desktop, an empty string.

void QSystemNetworkInfo::networkNameChanged ( QSystemNetworkInfo::NetworkMode mode, const QString & netName )   [signal]

This signal is emitted whenever the network mode name changes, specified by netName.

int QSystemNetworkInfo::networkSignalStrength ( QSystemNetworkInfo::NetworkMode mode )   [static]

Returns the strength of the network signal, per network mode , 0 - 100 linear scaling, or -1 in the case of unknown network mode or error.

In the case of QSystemNetworkInfo::EthMode, it will either be 100 for carrier active, or 0 for when there is no carrier or cable connected.

void QSystemNetworkInfo::networkSignalStrengthChanged ( QSystemNetworkInfo::NetworkMode mode, int strength )   [signal]

This signal is emitted whenever the network mode signal strength changes, specified by strength.

QSystemNetworkInfo::NetworkStatus QSystemNetworkInfo::networkStatus ( QSystemNetworkInfo::NetworkMode mode )

Returns the status of the network mode.

void QSystemNetworkInfo::networkStatusChanged ( QSystemNetworkInfo::NetworkMode mode, QSystemNetworkInfo::NetworkStatus status )   [signal]

This signal is emitted whenever the network status of mode changes, specified by status.


Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies) Trademarks
Qt Mobility Project 1.0.0