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

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.

List of all members, including inherited members

Public Types

enum IncomingNotification { MT_Forwarded, MT_ClosedUserGroup, MT_Hold, MT_Retrieved, ..., MT_AdditionalIncomingForwarded }
enum OutgoingNotification { MO_UnconditionalForwardingActive, MO_ConditionalForwardingActive, MO_Forwarded, MO_Waiting, ..., MO_Deflected }
enum UnstructuredAction { NoFurtherActionRequired, FurtherActionRequired, TerminatedByNetwork, OtherLocalClientResponded, OperationNotSupported, NetworkTimeout }

Public Functions

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

1 public function inherited from QCommInterface
4 public functions inherited from QAbstractIpcInterface
29 public functions inherited from QObject

Public Slots

virtual void cancelUnstructuredSession ()
virtual void sendSupplementaryServiceData ( const QString & data )
virtual void sendUnstructuredData ( const QString & data )

1 public slot inherited from QObject

Signals

void incomingNotification ( QSupplementaryServices::IncomingNotification type, int groupIndex, const QString & number )
void outgoingNotification ( QSupplementaryServices::OutgoingNotification type, int groupIndex )
void supplementaryServiceResult ( QTelephony::Result result )
void unstructuredNotification ( QSupplementaryServices::UnstructuredAction action, const QString & data )
void unstructuredResult ( QTelephony::Result result )

1 signal inherited from QAbstractIpcInterface
1 signal inherited from QObject

Additional Inherited Members

1 property inherited from QObject
1 public type inherited from QObject
4 static public members inherited from QObject
14 protected functions inherited from QAbstractIpcInterface
7 protected functions inherited from QObject
2 protected variables inherited from QObject

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

Member Type Documentation

enum QSupplementaryServices::IncomingNotification

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

Constant	Value	Description
`QSupplementaryServices::MT_Forwarded`	`0`	Call has been forwarded.
`QSupplementaryServices::MT_ClosedUserGroup`	`1`	Closed user group call.
`QSupplementaryServices::MT_Hold`	`2`	Call has been put on hold during a voice call.
`QSupplementaryServices::MT_Retrieved`	`3`	Call has been retrieved during a voice call.
`QSupplementaryServices::MT_MultipartyEntered`	`4`	Multiparty call entered during a voice call.
`QSupplementaryServices::MT_HoldReleased`	`5`	Call on hold has been released during a voice call.
`QSupplementaryServices::MT_ForwardCheck`	`6`	Forward check message received.
`QSupplementaryServices::MT_Alerting`	`7`	Call is being connected (alerting) with the remote party in alerting state in explicit call transfer operation (during a voice call).
`QSupplementaryServices::MT_ExplicitTransfer`	`8`	Call has been connected with the other remote party in explicit call transfer operation (during a voice call or MT call setup).
`QSupplementaryServices::MT_Deflected`	`9`	Call has been deflected.
`QSupplementaryServices::MT_AdditionalIncomingForwarded`	`10`	Additional incoming call forwarded.

enum QSupplementaryServices::OutgoingNotification

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

Constant	Value	Description
`QSupplementaryServices::MO_UnconditionalForwardingActive`	`0`	Unconditional call forwarding is active.
`QSupplementaryServices::MO_ConditionalForwardingActive`	`1`	Some of the conditional call forwardings are active.
`QSupplementaryServices::MO_Forwarded`	`2`	Call has been forwarded.
`QSupplementaryServices::MO_Waiting`	`3`	Call is waiting.
`QSupplementaryServices::MO_ClosedUserGroup`	`4`	Closed user group call.
`QSupplementaryServices::MO_OutgoingCallsBarred`	`5`	Outgoing calls are barred.
`QSupplementaryServices::MO_IncomingCallsBarred`	`6`	Incoming calls are barred.
`QSupplementaryServices::MO_CallerIdSuppressionRejected`	`7`	Caller-Id suppression request has been rejected.
`QSupplementaryServices::MO_Deflected`	`8`	Call 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.

Constant	Value	Description
`QSupplementaryServices::NoFurtherActionRequired`	`0`	No further user action required.
`QSupplementaryServices::FurtherActionRequired`	`1`	Further user action required.
`QSupplementaryServices::TerminatedByNetwork`	`2`	Terminated by network.
`QSupplementaryServices::OtherLocalClientResponded`	`3`	Other local client has responded.
`QSupplementaryServices::OperationNotSupported`	`4`	Operation not supported.
`QSupplementaryServices::NetworkTimeout`	`5`	Network 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.

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.

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.

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

Signal that is emitted to report the result of a call to 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.

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

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

Trademarks

Qt Extended 4.4.3

QSupplementaryServices Class Reference[QtTelephonyModule]