net.rim.blackberry.api.phone.phonelogs
Interface PhoneLogListener


public interface PhoneLogListener

Implement this interface if you wish to listen for phone log events, such as new phone logs being added to the system

Register your instance with PhoneLogs.addListener(net.rim.blackberry.api.phone.phonelogs.PhoneLogListener); remove it with PhoneLogs.removeListener(net.rim.blackberry.api.phone.phonelogs.PhoneLogListener).

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 Summary
Category: Signed  void callLogAdded(CallLog cl)
          Invoked when a new call log added.
Category: Signed  void callLogRemoved(CallLog cl)
          Invoked when a call log has been removed.
Category: Signed  void callLogUpdated(CallLog cl, CallLog oldCl)
          Invoked when a call log has been updated.
Category: Signed  void reset()
          Invoked to reset the log.
 



Method Detail

callLogAdded

void callLogAdded(CallLog cl)
Invoked when a new call log added.

Parameters:
cl - Call log added.
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

callLogUpdated

void callLogUpdated(CallLog cl,
                    CallLog oldCl)
Invoked when a call log has been updated.

Parameters:
cl - Updated version of the call log.
oldCl - Old version of 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:
BlackBerry API 4.0.0

callLogRemoved

void callLogRemoved(CallLog cl)
Invoked when a call log has been removed.

Parameters:
cl - Removed 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

reset

void reset()
Invoked to reset the log.

This method gets invoked when a batch operation occurs. Implementations should release all held CallLog references and rebuild the current set using the PhoneLogs API.

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-2010 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. All Rights Reserved.
Copyright 2002-2003 Nokia Corporation All Rights Reserved.
Java is a trademark of Sun Microsystems, Inc.