com.sap.tc.cmi.util

Interface ICMIObservableListChangeListener

All Known Subinterfaces:

ICMIObservableListChangeListener02

public interface ICMIObservableListChangeListener

Methods that a listener must implement to be informed about changes in an ICMIObservableList.

This type can be called, extended or implemented by applications or frameworks using CMI.

Type Classification:

This interface is part of the Common Model Interface and is intended to be implemented by applications.

Method Summary

void	complexChange(CMIObservableListEvent event) General callback when an observed list has changed and if none of the more specific callbacks elementAdded, elementReplaced or elementRemoved matches.
void	elementAdded(CMIObservableListEvent event) Callback when a single element has been added to an observed list.
void	elementChanged(CMIObservableListEvent event) Callback when a single element has been replaced in an observed list.
void	elementRemoved(CMIObservableListEvent event) Callback when a single element has been removed from an observed list.

Method Detail

elementAdded

void elementAdded(CMIObservableListEvent event)

Callback when a single element has been added to an observed list.

The event object must have the type ELEMENT_ADDED. See CMIObservableListEvent.ELEMENT_ADDED for details about the event object and the information that it provides.

Parameters:

event - event object that describes the added element

elementChanged

void elementChanged(CMIObservableListEvent event)

Callback when a single element has been replaced in an observed list.

Changed means, that the referenced object at an already existing position in the list has changed without modifying the length of the list.

The event object must have the type ELEMENT_CHANGED. See CMIObservableListEvent.ELEMENT_CHANGED for details about the event object and the information that it provides.

Parameters:

event - event object that describes the replaced element

elementRemoved

void elementRemoved(CMIObservableListEvent event)

Callback when a single element has been removed from an observed list.

The event object must have the type ELEMENT_REMOVED. See CMIObservableListEvent.ELEMENT_REMOVED for details about the event object and the information that it provides.

Parameters:

event - event object that describes the removed element

complexChange

void complexChange(CMIObservableListEvent event)

General callback when an observed list has changed and if none of the more specific callbacks elementAdded, elementReplaced or elementRemoved matches.

The event object will at least have a type and the type must be one of

• CMIObservableListEvent.LIST_CLEARED
• CMIObservableListEvent.ELEMENT_ADDED (not recommended, should be delivered via elementAdded)
• CMIObservableListEvent.ELEMENT_CHANGED (not recommended, should be delivered via elementChanged)
• CMIObservableListEvent.ELEMENT_REMOVED (not recommended, should be delivered via elementRemoved)
• CMIObservableListEvent.CONTIGUOUS_ELEMENTS_ADDED
• CMIObservableListEvent.CONTIGUOUS_ELEMENTS_REMOVED
• CMIObservableListEvent.MULTIPLE_ELEMENTS_REMOVED

See the documentation of CMIObservableListEvent and its event types for details.

Parameters:

event - event object that describes the change

Access Rights

This class can be accessed from:

SC	DC
[sap.com] FRAMEWORK	[sap.com] tc/cmi
[sap.com] FRAMEWORK	[sap.com] tc/cm/ejb/api