public abstract class DoubleProperty extends ReadOnlyDoubleProperty implements Property<java.lang.Number>
Property
wrapping a double
value.
The value of a DoubleProperty
can be get and set with #get()
,
#getValue()
, #set(double)
, and setValue(Number)
.
A property can be bound and unbound unidirectional with
#bind(ObservableValue)
and Property.unbind()
. Bidirectional bindings
can be created and removed with bindBidirectional(Property)
and
unbindBidirectional(Property)
.
The context of a DoubleProperty
can be read with ReadOnlyProperty.getBean()
and ReadOnlyProperty.getName()
.
Note: setting or binding this property to a null value will set the property to "0.0". See setValue(java.lang.Number)
.
javafx.beans.value.ObservableDoubleValue
,
javafx.beans.value.WritableDoubleValue
,
ReadOnlyDoubleProperty
,
Property
Constructor and Description |
---|
DoubleProperty() |
Modifier and Type | Method and Description |
---|---|
ObjectProperty<java.lang.Double> |
asObject()
Creates an
ObjectProperty
that bidirectionally bound to this DoubleProperty . |
void |
bindBidirectional(Property<java.lang.Number> other)
Create a bidirectional binding between this
Property and another
one. |
static DoubleProperty |
doubleProperty(Property<java.lang.Double> property)
Returns a
DoubleProperty that wraps a
Property and is
bidirectionally bound to it. |
void |
setValue(java.lang.Number v) |
java.lang.String |
toString()
Returns a string representation of this
DoubleProperty object. |
void |
unbindBidirectional(Property<java.lang.Number> other)
Remove a bidirectional binding between this
Property and another
one. |
readOnlyDoubleProperty
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
getBean, getName
public void setValue(java.lang.Number v)
public void bindBidirectional(Property<java.lang.Number> other)
Property
and another
one.
Bidirectional bindings exists independently of unidirectional bindings. So it is possible to
add unidirectional binding to a property with bidirectional binding and vice-versa. However, this practice is
discouraged.
It is possible to have multiple bidirectional bindings of one Property.
JavaFX bidirectional binding implementation use weak listeners. This means bidirectional binding does not prevent properties from being garbage collected.
bindBidirectional
in interface Property<java.lang.Number>
other
- the other Property
public void unbindBidirectional(Property<java.lang.Number> other)
Property
and another
one.
If no bidirectional binding between the properties exists, calling this
method has no effect.
It is possible to unbind by a call on the second property. This code will work:
property1.bindBirectional(property2); property2.unbindBidirectional(property1);
unbindBidirectional
in interface Property<java.lang.Number>
other
- the other Property
public java.lang.String toString()
DoubleProperty
object.toString
in class ReadOnlyDoubleProperty
DoubleProperty
object.public static DoubleProperty doubleProperty(Property<java.lang.Double> property)
DoubleProperty
that wraps a
Property
and is
bidirectionally bound to it.
Changing this property will result in a change of the original property.
This is very useful when bidirectionally binding an ObjectProperty<Double> and a DoubleProperty.
Another approach is to convert the DoubleProperty to ObjectProperty usingDoubleProperty doubleProperty = new SimpleDoubleProperty(1.0); ObjectProperty<Double> objectProperty = new SimpleObjectProperty<>(2.0); // Need to keep the reference as bidirectional binding uses weak references DoubleProperty objectAsDouble = DoubleProperty.doubleProperty(objectProperty); doubleProperty.bindBidirectional(objectAsDouble);
asObject()
method.
Note: null values in the source property will be interpreted as 0.0
property
- The source Property
DoubleProperty
that wraps the
Property
java.lang.NullPointerException
- if property
is null
asObject()
public ObjectProperty<java.lang.Double> asObject()
ObjectProperty
that bidirectionally bound to this DoubleProperty
. If the
value of this DoubleProperty
changes, the value of the
ObjectProperty
will be updated automatically and vice-versa.
Can be used for binding an ObjectProperty to DoubleProperty.
DoubleProperty doubleProperty = new SimpleDoubleProperty(1.0); ObjectProperty<Double> objectProperty = new SimpleObjectProperty<>(2.0); objectProperty.bind(doubleProperty.asObject());
asObject
in class ReadOnlyDoubleProperty
ObjectProperty