QCallBarring Class Reference
[QtTelephonyModule]

Detailed Description

The QCallBarring class provides access to the call barring settings on a GSM phone.

The functionality in this class is implemented in accordance with the Call Barring supplementary service described in 3GPP TS 02.88.

This service makes it possible for a mobile subscriber to have barring of certain categories of outgoing calls according to a barring type which is selected from a set of one or more barring types chosen at provision time and is valid for all outgoing calls, or just those associated with a specific call class (voice, data, etc).

The current state of the call barring service is retrieved using the requestBarringStatus() function. The state of the call barring service is changed using the setBarringStatus() function. An entire group of barred calls can be unlocked with unlockAll(), unlockAllIncoming(), and unlockAllOutgoing().

See also QCommInterface.

Member Type Documentation

enum QCallBarring::BarringType

The type of GSM barring information to be requested or modified.

Member Function Documentation

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

Construct a new call barring 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 call barring. If there is more than one service that supports call barring, the caller should enumerate them with QCommServiceManager::supports() and create separate QCallBarring objects for each.

See also QCommServiceManager::supports().

QCallBarring::~QCallBarring ()

Destroy this call barring object.

void QCallBarring::barringStatus ( QCallBarring::BarringType type, QTelephony::CallClass cls )   [signal]

Signal that is emitted in response to a requestBarring() call for type. The cls parameter contains a set of flags indicating which call types have been barred.

See also setBarringStatus() and requestBarringStatus().

void QCallBarring::changeBarringPassword ( QCallBarring::BarringType type, const QString & oldPassword, const QString & newPassword )   [virtual slot]

Change the password for the call barring service type from oldPassword to newPassword. The result is reported via the changeBarringPasswordResult() signal.

See also changeBarringPasswordResult().

void QCallBarring::changeBarringPasswordResult ( QTelephony::Result result )   [signal]

Signal that is emitted to report the result of calling changeBarringPassword().

See also changeBarringPassword().

void QCallBarring::requestBarringStatus ( QCallBarring::BarringType type )   [virtual slot]

Request the current call barring status of type. The service responds with the barringStatus() signal.

See also barringStatus() and setBarringStatus().

void QCallBarring::setBarringStatus ( QCallBarring::BarringType type, const QString & password, QTelephony::CallClass cls, bool lock )   [virtual slot]

Sets the call barring status of type. The cls parameter will contain flags for all of the call types that should be either locked or unlocked according to the lock flag. The password parameter should be the call barring password. The service responds with the setBarringStatusResult() signal.

See also barringStatus(), setBarringStatusResult(), requestBarringStatus(), and changeBarringPassword().

void QCallBarring::setBarringStatusResult ( QTelephony::Result result )   [signal]

Signal that is emitted in response to a setBarringStatus() call. If result is QTelephony::OK, then the request was successful. Otherwise the request failed (usually because the call barring password was incorrect).

See also setBarringStatus().

void QCallBarring::unlockAll ( const QString & password )   [virtual slot]

Unlock all barring services with the supplied call barring password. The service responds with the unlockResult() signal. On AT-based modems, this uses 3GPP TS 27.007 call barring type AB.

See also unlockResult(), unlockAllIncoming(), unlockAllOutgoing(), and changeBarringPassword().

void QCallBarring::unlockAllIncoming ( const QString & password )   [virtual slot]

Unlock all incoming barring services with the supplied call barring password. The service responds with the unlockResult() signal. On AT-based modems, this uses 3GPP TS 27.007 call barring type AB.

See also unlockResult(), unlockAll(), unlockAllOutgoing(), and changeBarringPassword().

void QCallBarring::unlockAllOutgoing ( const QString & password )   [virtual slot]

Unlock all outgoing barring services with the supplied call barring password. The service responds with the unlockResult() signal. On AT-based modems, this uses 3GPP TS 27.007 call barring type AB.

See also unlockResult(), unlockAll(), unlockAllIncoming(), and changeBarringPassword().

void QCallBarring::unlockResult ( QTelephony::Result result )   [signal]

Signal that is emitted in response to an unlockAll(), unlockAllIncoming(), or unlockAllOutgoing() call. If result is QTelephony::OK, then the request was successful. Otherwise the request failed (usually because the call barring password was incorrect).

See also unlockAll(), unlockAllIncoming(), and unlockAllOutgoing().