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

Properties

Public Functions

Signals

Static Public Members

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 network.
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, or 0 if not connected.

Access functions:

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:

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:

currentMode : const QSystemNetworkInfo::NetworkMode

Access functions:

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:

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:

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:


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, 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 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 © 2010 Nokia Corporation and/or its subsidiary(-ies) Trademarks
Qt Mobility Project 1.0.1