org.eclipse.ui.texteditor

Interface IElementStateListener

public interface IElementStateListener

Interface for parties interested in standardized element changes. These changes are:

• dirty state changes
• content replacements
• moves
• deletions

The notifications sent to the element state listeners inform about those standardized, abstract changes. The concrete change applied might differ from the one the listeners are notified about, but should be interpreted as the one the listeners receive.

In order to provided backward compatibility for clients of IElementStateListener, extension interfaces are used to provide a means of evolution. The following extension interface exists:

• IElementStateListenerExtension since version 2.0 introducing state validation events.

See Also:

IElementStateListenerExtension

Method Summary

Modifier and Type	Method and Description
void	elementContentAboutToBeReplaced(java.lang.Object element) Notifies that the content of the given element is about to be replaced.
void	elementContentReplaced(java.lang.Object element) Notifies that the content of the given element has been replaced.
void	elementDeleted(java.lang.Object element) Notifies that the given element has been deleted.
void	elementDirtyStateChanged(java.lang.Object element, boolean isDirty) Notifies that the dirty state of the given element has changed.
void	elementMoved(java.lang.Object originalElement, java.lang.Object movedElement) Notifies that the element has moved.

Method Detail

elementDirtyStateChanged

void elementDirtyStateChanged(java.lang.Object element,
                              boolean isDirty)

Notifies that the dirty state of the given element has changed.

Parameters:

element - the element

isDirty - the new dirty state

elementContentAboutToBeReplaced

void elementContentAboutToBeReplaced(java.lang.Object element)

Notifies that the content of the given element is about to be replaced.

Parameters:

element - the element

elementContentReplaced

void elementContentReplaced(java.lang.Object element)

Notifies that the content of the given element has been replaced.

Parameters:

element - the element

elementDeleted

void elementDeleted(java.lang.Object element)

Notifies that the given element has been deleted.

Parameters:

element - the element

elementMoved

void elementMoved(java.lang.Object originalElement,
                  java.lang.Object movedElement)

Notifies that the element has moved. If movedElement is null it is similar to elementDeleted(originalElement).

Parameters:

originalElement - the element before the move

movedElement - the element after the move