public abstract class LongProperty extends ReadOnlyLongProperty implements Property<java.lang.Number>
Property
wrapping a long
value.
The value of a LongProperty
can be get and set with #get()
,
#getValue()
, #set(long)
, 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 LongProperty
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.ObservableLongValue
,
javafx.beans.value.WritableLongValue
,
ReadOnlyLongProperty
,
Property
Constructor and Description |
---|
LongProperty() |
Modifier and Type | Method and Description |
---|---|
ObjectProperty<java.lang.Long> |
asObject()
Creates an
ObjectProperty
that bidirectionally bound to this LongProperty . |
void |
bindBidirectional(Property<java.lang.Number> other)
Create a bidirectional binding between this
Property and another
one. |
static LongProperty |
longProperty(Property<java.lang.Long> property)
Returns a
LongProperty 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
LongProperty object. |
void |
unbindBidirectional(Property<java.lang.Number> other)
Remove a bidirectional binding between this
Property and another
one. |
readOnlyLongProperty
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()
LongProperty
object.toString
in class ReadOnlyLongProperty
LongProperty
object.public static LongProperty longProperty(Property<java.lang.Long> property)
LongProperty
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<Long> and a LongProperty.
Another approach is to convert the LongProperty to ObjectProperty usingLongProperty longProperty = new SimpleLongProperty(1L); ObjectProperty<Long> objectProperty = new SimpleObjectProperty<>(2L); // Need to keep the reference as bidirectional binding uses weak references LongProperty objectAsLong = LongProperty.longProperty(objectProperty); longProperty.bindBidirectional(objectAsLong);
asObject()
method.
Note: null values in the source property will be interpreted as 0L
property
- The source Property
LongProperty
that wraps the
Property
java.lang.NullPointerException
- if property
is null
asObject()
public ObjectProperty<java.lang.Long> asObject()
ObjectProperty
that bidirectionally bound to this LongProperty
. If the
value of this LongProperty
changes, the value of the
ObjectProperty
will be updated automatically and vice-versa.
Can be used for binding an ObjectProperty to LongProperty.
LongProperty longProperty = new SimpleLongProperty(1L); ObjectProperty<Long> objectProperty = new SimpleObjectProperty<>(2L); objectProperty.bind(longProperty.asObject());
asObject
in class ReadOnlyLongProperty
ObjectProperty