QCallForwarding Class Reference
[QtTelephonyModule]

Detailed Description

The QCallForwarding class provides access to the call forwarding settings on a GSM phone.

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

This service permits a called mobile subscriber to have the network send all incoming calls, or just those associated with a specific call type, addressed to the called mobile subscriber's directory number to another directory number. The ability of the served mobile subscriber to originate calls is unaffected.

The current state of call forwarding can be queried using the requestForwardingStatus() function, and changed using the setForwarding() function. The reasons for forwarding (unconditional, mobile busy, no reply, etc) are specified by the QCallForwarding::Reason enumeration.

See also QCommInterface.

Member Type Documentation

enum QCallForwarding::Reason

Specifies the reason for a forwarding request.

Member Function Documentation

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

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

See also QCommServiceManager::supports().

QCallForwarding::~QCallForwarding ()

Destroy this call forwarding object.

void QCallForwarding::forwardingStatus ( QCallForwarding::Reason reason, const QList<QCallForwarding::Status> & status )   [signal]

Signal that is emitted in response to requestForwardingStatus() call for reason. The status parameter contains a list of forwarding rules for the reason code. The list only contains entries for rules where forwarding is enabled for a call class. If no forwarding is not enabled for any call class, the list will be empty.

See also requestForwardingStatus().

void QCallForwarding::requestForwardingStatus ( QCallForwarding::Reason reason )   [virtual slot]

Request the status of the forwarding rules associated with reason. The service responds by emitting the forwardingStatus() signal.

See also forwardingStatus().

void QCallForwarding::setForwarding ( QCallForwarding::Reason reason, const QCallForwarding::Status & status, bool enable )   [virtual slot]

Sets the forwarding state associated with reason to enable, with the number information in status if forwarding is being enabled. The service responds by emitting the setForwardingResult() signal.

See also setForwardingResult().

void QCallForwarding::setForwardingResult ( QCallForwarding::Reason reason, QTelephony::Result result )   [signal]

Signal that is emitted to report the result of calling setForwarding() for reason.

See also setForwarding().