QtMobility Reference Documentation

Contents

QSystemNetworkInfo Class Reference

The QSystemNetworkInfo class provides access to various networking status and signals. More...

 #include <QSystemNetworkInfo>

Inherits QObject.

Public Types

enum CellDataTechnology { UnknownDataTechnology, GprsDataTechnology, EdgeDataTechnology, UmtsDataTechnology, HspaDataTechnology }
enum NetworkMode { UnknownMode, GsmMode, CdmaMode, WcdmaMode, ..., LteMode }
enum NetworkStatus { UndefinedStatus, NoNetworkAvailable, EmergencyOnly, Searching, ..., Roaming }

Properties

Public Functions

QSystemNetworkInfo ( QObject * parent = 0 )
~QSystemNetworkInfo ()
QSystemNetworkInfo::CellDataTechnology cellDataTechnology ()
int cellId ()
QString currentMobileCountryCode ()
QString currentMobileNetworkCode ()
QSystemNetworkInfo::NetworkMode currentMode ()
QString homeMobileCountryCode ()
QString homeMobileNetworkCode ()
QNetworkInterface interfaceForMode ( QSystemNetworkInfo::NetworkMode mode )
int locationAreaCode ()
QString macAddress ( QSystemNetworkInfo::NetworkMode mode )
QSystemNetworkInfo::NetworkStatus networkStatus ( QSystemNetworkInfo::NetworkMode mode )

Signals

void cellDataTechnologyChanged ( QSystemNetworkInfo::CellDataTechnology )
void cellIdChanged ( int cellId )
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

QString networkName ( QSystemNetworkInfo::NetworkMode mode )
int networkSignalStrength ( QSystemNetworkInfo::NetworkMode mode )

Additional Inherited Members

Detailed Description

The QSystemNetworkInfo class provides access to various networking status and signals.

Member Type Documentation

enum QSystemNetworkInfo::CellDataTechnology

enum QSystemNetworkInfo::NetworkMode

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.
QSystemNetworkInfo::GprsMode?Gprs network
QSystemNetworkInfo::EdgeMode?Edge network.
QSystemNetworkInfo::HspaMode?Hspa network.
QSystemNetworkInfo::LteMode8Lte network.

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 network.
QSystemNetworkInfo::HomeNetwork6On Home Network.
QSystemNetworkInfo::Denied7Network access denied.
QSystemNetworkInfo::Roaming8On Roaming network.

Property Documentation

cellDataTechnology : const QSystemNetworkInfo::CellDataTechnology

Returns the current active cell data technology. If no data technology is active, returns QSystemNetworkInfo::NoDataTechnology. If data technology is not supported, this will return QSystemNetworkInfo::UnknownDataTechnology

Access functions:

QSystemNetworkInfo::CellDataTechnology cellDataTechnology ()

Notifier signal:

void cellDataTechnologyChanged ( QSystemNetworkInfo::CellDataTechnology )

cellId : const int

This property holds the devices Cell ID Returns the Cell ID of the connected tower or based station, or 0 if not connected.

Access functions:

int cellId ()

Notifier signal:

void cellIdChanged ( int cellId )

currentMobileCountryCode : const QString

This property holds the current MCC.

Returns the current Mobile Country Code. In the case of a Desktop computer, an empty string is returned.

Access functions:

QString currentMobileCountryCode ()

Notifier signal:

void currentMobileCountryCodeChanged ( const QString & mcc )

currentMobileNetworkCode : const QString

This property holds the current MNC.

Returns the current Mobile Network Code. In the case of a Desktop computer, an empty string is returned.

Access functions:

QString currentMobileNetworkCode ()

Notifier signal:

void currentMobileNetworkCodeChanged ( const QString & mnc )

currentMode : const QSystemNetworkInfo::NetworkMode

Returns the current active mode. If more than one mode is active, returns the default or preferred mode. If no modes are active, returns UnknownMode.

Access functions:

QSystemNetworkInfo::NetworkMode currentMode ()

homeMobileCountryCode : const QString

This property holds the home MNC.

Returns the home Mobile Country Code. In the case of a Desktop computer, an empty string is returned.

Access functions:

QString homeMobileCountryCode ()

homeMobileNetworkCode : const QString

This property holds the home MCC.

Returns the home Mobile Network Code. In the case of a Desktop computer, an empty string is returned. Note: Some platforms don't support retrieving this info. In this case the Network Code is returned only when the device is registered on home network.

Access functions:

QString homeMobileNetworkCode ()

locationAreaCode : const int

This property holds the LAC.

Returns the Location Area Code. In the case of a Desktop computer, 0 is returned.

Access functions:

int locationAreaCode ()

Member Function Documentation

QSystemNetworkInfo::QSystemNetworkInfo ( QObject * parent = 0 )

Constructs a QSystemNetworkInfo with the given parent.

QSystemNetworkInfo::~QSystemNetworkInfo ()

Destroys the QSystemNetworkInfo object.

void QSystemNetworkInfo::cellDataTechnologyChanged ( QSystemNetworkInfo::CellDataTechnology ) [signal]

void QSystemNetworkInfo::cellIdChanged ( int cellId ) [signal]

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

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, or an invalid QNetworkInterface, if none is found.

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 a Desktop computer, an empty string is returned.

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.