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

QCallSettings Class Reference
[QtTelephonyModule]

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

    #include <QCallSettings>

Inherits QCommInterface.

Inherited by QModemCallSettings.

Public Types

Public Functions

Public Slots

Signals

Additional Inherited Members


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.

ConstantValueDescription
QCallSettings::Subscription0Caller ID restriction is according to the network operator's subscription preferences.
QCallSettings::Invoked1Caller ID restriction is currently invoked. That is, the caller ID information of the local party will not be sent during calls.
QCallSettings::Suppressed2Caller ID restriction is currently suppressed. That is, the caller ID information of the local party will be sent during calls.

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.

ConstantValueDescription
QCallSettings::NotProvisioned0The caller ID restriction service is not provisioned.
QCallSettings::Permanent1The caller ID restriction service is provisioned in permanent mode and the local user cannot change it.
QCallSettings::Unknown2The caller ID restriction state is currently unknown (e.g. no network).
QCallSettings::TemporaryRestricted3The caller ID restriction service is provisioned in temporary restricted mode.
QCallSettings::TemporaryAllowed4The caller ID restriction service is provisioned in temporary allowed mode.

enum QCallSettings::PresentationStatus

This enum defines the presentation status of caller id information.

ConstantValueDescription
QCallSettings::PresentationNotProvisioned0Presentation of caller id has not been provisioned by the network operator.
QCallSettings::PresentationProvisioned1Presentation of caller id has been provisioned by the network operator.
QCallSettings::PresentationUnknown2Presentation status is unknown, probably because of no network service.

enum QCallSettings::SmsTransport

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

ConstantValueDescription
QCallSettings::SmsTransportPD0Use GPRS packet domain to send SMS messages.
QCallSettings::SmsTransportCS1Use non-GPRS circuit switching to send SMS messages.
QCallSettings::SmsTransportPDPreferred2Use GPRS packet domain if available, or non-GPRS circuit switched otherwise.
QCallSettings::SmsTransportCSPreferred3Use non-GPRS circuit switching if available, or GPRS packet domain otherwise.
QCallSettings::SmsTransportUnavailable4The modem does not support selecting an SMS transport.


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


Copyright © 2009 Nokia Trademarks
Qt Extended 4.4.3