Module MaterialFX

Package io.github.palexdev.materialfx.beans.properties.synced

Class SynchronizedBooleanProperty

java.lang.Object

javafx.beans.binding.BooleanExpression

javafx.beans.property.ReadOnlyBooleanProperty

javafx.beans.property.BooleanProperty

javafx.beans.property.BooleanPropertyBase

javafx.beans.property.SimpleBooleanProperty

io.github.palexdev.materialfx.beans.properties.synced.SynchronizedBooleanProperty

All Implemented Interfaces:

SynchronizedProperty<Boolean>, Observable, Property<Boolean>, ReadOnlyProperty<Boolean>, ObservableBooleanValue, ObservableValue<Boolean>, WritableBooleanValue, WritableValue<Boolean>

public class SynchronizedBooleanProperty
extends SimpleBooleanProperty
implements SynchronizedProperty<Boolean>

Implementation of SynchronizedProperty for boolean values.

Nested Class Summary

Nested classes/interfaces inherited from interface io.github.palexdev.materialfx.beans.properties.base.SynchronizedProperty

SynchronizedProperty.Helper

Constructor Summary

Constructors

Constructor	Description
SynchronizedBooleanProperty()
SynchronizedBooleanProperty(boolean initialValue)
SynchronizedBooleanProperty(Object bean, String name)
SynchronizedBooleanProperty(Object bean, String name, boolean initialValue)

Method Summary

Modifier and Type	Method	Description
void	awake()	Awakes the property by setting SynchronizedProperty.waiting() to false.
void	bind(ObservableValue<? extends Boolean> source)	Creates a unidirectional binding with the given observable.
void	bindBidirectional(Property<Boolean> other)	Creates a bidirectional bindings between this property and the given property.
void	clearBidirectional()	Delegate method for BiBindingManager.disposeFor(ObservableValue).
protected void	fireValueChangedEvent()
boolean	isBound()	Overridden to check the BindingManager.isBound(ObservableValue) flag value and BindingManager.isIgnoreBinding(ObservableValue).
boolean	isWaiting()
void	setAndWait(Boolean value, ObservableValue<?> observable)	Sets this property's state to "waiting" then uses ExecutionUtils.executeWhen(Observable, Runnable, boolean, Supplier, boolean) to "awake" the property when the given observable changes.
void	unbind()	Overridden to call BindingManager.unbind(ObservableValue).
void	unbindBidirectional(Property<Boolean> other)	Overridden to call BiBindingManager.unbind(ObservableValue, ObservableValue).
ReadOnlyBooleanProperty	waiting()

Methods inherited from class javafx.beans.property.SimpleBooleanProperty

getBean, getName

Methods inherited from class javafx.beans.property.BooleanPropertyBase

addListener, addListener, get, invalidated, removeListener, removeListener, set, toString

Methods inherited from class javafx.beans.property.BooleanProperty

asObject, booleanProperty, setValue

Methods inherited from class javafx.beans.property.ReadOnlyBooleanProperty

readOnlyBooleanProperty

Methods inherited from class javafx.beans.binding.BooleanExpression

and, asString, booleanExpression, booleanExpression, getValue, isEqualTo, isNotEqualTo, not, or

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface javafx.beans.Observable

addListener, removeListener

Methods inherited from interface javafx.beans.value.ObservableValue

addListener, getValue, removeListener

Methods inherited from interface javafx.beans.property.ReadOnlyProperty

getBean, getName

Methods inherited from interface javafx.beans.value.WritableValue

getValue

Constructor Details

SynchronizedBooleanProperty

public SynchronizedBooleanProperty()

SynchronizedBooleanProperty

public SynchronizedBooleanProperty(boolean initialValue)

SynchronizedBooleanProperty

public SynchronizedBooleanProperty(Object bean,
 String name)

SynchronizedBooleanProperty

public SynchronizedBooleanProperty(Object bean,
 String name,
 boolean initialValue)

Method Details

setAndWait

public void setAndWait(Boolean value,
 ObservableValue<?> observable)

Sets this property's state to "waiting" then uses ExecutionUtils.executeWhen(Observable, Runnable, boolean, Supplier, boolean) to "awake" the property when the given observable changes.

Just like JavaFX properties if the new value is the same as the current value the method returns and does nothing.

Specified by:

setAndWait in interface SynchronizedProperty<Boolean>

Parameters:

value - the new value of the property

observable - the observable to wait for

isWaiting

public boolean isWaiting()

Specified by:

isWaiting in interface SynchronizedProperty<Boolean>

Returns:

whether this property is in waiting state

waiting

public ReadOnlyBooleanProperty waiting()

Specified by:

waiting in interface SynchronizedProperty<Boolean>

Returns:

the waiting state property as a read only property

awake

public void awake()

Awakes the property by setting SynchronizedProperty.waiting() to false.

This method should never be invoked by the user, the awakening is automatically managed by the property. If for some reason the property stays in waiting state you are probably doing something wrong.

Specified by:

awake in interface SynchronizedProperty<Boolean>

fireValueChangedEvent

protected void fireValueChangedEvent()

Overridden to not fire a change event if waiting() is true.

Overrides:

fireValueChangedEvent in class BooleanPropertyBase

bind

public void bind(ObservableValue<? extends Boolean> source)

Creates a unidirectional binding with the given observable.

The binding is created using the new BindingManager mechanism.

If the property is already bound it is automatically unbound before bindings to the new observable.

Specified by:

bind in interface Property<Boolean>

Overrides:

bind in class BooleanPropertyBase

Throws:

IllegalArgumentException - if the given observable is the property itself

See Also:

• BindingManager

bindBidirectional

public void bindBidirectional(Property<Boolean> other)

Creates a bidirectional bindings between this property and the given property.

The binding is created using the new BiBindingManager mechanism.

If the property is already bound unidirectionally it is automatically unbound.

If the property is already bound bidirectionally it won't be automatically unbound, just like JavaFX, this way you can have multiple bidirectional bindings

Specified by:

bindBidirectional in interface Property<Boolean>

Overrides:

bindBidirectional in class BooleanProperty

Throws:

IllegalArgumentException - if the given observable is the property itself

See Also:

• BiBindingManager

unbind

public void unbind()

Overridden to call BindingManager.unbind(ObservableValue).

Specified by:

unbind in interface Property<Boolean>

Overrides:

unbind in class BooleanPropertyBase

unbindBidirectional

public void unbindBidirectional(Property<Boolean> other)

Overridden to call BiBindingManager.unbind(ObservableValue, ObservableValue).

Specified by:

unbindBidirectional in interface Property<Boolean>

Overrides:

unbindBidirectional in class BooleanProperty

clearBidirectional

public void clearBidirectional()

Delegate method for BiBindingManager.disposeFor(ObservableValue).

isBound

public boolean isBound()

Overridden to check the BindingManager.isBound(ObservableValue) flag value and BindingManager.isIgnoreBinding(ObservableValue).

Specified by:

isBound in interface Property<Boolean>

Overrides:

isBound in class BooleanPropertyBase

Returns:

true only if `BindingManager.isBound()` is true and `isIgnoreBound()` is false