Module javafx.base

Package javafx.beans.property

Class DoubleProperty

java.lang.Object

javafx.beans.binding.NumberExpressionBase

javafx.beans.binding.DoubleExpression

javafx.beans.property.ReadOnlyDoubleProperty

javafx.beans.property.DoubleProperty

All Implemented Interfaces:

NumberExpression, Observable, Property<Number>, ReadOnlyProperty<Number>, ObservableDoubleValue, ObservableNumberValue, ObservableValue<Number>, WritableDoubleValue, WritableNumberValue, WritableValue<Number>

Direct Known Subclasses:

DoublePropertyBase, JavaBeanDoubleProperty

public abstract class DoubleProperty
extends ReadOnlyDoubleProperty
implements Property<Number>, WritableDoubleValue

This class defines a Property wrapping a double value.

The value of a DoubleProperty can be get and set with ObservableDoubleValue.get(), ObservableValue.getValue(), WritableDoubleValue.set(double), and WritableDoubleValue.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 Property.bindBidirectional(Property) and Property.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 WritableDoubleValue.setValue(java.lang.Number).

Since:

JavaFX 2.0

See Also:

ObservableDoubleValue, WritableDoubleValue, ReadOnlyDoubleProperty, Property

Constructor Summary

Constructors

Constructor	Description
DoubleProperty()

Method Summary

Modifier and Type	Method	Description
ObjectProperty<Double>	asObject()	Creates an ObjectProperty that bidirectionally bound to this DoubleProperty.
static DoubleProperty	doubleProperty(Property<Double> property)	Returns a DoubleProperty that wraps a Property and is bidirectionally bound to it.
String	toString()	Returns a string representation of this DoubleProperty object.

Methods declared in class javafx.beans.binding.DoubleExpression

doubleExpression, doubleExpression

Methods declared in interface javafx.beans.binding.NumberExpression

add, add, add, add, add, asString, asString, asString, divide, divide, divide, divide, divide, 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, multiply, multiply, multiply, multiply, multiply, negate, subtract, subtract, subtract, subtract, subtract

Methods declared in class javafx.beans.binding.NumberExpressionBase

numberExpression

Methods declared in class java.lang.Object

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

Methods declared in interface javafx.beans.Observable

addListener, removeListener

Methods declared in interface javafx.beans.value.ObservableDoubleValue

get

Methods declared in interface javafx.beans.value.ObservableNumberValue

doubleValue, floatValue, intValue, longValue

Methods declared in interface javafx.beans.value.ObservableValue

addListener, getValue, removeListener

Methods declared in interface javafx.beans.property.Property

bind, bindBidirectional, isBound, unbind, unbindBidirectional

Methods declared in class javafx.beans.property.ReadOnlyDoubleProperty

readOnlyDoubleProperty

Methods declared in interface javafx.beans.property.ReadOnlyProperty

getBean, getName

Methods declared in interface javafx.beans.value.WritableDoubleValue

get, set, setValue

Methods declared in interface javafx.beans.value.WritableValue

getValue

Constructor Detail

DoubleProperty

public DoubleProperty()

Method Detail

toString

public String toString()

Returns a string representation of this DoubleProperty object.

Overrides:

toString in class ReadOnlyDoubleProperty

Returns:

a string representation of this DoubleProperty object.

doubleProperty

public static DoubleProperty doubleProperty(Property<Double> property)

Returns a 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.

   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);

 

Another approach is to convert the DoubleProperty to ObjectProperty using asObject() method.

Note: null values in the source property will be interpreted as 0.0

Parameters:

property - The source Property

Returns:

A DoubleProperty that wraps the Property

Throws:

NullPointerException - if property is null

Since:

JavaFX 8.0

See Also:

asObject()

asObject

public ObjectProperty<Double> asObject()

Creates an 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());
 

Overrides:

asObject in class ReadOnlyDoubleProperty

Returns:

the new ObjectProperty

Since:

JavaFX 8.0