java.telephony.callcontrol.callcontrolterminalconnection.html

JTAPI_html 用于JTAPI的HTML文档.

<h2>
  <img src="images/methods.gif" width=151 height=38 alt="Methods">
</h2>
<a name="getCallControlState()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="getCallControlState"><b>getCallControlState</b></a>
<pre>
  public abstract int getCallControlState() throws <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
</pre>
<dl>
  <dd> Returns the call control state of the TerminalConnection object.
<p>
  <dl>
    <dt> <b>Returns:</b>
    <dd> The current state of the TerminalConnection object.
    <dt> <b>Throws:</b> <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
    <dd> A platform-specific exception occurred.
  </dl>
</dl>
<a name="hold()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="hold"><b>hold</b></a>
<pre>
  public abstract void hold() throws <a href="java.telephony.InvalidStateException.html#_top_">InvalidStateException</a>, <a href="java.telephony.MethodNotSupportedException.html#_top_">MethodNotSupportedException</a>, <a href="java.telephony.PrivilegeViolationException.html#_top_">PrivilegeViolationException</a>, <a href="java.telephony.ResourceUnavailableException.html#_top_">ResourceUnavailableException</a>, <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
</pre>
<dl>
  <dd> Places a TerminalConnection on hold with respect to the telephone call
of which it is a part. Many TerminalConnections may be involved in a
telephone call which are part of the same address, and any one of them
may go "on hold" at any time provided they are active in the telephone
call. This method returns successfully when the TerminalConnection has
been placed on hold, otherwise an exception is thrown to signal an error.
<p>
This TerminalConnection must be in the TALKING state and the Provider must
be IN_SERVICE. The pre-conditions are given below:
<p>
<OL>
<LI>(this.getTerminal()).getProvider()).getState() == IN_SERVICE
<LI>this.getCallControlState() == TALKING
</OL>
<p>
The post-conditions for this method are as follows:
<OL>
<LI>(terminal.getProvider()).getState() == IN_SERVICE
<LI>this.getCallControlState() == HELD
</OL>
<p>
  <dl>
    <dt> <b>Throws:</b> <a href="java.telephony.InvalidStateException.html#_top_">InvalidStateException</a>
    <dd> The state of some object is not valid
as designated by the pre-conditions for this method.
    <dt> <b>Throws:</b> <a href="java.telephony.MethodNotSupportedException.html#_top_">MethodNotSupportedException</a>
    <dd> This method is not supported by
the implementation.
    <dt> <b>Throws:</b> <a href="java.telephony.PrivilegeViolationException.html#_top_">PrivilegeViolationException</a>
    <dd> The application does not have
the proper authority to invoke this method.
    <dt> <b>Throws:</b> <a href="java.telephony.ResourceUnavailableException.html#_top_">ResourceUnavailableException</a>
    <dd> An internal resource neccessary
for the successful invocation of this method is not available.
    <dt> <b>Throws:</b> <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
    <dd> A platform-specific exception occurred.
  </dl>
</dl>
<a name="unhold()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="unhold"><b>unhold</b></a>
<pre>
  public abstract void unhold() throws <a href="java.telephony.InvalidStateException.html#_top_">InvalidStateException</a>, <a href="java.telephony.MethodNotSupportedException.html#_top_">MethodNotSupportedException</a>, <a href="java.telephony.PrivilegeViolationException.html#_top_">PrivilegeViolationException</a>, <a href="java.telephony.ResourceUnavailableException.html#_top_">ResourceUnavailableException</a>, <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
</pre>
<dl>
  <dd> Takes a TerminalConnection off hold with respect to the telephone call
of which it is a part. Many Terminals may be involved in a telephone
call which are part of the same address, and any one of them may go
"on hold" at any time provided they are active in the telephone call.
This method returns successfully once the TerminalConnection has been
taken off of hold, otherwise an exception is thrown to signal an error.
<p>
This TerminalConnection must be in the HELD state and the Provider must
be IN_SERVICE. These pre-conditions are given below:
<p>
<OL>
<LI>((this.getTerminal()).getProvider()).getState() == IN_SERVICE
<LI>this.getCallControlState() == HELD
</OL>
<p>
The post-conditions for this method are:
<OL>
<LI>((this.getTerminal()).getProvider()).getState() == IN_SERVICE
<LI>this.getCallControlState() == TALKING
</OL>
<p>
  <dl>
    <dt> <b>Throws:</b> <a href="java.telephony.InvalidStateException.html#_top_">InvalidStateException</a>
    <dd> The state of some object is not valid
as designated by the pre-conditions for this method.
    <dt> <b>Throws:</b> <a href="java.telephony.MethodNotSupportedException.html#_top_">MethodNotSupportedException</a>
    <dd> This method is not supported by
the implementation.
    <dt> <b>Throws:</b> <a href="java.telephony.PrivilegeViolationException.html#_top_">PrivilegeViolationException</a>
    <dd> The application does not have
the proper authority to invoke this method.
    <dt> <b>Throws:</b> <a href="java.telephony.ResourceUnavailableException.html#_top_">ResourceUnavailableException</a>
    <dd> An internal resource neccessary
for the successful invocation of this method is not available.
    <dt> <b>Throws:</b> <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
    <dd> A platform-specific exception occurred.
  </dl>
</dl>
<a name="join()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="join"><b>join</b></a>
<pre>
  public abstract void join() throws <a href="java.telephony.InvalidStateException.html#_top_">InvalidStateException</a>, <a href="java.telephony.MethodNotSupportedException.html#_top_">MethodNotSupportedException</a>, <a href="java.telephony.PrivilegeViolationException.html#_top_">PrivilegeViolationException</a>, <a href="java.telephony.ResourceUnavailableException.html#_top_">ResourceUnavailableException</a>, <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
</pre>
<dl>
  <dd> Makes a TerminalConnection which is bridged with a telephone call active
on that
telephone call. Bridging situations exists when another Terminal which
shares an address with this Terminal is active on a telephone call.
This method returns successful when the Terminal has been made active
on this telephone call, otherwise an exception is thrown to signal an
error.
<p>
This TerminalConnection must be in the BRIDGED state and the Provider
must be IN_SERVICE. These pre-conditions are given below:
<p>
<OL>
<LI>((this.getTerminal()).getProvider()).getState() == IN_SERVICE
<LI>this.getCallControlState() == BRIDGED
</OL>
<p>
The post-conditions for this method are:
<OL>
<LI>((this.getTerminal()).getProvider()).getState() == IN_SERVICE
<LI>this.getCallControlState() == TALKING
</OL>
<p>
  <dl>
    <dt> <b>Throws:</b> <a href="java.telephony.InvalidStateException.html#_top_">InvalidStateException</a>
    <dd> The state of some object is not valid
as designated by the pre-conditions for this method.
    <dt> <b>Throws:</b> <a href="java.telephony.MethodNotSupportedException.html#_top_">MethodNotSupportedException</a>
    <dd> This method is not supported by
the implementation.
    <dt> <b>Throws:</b> <a href="java.telephony.PrivilegeViolationException.html#_top_">PrivilegeViolationException</a>
    <dd> The application does not have
the proper authority to invoke this method.
    <dt> <b>Throws:</b> <a href="java.telephony.ResourceUnavailableException.html#_top_">ResourceUnavailableException</a>
    <dd> An internal resource neccessary
for the successful invocation of this method is not available.
    <dt> <b>Throws:</b> <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
    <dd> A platform-specific exception occurred.
  </dl>
</dl>
<a name="leave()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="leave"><b>leave</b></a>
<pre>
  public abstract void leave() throws <a href="java.telephony.InvalidStateException.html#_top_">InvalidStateException</a>, <a href="java.telephony.MethodNotSupportedException.html#_top_">MethodNotSupportedException</a>, <a href="java.telephony.PrivilegeViolationException.html#_top_">PrivilegeViolationException</a>, <a href="java.telephony.ResourceUnavailableException.html#_top_">ResourceUnavailableException</a>, <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
</pre>
<dl>
  <dd> Takes a TerminalConnection which is active in a telephone call and places
it back
into the bridged state. Bridging situations exists when another Terminal
which shares an address with this Terminal is active on a telephone call.
If this Terminal is the only remaining Terminal which is active on the
telephone call with respect to its Address, then the Connection to that
address moves into the DISCONNECTED state as well as all of the associated
TerminalConnection objects.
<p>
This TerminalConnection object must be in the TALKING state and the
Provider must be IN_SERVICE. These pre-conditions are given below:
<p>
<OL>
<LI>((this.getTerminal()).getProvider()).getState() == IN_SERVICE
<LI>this.getCallControlState() == TALKING
</OL>
<p>
The post-conditions for this method are as follows. Note that there
are two possible outcomes: one in which this TerminalConnection moves
back into the BRIDGED state and one in which the entire Connection moves
to DISCONNECTED if it is the only remanining active TerminalConnection.
<p>
<OL>
<LI>((this.getTerminal()).getProvider()).getState() == IN_SERVICE
<LI>if for all (this.getTerminal()).getTerminalConnections(), this
TerminalConnection is the only
one in the non-BRIDGED or non-DROPPED state, then this.getState() ==
DROPPED and this.getConnection() == DISCONNECTED.
<LI>if for all (this.getTerminal()).getTerminalConnections(), there is
exists a
TerminalConnection in the TALKING state besides this TerminalConnection,
then this.getState() == BRIDGED
</OL>
<p>
  <dl>
    <dt> <b>Throws:</b> <a href="java.telephony.InvalidStateException.html#_top_">InvalidStateException</a>
    <dd> The state of some object is not valid
as designated by the pre-conditions for this method.
    <dt> <b>Throws:</b> <a href="java.telephony.MethodNotSupportedException.html#_top_">MethodNotSupportedException</a>
    <dd> This method is not supported by
the implementation.
    <dt> <b>Throws:</b> <a href="java.telephony.PrivilegeViolationException.html#_top_">PrivilegeViolationException</a>
    <dd> The application does not have
the proper authority to invoke this method.
    <dt> <b>Throws:</b> <a href="java.telephony.ResourceUnavailableException.html#_top_">ResourceUnavailableException</a>
    <dd> An internal resource neccessary
for the successful invocation of this method is not available.
    <dt> <b>Throws:</b> <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
    <dd> A platform-specific exception occurred.
  </dl>
</dl>
<hr>
<pre>
<a href="packages.html">All Packages</a>  <a href="tree.html">Class Hierarchy</a>  <a href="Package-java.telephony.callcontrol.html">This Package</a>  <a href="java.telephony.callcontrol.CallControlTerminal.html#_top_">Previous</a>  <a href="java.telephony.callcontrol.CallControlTerminalObserver.html#_top_">Next</a>  <a href="AllNames.html">Index</a></pre>
</body>
</html>