QNetworkRegistration Class Reference
[QtTelephonyModule]

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.

Property Documentation

cellId : const int

This property holds the GSM cell id, or .

Access functions:

• int cellId () const

currentOperatorId : const QString

This property holds the identifier of the current network operator.

Access functions:

• QString currentOperatorId () const

currentOperatorMode : const QTelephony::OperatorMode

This property holds the mode that the current network operator is operating in.

Access functions:

• QTelephony::OperatorMode currentOperatorMode () const

currentOperatorName : const QString

This property holds the name of the current network operator.

Access functions:

• QString currentOperatorName () const

currentOperatorTechnology : const QString

This property holds the technology used the current network operator.

Access functions:

• QString currentOperatorTechnology () const

initialized : const bool

This property holds true if the network registration service has initialized the modem.

Access functions:

• bool initialized () const

locationAreaCode : const int

This property holds the GSM location area code, or .

Access functions:

• int locationAreaCode () const

registrationState : const QTelephony::RegistrationState

This property holds the current network registration state.

Access functions:

• QTelephony::RegistrationState registrationState () const

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().

void QNetworkRegistration::currentOperatorChanged ()   [signal]

Signal that is emitted when the current operator information changes.

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

void QNetworkRegistration::initializedChanged ()   [signal]

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

See also initialized().

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().

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().