Qt Mobility Reference Documentation

QSystemNetworkInfo Class Reference

The QSystemNetworkInfo class provides access to network information. More...

 #include <QSystemNetworkInfo>

Inherits QObject.

Public Types

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

Properties

  • 1 property inherited from QObject

Public Functions

QSystemNetworkInfo ( QObject * parent = 0 )
~QSystemNetworkInfo ()
int cellId ()
QString currentMobileCountryCode ()
QString currentMobileNetworkCode ()
QString homeMobileCountryCode ()
QString homeMobileNetworkCode ()
QNetworkInterface interfaceForMode ( QSystemNetworkInfo::NetworkMode mode )
int locationAreaCode ()
  • 29 public functions inherited from QObject

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 )

Additional Inherited Members

  • 1 public slot inherited from QObject
  • 1 public variable inherited from QObject
  • 4 static public members inherited from QObject
  • 7 protected functions inherited from QObject
  • 2 protected variables inherited from QObject

Detailed Description

The QSystemNetworkInfo class provides access to network information.

Constructs a QSystemNetworkInfo object with the given parent.

Member Type Documentation

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.

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:

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.

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::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.

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

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

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

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

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

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

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

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

X

Thank you for giving your feedback.

Make sure it is related to this specific page. For more general bugs and requests, please use the Qt Bug Tracker.