Home · All Classes · Grouped Classes · Annotated · Functions

QNetworkRegistration Class Reference

The QNetworkRegistration class provides information about network operators. More...

    #include <QNetworkRegistration>

Inherits QCommInterface.

Inherited by QNetworkRegistrationServer.

• List of all members, including inherited members

Public Types

• class AvailableOperator

Public Functions

• QNetworkRegistration ( const QString & service = QString(), QObject * parent = 0, QCommInterface::Mode mode = Client )
• ~QNetworkRegistration ()
• int cellId () const
• QString currentOperatorId () const
• QTelephony::OperatorMode currentOperatorMode () const
• QString currentOperatorName () const
• QString currentOperatorTechnology () const
• bool initialized () const
• int locationAreaCode () const
• QTelephony::RegistrationState registrationState () const

• 1 public function inherited from QCommInterface
• 4 public functions inherited from QAbstractIpcInterface
• 37 public functions inherited from QObject

Public Slots

• virtual void requestAvailableOperators ()
• virtual void setCurrentOperator ( QTelephony::OperatorMode mode, const QString & id = QString(), const QString & technology = QString() )

• 1 public slot inherited from QObject

Signals

• void availableOperators ( const QList<QNetworkRegistration::AvailableOperator> & opers )
• void currentOperatorChanged ()
• void initializedChanged ()
• void locationChanged ()
• void registrationStateChanged ()
• void setCurrentOperatorResult ( QTelephony::Result result )

• 1 signal inherited from QAbstractIpcInterface
• 1 signal inherited from QObject

Additional Inherited Members

• 1 property inherited from QObject
• 1 public type inherited from QObject
• 4 static public members inherited from QObject
• 14 protected functions inherited from QAbstractIpcInterface
• 8 protected functions inherited from QObject
• 2 protected variables inherited from QObject
• 1 static protected member inherited from QObject

Detailed Description

The QNetworkRegistration class provides information about network operators.

The network registration information that is reported includes the registrationState(), currentOperatorId(), currentOperatorName(), currentOperatorMode(), and currentOperatorTechnology(). On GSM networks, the information may also include the locationAreaCode() and cellId() for the current cell.

All telephony services are expected to implement the QNetworkRegistration interface so that client applications can be made aware of when a service can be used to make phone calls or perform other telephony operations. For simple telephony services (e.g. VoIP providers), it is sufficient that registrationState() be either RegistrationNone or RegistrationHome to indicate when the network is registered.

See also QNetworkRegistrationServer and QCommInterface.

Member Function Documentation

QNetworkRegistration::QNetworkRegistration ( const QString & service = QString(), QObject * parent = 0, QCommInterface::Mode mode = Client )

Construct a new network registration object for service and attach it to parent. The object will be created in client mode if mode is Client, or server mode otherwise.

If service is empty, this class will use the first available service that supports network registration. If there is more than one service that supports network registration, the caller should enumerate them with QCommServiceManager::supports() and create separate QNetworkRegistration objects for each.

See also QCommServiceManager::supports().

QNetworkRegistration::~QNetworkRegistration ()

Destroy this network registration object.

void QNetworkRegistration::availableOperators ( const QList<QNetworkRegistration::AvailableOperator> & opers )   [signal]

Signal that is emitted when a requestAvailableOperators() request completes. The opers parameter contains the list of available operators.

See also requestAvailableOperators().

int QNetworkRegistration::cellId () const

Returns the GSM cell id, or ci. Returns -1 if the cell id is unknown. The locationChanged() signal can be used to detect changes in this value.

See also locationAreaCode() and locationChanged().

void QNetworkRegistration::currentOperatorChanged ()   [signal]

Signal that is emitted when the current operator information changes.

See also currentOperatorId(), currentOperatorName(), currentOperatorMode(), and currentOperatorTechnology().

QString QNetworkRegistration::currentOperatorId () const

Returns the identifier of the current network operator, which can be used in a setCurrentOperator() request do change between OperatorModeAutomatic and OperatorModeManual.

See also currentOperatorMode(), currentOperatorTechnology(), and currentOperatorChanged().

QTelephony::OperatorMode QNetworkRegistration::currentOperatorMode () const

Returns the mode that the current network operator is operating in.

See also currentOperatorName(), currentOperatorTechnology(), and currentOperatorChanged().

QString QNetworkRegistration::currentOperatorName () const

Returns the name of the current network operator.

See also currentOperatorMode(), currentOperatorTechnology(), and currentOperatorChanged().

QString QNetworkRegistration::currentOperatorTechnology () const

Returns the technology used by the current network operator (GSM, UTRAN, VoIP, etc).

See also currentOperatorName(), currentOperatorMode(), and currentOperatorChanged().

bool QNetworkRegistration::initialized () const

Returns true if the network registration service has initialized the modem and is ready to attempt to register to the network; false otherwise. Attempts to change the operator with setCurrentOperator() will always fail before this function returns true.

See also initializedChanged().

void QNetworkRegistration::initializedChanged ()   [signal]

Signal that is emitted when the state of initialized() changes.

See also initialized().

int QNetworkRegistration::locationAreaCode () const

Returns the GSM location area code, or lac. Returns -1 if the location area code is unknown. The locationChanged() signal can be used to detect changes in this value.

See also cellId() and locationChanged().

void QNetworkRegistration::locationChanged ()   [signal]

Signal that is emitted when the locationAreaCode() or cellId() changes.

If both the registrationState() and the location has changed, then registrationStateChanged() will be sent before locationChanged(), but the new location will already be available in slots connected to registrationStateChanged().

See also locationAreaCode() and cellId().

QTelephony::RegistrationState QNetworkRegistration::registrationState () const

Returns the current network registration state.

See also registrationStateChanged().

void QNetworkRegistration::registrationStateChanged ()   [signal]

Signal that is emitted when the registration state changes.

See also registrationState().

void QNetworkRegistration::requestAvailableOperators ()   [virtual slot]

Request a list of all available network operators. The server will respond with the availableOperators() signal.

The preferred operator list on the SIM card can be accessed with the QPreferredNetworkOperators class.

See also availableOperators() and QPreferredNetworkOperators.

void QNetworkRegistration::setCurrentOperator ( QTelephony::OperatorMode mode, const QString & id = QString(), const QString & technology = QString() )   [virtual slot]

Sets the current network operator information to mode, id, and technology. The server will respond with the setCurrentOperatorResult() signal when the request completes.

If the request succeeds, then the client may also receive the currentOperatorChanged() signal to indicate the newly selected values. The currentOperatorChanged() signal may be suppressed if the request succeeded, but the new values are the same as the previous ones.

See also setCurrentOperatorResult().

void QNetworkRegistration::setCurrentOperatorResult ( QTelephony::Result result )   [signal]

Signal that is emitted when a setCurrentOperator() request completes. The result parameter indicates the result of the request.

See also setCurrentOperator().