net.rim.blackberry.api.phone
Class MultiLineListener

java.lang.Object
  extended by net.rim.blackberry.api.phone.MultiLineListener
All Implemented Interfaces:
PhoneListener

public abstract class MultiLineListener
extends Object
implements PhoneListener

A helper class defining an empty implementation of the PhoneListener class. For devices with multiple lines only.

Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 5.0.0

Field Summary
 
Fields inherited from interface net.rim.blackberry.api.phone.PhoneListener
CALL_ERROR_AUTHORIZATION_FAILURE, CALL_ERROR_CALL_REPLACED_BY_STK, CALL_ERROR_CONGESTION, CALL_ERROR_CONNECTION_DENIED_BY_NETWORK, CALL_ERROR_DUE_TO_FADING, CALL_ERROR_EMERGENCY_CALLS_ONLY, CALL_ERROR_FDN_MISMATCH, CALL_ERROR_GENERAL, CALL_ERROR_HOLD_ERROR, CALL_ERROR_INCOMING_CALL_BARRED, CALL_ERROR_LOST_DUE_TO_FADING, CALL_ERROR_MAINTENANCE_REQUIRED, CALL_ERROR_NUMBER_NOT_IN_SERVICE, CALL_ERROR_NUMBER_UNOBTAINABLE, CALL_ERROR_OUTGOING_CALLS_BARRED, CALL_ERROR_PLEASE_TRY_LATER, CALL_ERROR_RADIO_PATH_UNAVAILABLE, CALL_ERROR_SERVICE_CONFLICT, CALL_ERROR_SERVICE_NOT_AVAILABLE, CALL_ERROR_STK_CALL_NOT_ALLOWED, CALL_ERROR_SUBSCRIBER_BUSY, CALL_ERROR_SYSTEM_BUSY_TRY_LATER, CALL_ERROR_TRY_AGAIN, CALL_ERROR_USER_BUSY_IN_DATA, CALL_ERROR_USER_BUSY_IN_PRIVATE, CALL_ERROR_USER_NOT_AUTHORIZED, CALL_ERROR_USER_NOT_AVAILABLE, CALL_ERROR_USER_NOT_REACHABLE, CALL_ERROR_USER_UNKNOWN
 
Constructor Summary
Category: Signed MultiLineListener()
          default constructor
 
Method Summary
Category: Signed  void activeLineAvailabilityChanged(int lineId)
          Invoked when the active line has been changed.
Category: Signed  void callAdded(int callId)
          Invoked when a call gets added to a conference call.
Category: Signed  void callAnswered(int callId)
          Invoked when the user answers a call (user driven).
Category: Signed  void callConferenceCallEstablished(int callId)
          Invoked when a conference call has been established.
Category: Signed  void callConnected(int callId)
          Invoked when the network indicates a connected event (network driven).
Category: Signed  void callDirectConnectConnected(int callId)
          Invoked when a direct-connect call is connected.
Category: Signed  void callDirectConnectDisconnected(int callId)
          Invoked when a direct-connect call is disconnected.
Category: Signed  void callDisconnected(int callId)
          Invoked when a call is disconnected.
Category: Signed  void callEndedByUser(int callId)
          Invoked when the user ends the call.
Category: Signed  void callFailed(int callId, int reason)
          Invoked when a call fails.
Category: Signed  void callHeld(int callId)
          Invoked when a call goes into the 'held' state.
Category: Signed  void callIncoming(int callId)
          Invoked when a new call is arriving.
Category: Signed  void callInitiated(int callid)
          Invoked when a call has been initiated by the device (outbound).
Category: Signed  void callRemoved(int callId)
          Invoked when a call gets removed from a conference call.
Category: Signed  void callResumed(int callId)
          Invoked when a call goes from 'held' to 'resumed' state.
Category: Signed  void callWaiting(int callid)
          Invoked when a call is waiting.
Category: Signed  void conferenceCallDisconnected(int callId)
          Invoked when a conference call is terminated (all members disconnected).
Category: Signed  void preSwitchingConditionFailure(int reason)
          Invoked when the pre-switching validation check failed.
Category: Signed  void refreshAvailableList()
          Invoked when a line has been updated.
Category: Signed  void setPreferredLineFailure(int lineId)
          Invoked when the pre-switching check succeeded but switching failed.
Category: Signed  void setPreferredLineSuccess(int lineId)
          Invoked when both pre-switching check and switching succeeded.
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 



Constructor Detail

MultiLineListener

public MultiLineListener()
default constructor

Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 5.0.0


Method Detail

callAdded

public void callAdded(int callId)
Invoked when a call gets added to a conference call.

Specified by:
callAdded in interface PhoneListener
Parameters:
callId - ID for the added call.
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 5.0.0

callAnswered

public void callAnswered(int callId)
Invoked when the user answers a call (user driven).

Specified by:
callAnswered in interface PhoneListener
Parameters:
callId - ID for the call.
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 5.0.0

callConferenceCallEstablished

public void callConferenceCallEstablished(int callId)
Invoked when a conference call has been established.

Specified by:
callConferenceCallEstablished in interface PhoneListener
Parameters:
callId - ID for the call (currently always 0).
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 5.0.0

callConnected

public void callConnected(int callId)
Invoked when the network indicates a connected event (network driven).

Specified by:
callConnected in interface PhoneListener
Parameters:
callId - ID for the call.
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 5.0.0

callDirectConnectConnected

public void callDirectConnectConnected(int callId)
Invoked when a direct-connect call is connected.

Specified by:
callDirectConnectConnected in interface PhoneListener
Parameters:
callId - ID for the direct-connect call.
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 5.0.0

callDirectConnectDisconnected

public void callDirectConnectDisconnected(int callId)
Invoked when a direct-connect call is disconnected.

Specified by:
callDirectConnectDisconnected in interface PhoneListener
Parameters:
callId - ID for the disconnected direct-connect call.
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 5.0.0

callDisconnected

public void callDisconnected(int callId)
Invoked when a call is disconnected.

Specified by:
callDisconnected in interface PhoneListener
Parameters:
callId - ID for the disconnected call.
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 5.0.0

callEndedByUser

public void callEndedByUser(int callId)
Invoked when the user ends the call.

Specified by:
callEndedByUser in interface PhoneListener
Parameters:
callId - ID for the terminated call.
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 5.0.0

callFailed

public void callFailed(int callId,
                       int reason)
Invoked when a call fails.

Specified by:
callFailed in interface PhoneListener
Parameters:
callId - ID for the failed call.
reason - CALL_ERROR_* code describing the reason for the failure.
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 5.0.0

callHeld

public void callHeld(int callId)
Invoked when a call goes into the 'held' state.

Specified by:
callHeld in interface PhoneListener
Parameters:
callId - ID for the held call.
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 5.0.0

callIncoming

public void callIncoming(int callId)
Invoked when a new call is arriving.

Specified by:
callIncoming in interface PhoneListener
Parameters:
callId - ID for the call.
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 5.0.0

callInitiated

public void callInitiated(int callid)
Invoked when a call has been initiated by the device (outbound).

Specified by:
callInitiated in interface PhoneListener
Parameters:
callid - ID for the call.
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 5.0.0

callRemoved

public void callRemoved(int callId)
Invoked when a call gets removed from a conference call.

Specified by:
callRemoved in interface PhoneListener
Parameters:
callId - ID for the removed call.
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 5.0.0

callResumed

public void callResumed(int callId)
Invoked when a call goes from 'held' to 'resumed' state.

Specified by:
callResumed in interface PhoneListener
Parameters:
callId - ID for the resumed call.
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 5.0.0

callWaiting

public void callWaiting(int callid)
Invoked when a call is waiting.

Specified by:
callWaiting in interface PhoneListener
Parameters:
callid - ID for the call.
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 5.0.0

conferenceCallDisconnected

public void conferenceCallDisconnected(int callId)
Invoked when a conference call is terminated (all members disconnected).

Specified by:
conferenceCallDisconnected in interface PhoneListener
Parameters:
callId - ID for the disconnected call (currently always 0).
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 5.0.0

preSwitchingConditionFailure

public void preSwitchingConditionFailure(int reason)
Invoked when the pre-switching validation check failed.

Parameters:
reason - Reason code as defined in Phone.
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 5.0.0

refreshAvailableList

public void refreshAvailableList()
Invoked when a line has been updated.

Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 5.0.0

activeLineAvailabilityChanged

public void activeLineAvailabilityChanged(int lineId)
Invoked when the active line has been changed.

Parameters:
lineid - the id of an active line
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 5.0.0

setPreferredLineFailure

public void setPreferredLineFailure(int lineId)
Invoked when the pre-switching check succeeded but switching failed.

Parameters:
lineId - the id of the line to be switched.
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 5.0.0

setPreferredLineSuccess

public void setPreferredLineSuccess(int lineId)
Invoked when both pre-switching check and switching succeeded.

Parameters:
lineId - the id of the line to be switched.
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 5.0.0





Copyright 1999-2011 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Java is a trademark of Oracle America Inc. in the US and other countries.
Legal