All Known Implementing Classes:: EventBasedItemPropertyChangeListener, EventBasedValueChangeListener, ItemPropertyChangeListener, SynchronousItemPropertyChangeListener, SynchronousValueChangeListener, ValueChangeAdapter

public interface ValueChangeListener

A value change listener can be added to ValueChangeSenders (like Field). When the value of a field changes, the method valueChanged(Object) is called. In this way, ValueChangeListener implementing classes can react on field changes.

Author:: Dr. Peter Droste, Omix Visualization
See Also:: ValueChangeSender.connect(ValueChangeListener...), ValueChangeSender.disconnect(ValueChangeListener...)

Method Summary

Modifier and Type	Method	Description
`void`	`addSender(ValueChangeSender sender)`	This method is called from inside `ValueChangeSender.connect(ValueChangeListener...)` in order to install a bidirectional connection.
`void`	`blockListening(boolean value)`	sets the listeningBlocked state in order to avoid listen to value changes.
`void`	`disconnectFromAllSenders()`	This method can be called in order to disconnect the listener from all senders which has been added by `addSender(ValueChangeSender)`.
`boolean`	`isConnected()`	Returns true if this listener is connected to at least one sender.
`boolean`	`listeningBlocked()`	If this method returns true the `valueChanged(Object)` is not invoked.
`void`	`removeSender(ValueChangeSender sender)`	This method is called from inside `ValueChangeSender.disconnect(ValueChangeListener...)` in order to remove the bidirectional connection.
`void`	`valueChanged(Object value)`	This method is called whenever the value of a field changes.
`default void`	`valueChanged(Object object, String property, Object oldValue, Object newValue)`	This method is called whenever the value of a field changes.

Method Details
- valueChanged
  
  void valueChanged(Object value) throws RuntimeException
  
  This method is called whenever the value of a field changes.
  
  Parameters:
  
  value - the new value of the field
  
  Throws:
  
  RuntimeException
- valueChanged
  
  default void valueChanged(Object object, String property, Object oldValue, Object newValue) throws RuntimeException
  
  This method is called whenever the value of a field changes.
  
  Parameters:
  
  value - the new value of the field
  
  Throws:
  
  RuntimeException
- addSender
  
  void addSender(ValueChangeSender sender)
  
  This method is called from inside ValueChangeSender.connect(ValueChangeListener...) in order to install a bidirectional connection.
  
  Parameters:
  
  sender - the connected sender
  
  See Also:
  
  ValueChangeSender.connect(ValueChangeListener...)
- disconnectFromAllSenders
  
  void disconnectFromAllSenders()
  
  This method can be called in order to disconnect the listener from all senders which has been added by addSender(ValueChangeSender).
- removeSender
  
  void removeSender(ValueChangeSender sender)
  
  This method is called from inside ValueChangeSender.disconnect(ValueChangeListener...) in order to remove the bidirectional connection.
  
  Parameters:
  
  sender -
- listeningBlocked
  
  boolean listeningBlocked()
  
  If this method returns true the valueChanged(Object) is not invoked.
  
  Returns:
  
  listeningBlocked
- blockListening
  
  void blockListening(boolean value)
  
  sets the listeningBlocked state in order to avoid listen to value changes.
  
  Parameters:
  
  value -
- isConnected
  
  boolean isConnected()
  
  Returns true if this listener is connected to at least one sender.
  
  Returns:
  
  connected

Interface ValueChangeListener

Method Summary

Method Details