net.rim.blackberry.api.phone.phonelogs
Class CallLog

java.lang.Object
  extended by net.rim.blackberry.api.phone.phonelogs.CallLog
Direct Known Subclasses:
ConferencePhoneCallLog, PhoneCallLog

public abstract class CallLog
extends Object

Abstract base class for phone call logs contained by the PhoneLogs class.

CallLog objects cannot be instantiated, instead use the PhoneCallLog or ConferencePhoneCallLog derived classes.

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 4.0.0

Field Summary
Category: Signed static int STATUS_AUTHENTICATION_FAILURE
          Error due to call authorization failure.
Category: Signed static int STATUS_BUSY
          Busy call status.
Category: Signed static int STATUS_CALL_FAILED_TRY_AGAIN
          Call failed, try again.
Category: Signed static int STATUS_CALL_FAIL_DUE_TO_FADING
          Call failed due to fading.
Category: Signed static int STATUS_CALL_LOST_DUE_TO_FADING
          Call lost due to fading.
Category: Signed static int STATUS_CONGESTION
          Error due to congestion.
Category: Signed static int STATUS_CONNECTION_DENIED
          Call connection was denied.
Category: Signed static int STATUS_EMERGENCY_CALLS_ONLY
          Emergency calls only.
Category: Signed static int STATUS_FDN_MISMATCH
          An FDN mismatch occured.
Category: Signed static int STATUS_GENERAL_ERROR
          General error occured.
Category: Signed static int STATUS_HOLD_ERROR
          Call hold error.
Category: Signed static int STATUS_INCOMING_CALL_BARRED
          Incoming calls are barred.
Category: Signed static int STATUS_MAINTENANCE_REQUIRED
          Maintenance required.
Category: Signed static int STATUS_NORMAL
          Normal call status (no errors).
Category: Signed static int STATUS_NUMBER_UNOBTAINABLE
          Error due to number unobtainability.
Category: Signed static int STATUS_OUTGOING_CALLS_BARRED
          Outgoing calls barred.
Category: Signed static int STATUS_PATH_UNAVAILABLE
          Error due to path unavailability.
Category: Signed static int STATUS_SERVICE_NOT_AVAILABLE
          Service not available.
 
Method Summary
Category: Signed  Date getDate()
          Retrieves this call log's date.
Category: Signed  int getDuration()
          Retrieves logged call's duration.
Category: Signed  String getNotes()
          Retrieves logged call's notes.
Category: Signed  int getStatus()
          Retrieves logged call's status.
Category: Signed  void setDate(Date date)
          Sets this call log's date.
Category: Signed  void setDuration(int callDuration)
          Sets the duration of this logged call.
Category: Signed  void setNotes(String notes)
          Sets the notes for this logged call.
Category: Signed  void setStatus(int callStatus)
          Sets the status for this logged call.
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 



Field Detail

STATUS_NORMAL

public static final int STATUS_NORMAL
Normal call status (no errors).

See Also:
Constant Field Values
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 4.0.0

STATUS_BUSY

public static final int STATUS_BUSY
Busy call status.

See Also:
Constant Field Values
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 4.0.0

STATUS_CONGESTION

public static final int STATUS_CONGESTION
Error due to congestion.

See Also:
Constant Field Values
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 4.0.0

STATUS_PATH_UNAVAILABLE

public static final int STATUS_PATH_UNAVAILABLE
Error due to path unavailability.

See Also:
Constant Field Values
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 4.0.0

STATUS_NUMBER_UNOBTAINABLE

public static final int STATUS_NUMBER_UNOBTAINABLE
Error due to number unobtainability.

See Also:
Constant Field Values
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 4.0.0

STATUS_AUTHENTICATION_FAILURE

public static final int STATUS_AUTHENTICATION_FAILURE
Error due to call authorization failure.

See Also:
Constant Field Values
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 4.0.0

STATUS_EMERGENCY_CALLS_ONLY

public static final int STATUS_EMERGENCY_CALLS_ONLY
Emergency calls only.

See Also:
Constant Field Values
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 4.0.0

STATUS_HOLD_ERROR

public static final int STATUS_HOLD_ERROR
Call hold error.

See Also:
Constant Field Values
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 4.0.0

STATUS_OUTGOING_CALLS_BARRED

public static final int STATUS_OUTGOING_CALLS_BARRED
Outgoing calls barred.

See Also:
Constant Field Values
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 4.0.0

STATUS_GENERAL_ERROR

public static final int STATUS_GENERAL_ERROR
General error occured.

See Also:
Constant Field Values
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 4.0.0

STATUS_MAINTENANCE_REQUIRED

public static final int STATUS_MAINTENANCE_REQUIRED
Maintenance required.

See Also:
Constant Field Values
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 4.0.0

STATUS_SERVICE_NOT_AVAILABLE

public static final int STATUS_SERVICE_NOT_AVAILABLE
Service not available.

See Also:
Constant Field Values
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 4.0.0

STATUS_CALL_FAIL_DUE_TO_FADING

public static final int STATUS_CALL_FAIL_DUE_TO_FADING
Call failed due to fading.

See Also:
Constant Field Values
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 4.0.0

STATUS_CALL_LOST_DUE_TO_FADING

public static final int STATUS_CALL_LOST_DUE_TO_FADING
Call lost due to fading.

See Also:
Constant Field Values
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 4.0.0

STATUS_CALL_FAILED_TRY_AGAIN

public static final int STATUS_CALL_FAILED_TRY_AGAIN
Call failed, try again.

See Also:
Constant Field Values
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 4.0.0

STATUS_FDN_MISMATCH

public static final int STATUS_FDN_MISMATCH
An FDN mismatch occured.

See Also:
Constant Field Values
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 4.0.0

STATUS_CONNECTION_DENIED

public static final int STATUS_CONNECTION_DENIED
Call connection was denied.

See Also:
Constant Field Values
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 4.0.0

STATUS_INCOMING_CALL_BARRED

public static final int STATUS_INCOMING_CALL_BARRED
Incoming calls are barred.

See Also:
Constant Field Values
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 4.0.0


Method Detail

getDate

public Date getDate()
Retrieves this call log's date.

Returns:
Date for this logged 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 4.0.0

getDuration

public int getDuration()
Retrieves logged call's duration.

Returns:
Logged call's duration in seconds.
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 4.0.0

getStatus

public int getStatus()
Retrieves logged call's status.

Returns:
One of the STATUS_* values indicating the status of this logged 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 4.0.0

getNotes

public String getNotes()
Retrieves logged call's notes.

The notes (if any exist) appear at the bottom of the call log when you open the log for viewing from the message list.

Returns:
Notes of the logged 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 4.0.0

setDate

public void setDate(Date date)
Sets this call log's date.

The date is visible both in the message list and when a log is opened for viewing from the message list.

Parameters:
date - New date for this call log.
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 4.0.0

setDuration

public void setDuration(int callDuration)
Sets the duration of this logged call.

The duration of the logged call is shown when the log is opened for viewing from the message list.

Parameters:
callDuration - New duration for this logged call in seconds.
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 4.0.0

setStatus

public void setStatus(int callStatus)
Sets the status for this logged call.

Parameters:
callStatus - New call status for the call log. This should be one of the STATUS_* values in this class; if a value other than CallLog.STATUS_NORMAL, the new status appears when the log is opened for viewing from the message list.
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 4.0.0

setNotes

public void setNotes(String notes)
Sets the notes for this logged call.

The notes for the logged call appear when the log is opened for viewing from the message list.

Parameters:
notes - New notes for this logged 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 4.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