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

DialerControl Class Reference
[QtTelephonyModule]

The DialerControl class provides a convenient interface to the phone call manager. More...

    #include <DialerControl>

Inherits QObject.

• List of all members, including inherited members

Public Functions

• QList<QPhoneCall> activeCalls () const
• uint activeCallsCount () const
• QList<QPhoneCall> allCalls () const
• QCallList & callList ()
• bool callerIdNeeded ( const QString & n ) const
• QList<QPhoneCall> callsOnHold () const
• uint callsOnHoldCount () const
• bool hasActiveCalls () const
• bool hasCallsOnHold () const
• bool hasIncomingCall () const
• QPhoneCall incomingCall () const
• bool isConnected () const
• bool isDialing () const
• int missedCallCount () const

• 29 public functions inherited from QObject

Public Slots

• void accept ()
• void activateCall ( int id )
• void deflect ( const QString & number )
• void dial ( const QString & number, bool sendcallerid, const QString & callType = "Voice", const QUniqueId & contact = QUniqueId() )
• void endAllCalls ()
• void endCall ()
• void endCall ( int id )
• void endHeldCalls ()
• void hold ()
• void join ()
• void recordCall ( const QPhoneCall & call )
• void resetMissedCalls ()
• void sendBusy ()
• void transfer ()
• void unhold ()

• 1 public slot inherited from QObject

Signals

• void activeCount ( int activeCalls )
• void autoAnswerCall ()
• void callConnected ( const QPhoneCall & call )
• void callControlRequested ()
• void callControlSucceeded ()
• void callCreated ( const QPhoneCall & call )
• void callDialing ( const QPhoneCall & call )
• void callDropped ( const QPhoneCall & call )
• void callIncoming ( const QPhoneCall & call )
• void callMissed ( const QPhoneCall & call )
• void callPutOnHold ( const QPhoneCall & call )
• void missedCount ( int missedCalls )
• void modifyDial ( QDialOptions & options, bool & handledAlready )
• void pendingTonesChanged ( const QPhoneCall & call )
• void requestFailed ( const QPhoneCall & call, QPhoneCall::Request request )
• void stateChanged ()

• 1 signal inherited from QObject

Static Public Members

• DialerControl * instance ()

• 4 static public members inherited from QObject

Additional Inherited Members

• 1 property inherited from QObject
• 1 public type inherited from QObject
• 7 protected functions inherited from QObject
• 2 protected variables inherited from QObject

Detailed Description

The DialerControl class provides a convenient interface to the phone call manager.

The DialerControl class make making calls and keeping track of calls simpler than dealing with QPhoneCallManager class directly. It provides a reusable block of functionality that simplifies the common model of managing calls.

This class is part of the Qt Extended server and cannot be used by other Qt Extended applications.

Member Function Documentation

void DialerControl::accept ()   [slot]

Accepts an incoming call. Has no effect if there is no incoming call.

void DialerControl::activateCall ( int id )   [slot]

Activate a specific call with the modem identifier id. This will typically only work with GSM calls that set the QPhoneCall::modemIdentifier() value. It is used to implement the GSM 2x SEND key sequence where x is the identifier.

QList<QPhoneCall> DialerControl::activeCalls () const

Returns the list of calls in the active state (i.e. not on hold).

uint DialerControl::activeCallsCount () const

Returns the number of active calls (i.e. calls not on hold).

void DialerControl::activeCount ( int activeCalls )   [signal]

Emitted whenever the number of activeCalls changes.

QList<QPhoneCall> DialerControl::allCalls () const

Returns the list of all calls in the system.

void DialerControl::autoAnswerCall ()   [signal]

Emitted whenever auto answer is enabled and the auto answer time has elapsed.

void DialerControl::callConnected ( const QPhoneCall & call )   [signal]

This signal is emitted when an outgoing call is connected. call is the associated QPhoneCall object.

void DialerControl::callControlRequested ()   [signal]

This signal is emitted when a call control operations such as hold, resume and join are requested.

void DialerControl::callControlSucceeded ()   [signal]

This signal is emitted when a call control operation such as hold, resume and join are successful.

void DialerControl::callCreated ( const QPhoneCall & call )   [signal]

This signal is emitted whenever any new call is created. call is the associated QPhoneCall object.

void DialerControl::callDialing ( const QPhoneCall & call )   [signal]

This signal is emitted when a call begins dialing. call is the associated QPhoneCall object.

void DialerControl::callDropped ( const QPhoneCall & call )   [signal]

This signal is emitted when a call is dropped or missed. call is the associated QPhoneCall object.

void DialerControl::callIncoming ( const QPhoneCall & call )   [signal]

This signal is emitted when an incoming call arrives. call is the associated QPhoneCall object.

QCallList & DialerControl::callList ()

Returns the current list of calls.

void DialerControl::callMissed ( const QPhoneCall & call )   [signal]

This signal is emitted when a call is considered missed. call is the associated QPhoneCall object.

void DialerControl::callPutOnHold ( const QPhoneCall & call )   [signal]

This signal is emitted when a call is placed on hold. call is the associated QPhoneCall object.

bool DialerControl::callerIdNeeded ( const QString & n ) const

Returns true if the user wants to send callerID information to the number n.

QList<QPhoneCall> DialerControl::callsOnHold () const

Returns the list of calls on hold.

uint DialerControl::callsOnHoldCount () const

Returns the number of calls on hold.

void DialerControl::deflect ( const QString & number )   [slot]

Deflect the incoming call to a new number.

void DialerControl::dial ( const QString & number, bool sendcallerid, const QString & callType = "Voice", const QUniqueId & contact = QUniqueId() )   [slot]

Dials a number if there are no currently active calls. If a contact is specified, it is used as the contact to display and insert into the call history. Before calling this function, you should check that there are no incoming calls, or active calls. If sendcallerid is true, then send the caller's identifier as part of the dial sequence.

If callType is "Voice" a GSM call will be dialed. If callType is "VoIP" a VoIP call will be dialed.

void DialerControl::endAllCalls ()   [slot]

Ends all calls, whether dialing, active, incoming, or on hold.

void DialerControl::endCall ()   [slot]

Ends the current call(s). The current call(s) is searched for in this order:

1. Currently dialing call 2. Active calls 3. Incoming call 4. Calls on Hold

void DialerControl::endCall ( int id )   [slot]

This is an overloaded member function, provided for convenience.

End a specific call with the modem identifier id. This will typically only work with GSM calls that set the QPhoneCall::modemIdentifier() value. It is used to implement the GSM 1x SEND key sequence where x is the identifier.

void DialerControl::endHeldCalls ()   [slot]

End the held calls.

bool DialerControl::hasActiveCalls () const

Returns true if there are any active calls (i.e. calls not on hold).

bool DialerControl::hasCallsOnHold () const

Returns true if there are any calls on hold.

bool DialerControl::hasIncomingCall () const

Returns true if there is an incoming call (i.e. not yet answered).

void DialerControl::hold ()   [slot]

Places the active calls on hold. If there were calls already on hold, they will become active.

QPhoneCall DialerControl::incomingCall () const

Returns the incoming call. If there is no incoming call, a null QPhoneCall is returned.

DialerControl * DialerControl::instance ()   [static]

Return the single instance of DialerControl

bool DialerControl::isConnected () const

Returns true if there are any calls active or on hold.

bool DialerControl::isDialing () const

Returns true if there is an outgoing call currently dialing, but not yet connected.

void DialerControl::join ()   [slot]

Joins the active calls and calls on hold to form a multiparty call.

int DialerControl::missedCallCount () const

Returns the number of missed calls.

void DialerControl::missedCount ( int missedCalls )   [signal]

Emitted whenever the number of missedCalls changes.

void DialerControl::modifyDial ( QDialOptions & options, bool & handledAlready )   [signal]

Emitted whenever a dial is about to be performed with the information in options. This gives other parts of the server (e.g. GsmKeyActions) the ability to modify the request if it contains supplementary service information. The handledAlready parameter is set to false prior to emitting the signal. If a slot sets this to true, then DialerControl will assume that the request was already handled and the normal dial should not be performed.

void DialerControl::pendingTonesChanged ( const QPhoneCall & call )   [signal]

Emitted whenever the pending tones for the call changes.

void DialerControl::recordCall ( const QPhoneCall & call )   [slot]

Record the call in the call list.

void DialerControl::requestFailed ( const QPhoneCall & call, QPhoneCall::Request request )   [signal]

Emitted if the request on call fails.

void DialerControl::resetMissedCalls ()   [slot]

Reset the missed call count to 0.

void DialerControl::sendBusy ()   [slot]

Sends a busy signal to an incoming call.

void DialerControl::stateChanged ()   [signal]

This signal is emitted when any call state changes.

void DialerControl::transfer ()   [slot]

Joins the active calls and calls on hold to form a multiparty call, and then detaches the local user.

void DialerControl::unhold ()   [slot]

Makes calls on hold active.