Public Types | Public Slots | Signals | Public Member Functions | Friends

QS60Telephony Class Reference

The QS60Telephony class can be used for establishing circuit switched calls and monitoring the status of the line. Monitoring can be started with the QS60Telephony::startMonitoringLine() function call. More...

List of all members.

Public Types

enum  Error {
  NoError = 0, OutOfMemoryError, AccessDeniedError, TimedOutError,
  UnknownError = -1
}
enum  LineStatus {
  StatusUnknown, StatusIdle, StatusDialling, StatusRinging,
  StatusAnswering, StatusConnecting, StatusConnected, StatusReconnectPending,
  StatusDisconnecting, StatusHold, StatusTransferring, StatusTransferAlerting
}

Public Slots

void call (const QString &phoneNumber)
 Make a phone call.
void answerIncomingCall ()
 Answer incoming call.
void terminateCall ()
 Terminate a call.
void rejectCall ()
 Reject a call.
bool startMonitoringLine ()
void toBackground ()
void stopMonitoringLine ()
void showOnTop ()
void showNormal ()

Signals

void lineStatusChanged (QS60Telephony::LineStatus status, QString number)
void error (QS60Telephony::Error error)
void answered ()
void terminated ()

Public Member Functions

 QS60Telephony (QObject *parent=0)
 ~QS60Telephony ()
Q_INVOKABLE QString IMEI ()
 Read the IMEI Code.
Q_INVOKABLE QS60Telephony::Error error () const

Friends

class QS60TelephonyPrivate

Detailed Description

The QS60Telephony class can be used for establishing circuit switched calls and monitoring the status of the line. Monitoring can be started with the QS60Telephony::startMonitoringLine() function call.


Member Enumeration Documentation

This enum defines the possible errors for a QS60Telephony object.

Enumerator:
NoError 

No error occured.

OutOfMemoryError 

Not enough memory.

UnknownError 

Unknown error.

This enum defines the possible line statuses

Enumerator:
StatusUnknown 

Status is unknown.

StatusIdle 

Status is idle. No active calls.

StatusDialling 

Call dialling status.

StatusRinging 

Call ringing status.

StatusAnswering 

Call answering status.

StatusConnecting 

Call connecting status.

StatusConnected 

Call connected status.

StatusReconnectPending 

Call is undergoing temporary channel loss and it may or may not be reconnected.

StatusDisconnecting 

Call disconnecting status.

StatusHold 

Call status hold.

StatusTransferring 

Call is transferring.

StatusTransferAlerting 

Call in transfer is alerting the remote party.


Constructor & Destructor Documentation

QS60Telephony::QS60Telephony ( QObject *  parent = 0  )  [explicit]

Constructs a QS60Telephony object with the given parent. Call error() to get the QS60Telephony::Error value that indicates if an error occurred during construction.

See also:
call(), error()
QS60Telephony::~QS60Telephony (  ) 

Destroys the QS60Telephony object.


Member Function Documentation

void QS60Telephony::call ( const QString &  phoneNumber  )  [slot]

Make a phone call.

Parameters:
phone number

Initiates new call.

Note: If an error occurs while the call is being established, the error() signal is emitted

Parameters:
phoneNumber Telephone number to call
See also:
error()
void QS60Telephony::error ( QS60Telephony::Error  error  )  [signal]

This signal is emitted when an error occurs during a phone call, i.e. after the call() method is called.

Parameters:
error Error
QS60Telephony::Error QS60Telephony::error (  )  const

Returns the type of error that occurred if the latest function call failed; otherwise returns NoError.

Returns:
Error code
void QS60Telephony::lineStatusChanged ( QS60Telephony::LineStatus  status,
QString  number 
) [signal]

This signal is emitted when line status is changed.

Parameters:
status Current status is retrived as enumeration
number Number if available
See also:
call()
bool QS60Telephony::startMonitoringLine (  )  [slot]

Starts monitoring changes in the line. QS60Telephony::lineStatusChanged(QS60Telephony::LineStatus status, QString number) is emitted when there are changes in the line status(e.g. incoming call etc.).

Returns:
If false is returned, an error has occurred. Call error() to the QS60Telephony::Error value that indicates which error occurred
See also:
error()
void QS60Telephony::stopMonitoringLine (  )  [slot]

Stops monitoring changes in the line status.


The documentation for this class was generated from the following files:
 All Classes Functions Enumerations Enumerator