Package com.globalmentor.beans

Interface PropertyBindable

All Known Subinterfaces:

SequenceTask, Task

All Known Implementing Classes:

AbstractIOKit, AbstractOperation, AbstractReadWriteLockOperation, AbstractSequenceTask, AbstractTask, AbstractViewIOKit, BoundPropertyObject, BoundPropertyResource, DefaultModifiable, DefaultObjectState, DefaultURIAccessible, ModelViewIOKit, ModifiableCollection, ModifiableSet, ResourceModel, RunnableOperation, TextIOKit, URIAccessibleModel

public interface PropertyBindable

Indicates that an object supports bound properties and property change listener notification.

Author:

Garret Wilson

Method Summary

Modifier and Type	Method	Description
void	addPropertyChangeListener(java.beans.PropertyChangeListener listener)	Adds a property change listener to the listener list.
void	addPropertyChangeListener(java.lang.String propertyName, java.beans.PropertyChangeListener listener)	Add a property change listener for a specific property.
java.beans.PropertyChangeListener[]	getPropertyChangeListeners()	Returns an array of all the listeners that were added to the with addPropertyChangeListener(PropertyChangeListener).
java.beans.PropertyChangeListener[]	getPropertyChangeListeners(java.lang.String propertyName)	Returns an array of all the listeners which have been associated with the named property.
boolean	hasPropertyChangeListeners(java.lang.String propertyName)	Checks if there are any property change listeners for a specific property, including those registered on all properties.
void	removePropertyChangeListener(java.beans.PropertyChangeListener listener)	Remove a property change listener from the listener list.
void	removePropertyChangeListener(java.lang.String propertyName, java.beans.PropertyChangeListener listener)	Remove a property change listener for a specific property.

Method Detail

addPropertyChangeListener

void addPropertyChangeListener(java.beans.PropertyChangeListener listener)

Adds a property change listener to the listener list. The listener is registered for all properties.

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

Parameters:

listener - The PropertyChangeListener to be added.

See Also:

PropertyChangeEvent

removePropertyChangeListener

void removePropertyChangeListener(java.beans.PropertyChangeListener listener)

Remove a property change listener from the listener list. This removes a PropertyChangeListener that was registered for all properties.

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

Parameters:

listener - The PropertyChangeListener to be removed.

addPropertyChangeListener

void addPropertyChangeListener(java.lang.String propertyName,
                               java.beans.PropertyChangeListener listener)

Add a property change listener for a specific property.

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

Parameters:

propertyName - The name of the property to listen on.

listener - The PropertyChangeListener to be added.

removePropertyChangeListener

void removePropertyChangeListener(java.lang.String propertyName,
                                  java.beans.PropertyChangeListener listener)

Remove a property change listener for a specific property.

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

Parameters:

propertyName - The name of the property that was listened on.

listener - The PropertyChangeListener to be removed

getPropertyChangeListeners

java.beans.PropertyChangeListener[] getPropertyChangeListeners()

Returns an array of all the listeners that were added to the with addPropertyChangeListener(PropertyChangeListener). If some listeners have been added with a named property, then the returned array will be a mixture of PropertyChangeListeners and PropertyChangeListenerProxy s. If the calling method is interested in distinguishing the listeners then it must test each element to see if it's a PropertyChangeListenerProxy, perform the cast, and examine the parameter.

Returns:

all of the PropertyChangeListeners added or an empty array if no listeners have been added

See Also:

PropertyChangeListenerProxy

getPropertyChangeListeners

java.beans.PropertyChangeListener[] getPropertyChangeListeners(java.lang.String propertyName)

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

Parameters:

propertyName - The name of the property.

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

hasPropertyChangeListeners

boolean hasPropertyChangeListeners(java.lang.String propertyName)

Checks if there are any property change listeners for a specific property, including those registered on all properties. If propertyName is null, this method only checks for listeners registered on all properties.

Parameters:

propertyName - The property name.

Returns:

true if there are one or more listeners for the given property.