SHOW Signed
 

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

java.lang.Object
  |
  +--net.rim.blackberry.api.phone.phonelogs.CallLog
        |
        +--net.rim.blackberry.api.phone.phonelogs.PhoneCallLog

public final class PhoneCallLog
extends CallLog

Represents a call log in the message list for a simple phone call.

Unlike a ConferencePhoneCallLog, you can set and change the type of the call log (using this class's TYPE_* values); this changes how the call is presented in the message list.

You cannot have more than one participant in a phone call log. If you want more than one participant you must use a ConferencePhoneCallLog object for the 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:
JDE 4.0.0

Field Summary
 Category: Signed static int TYPE_MISSED_CALL_OPENED
          Call that was missed and that has been viewed.
 Category: Signed static int TYPE_MISSED_CALL_UNOPENED
          Call that was missed and has not been viewed yet.
 Category: Signed static int TYPE_PLACED_CALL
          Successfully connected outgoing call.
 Category: Signed static int TYPE_RECEIVED_CALL
          Incoming call that was successfully received.
 
Fields inherited from class net.rim.blackberry.api.phone.phonelogs.CallLog
STATUS_AUTHENTICATION_FAILURE, STATUS_BUSY, STATUS_CALL_FAIL_DUE_TO_FADING, STATUS_CALL_FAILED_TRY_AGAIN, STATUS_CALL_LOST_DUE_TO_FADING, STATUS_CONGESTION, STATUS_CONNECTION_DENIED, STATUS_EMERGENCY_CALLS_ONLY, STATUS_FDN_MISMATCH, STATUS_GENERAL_ERROR, STATUS_HOLD_ERROR, STATUS_INCOMING_CALL_BARRED, STATUS_MAINTENANCE_REQUIRED, STATUS_NORMAL, STATUS_NUMBER_UNOBTAINABLE, STATUS_OUTGOING_CALLS_BARRED, STATUS_PATH_UNAVAILABLE, STATUS_SERVICE_NOT_AVAILABLE
 
Constructor Summary
 Category: Signed PhoneCallLog(Date date, int callType, int callDuration, int callStatus, PhoneCallLogID participant, String notes)
          Creates a new phone call log.
 
Method Summary
 Category: Signed  PhoneCallLogID getParticipant()
          Retrieves the participant for this call.
 Category: Signed  int getType()
          Retrieves this call's type.
 Category: Signed  void setParticipant(PhoneCallLogID participant)
          Sets the participant for this call.
 Category: Signed  void setType(int callType)
          Sets this call's type.
 
Methods inherited from class net.rim.blackberry.api.phone.phonelogs.CallLog
getDate, getDuration, getNotes, getStatus, setDate, setDuration, setNotes, setStatus
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

TYPE_MISSED_CALL_OPENED

public static final int TYPE_MISSED_CALL_OPENED
Call that was missed and that has been viewed.
Since:
JDE 4.0.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.

TYPE_MISSED_CALL_UNOPENED

public static final int TYPE_MISSED_CALL_UNOPENED
Call that was missed and has not been viewed yet.
Since:
JDE 4.0.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.

TYPE_PLACED_CALL

public static final int TYPE_PLACED_CALL
Successfully connected outgoing call.
Since:
JDE 4.0.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.

TYPE_RECEIVED_CALL

public static final int TYPE_RECEIVED_CALL
Incoming call that was successfully received.
Since:
JDE 4.0.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.
Constructor Detail

PhoneCallLog

public PhoneCallLog(Date date,
                    int callType,
                    int callDuration,
                    int callStatus,
                    PhoneCallLogID participant,
                    String notes)
Creates a new phone call log.
Parameters:
date - Date for this call.
callType - Type of this call; one of the TYPE_* values.
callDuration - Duration of this call in seconds.
callStatus - Status of this call; one of the STATUS_* values inherited from CallLog.
participant - Participant in this call.
notes - Any notes associated with this call.
Since:
JDE 4.0.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.
Method Detail

getParticipant

public PhoneCallLogID getParticipant()
Retrieves the participant for this call.

The participant information is presented both in the message list and when the log is opened for viewing.

Returns:
Participant for this call.
Since:
JDE 4.0.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.

getType

public int getType()
Retrieves this call's type.
Returns:
Type for this call; one of the TYPE_* values.
Since:
JDE 4.0.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.

setParticipant

public void setParticipant(PhoneCallLogID participant)
Sets the participant for this call.

The participant information is presented both in the message list and when the log is opened for viewing.

Parameters:
participant - New participant for this call.
Since:
JDE 4.0.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.

setType

public void setType(int callType)
Sets this call's type.
Parameters:
callType - New type for this call; must be one of the four PhoneCallLog.TYPE_* constants.
Throws:
IllegalArgumentException - if the input callType is not one of the four PhoneCallLog.TYPE_* constants.
Since:
JDE 4.0.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.



Copyright 1999-2009 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Copyright 1993-2003 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California, 94303, U.S.A.
Copyright 2002-2003 Nokia Corporation All Rights Reserved.
Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.