java.telephony.callcontrol.callcontrolterminal.html

JTAPI_html 用于JTAPI的HTML文档.

    <dd> One of the arguments provided is
not valid.
    <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.
    <dt> <b>Throws:</b> <a href="java.lang.Exception.html#_top_">Exception</a>
    <dd> An implementation-specific exception occurred.
  </dl>
</dl>
<a name="pickup(java.telephony.Address, java.telephony.Address)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="pickup"><b>pickup</b></a>
<pre>
  public abstract <a href="java.telephony.TerminalConnection.html#_top_">TerminalConnection</a> pickup(<a href="java.telephony.Address.html#_top_">Address</a> pickAddress,
                                            <a href="java.telephony.Address.html#_top_">Address</a> terminalAddress) throws <a href="java.telephony.InvalidArgumentException.html#_top_">InvalidArgumentException</a>, <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>, <a href="java.lang.Exception.html#_top_">Exception</a>
</pre>
<dl>
  <dd> pickup() is analogous to TerminalConnection.answer(). The difference is that
for answer(), the Terminal that "answers" the Call is the one specified by
the TerminalConnection object. For pickup(), "this" Terminal is the one
answering the Call. pickup() picks a call from the specified Address and
pulls it to "this" Terminal using the specified Address. There must be at least
one Connection at the Address that is QUEUED or ALERTING. If there are multiple
Connections in those states, then the implementation will choose one of those
Connections (to pick a specific Connection, use the pickup(Connection, Address)
form of pickup()). Picking up a call changes
the state of the chosen Connection
from QUEUED or ALERTING to DISCONNECTED (if the Address specified
is different than the Address of the Connection) or CONNECTED (if the Address
specified is that same as the Address of the Connection). If the Addresses ARE
different, a new Connection (to the specified Address) is added to the Call in
the CONNECTED state.  The TerminalConnections from the original Connection are
placed into the DISCONNECTED state. The proper TerminalConnections in the new
Connection are created, including the
one to "this" Terminal. That TerminalConnection will be in the ACTIVE state and
is returned by pickup().
<p>
  <dl>
    <dt> <b>Parameters:</b>
    <dd> pickAddress - The Address to be picked.
    <dd> terminalAddress - The Address associated with the Terminal.
    <dt> <b>Returns:</b>
    <dd> s The new TerminalConnection associated with the Terminal.
    <dt> <b>Throws:</b> <a href="java.telephony.InvalidArgumentException.html#_top_">InvalidArgumentException</a>
    <dd> One of the arguments provided is
not valid.
    <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.
    <dt> <b>Throws:</b> <a href="java.lang.Exception.html#_top_">Exception</a>
    <dd> An implementation-specific exception occurred.
  </dl>
</dl>
<a name="pickupFromGroup(java.lang.String, java.telephony.Address)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="pickupFromGroup"><b>pickupFromGroup</b></a>
<pre>
  public abstract <a href="java.telephony.TerminalConnection.html#_top_">TerminalConnection</a> pickupFromGroup(<a href="java.lang.String.html#_top_">String</a> pickupGroup,
                                                     <a href="java.telephony.Address.html#_top_">Address</a> terminalAddress) throws <a href="java.telephony.InvalidArgumentException.html#_top_">InvalidArgumentException</a>, <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>, <a href="java.lang.Exception.html#_top_">Exception</a>
</pre>
<dl>
  <dd> pickupFromGroup() is analogous to TerminalConnection.answer(). The difference is that
for answer(), the Terminal that "answers" the Call is the one specified by
the TerminalConnection object. For pickupFromGroup(), "this" Terminal is the one
answering the Call. pickupFromGroup() picks a call from the specified pickup group and
pulls it to "this" Terminal using the specified Address. There must be at least
one Connection at the set of Addresses in the pickup group that is QUEUED or ALERTING.
If there are multiple
Connections in those states, then the implementation will choose one of those
Connections (to pick a specific Connection, use pickup(Connection, Address)). 
Picking up a call changes the state of the chosen Connection
from QUEUED or ALERTING to DISCONNECTED (if the Address specified
is different than the Address of the Connection) or CONNECTED (if the Address
specified is that same as the Address of the Connection). If the Addresses ARE
different, a new Connection (to the specified Address) is added to the Call in
the CONNECTED state.  The TerminalConnections from the original Connection are
placed into the DISCONNECTED state. The proper TerminalConnections in the new
Connection are created, including the
one to "this" Terminal. That TerminalConnection will be in the ACTIVE state and
is returned by pickupFromGroup().
<p>
  <dl>
    <dt> <b>Parameters:</b>
    <dd> pickupGroup - The pickup group to be picked.
    <dd> terminalAddress - The Address associated with the Terminal.
    <dt> <b>Returns:</b>
    <dd> s The new TerminalConnection associated with the Terminal.
    <dt> <b>Throws:</b> <a href="java.telephony.InvalidArgumentException.html#_top_">InvalidArgumentException</a>
    <dd> One of the arguments provided is
not valid.
    <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.
    <dt> <b>Throws:</b> <a href="java.lang.Exception.html#_top_">Exception</a>
    <dd> An implementation-specific exception occurred.
  </dl>
</dl>
<a name="pickupFromGroup(java.telephony.Address)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="pickupFromGroup"><b>pickupFromGroup</b></a>
<pre>
  public abstract <a href="java.telephony.TerminalConnection.html#_top_">TerminalConnection</a> pickupFromGroup(<a href="java.telephony.Address.html#_top_">Address</a> terminalAddress) throws <a href="java.telephony.InvalidArgumentException.html#_top_">InvalidArgumentException</a>, <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>, <a href="java.lang.Exception.html#_top_">Exception</a>
</pre>
<dl>
  <dd> pickupFromGroup() is analogous to TerminalConnection.answer(). The difference is that
for answer(), the Terminal that "answers" the Call is the one specified by
the TerminalConnection object. For pickupFromGroup(), "this" Terminal is the one
answering the Call. pickupFromGroup() picks a call from a pickup group that the
specified Address is in and
pulls it to "this" Terminal using that Address. There must be at least
one Connection at the set of Addresses in the pickup group that is QUEUED or ALERTING.
If there are multiple
Connections in those states, then the implementation will choose one of those
Connections (to pick a specific Connection, use pickup(Connection, Address)). 
Picking up a call changes the state of the chosen Connection
from QUEUED or ALERTING to DISCONNECTED (if the Address specified
is different than the Address of the Connection) or CONNECTED (if the Address
specified is that same as the Address of the Connection). If the Addresses ARE
different, a new Connection (to the specified Address) is added to the Call in
the CONNECTED state.  The TerminalConnections from the original Connection are
placed into the DISCONNECTED state. The proper TerminalConnections in the new
Connection are created, including the
one to "this" Terminal. That TerminalConnection will be in the ACTIVE state and
is returned by pickupFromGroup().
<p>
  <dl>
    <dt> <b>Parameters:</b>
    <dd> terminalAddress - The Address associated with the Terminal.
    <dt> <b>Returns:</b>
    <dd> s The new TerminalConnection associated with the Terminal.
    <dt> <b>Throws:</b> <a href="java.telephony.InvalidArgumentException.html#_top_">InvalidArgumentException</a>
    <dd> One of the arguments provided is
not valid.
    <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.
    <dt> <b>Throws:</b> <a href="java.lang.Exception.html#_top_">Exception</a>
    <dd> An implementation-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.CallControlConnection.html#_top_">Previous</a>  <a href="java.telephony.callcontrol.CallControlTerminalConnection.html#_top_">Next</a>  <a href="AllNames.html">Index</a></pre>
</body>
</html>