com.starteam.events

Interface ItemListListener

All Superinterfaces:

java.util.EventListener, IItemListener

public interface ItemListListener
extends IItemListener

ItemListListener allows an application to listen for changes to the contents of one or more folders.

An ItemListEvent provides access to a small subset of the information available through the more general ItemEvent. However, ItemEvents can be considerably more expensive to generate. So, for applications that just want to know when the list of items changes, ItemListEvent is prefered.

Note that an application will not receive ItemListEvents for folders that the logged-in user does not have permission to access.

See Also:

ItemIDListener, ItemListener, View.addItemListener(com.starteam.events.IItemListener, com.starteam.Item.Type), Folder.addItemListener(com.starteam.events.IItemListener, com.starteam.Item.Type, int), ViewMemberListManager.addItemListener(com.starteam.events.IItemListener)

Method Summary

Modifier and Type	Method and Description
void	itemsChanged(ItemListEvent e) Invoked when the list of Items of a particular Type has changed in a Folder.

Method Detail

itemsChanged

void itemsChanged(ItemListEvent e)

Invoked when the list of Items of a particular Type has changed in a Folder. This includes whenever an Item is added, moved, shared, deleted, etc.

ItemListEvent.getFolder() returns the Folder whose item list has changed. For example, if Item A is moved from Folder B to Folder C, itemsChanged events are triggered for both Folder B and Folder C.

Applications that are more interested in receiving information about Item A in this case should listen for ItemEvents by registering an ItemListener.

Parameters:

e - The corresponding ItemListEvent.

See Also:

ItemListEvent