org.noos.xing.mydoggy
Interface Observable

All Known Subinterfaces:

Content, ContentManager, ContentManagerUI<C>, ContentUI, DesktopContentManagerUI, DesktopContentUI, Dockable<M>, DockableUI, DockedTypeDescriptor, FloatingLiveTypeDescriptor, FloatingTypeDescriptor, MultiSplitContentManagerUI, MultiSplitContentUI, RepresentativeAnchorDescriptor<D>, SlidingTypeDescriptor, TabbedContentManagerUI<E>, TabbedContentUI, ToolWindow, ToolWindowBar, ToolWindowManagerDescriptor, ToolWindowTab, ToolWindowTypeDescriptor

public interface Observable

This interface contains generic methods concerning PropertyChangeListeners. Implementors gain ability to be observed, which means they can add, remove or get the list of {@link java.beans.PropertyChangeListener]s currently registered.

Since:

1.4.0

Version:

1.0 5 nov. 2007 11:40:15

Author:

David DOLCIMASCOLO

Method Summary

void	addPropertyChangeListener(PropertyChangeListener listener) Adds a PropertyChangeListener to the listener list.
void	addPropertyChangeListener(String propertyName, PropertyChangeListener listener) Adds a PropertyChangeListener to the listener list for a specific property.
PropertyChangeListener[]	getPropertyChangeListeners() Returns an array of all the property change listeners registered on this descritpro.
PropertyChangeListener[]	getPropertyChangeListeners(String propertyName) Returns an array of all the listeners which have been associated with the named property.
void	removePropertyChangeListener(PropertyChangeListener listener) Removes a PropertyChangeListener from the listener list.
void	removePropertyChangeListener(String propertyName, PropertyChangeListener listener) Removes a PropertyChangeListener from the listener list for a specific property.

Method Detail

addPropertyChangeListener

void addPropertyChangeListener(PropertyChangeListener listener)

Adds a PropertyChangeListener to the listener list. The listener is registered for all bound properties of the class. If listener is null, no exception is thrown and no action is performed.

Parameters:

listener - the PropertyChangeListener to be added

Since:

1.4.0

See Also:

getPropertyChangeListeners(), removePropertyChangeListener(java.beans.PropertyChangeListener)

removePropertyChangeListener

void removePropertyChangeListener(PropertyChangeListener listener)

Removes a PropertyChangeListener from the listener list.

If listener is null, no exception is thrown and no action is performed.

Parameters:

listener - the PropertyChangeListener to be removed.

Since:

1.4.0

See Also:

addPropertyChangeListener(java.beans.PropertyChangeListener), getPropertyChangeListeners()

getPropertyChangeListeners

PropertyChangeListener[] getPropertyChangeListeners()

Returns an array of all the property change listeners registered on this descritpro.

Returns:

all of this descriptor's PropertyChangeListeners or an empty array if no property change listeners are currently registered.

Since:

1.4.0

See Also:

addPropertyChangeListener(java.beans.PropertyChangeListener), removePropertyChangeListener(java.beans.PropertyChangeListener)

addPropertyChangeListener

void addPropertyChangeListener(String propertyName,
                               PropertyChangeListener listener)

Adds a PropertyChangeListener to the listener list for a specific property. If propertyName or listener is null, no exception is thrown and no action is taken.

Parameters:

propertyName - one of the property names listed above

listener - the property change listener to be added

Since:

1.4.2

See Also:

removePropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener), getPropertyChangeListeners(java.lang.String), addPropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener)

removePropertyChangeListener

void removePropertyChangeListener(String propertyName,
                                  PropertyChangeListener listener)

Removes a PropertyChangeListener from the listener list for a specific property. This method should be used to remove PropertyChangeListeners that were registered for a specific bound property.

If propertyName or listener is null, no exception is thrown and no action is taken.

Parameters:

propertyName - a valid property name

listener - the PropertyChangeListener to be removed

Since:

1.4.2

See Also:

addPropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener), getPropertyChangeListeners(java.lang.String), removePropertyChangeListener(java.beans.PropertyChangeListener)

getPropertyChangeListeners

PropertyChangeListener[] getPropertyChangeListeners(String propertyName)

Returns an array of all the listeners which have been associated with the named property.

Parameters:

propertyName - the property whose associated listeners are to be returned.

Returns:

all of the PropertyChangeListeners associated with the named property; if no such listeners have been added or if propertyName is null, an empty array is returned

Since:

1.4.2

See Also:

addPropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener), removePropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener), getPropertyChangeListeners()