Qtopia Home - Classes - Hierachy - Annotated - Functions - Licenses - Reference

PhoneManager Class Reference

The PhoneManager class performs the overall management of calls and associated user interface. More...

#include <phonemanager.h>

Inherits QObject.

List of all member functions.

Public Members

PhoneManager ( QObject * parent, const char * name = 0 )
~PhoneManager ()
DialerControl * dialerControl () const
CallScreen * callScreen () const
QuickDial * quickDialer () const
Dialer * touchscreenDialer () const
void showDialer ( const QString & digits, bool speedDial = TRUE )
void showCallHistory ( bool missed = FALSE, const QString & hint = QString::null )
void showCallScreen ()
void showAlertDialogs ()
void hideAlertDialogs ()
void hideAll ()
void queryPinRequired ()
void queryPinAuthenticate ( const QString & pin )
void queryPinAuthenticate ( const QString & puk, const QString & npin )
void update ()
int ringTime () const
int missedCallCount () const
enum Registration { NotRegistered = 0, Home = 1, Searching = 2, Denied = 3, Unknown = 4, Roaming = 5 }
enum VoIPRegistration { VoIPLineNotRegistered = 0, VoIPLineRegistered, VoIPSearching, VoIPAuthenticationFailed }
bool activateSpeedDial ( const QString & input )
void setStatusValue ( PhoneStatus::StatusItem item, QVariant value )

Public Slots

void showProfileSelector ()
void dialNumber ( const QString & n, const QUuid & cnt )
void dialNumber ( const QString & n )
void acceptIncoming ()
void muteRing ()
void nextRing ()
void setPhoneEnabled ( bool enable )
void queryPhoneEnabled ()
void queryCallForwarding ()
void increaseEarVolume ()
void decreaseEarVolume ()
void dialVoiceMail ()

Signals

void missedCount ( int )
void messageCount ( int )
void activeCallCount ( int )
void locationChanged ( const QString & )
void registrationChanged ( PhoneManager::Registration, PhoneManager::VoIPRegistration )
void phoneEnabled ( bool )
void callForwardingEnabled ( bool )
void pinUnlocked ()
void pinRequired ( const QString & pin )
void pinError ()
void operatorChanged ( const QString & )
void smsStoreFull ( bool )

Static Public Members

PhoneManager * instance ()
const QStringList & emergencyNumbers ()

Protected Members

virtual void timerEvent ( QTimerEvent * )

Detailed Description

The PhoneManager class performs the overall management of calls and associated user interface.

Member Type Documentation

PhoneManager::Registration

PhoneManager::NotRegistered - no network is registered
PhoneManager::Home - home network is currently registered
PhoneManager::Searching - searching for a network
PhoneManager::Denied - connection to network denied
PhoneManager::Unknown
PhoneManager::Roaming - connected to a network away from your home network.

Member Function Documentation

PhoneManager::PhoneManager ( QObject * parent, const char * name = 0 )

Constructs the PhoneManager class. There should only ever be one PhoneManager object.

void PhoneManager::acceptIncoming () `[slot]`

Accepts an incoming call. Has no affect if an incoming call is not currently available.

bool PhoneManager::activateSpeedDial ( const QString & input )

Activate speed dial associated with input.

void PhoneManager::activeCallCount ( int ) `[signal]`

This signal is emitted when the number of calls changes, including calls on hold, incoming calls, and outgoing calls.

void PhoneManager::callForwardingEnabled ( bool ) `[signal]`

This signal is emitted in response to a call forwarding query.

CallScreen * PhoneManager::callScreen () const

returns the call screen object.

void PhoneManager::decreaseEarVolume () `[slot]`

Decreases the earpiece volume.

Note: this affects the user interface only. Hardware specific code must be added to modify the actual earpiece volume.

void PhoneManager::dialNumber ( const QString & n, const QUuid & cnt ) `[slot]`

Dials number n, displaying the contact with the QUuid specified in cnt as the contact being called. The current call state is first checked to confirm that it is possible to make a call. If it is not possible to make a call, the user will be notified, otherwise the call screen will be shown and the call initiated.

void PhoneManager::dialNumber ( const QString & n ) `[slot]`

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

Dials number n. The current call state is first checked to confirm that it is possible to make a call. If it is not possible to make a call, the user will be notified, otherwise the call screen will be shown and the call initiated.

void PhoneManager::dialVoiceMail () `[slot]`

Dial the voice mail number in the SIM.

DialerControl * PhoneManager::dialerControl () const

Returns the DialerControl object that this object is managing.

const QStringList & PhoneManager::emergencyNumbers () `[static]`

Returns the list of emergency numbers.

void PhoneManager::hideAlertDialogs ()

Hides the Missed Calls and New Messages dialogs if they are visible.

void PhoneManager::hideAll ()

Hides the Call History, Dialer and Call Screen.

void PhoneManager::increaseEarVolume () `[slot]`

Increases the earpiece volume.

Note: this affects the user interface only. Hardware specific code must be added to modify the actual earpiece volume.

PhoneManager * PhoneManager::instance () `[static]`

Returns the current PhoneManager instance.

void PhoneManager::locationChanged ( const QString & ) `[signal]`

This signal is emitted when the cell location changes.

void PhoneManager::messageCount ( int ) `[signal]`

This signal is emitted when the number of new messages changes.

void PhoneManager::missedCount ( int ) `[signal]`

This signal is emitted when the number off missed calls changes.

void PhoneManager::muteRing () `[slot]`

Makes the ringing stop, but does not reject the incoming call.

void PhoneManager::phoneEnabled ( bool ) `[signal]`

This signal is emitted when the modem is enabled/disabled.

void PhoneManager::pinError () `[signal]`

This signal is emitted if the incorrect PIN is entered.

void PhoneManager::pinRequired ( const QString & pin ) `[signal]`

This signal is emitted if a PIN is required. pin is one of:

SIM PIN
SIM PIN2
SIM PUK

void PhoneManager::pinUnlocked () `[signal]`

This signal is emitted if the PIN was accepted.

void PhoneManager::queryCallForwarding () `[slot]`

Queries the modem for the call forwarding state. The results is returned by the callForwardingEnabled(bool) signal.

void PhoneManager::queryPhoneEnabled () `[slot]`

Queryies whether the modem is on. The result will the returned by the phoneEnabled(bool) signal.

void PhoneManager::queryPinAuthenticate ( const QString & pin )

Sends the PIN pin to the modem.

The results will be returned by the pinRequired(const QString &), pinError(), or pinUnlocked() signals.

void PhoneManager::queryPinAuthenticate ( const QString & puk, const QString & npin )

Sends the PUK puk and and changes the PIN to npin.

The results will be returned by the pinRequired(const QString &), pinError(), or pinUnlocked() signals.

void PhoneManager::queryPinRequired ()

Queries whether a PIN is required. This query also starts modem initialization if it has not yet been initialized.

The results will be returned by the pinRequired(const QString &) or pinUnlocked() signals.

void PhoneManager::setPhoneEnabled ( bool enable ) `[slot]`

If enable is TRUE, the modem is turned on, otherwise the modem is turned off.

void PhoneManager::showAlertDialogs ()

Shows the Missed Calls dialog if there are any missed calls. If there are no missed calls but there are new messages then the New Mesages dialog is shown.

void PhoneManager::showCallHistory ( bool missed = FALSE, const QString & hint = QString::null )

Displays the call history window. If missed is true, the missed calls tab will be on top. If hint is not empty, it is used to highlight a matching call.

void PhoneManager::showCallScreen ()

Displays the call screen.

void PhoneManager::showDialer ( const QString & digits, bool speedDial = TRUE )

Displays the dialer, preloaded with digits. If speedDial is true, the digits will be considered for use in speed dial (press and hold).

void PhoneManager::showProfileSelector () `[slot]`

Shows the Ring Profile settings application.

void PhoneManager::update ()

Emits the following signals. If the modem has been initialized then the signals are emitted immediately, otherwise the signals will be emitted once the modem is initialized.

phoneEnabled(bool)
missedCount(int)
activeCallCount(int)
registrationChanged(PhoneManager::Registration)
operatorChanged(const QString &)
callForwardingEnabled(bool)

Trademarks

Qtopia version 2.2.0

PhoneManager Class Reference

Public Members

Public Slots

Signals

Static Public Members

Protected Members

Detailed Description

Member Type Documentation

PhoneManager::Registration

Member Function Documentation

PhoneManager::PhoneManager ( QObject * parent, const char * name = 0 )

void PhoneManager::acceptIncoming () [slot]

bool PhoneManager::activateSpeedDial ( const QString & input )

void PhoneManager::activeCallCount ( int ) [signal]

void PhoneManager::callForwardingEnabled ( bool ) [signal]

CallScreen * PhoneManager::callScreen () const

void PhoneManager::decreaseEarVolume () [slot]

void PhoneManager::dialNumber ( const QString & n, const QUuid & cnt ) [slot]

void PhoneManager::dialNumber ( const QString & n ) [slot]

void PhoneManager::dialVoiceMail () [slot]

DialerControl * PhoneManager::dialerControl () const

const QStringList & PhoneManager::emergencyNumbers () [static]

void PhoneManager::hideAlertDialogs ()

void PhoneManager::hideAll ()

void PhoneManager::increaseEarVolume () [slot]

PhoneManager * PhoneManager::instance () [static]

void PhoneManager::locationChanged ( const QString & ) [signal]

void PhoneManager::messageCount ( int ) [signal]

void PhoneManager::missedCount ( int ) [signal]

void PhoneManager::muteRing () [slot]

void PhoneManager::phoneEnabled ( bool ) [signal]

void PhoneManager::pinError () [signal]

void PhoneManager::pinRequired ( const QString & pin ) [signal]

void PhoneManager::pinUnlocked () [signal]

void PhoneManager::queryCallForwarding () [slot]

void PhoneManager::queryPhoneEnabled () [slot]