QCallSettings Class Reference
[QtTelephonyModule]

Detailed Description

The QCallSettings class provides access to auxiliary settings in a GSM phone related to calls.

Other classes such as QCallForwarding, QCallBarring, QNetworkRegistration, etc, are used for specific call settings that have rich interfaces. The QCallSettings class is for minor settings that don't require more than simple request and set methods.

See also QCallForwarding, QCallBarring, and QNetworkRegistration.

Member Type Documentation

enum QCallSettings::CallerIdRestriction

This enum defines the states that the caller ID restriction service can be in.

enum QCallSettings::CallerIdRestrictionStatus

This enum defines the status of the caller ID restriction service within the network, indicating whether it can be modified or not.

enum QCallSettings::PresentationStatus

This enum defines the presentation status of caller id information.

enum QCallSettings::SmsTransport

This enum defines the transport to be used for sending SMS messages.

Member Function Documentation

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

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

See also QCommServiceManager::supports().

QCallSettings::~QCallSettings ()

Destroy this call settings object.

void QCallSettings::callWaiting ( QTelephony::CallClass cls )   [signal]

Signal that is emitted in response to a requestCallWaiting() request. The call classes in cls currently have call waiting enabled. All other classes have call waiting disabled.

See also setCallWaiting() and requestCallWaiting().

void QCallSettings::callerIdPresentation ( QCallSettings::PresentationStatus status )   [signal]

Signal that is emitted to report the current caller id presentation status.

See also requestCallerIdPresentation().

void QCallSettings::callerIdRestriction ( QCallSettings::CallerIdRestriction clir, QCallSettings::CallerIdRestrictionStatus status )   [signal]

Signal that is emitted in response to a requestCallerIdRestriction() request. The current state is specified by the clir and status parameters.

See also setCallerIdRestriction() and requestCallerIdRestriction().

void QCallSettings::connectedIdPresentation ( QCallSettings::PresentationStatus status )   [signal]

Signal that is emitted to report the current connected line id presentation status.

See also requestConnectedIdPresentation().

void QCallSettings::requestCallWaiting ()   [virtual slot]

Request the current call waiting flags. The service responds by emitting the callWaiting() signal.

On AT-based modems, this will typically use the AT+CCWA command.

See also callWaiting().

void QCallSettings::requestCallerIdPresentation ()   [virtual slot]

Request the presentation state of caller id information on incoming calls. The state will be returned via the callerIdPresentation() signal.

On AT-based modems, this will typically use the AT+CLIP command.

See also callerIdPresentation().

void QCallSettings::requestCallerIdRestriction ()   [virtual slot]

Request the current state of the caller ID restriction service. The service responds by emitting the callerIdRestriction() signal.

On AT-based modems, this will typically use the AT+CLIR command.

See also callerIdRestriction().

void QCallSettings::requestConnectedIdPresentation ()   [virtual slot]

Request the presentation state of connected line identification information (COLP). The state will be returned via the connectedIdPresentation() signal.

On AT-based modems, this will typically use the AT+COLP command.

See also connectedIdPresentation().

void QCallSettings::requestSmsTransport ()   [virtual slot]

Request the transport that is being used to send SMS messages. The service responds by emitting the smsTransport() signal.

On AT-based modems, this will typically use the AT+CGSMS command.

See also smsTransport().

void QCallSettings::setCallWaiting ( bool enable, QTelephony::CallClass cls )   [virtual slot]

Enable or disable call waiting for the call classes specified in cls, according to the enable flag. The service responds by emitting the setCallWaitingResult() signal.

On AT-based modems, this will typically use the AT+CCWA command.

See also callWaiting() and setCallWaitingResult().

void QCallSettings::setCallWaitingResult ( QTelephony::Result result )   [signal]

Signal that is emitted to report the result of a setCallWaiting() request.

See also setCallWaiting().

void QCallSettings::setCallerIdRestriction ( QCallSettings::CallerIdRestriction clir )   [virtual slot]

Sets the caller ID restriction state to clir. The service responds by emitting the setCallerIdRestrictionResult() signal.

On AT-based modems, this will typically use the AT+CLIR command.

See also callerIdRestriction() and setCallerIdRestrictionResult().

void QCallSettings::setCallerIdRestrictionResult ( QTelephony::Result result )   [signal]

Signal that is emitted to report the result of a setCallerIdRestriction() request.

See also setCallerIdRestriction().

void QCallSettings::setSmsTransport ( QCallSettings::SmsTransport transport )   [virtual slot]

Sets the transport to be used for sending SMS messages. The service responds by emitting the setSmsTransportResult() signal.

On AT-based modems, this will typically use the AT+CGSMS command.

See also smsTransport() and setSmsTransportResult().

void QCallSettings::setSmsTransportResult ( QTelephony::Result result )   [signal]

Signal that is emitted to report the result of a setSmsTransport() request.

See also setSmsTransport().

void QCallSettings::smsTransport ( QCallSettings::SmsTransport transport )   [signal]

Signal that is emitted in response to a requestSmsTransport() request. The current transport is specified by the transport parameter. If transport is SmsTransportUnavailable, then the modem does not support selecting an SMS transport.

See also setSmsTransport() and requestSmsTransport().