Qtopia Home - Classes - Annotated - Functions - Qt Embedded

PhoneLine Class Reference

Implementation of a single "phone line". More...

#include <phone.h>

List of all member functions.

Public Members

• PhoneLine ( const QString & name = QString::null, QObject * parent = 0 )
• ~PhoneLine ()
• QString name () const
• QValueList<PhoneCall> calls () const
• PhoneCall createCall ()
• PhoneCall active () const
• enum QueryType { Number, Manufacturer, Model, Revision, Serial, BatteryCharge, SignalQuality, CharacterSet, SupportedCharacterSets, AdviceOfCharge, Registration, Operator, AvailableOperators, PricePerUnit, SIMIdentity, VibrateOnRing, SilentMode, ServiceCenter, CallerIdRestriction, LockControlSurface, LockPhoneToSimCard, LockSimCard, BarrAllOutgoing, BarrAllOutgoingIntl, BarrOutgoingIntlExceptHome, BarrAllIncoming, BarrIncomingWhenRoaming, BarrIncomingNotTA, BarrIncomingNotME, BarrIncomingNotSim, BarrIncomingNotAny, AllBarringServices, AllOutgoingBarringServices, AllIncomingBarringServices, SimFixedDialingMemory, ChangeLockControlSurfacePassword, ChangeLockPhoneToSimCardPassword, ChangeLockSimCardPassword, ChangeBarrAllOutgoingPassword, ChangeBarrAllOutgoingIntlPassword, ChangeBarrOutgoingIntlExceptHomePassword, ChangeBarrAllIncomingPassword, ChangeBarrIncomingWhenRoamingPassword, ChangeBarrIncomingNotTAPassword, ChangeBarrIncomingNotMEPassword, ChangeBarrIncomingNotSimPassword, ChangeBarrIncomingNotAnyPassword, ChangeAllBarringServicesPassword, ChangeAllOutgoingBarringServicesPassword, ChangeAllIncomingBarringServicesPassword, ChangeSimFixedDialingMemoryPassword, ClosedUserGroup, ForwardingUnconditional, ForwardingMobileBusy, ForwardingNoReply, ForwardingNotReachable, ForwardingAll, ForwardingAllConditional, CallWaiting, Channels, SimFieldLimits, Functionality, RequiredPin, SendPin, ChangePin, SimInserted, SimRemoved, VibrateNow, InitializationDone, AccessoryStatus }
• void query ( QueryType type ) const
• void modify ( QueryType type, const QString & value )
• class OperatorInfo { }
• enum ClassX { Voice = 1, Data = 2, Fax = 4, Sms = 8 }
• class ForwardRec { }
• SMSRequest * sms ()
• PhoneBook * phoneBook ()
• SimToolkit * simToolkit ()
• void startData ( const QString & number, const QStringList & initCmds, const QStringList & moduleArgs, bool persist )
• void stopData ()

Signals

• void newCall ( const PhoneCall & call )
• void queryResult ( PhoneLine::QueryType type, const QString & value )
• void notification ( PhoneLine::QueryType type, const QString & value )

Static Public Members

• OperatorInfo parseOperator ( const QString &, bool * automatic )
• QString formatOperator ( bool automatic, const QString & opid = QString::null )
• QValueList<OperatorInfo> parseAvailableOperators ( const QString & )
• QString parseServiceCenter ( const QString & )
• bool parseCallerIdRestriction ( const QString &, bool * modifiable = 0 )
• QString formatCallerIdRestriction ( bool on )
• QString formatChannels ( QValueList<int> channels )
• QString formatBarring ( bool enable, const QString & password = QString::null )
• QValueList<ForwardRec> parseForwarding ( const QString & )
• QString formatForwarding ( bool enable, int classx, const QString & number )
• int parseCallWaiting ( const QString & )
• QString formatCallWaiting ( bool enable, int classx )
• QString formatChangePassword ( const QString & op, const QString & np )

Detailed Description

The PhoneLine class abstracts the idea of a single "line" on the local device. Phones will normally only have one line, but it is theoretically possible to have multiple lines, each with its own list of calls. QString::null is used in the constructor to refer to the default line.

The PhoneLine class keeps a list of all "active" calls: those that are dialing, incoming, or connected. Idle and dropped calls are not reported in this list, and the underlying object will disappear when the last PhoneCall reference is dropped.

[Aside: identifier instances are used to represent calls because of race conditions. e.g. a pending call arrives, the user accepts, but before the request can be fully processed, the other party hangs up and the real call object disappears. The identifier system avoids dangling references to deallocated objects. Requests to inactive calls will always "fail safe".]

Because of race conditions, callers should not assume that a request (hangup, accept, etc) succeeded without error. Callers should use the state() function to query the actual state after the request.

See also PhoneCall, PhoneUtils and Qtopia Phone Classes.

Member Function Documentation

PhoneCall PhoneLine::active () const

QValueList<PhoneCall> PhoneLine::calls () const

PhoneCall PhoneLine::createCall ()

void PhoneLine::modify ( QueryType type, const QString & value )

QString PhoneLine::name () const

PhoneBook * PhoneLine::phoneBook ()

SimToolkit * PhoneLine::simToolkit ()

SMSRequest * PhoneLine::sms ()

void PhoneLine::startData ( const QString & number, const QStringList & initCmds, const QStringList & moduleArgs, bool persist )

The initCmds argument is a list of AT commands to send before dialing to initialize the data call.

The moduleArgs argument is the full list of command-line options to launch the data protocol module (e.g. pppd).

If persist is set to TRUE, then it indicates that pppd should be started, but the dial process should not happen yet. The dial will happen only when pppd detects TCP/IP network activity.

void PhoneLine::stopData ()

This file is part of the Qtopia platform, copyright © 1995-2004 Trolltech, all rights reserved.