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

QCallForwarding Class Reference
[QtTelephonyModule]

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

    #include <QCallForwarding>

Inherits QCommInterface.

Inherited by QModemCallForwarding.

List of all members, including inherited members

Public Types

class Status
enum Reason { Unconditional, MobileBusy, NoReply, NotReachable, All, AllConditional }

Public Functions

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

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

Public Slots

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

1 public slot inherited from QObject

Signals

void forwardingStatus ( QCallForwarding::Reason reason, const QList<QCallForwarding::Status> & status )
void setForwardingResult ( QCallForwarding::Reason reason, 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 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.

Member Type Documentation

enum QCallForwarding::Reason

Specifies the reason for a forwarding request.

Constant	Value	Description
`QCallForwarding::Unconditional`	`0`	Forward all calls unconditionally.
`QCallForwarding::MobileBusy`	`1`	Forward calls when the mobile is busy on another call.
`QCallForwarding::NoReply`	`2`	Forward calls when no reply within a certain time period.
`QCallForwarding::NotReachable`	`3`	Forward calls when the mobile is not reachable.
`QCallForwarding::All`	`4`	Special value to modify all forwarding rules. This is typically used to turn off all forwarding.
`QCallForwarding::AllConditional`	`5`	Special value to modify all conditional forwarding rules. This is typically used to turn off all conditional forwarding.

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.

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.

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.

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.

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

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

QCallForwarding Class Reference[QtTelephonyModule]