Home · All Namespaces · All Classes · Grouped Classes · Modules · Functions codeless banner

QSupplementaryServices Class Reference
[QtTelephonyModule]

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

    #include <QSupplementaryServices>

Inherits QCommInterface.

Inherited by QModemSupplementaryServices.

Public Types

Public Functions

Public Slots

Signals

Additional Inherited Members


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.

ConstantValueDescription
QSupplementaryServices::MT_Forwarded0Call has been forwarded.
QSupplementaryServices::MT_ClosedUserGroup1Closed user group call.
QSupplementaryServices::MT_Hold2Call has been put on hold during a voice call.
QSupplementaryServices::MT_Retrieved3Call has been retrieved during a voice call.
QSupplementaryServices::MT_MultipartyEntered4Multiparty call entered during a voice call.
QSupplementaryServices::MT_HoldReleased5Call on hold has been released during a voice call.
QSupplementaryServices::MT_ForwardCheck6Forward check message received.
QSupplementaryServices::MT_Alerting7Call is being connected (alerting) with the remote party in alerting state in explicit call transfer operation (during a voice call).
QSupplementaryServices::MT_ExplicitTransfer8Call has been connected with the other remote party in explicit call transfer operation (during a voice call or MT call setup).
QSupplementaryServices::MT_Deflected9Call has been deflected.
QSupplementaryServices::MT_AdditionalIncomingForwarded10Additional incoming call forwarded.

enum QSupplementaryServices::OutgoingNotification

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

ConstantValueDescription
QSupplementaryServices::MO_UnconditionalForwardingActive0Unconditional call forwarding is active.
QSupplementaryServices::MO_ConditionalForwardingActive1Some of the conditional call forwardings are active.
QSupplementaryServices::MO_Forwarded2Call has been forwarded.
QSupplementaryServices::MO_Waiting3Call is waiting.
QSupplementaryServices::MO_ClosedUserGroup4Closed user group call.
QSupplementaryServices::MO_OutgoingCallsBarred5Outgoing calls are barred.
QSupplementaryServices::MO_IncomingCallsBarred6Incoming calls are barred.
QSupplementaryServices::MO_CallerIdSuppressionRejected7Caller-Id suppression request has been rejected.
QSupplementaryServices::MO_Deflected8Call has been deflected.

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.

ConstantValueDescription
QSupplementaryServices::NoFurtherActionRequired0No further user action required.
QSupplementaryServices::FurtherActionRequired1Further user action required.
QSupplementaryServices::TerminatedByNetwork2Terminated by network.
QSupplementaryServices::OtherLocalClientResponded3Other local client has responded.
QSupplementaryServices::OperationNotSupported4Operation not supported.
QSupplementaryServices::NetworkTimeout5Network time out.


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


Copyright © 2009 Nokia Trademarks
Qt Extended 4.4.3