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

DialerService Class Reference
[QtTelephonyModule]

The DialerService class provides the Dialer service. More...

    #include <DialerService>

Inherits QtopiaAbstractService.

Inherited by DialProxy.

• List of all members, including inherited members

Public Slots

• virtual void dial ( const QString & name, const QString & number ) = 0
• virtual void dial ( const QString & number, const QUniqueId & contact ) = 0
• virtual void dialVoiceMail () = 0
• virtual void headset () = 0
• virtual void offHook () = 0
• virtual void onHook () = 0
• virtual void redial () = 0
• virtual void setDialToneOnlyHint ( const QString & app ) = 0
• virtual void showDialer ( const QString & digits ) = 0
• virtual void showDialer ()
• virtual void speaker () = 0

• 1 public slot inherited from QObject

Additional Inherited Members

• 1 property inherited from QObject
• 29 public functions inherited from QObject
• 1 signal inherited from QObject
• 1 public type inherited from QObject
• 4 static public members inherited from QObject
• 1 protected function inherited from QtopiaAbstractService
• 7 protected functions inherited from QObject
• 2 protected variables inherited from QObject

Detailed Description

The DialerService class provides the Dialer service.

The Dialer service enables applications to access the system dialer to place outgoing calls.

The DialProxy server task implements this service for Qtopia.

See also DialProxy.

Member Function Documentation

void DialerService::dial ( const QString & name, const QString & number )   [pure virtual slot]

Dials the specified number, tagged with the optional name.

This slot corresponds to the QCop service message Dialer::dial(QString,QString).

void DialerService::dial ( const QString & number, const QUniqueId & contact )   [pure virtual slot]

This is an overloaded member function, provided for convenience.

Dials the specified contact, using the given number.

This slot corresponds to the QCop service message Dialer::dial(QUniqueId,QString).

void DialerService::dialVoiceMail ()   [pure virtual slot]

Dials the user's voice mail service.

This slot corresponds to the QCop service message Dialer::dialVoiceMail().

void DialerService::headset ()   [pure virtual slot]

Turns on or off the headset.

void DialerService::offHook ()   [pure virtual slot]

Displays the dialer if the application's guesture hint is QtopiaApplication::ShowDialer otherwise plays dial tone.

void DialerService::onHook ()   [pure virtual slot]

Hangs up a call if any, otherwise closes dialer screen and stops playing dial tone.

void DialerService::redial ()   [pure virtual slot]

Redials the last phone number.

void DialerService::setDialToneOnlyHint ( const QString & app )   [pure virtual slot]

Sets the dial tone only hint for app.

This hint is used by the phone server to determine whether the dialer should be shown or not when a dialing guesture has occurred depending on the active applications preference.

For example, if the application does not have the capability to initiate phone calls and a dialing guesture occurred by picking up the receiver or pressing the speaker phone button, that means the user wants to type in a phone number. Hence the dialer should be shown. However, applications such as contacts and call history can initiate phone calls by selecting the number or pressing the button within the application and the dialing guesture doesn't mean typing the number in.

void DialerService::showDialer ( const QString & digits )   [pure virtual slot]

Displays the dialer, preloaded with digits.

This slot corresponds to the QCop service message Dialer::showDialer(QString).

void DialerService::showDialer ()   [virtual slot]

This is an overloaded member function, provided for convenience.

Displays the dialer and clears all digits.

This slot corresponds to the QCop service message Dialer::showDialer().

void DialerService::speaker ()   [pure virtual slot]

Turns on or off the speaker.