QSupplementaryServices Class Reference
[QtTelephonyModule]

Detailed Description

The QSupplementaryServices class provides access to structured and unstructured supplementary services within GSM networks.

Structured supplementary service data can be sent to the network with sendSupplementaryServiceData() and unstructured supplementary service data can be sent with sendUnstructuredData().

As structured and unstructured supplementary service data is received from the network, the outgoingNotification(), incomingNotification(), and unstructuredNotification() signals will be emitted.

If there is an ongoing unstructured supplementary service session in progress, it can be canceled with cancelUnstructuredSession().

See also QCommInterface.

Member Type Documentation

enum QSupplementaryServices::IncomingNotification

This enum defines notification types for incoming mobile-terminated (MT) calls according to 3GPP TS 27.007.

enum QSupplementaryServices::OutgoingNotification

This enum defines notification types for outgoing mobile-originated (MO) calls according to 3GPP TS 27.007.

enum QSupplementaryServices::UnstructuredAction

This enum defines the action that should be taken for an incoming unstructured supplementary service notification according to 3GPP TS 27.007.

Member Function Documentation

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

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

See also QCommServiceManager::supports().

QSupplementaryServices::~QSupplementaryServices ()

Destroy this supplementary services object.

void QSupplementaryServices::cancelUnstructuredSession ()   [virtual slot]

Cancel the current USSD session. The unstructuredResult() signal will be emitted to indicate the result of canceling the current USSD session.

See also sendUnstructuredData() and unstructuredResult().

void QSupplementaryServices::incomingNotification ( QSupplementaryServices::IncomingNotification type, int groupIndex, const QString & number )   [signal]

Signal that is emitted when a supplementary service notification type arrives for an incoming mobile-terminated (MT) call. If type is MT_ClosedUserGroup, then groupIndex will be the index of the closed user group. Otherwise groupIndex will be zero. If the call was transferred (type equal to MT_ExplicitTransfer), number will be present.

void QSupplementaryServices::outgoingNotification ( QSupplementaryServices::OutgoingNotification type, int groupIndex )   [signal]

Signal that is emitted when a supplementary service notification type arrives for an outgoing mobile-originated (MO) call. If type is MO_ClosedUserGroup, then groupIndex will be the index of the closed user group. Otherwise groupIndex will be zero.

void QSupplementaryServices::sendSupplementaryServiceData ( const QString & data )   [virtual slot]

Sends data as a supplementary service command. On GSM modems, the ATD command is used for this purpose. The data should start with * or #. The sendSupplementaryServiceDataResult() signal will be emitted to indicate the result of sending data.

See also supplementaryServiceResult() and sendUnstructuredData().

void QSupplementaryServices::sendUnstructuredData ( const QString & data )   [virtual slot]

Sends data within the current USSD session. On GSM modems, the AT+CUSD command is used for this purpose. The unstructuredResult() signal will be emitted to indicate the result of sending data.

See also cancelUnstructuredSession(), sendSupplementaryServiceData(), and unstructuredResult().

void QSupplementaryServices::supplementaryServiceResult ( QTelephony::Result result )   [signal]

Signal that is emitted to report the result of a call to sendSupplementaryServiceData().

See also sendSupplementaryServiceData().

void QSupplementaryServices::unstructuredNotification ( QSupplementaryServices::UnstructuredAction action, const QString & data )   [signal]

Signal that is emitted when an unstructured supplementary service notification arrives. The action parameter specifies the action to be taken next in the current session, and data specifies the data provided by the network.

See also cancelUnstructuredSession() and sendUnstructuredData().

void QSupplementaryServices::unstructuredResult ( QTelephony::Result result )   [signal]

Signal that is emitted to report the result of a call to cancelUnstructuredSession() or sendUnstructuredData().

See also cancelUnstructuredSession() and sendUnstructuredData().