net.rim.blackberry.api.pdap
Interface ListChangeListener2

All Superinterfaces:

ListChangeListener

public interface ListChangeListener2
extends ListChangeListener

A listener that can be notified when properties of PIM lists change, in addition to those provided in ListChangeListener.

Classes that implement this listener can be added to the list of list change listeners to receive notifications by invoking BlackBerryPIM.addListChangeListener(net.rim.blackberry.api.pdap.ListChangeListener) and can be removed by invoking BlackBerryPIM.removeListChangeListener(net.rim.blackberry.api.pdap.ListChangeListener).

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 Summary
	void	listAdded(int listType, String listName, long pimListUID) Invoked when a PIMList is added.
	void	listRemoved(int listType, String listName, long pimListUID) Invoked when a PIMList is removed.
	void	listRenamed(int listType, String oldListName, String newListName, long pimListUID) Invoked when the name of a PIMList changes.

Methods inherited from interface net.rim.blackberry.api.pdap.ListChangeListener

defaultListChanged

Method Detail

listAdded

void listAdded(int listType,
               String listName,
               long pimListUID)

Invoked when a PIMList is added.

Parameters:

listType - the type of PIMList was PIMList added; one of PIM.CONTACT_LIST, PIM.EVENT_LIST, PIM.TODO_LIST, or BlackBerryPIM.MEMO_LIST.

listName - the name of the newly-added PIMList; this value will now be included in the array returned from PIM.listPIMLists(int) and may be specified as the "name" parameter to PIM.openPIMList(int, int, String) to open the PIMList.

pimListUID - the UID of the newly-added PIMList; this value may be specified as the "uid" parameter to BlackBerryPIM.openPIMList(int, int, long) to open the PIMList.

See Also:

PIM.listPIMLists(int), PIM.openPIMList(int, int, String), BlackBerryPIM.openPIMList(int, int, long)

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

listRemoved

void listRemoved(int listType,
                 String listName,
                 long pimListUID)

Invoked when a PIMList is removed.

Parameters:

listType - the type of PIMList that was removed; one of PIM.CONTACT_LIST, PIM.EVENT_LIST, PIM.TODO_LIST, or BlackBerryPIM.MEMO_LIST.

listName - the name of the removed PIMList; this value will no longer be included in the array returned from PIM.listPIMLists(int) and if this value is specified as the "name" parameter to PIM.openPIMList(int, int, String) then PIMException will be thrown.

pimListUID - the UID of the removed PIMList; if this value is specified as the "uid" parameter to BlackBerryPIM.openPIMList(int, int, long) then PIMException will be thrown.

See Also:

PIM.listPIMLists(int), PIM.openPIMList(int, int, String), BlackBerryPIM.openPIMList(int, int, long)

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

listRenamed

void listRenamed(int listType,
                 String oldListName,
                 String newListName,
                 long pimListUID)

Invoked when the name of a PIMList changes.

Parameters:

listType - the type of PIMList that was renamed; one of PIM.CONTACT_LIST, PIM.EVENT_LIST, PIM.TODO_LIST, or BlackBerryPIM.MEMO_LIST.

oldListName - the old name of the PIMList; this value will no longer be included in the array returned from PIM.listPIMLists(int) and if this value is specified as the "name" parameter to PIM.openPIMList(int, int, String) then PIMException will be thrown.

newListName - the new name of the PIMList; this value will now be included in the array returned from PIM.listPIMLists(int) in place of oldListName and may be specified as the "name" parameter to PIM.openPIMList(int, int, String) to open the PIMList.

pimListUID - the UID of the renamed PIMList; this value may be specified as the "uid" parameter to BlackBerryPIM.openPIMList(int, int, long) to open the PIMList; the UID does not change when the name changes.

See Also:

PIM.listPIMLists(int), PIM.openPIMList(int, int, String), BlackBerryPIM.openPIMList(int, int, long)

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