Home · All Classes · Grouped Classes · Annotated · Functions

QCallBarring Class Reference

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

    #include <QCallBarring>

Inherits QCommInterface.

Inherited by QModemCallBarring.

Public Types

Public Functions

Public Slots

Signals

Additional Inherited Members


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.

ConstantValueDescription
QCallBarring::OutgoingAll0All outgoing calls. 3GPP TS 27.007 type AO.
QCallBarring::OutgoingInternational1All outgoing international calls. 3GPP TS 27.007 type OI.
QCallBarring::OutgoingInternationalExceptHome2All outgoing international calls except to home country. 3GPP TS 27.007 type OX.
QCallBarring::IncomingAll3All incoming calls. 3GPP TS 27.007 type AI.
QCallBarring::IncomingWhenRoaming4All incoming calls when roaming. 3GPP TS 27.007 type IR.
QCallBarring::IncomingNonTA5All incoming calls not stored to TA memory. 3GPP TS 27.007 type NT.
QCallBarring::IncomingNonMT6All incoming calls not stored to MT memory. 3GPP TS 27.007 type NM.
QCallBarring::IncomingNonSIM7All incoming calls not stored to SIM/UICC memory. 3GPP TS 27.007 type NS.
QCallBarring::IncomingNonMemory8All incoming calls not stored in any memory. 3GPP TS 27.007 type NA.
QCallBarring::AllBarringServices9All barring services. 3GPP TS 27.007 type AB. This should only be used with QCallBarring::changeBarringPassword().
QCallBarring::AllOutgoingBarringServices10All outgoing barring services. 3GPP TS 27.007 type AG. This should only be used with QCallBarring::changeBarringPassword().
QCallBarring::AllIncomingBarringServices11All incoming barring services. 3GPP TS 27.007 type AC. This should only be used with QCallBarring::changeBarringPassword().


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


Copyright © 2008 Nokia Trademarks
Qtopia 4.3.3