public abstract class DoubleProperty extends ReadOnlyDoubleProperty implements Property<Number>, WritableDoubleValue
Property
wrapping a double
value.
The value of a DoubleProperty
can be get and set with ObservableDoubleValue.get()
,
DoubleExpression.getValue()
, WritableDoubleValue.set(double)
, and setValue(Number)
.
A property can be bound and unbound unidirectional with
Property.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)
.
ObservableDoubleValue
,
WritableDoubleValue
,
ReadOnlyDoubleProperty
,
Property
Constructor and Description |
---|
DoubleProperty() |
Modifier and Type | Method and Description |
---|---|
ObjectProperty<Double> |
asObject()
Creates an
ObjectProperty
that bidirectionally bound to this DoubleProperty . |
void |
bindBidirectional(Property<Number> other)
Create a bidirectional binding between this
Property and another
one. |
static DoubleProperty |
doubleProperty(Property<Double> property)
Returns a
DoubleProperty that wraps a
Property and is
bidirectionally bound to it. |
void |
setValue(Number v)
Set the wrapped value.
|
String |
toString()
Returns a string representation of this
DoubleProperty object. |
void |
unbindBidirectional(Property<Number> other)
Remove a bidirectional binding between this
Property and another
one. |
readOnlyDoubleProperty
add, add, add, add, add, divide, divide, divide, divide, divide, doubleExpression, doubleExpression, doubleValue, floatValue, getValue, intValue, longValue, multiply, multiply, multiply, multiply, multiply, negate, subtract, subtract, subtract, subtract, subtract
asString, asString, asString, greaterThan, greaterThan, greaterThan, greaterThan, greaterThan, greaterThanOrEqualTo, greaterThanOrEqualTo, greaterThanOrEqualTo, greaterThanOrEqualTo, greaterThanOrEqualTo, isEqualTo, isEqualTo, isEqualTo, isEqualTo, isEqualTo, isEqualTo, isEqualTo, isEqualTo, isNotEqualTo, isNotEqualTo, isNotEqualTo, isNotEqualTo, isNotEqualTo, isNotEqualTo, isNotEqualTo, isNotEqualTo, lessThan, lessThan, lessThan, lessThan, lessThan, lessThanOrEqualTo, lessThanOrEqualTo, lessThanOrEqualTo, lessThanOrEqualTo, lessThanOrEqualTo, numberExpression
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
getBean, getName
addListener, getValue, removeListener
addListener, removeListener
get, set
getValue
get
public void setValue(Number v)
setValue
in interface WritableDoubleValue
setValue
in interface WritableValue<Number>
v
- The new valuepublic void bindBidirectional(Property<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<Number>
other
- the other Property
public void unbindBidirectional(Property<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<Number>
other
- the other Property
public String toString()
DoubleProperty
object.toString
in class ReadOnlyDoubleProperty
DoubleProperty
object.public static DoubleProperty doubleProperty(Property<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
Note: null values in the source property will be interpreted as 0.0
Another approach is to convert the DoubleProperty to ObjectProperty using
DoubleProperty 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.
property
- The source Property
DoubleProperty
that wraps the
Property
NullPointerException
- if property
is null
asObject()
public ObjectProperty<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
Copyright (c) 2008, 2015, Oracle and/or its affiliates. All rights reserved.