QtMobility Reference Documentation

Contents

QML NetworkInfo Element

The NetworkInfo element allows you to get information and receive notifications from the network. More...

  • List of all members, including inherited members
  • Properties

    Signals

    Methods

    Detailed Description

    This element is part of the QtMobility.systeminfo 1.1 module. It is a convience class to make QML usage easier.

    Note: To use notification signals, you need to set the monitor* properties to true.

    To use this in a mode other than the default mode given by currentMode, set the mode with mode.

     import Qt 4.7
     import QtMobility.systeminfo 1.1
    
     Rectangle {
    
         NetworkInfo {
             id: wlaninfo
             mode: NetworkInfo.WlanMode;
             monitorNameChanges: true
             monitorSignalStrengthChanges: true
         }
         Text {
             id: signame
             color: "white"
             text:  wlaninfo.networkName +" "+wlaninfo.networkSignalStrength;
             anchors.horizontalCenter: parent.horizontalCenter;
             anchors.verticalCenter: parent.verticalCenter;
         }
     }

    See also QSystemNetworkInfo.

    Property Documentation

    macAddress : string

    Returns this NetworkInfo's network interface's MAC address.


    mode : enumeration

    Sets this NetworkInfo to use QSystemNetworkInfo::NetworkModes. Does not set the mode of the underlaying system.

    If not set, the default is whatever defaultMode is.


    monitorCurrentMobileNetworkCodeChanges : bool


    monitorModeChanges : bool


    monitorNameChanges : bool


    monitorSignalStrengthChanges : bool


    monitorStatusChanges : bool


    monitoringCellDataTechnologyChanges : bool

    See also QSystemNetworkInfo::cellDataTechnologyChanged.


    monitoringCellIdChanges : bool


    monitoringCurrentMobileCountryCodeChanges : bool


    networkName : string

    Returns this NetworkInfo's network name.


    networkSignalStrength : int

    Returns this NetworkInfo's network signal strength.


    networkStatus : string

    Returns this NetworkInfo's network status.

    The following table shows the mapping between the NetworkInfo NetworkStatus property and the QSystemNetworkInfo::NetworkStatus enum.

    NetworkInfo.networkStatusQSystemNetworkInfo::NetworkStatus

    "Undefined"

    QSystemNetworkInfo::UndefinedStatus

    "No Network Available"

    QSystemNetworkInfo::NoNetworkAvailable

    "Emergency Only"

    QSystemNetworkInfo::EmergencyOnly

    "Searching"

    QSystemNetworkInfo::Searching

    "Busy"

    QSystemNetworkInfo::Busy

    "Connected"

    QSystemNetworkInfo::Connected

    "Home Network"

    QSystemNetworkInfo::HomeNetwork

    "Denied"

    QSystemNetworkInfo::Denied

    "Roaming"

    QSystemNetworkInfo::Roaming


    Signal Documentation

    NetworkInfo::currentMobileCountryCodeChanged ()

    This handler is called when network MCC has changed. Note: To receive this notification, you must first call startCurrentMobileCountryCodeChanged.


    NetworkInfo::currentMobileNetworkCodeChanged ()

    This handler is called when network MNC has changed. Note: To receive this notification, you must first call startCurrentMobileNetworkCodeChanged.


    NetworkInfo::modeChanged ()

    This handler is called when the systems default network mode has changed. Note: To receive this notification, you must first call startModeChanged.


    NetworkInfo::nameChanged ()

    This handler is called when network name has changed. Note: To receive this notification, you must first call startNameChanged.


    NetworkInfo::signalStrengthChanged ()

    This handler is called when network signal strength has changed. Note: To receive this notification, you must first call startSignalStrengthChanged.


    NetworkInfo::statusChanged ()

    This handler is called when network status has changed. Note: To receive this notification, you must first call startStatusChanged.


    Method Documentation

    QNetworkInterface NetworkInfo::interfaceForMode ()

    Returns the QNetworkInterface for this NetworkInfo.