📄 phonecall.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"><!-- /home/edba/dist/qtopia/main-Sunday/qtopia/src/libraries/qtopiaphone/phone.cpp:27 --><html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>PhoneCall Class</title><style type="text/css"><!--h3.fn,span.fn { margin-left: 1cm; text-indent: -1cm; }a:link { color: #004faf; text-decoration: none }a:visited { color: #672967; text-decoration: none }body { background: #ffffff; color: black; }--></style></head><body><table border="0" cellpadding="0" cellspacing="0" width="100%"><tr><td width="200" align="left" valign="top"><a href="index.html"><img height="27" width="472" src="dochead.png" border="0"></a><br><font face="Arial,Helvetica,Geneva,Swiss,SunSans-Regular" align="center" size=32>Qtopia</font> <a href="index.html">Home</a> - <a href="qtopiaclasses.html">Classes</a> - <a href="qtopiaannotated.html">Annotated</a> - <a href="qtopiafunctions.html">Functions</a> - <a href="qtindex.html">Qt Embedded</a></td><td align="right" valign="top"> <table border="0" cellpadding="0" cellspacing="0" width="137"> <tr> <td><a href="http://www.trolltech.com/company/about/trolls.html"><img height="100" width="100" src="face.png" border="0"></a></td> <td><img height="100" width="100" src="qtlogo.png" align="top" border="0"></td> </tr> </table></td></tr></table><h1 align=center>PhoneCall Class Reference</h1><p>Implementation of a single incoming or outgoing phone call.<a href="#details">More...</a><p><tt>#include <<a href="phone-h.html">phone.h</a>></tt><p><a href="phonecall-members.html">List of all member functions.</a><h2>Public Members</h2><ul><li><div class=fn><b>PhoneCall</b> ()</div></li><li><div class=fn><b>PhoneCall</b> ( const PhoneCall & call )</div></li><li><div class=fn><b>~PhoneCall</b> ()</div></li><li><div class=fn>enum <a href="#State-enum"><b>State</b></a> { Idle, Incoming, Dialing, Connected, Hold, HangupLocal, HangupRemote, Missed, NetworkFailure, OtherFailure }</div></li><li><div class=fn>enum <a href="#Scope-enum"><b>Scope</b></a> { CallOnly, Group }</div></li><li><div class=fn>enum <a href="#Request-enum"><b>Request</b></a> { HoldFailed, JoinFailed }</div></li><li><div class=fn>enum <b>CallType</b> { Voice, Data, Fax }</div></li><li><div class=fn>int <a href="#id"><b>id</b></a> () const</div></li><li><div class=fn>PhoneCall & <a href="#operator-eq"><b>operator=</b></a> ( const PhoneCall & call )</div></li><li><div class=fn>PhoneLine & <a href="#line"><b>line</b></a> () const</div></li><li><div class=fn>QString <a href="#fullNumber"><b>fullNumber</b></a> () const</div></li><li><div class=fn>QString <a href="#number"><b>number</b></a> () const</div></li><li><div class=fn>State <a href="#state"><b>state</b></a> () const</div></li><li><div class=fn>CallType <a href="#callType"><b>callType</b></a> () const</div></li><li><div class=fn>QDateTime <a href="#startTime"><b>startTime</b></a> () const</div></li><li><div class=fn>QDateTime <a href="#endTime"><b>endTime</b></a> () const</div></li><li><div class=fn>bool <a href="#hasBeenConnected"><b>hasBeenConnected</b></a> () const</div></li><li><div class=fn>bool <b>idle</b> () const</div></li><li><div class=fn>bool <b>incoming</b> () const</div></li><li><div class=fn>bool <b>dialing</b> () const</div></li><li><div class=fn>bool <b>connected</b> () const</div></li><li><div class=fn>bool <b>onHold</b> () const</div></li><li><div class=fn>bool <b>dropped</b> () const</div></li><li><div class=fn>bool <b>missed</b> () const</div></li><li><div class=fn>bool <a href="#dialed"><b>dialed</b></a> () const</div></li><li><div class=fn>QString <a href="#pendingTones"><b>pendingTones</b></a> () const</div></li><li><div class=fn>void <a href="#dial"><b>dial</b></a> ( const QString & number, bool sendcallerid )</div></li><li><div class=fn>void <a href="#accept"><b>accept</b></a> ()</div></li><li><div class=fn>void <b>hangup</b> ( Scope scope = Group )</div></li><li><div class=fn>void <a href="#hold"><b>hold</b></a> ()</div></li><li><div class=fn>void <b>activate</b> ( Scope scope = Group )</div></li><li><div class=fn>void <a href="#join"><b>join</b></a> ( bool detachSubscriber = FALSE )</div></li><li><div class=fn>void <a href="#tone"><b>tone</b></a> ( const QString & tones )</div></li><li><div class=fn>void <a href="#transfer"><b>transfer</b></a> ( const QString & number )</div></li><li><div class=fn>void <a href="#connectPendingTonesChanged"><b>connectPendingTonesChanged</b></a> ( QObject * object, const char * slot )</div></li><li><div class=fn>void <b>connectStateChanged</b> ( QObject *, const char * )</div></li><li><div class=fn>void <a href="#disconnectStateChanged"><b>disconnectStateChanged</b></a> ( QObject * object, const char * slot )</div></li><li><div class=fn>void <a href="#connectRequestFailed"><b>connectRequestFailed</b></a> ( QObject * object, const char * slot )</div></li><li><div class=fn>void <a href="#disconnectRequestFailed"><b>disconnectRequestFailed</b></a> ( QObject * object, const char * slot )</div></li></ul><hr><a name="details"></a><h2>Detailed Description</h2>Implementation of a single incoming or outgoing phone call.<p> The PhoneCall class refers to a single outgoing or incoming on aphone line. Calls may be in a number of states: idle, dialing,incoming, connected, hold, hangup, etc. PhoneCall instances actas identifiers for actual call objects. The actual object disappearswhen the last identifier instance is dropped.<p> <p>See also <a href="phoneline.html">PhoneLine</a>, <a href="phoneutils.html">PhoneUtils</a> and <a href="qtopiaphone.html">Qtopia Phone Classes</a>.<hr><h2>Member Type Documentation</h2><h3 class=fn><a name="Request-enum"></a>PhoneCall::Request</h3>Defines the Request types, for reporting failures.<ul><li><tt>PhoneCall::HoldFailed</tt><li><tt>PhoneCall::JoinFailed</tt></ul><h3 class=fn><a name="Scope-enum"></a>PhoneCall::Scope</h3>Defines the scope of an operation.<ul><li><tt>PhoneCall::CallOnly</tt> - Only the referenced call.<li><tt>PhoneCall::Group</tt> - All calls in the same active/held group.</ul><h3 class=fn><a name="State-enum"></a>PhoneCall::State</h3>This enum defines the different states a phonecall can have.<ul><li><tt>PhoneCall::Idle</tt> - New outgoing call, not dialed yet.<li><tt>PhoneCall::Incoming</tt> - Incoming connection from remote party.<li><tt>PhoneCall::Dialing</tt> - Dialing, but not yet connected.<li><tt>PhoneCall::Connected</tt> - Connected to the other party.<li><tt>PhoneCall::Hold</tt> - Connected, but currently on hold.<li><tt>PhoneCall::HangupLocal</tt> - Local side hung up the call.<li><tt>PhoneCall::HangupRemote</tt> - Remote side hung up the call, or call lost.<li><tt>PhoneCall::Missed</tt> - Incoming call that was missed.<li><tt>PhoneCall::NetworkFailure</tt> - Network has failed in some way.<li><tt>PhoneCall::OtherFailure</tt> - Something else went wrong.</ul><hr><h2>Member Function Documentation</h2><h3 class=fn>void <a name="accept"></a>PhoneCall::accept ()</h3>Accept an incoming call (must be in the Incoming state).All active calls are automatically put on hold.<h3 class=fn>CallType <a name="callType"></a>PhoneCall::callType () const</h3>Get the type of call (voice, data, etc).<h3 class=fn>void <a name="connectPendingTonesChanged"></a>PhoneCall::connectPendingTonesChanged ( QObject * object, const char * slot )</h3>Register a slot to receive notification of state changes. The signalprototype is "stateChanged( const PhoneCall& call )".<h3 class=fn>void <a name="connectRequestFailed"></a>PhoneCall::connectRequestFailed ( QObject * object, const char * slot )</h3>Register a slot to receive notification of request failures. The signalprototype is "requestFailed( const PhoneCall& call, Request request )".<h3 class=fn>void <a name="dial"></a>PhoneCall::dial ( const QString & number, bool sendcallerid )</h3>Dial a number on this call (must be in the Idle state).The user must ensure there is space for this call on the <a href="phoneline.html">PhoneLine</a>.<p> If <em>sendcallerid</em> is TRUE, the caller ID is enabled(on the assumption that it is normally disabled).<h3 class=fn>bool <a name="dialed"></a>PhoneCall::dialed () const</h3>Returns TRUE if this call was dialed, FALSE otherwise.<h3 class=fn>void <a name="disconnectRequestFailed"></a>PhoneCall::disconnectRequestFailed ( QObject * object, const char * slot )</h3>Un-register a slot to receive notification of request failures. The signalprototype is "requestFailed( const PhoneCall& call, Request request )".<h3 class=fn>void <a name="disconnectStateChanged"></a>PhoneCall::disconnectStateChanged ( QObject * object, const char * slot )</h3>Un-register a slot to receive notification of state changes. The signalprototype is "stateChanged( const PhoneCall& call )".<h3 class=fn>QDateTime <a name="endTime"></a>PhoneCall::endTime () const</h3>Returns the date and time this called ended.If the call never connected a null QDateTime is returned.<h3 class=fn>QString <a name="fullNumber"></a>PhoneCall::fullNumber () const</h3>Get the full number of the remote party. This is the literal number that was dialed including affixes. QString::null if unknown.<h3 class=fn>bool <a name="hasBeenConnected"></a>PhoneCall::hasBeenConnected () const</h3>Returns TRUE if this call has been in the state PhoneCall::Connectedat some stage, otherwise FALSE.<h3 class=fn>void <a name="hold"></a>PhoneCall::hold ()</h3>Put this active call, and all other active calls, on hold.If there were calls on hold or waiting, then activate them.<h3 class=fn>int <a name="id"></a>PhoneCall::id () const</h3>Returns the id of this phone call. This is a unique integer amongall PhoneCall objects across all lines.<h3 class=fn>void <a name="join"></a>PhoneCall::join ( bool detachSubscriber = FALSE )</h3>Join the active and held calls together and make them all active.<h3 class=fn><a href="phoneline.html">PhoneLine</a> & <a name="line"></a>PhoneCall::line () const</h3>Get the phone line that was used to create this call object.The return value will be invalid if this is a null call.<h3 class=fn>QString <a name="number"></a>PhoneCall::number () const</h3>Get the phone number of the remote party. QString::null if unknown.<h3 class=fn><a href="phonecall.html">PhoneCall</a> & <a name="operator-eq"></a>PhoneCall::operator= ( const <a href="phonecall.html">PhoneCall</a> & call )</h3>Copy <em>call</em> object.<h3 class=fn>QString <a name="pendingTones"></a>PhoneCall::pendingTones () const</h3>Returns the pending tones for this call.<h3 class=fn>QDateTime <a name="startTime"></a>PhoneCall::startTime () const</h3>Returns the date and time that this called started.For calls that are never connected this is the time thecall was activated.For calls that connected, this is the connection time.<h3 class=fn><a href="phonecall.html#State-enum">State</a> <a name="state"></a>PhoneCall::state () const</h3>Return the state of this call.<h3 class=fn>void <a name="tone"></a>PhoneCall::tone ( const QString & tones )</h3>Send a sequence of DTMF tones over the call. Ignoredif the call is not connected, or it is on hold.<h3 class=fn>void <a name="transfer"></a>PhoneCall::transfer ( const QString & number )</h3>Transfer the call to a new number and then discontinue this call.<!-- eof --><hr><p>This file is part of the <a href="../index.html">Qtopia</a> platform,copyright © 1995-2004<a href="http://www.trolltech.com/">Trolltech</a>, all rights reserved.<p><address><hr><div align="center"><table width="100%" cellspacing="0" border="0"><tr><td>Copyright © 2001-2004 Trolltech<td><a href="http://www.trolltech.com/trademarks.html">Trademarks</a><td align="right"><div align="right">Qtopia version 2.0.0</div></table></div></address></body></html>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -