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