Class LongProperty

java.lang.Object

javafx.beans.binding.NumberExpressionBase

javafx.beans.binding.LongExpression

javafx.beans.property.ReadOnlyLongProperty

javafx.beans.property.LongProperty

All Implemented Interfaces:

NumberExpression, Observable, Property<Number>, ReadOnlyProperty<Number>, ObservableLongValue, ObservableNumberValue, ObservableValue<Number>, WritableLongValue, WritableNumberValue, WritableValue<Number>

Direct Known Subclasses:

JavaBeanLongProperty, LongPropertyBase

public abstract class LongProperty
extends ReadOnlyLongProperty
implements Property<Number>, WritableLongValue

This class defines a Property wrapping a long value.

The value of a LongProperty can be get and set with ObservableLongValue.get(), LongExpression.getValue(), WritableLongValue.set(long), 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 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).

Since:

JavaFX 2.0

See Also:

• ObservableLongValue
• WritableLongValue
• ReadOnlyLongProperty
• Property

Constructor Summary

Constructors

Constructor	Description
LongProperty()	Creates a default LongProperty.

Method Summary

Modifier and Type	Method	Description
ObjectProperty<Long>	asObject()	Creates an ObjectProperty that bidirectionally bound to this LongProperty.
void	bindBidirectional(Property<Number> other)	Create a bidirectional binding between this Property and another one.
static LongProperty	longProperty(Property<Long> property)	Returns a LongProperty 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 LongProperty object.
void	unbindBidirectional(Property<Number> other)	Removes a bidirectional binding between this Property and another one.

Methods declared in class ReadOnlyLongProperty

readOnlyLongProperty

Modifier and Type	Method	Description
static <T extends Number> ReadOnlyLongProperty	readOnlyLongProperty(ReadOnlyProperty<T> property)	Returns a ReadOnlyLongProperty that wraps a ReadOnlyProperty.

Methods declared in class LongExpression

add, add, add, add, divide, divide, divide, divide, doubleValue, floatValue, getValue, intValue, longExpression, longExpression, longValue, multiply, multiply, multiply, multiply, negate, subtract, subtract, subtract, subtract

Modifier and Type	Method	Description
DoubleBinding	add(double other)	Creates a new NumberBinding that calculates the sum of this NumberExpression and a constant value.
FloatBinding	add(float other)	Creates a new NumberBinding that calculates the sum of this NumberExpression and a constant value.
LongBinding	add(int other)	Creates a new NumberBinding that calculates the sum of this NumberExpression and a constant value.
LongBinding	add(long other)	Creates a new NumberBinding that calculates the sum of this NumberExpression and a constant value.
DoubleBinding	divide(double other)	Creates a new NumberBinding that calculates the division of this NumberExpression and a constant value.
FloatBinding	divide(float other)	Creates a new NumberBinding that calculates the division of this NumberExpression and a constant value.
LongBinding	divide(int other)	Creates a new NumberBinding that calculates the division of this NumberExpression and a constant value.
LongBinding	divide(long other)	Creates a new NumberBinding that calculates the division of this NumberExpression and a constant value.
double	doubleValue()	Returns the value of this ObservableNumberValue as a double.
float	floatValue()	Returns the value of this ObservableNumberValue as a float.
Long	getValue()	Returns the current value of this ObservableValue
int	intValue()	Returns the value of this ObservableNumberValue as an int .
static LongExpression	longExpression(ObservableLongValue value)	Returns a LongExpression that wraps a ObservableLongValue.
static <T extends Number> LongExpression	longExpression(ObservableValue<T> value)	Returns a LongExpression that wraps an ObservableValue.
long	longValue()	Returns the value of this ObservableNumberValue as a long .
DoubleBinding	multiply(double other)	Creates a new NumberBinding that calculates the product of this NumberExpression and a constant value.
FloatBinding	multiply(float other)	Creates a new NumberBinding that calculates the product of this NumberExpression and a constant value.
LongBinding	multiply(int other)	Creates a new NumberBinding that calculates the product of this NumberExpression and a constant value.
LongBinding	multiply(long other)	Creates a new NumberBinding that calculates the product of this NumberExpression and a constant value.
LongBinding	negate()	Creates a new NumberBinding that calculates the negation of NumberExpression.
DoubleBinding	subtract(double other)	Creates a new NumberBinding that calculates the difference of this NumberExpression and a constant value.
FloatBinding	subtract(float other)	Creates a new NumberBinding that calculates the difference of this NumberExpression and a constant value.
LongBinding	subtract(int other)	Creates a new NumberBinding that calculates the difference of this NumberExpression and a constant value.
LongBinding	subtract(long other)	Creates a new NumberBinding that calculates the difference of this NumberExpression and a constant value.

Methods declared in class NumberExpressionBase

add, asString, asString, asString, 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, numberExpression, subtract

Modifier and Type	Method	Description
NumberBinding	add(ObservableNumberValue other)	Creates a new NumberBinding that calculates the sum of this NumberExpression and another ObservableNumberValue.
StringBinding	asString()	Creates a StringBinding that holds the value of the NumberExpression turned into a String.
StringBinding	asString(String format)	Creates a StringBinding that holds the value of the NumberExpression turned into a String.
StringBinding	asString(Locale locale, String format)	Creates a StringBinding that holds the value of the NumberExpression turned into a String.
NumberBinding	divide(ObservableNumberValue other)	Creates a new NumberBinding that calculates the division of this NumberExpression and another ObservableNumberValue.
BooleanBinding	greaterThan(double other)	Creates a new BooleanBinding that holds true if this NumberExpression is greater than a constant value.
BooleanBinding	greaterThan(float other)	Creates a new BooleanBinding that holds true if this NumberExpression is greater than a constant value.
BooleanBinding	greaterThan(int other)	Creates a new BooleanBinding that holds true if this NumberExpression is greater than a constant value.
BooleanBinding	greaterThan(long other)	Creates a new BooleanBinding that holds true if this NumberExpression is greater than a constant value.
BooleanBinding	greaterThan(ObservableNumberValue other)	Creates a new BooleanBinding that holds true if this NumberExpression is greater than another ObservableNumberValue.
BooleanBinding	greaterThanOrEqualTo(double other)	Creates a new BooleanBinding that holds true if this NumberExpression is greater than or equal to a constant value.
BooleanBinding	greaterThanOrEqualTo(float other)	Creates a new BooleanBinding that holds true if this NumberExpression is greater than or equal to a constant value.
BooleanBinding	greaterThanOrEqualTo(int other)	Creates a new BooleanBinding that holds true if this NumberExpression is greater than or equal to a constant value.
BooleanBinding	greaterThanOrEqualTo(long other)	Creates a new BooleanBinding that holds true if this NumberExpression is greater than or equal to a constant value.
BooleanBinding	greaterThanOrEqualTo(ObservableNumberValue other)	Creates a new BooleanBinding that holds true if this NumberExpression is greater than or equal to another ObservableNumberValue.
BooleanBinding	isEqualTo(double other, double epsilon)	Creates a new BooleanBinding that holds true if this NumberExpression is equal to a constant value (with a tolerance).
BooleanBinding	isEqualTo(float other, double epsilon)	Creates a new BooleanBinding that holds true if this NumberExpression is equal to a constant value (with a tolerance).
BooleanBinding	isEqualTo(int other)	Creates a new BooleanBinding that holds true if this NumberExpression is equal to a constant value.
BooleanBinding	isEqualTo(int other, double epsilon)	Creates a new BooleanBinding that holds true if this NumberExpression is equal to a constant value (with a tolerance).
BooleanBinding	isEqualTo(long other)	Creates a new BooleanBinding that holds true if this NumberExpression is equal to a constant value.
BooleanBinding	isEqualTo(long other, double epsilon)	Creates a new BooleanBinding that holds true if this NumberExpression is equal to a constant value (with a tolerance).
BooleanBinding	isEqualTo(ObservableNumberValue other)	Creates a new BooleanBinding that holds true if this and another ObservableNumberValue are equal.
BooleanBinding	isEqualTo(ObservableNumberValue other, double epsilon)	Creates a new BooleanBinding that holds true if this and another ObservableNumberValue are equal (with a tolerance).
BooleanBinding	isNotEqualTo(double other, double epsilon)	Creates a new BooleanBinding that holds true if this NumberExpression is not equal to a constant value (with a tolerance).
BooleanBinding	isNotEqualTo(float other, double epsilon)	Creates a new BooleanBinding that holds true if this NumberExpression is not equal to a constant value (with a tolerance).
BooleanBinding	isNotEqualTo(int other)	Creates a new BooleanBinding that holds true if this NumberExpression is not equal to a constant value.
BooleanBinding	isNotEqualTo(int other, double epsilon)	Creates a new BooleanBinding that holds true if this NumberExpression is not equal to a constant value (with a tolerance).
BooleanBinding	isNotEqualTo(long other)	Creates a new BooleanBinding that holds true if this NumberExpression is not equal to a constant value.
BooleanBinding	isNotEqualTo(long other, double epsilon)	Creates a new BooleanBinding that holds true if this NumberExpression is not equal to a constant value (with a tolerance).
BooleanBinding	isNotEqualTo(ObservableNumberValue other)	Creates a new BooleanBinding that holds true if this and another ObservableNumberValue are not equal.
BooleanBinding	isNotEqualTo(ObservableNumberValue other, double epsilon)	Creates a new BooleanBinding that holds true if this and another ObservableNumberValue are not equal (with a tolerance).
BooleanBinding	lessThan(double other)	Creates a new BooleanBinding that holds true if this NumberExpression is lesser than a constant value.
BooleanBinding	lessThan(float other)	Creates a new BooleanBinding that holds true if this NumberExpression is lesser than a constant value.
BooleanBinding	lessThan(int other)	Creates a new BooleanBinding that holds true if this NumberExpression is lesser than a constant value.
BooleanBinding	lessThan(long other)	Creates a new BooleanBinding that holds true if this NumberExpression is lesser than a constant value.
BooleanBinding	lessThan(ObservableNumberValue other)	Creates a new BooleanBinding that holds true if this NumberExpression is lesser than another ObservableNumberValue.
BooleanBinding	lessThanOrEqualTo(double other)	Creates a new BooleanBinding that holds true if this NumberExpression is less than or equal to a constant value.
BooleanBinding	lessThanOrEqualTo(float other)	Creates a new BooleanBinding that holds true if this NumberExpression is less than or equal to a constant value.
BooleanBinding	lessThanOrEqualTo(int other)	Creates a new BooleanBinding that holds true if this NumberExpression is less than or equal to a constant value.
BooleanBinding	lessThanOrEqualTo(long other)	Creates a new BooleanBinding that holds true if this NumberExpression is less than or equal to a constant value.
BooleanBinding	lessThanOrEqualTo(ObservableNumberValue other)	Creates a new BooleanBinding that holds true if this NumberExpression is less than or equal to another ObservableNumberValue.
NumberBinding	multiply(ObservableNumberValue other)	Creates a new NumberBinding that calculates the product of this NumberExpression and another ObservableNumberValue.
static <S extends Number> NumberExpressionBase	numberExpression(ObservableNumberValue value)	Returns an NumberExpressionBase that wraps a ObservableNumberValue.
NumberBinding	subtract(ObservableNumberValue other)	Creates a new NumberBinding that calculates the difference of this NumberExpression and another ObservableNumberValue.

Methods declared in class Object

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

Methods declared in interface Observable

addListener, removeListener, subscribe

Modifier and Type	Method	Description
void	addListener(InvalidationListener listener)	Adds an InvalidationListener which will be notified whenever the Observable becomes invalid.
void	removeListener(InvalidationListener listener)	Removes the given listener from the list of listeners, that are notified whenever the value of the Observable becomes invalid.
default Subscription	subscribe(Runnable invalidationSubscriber)	Creates a Subscription on this Observable which calls invalidationSubscriber whenever it becomes invalid.

Methods declared in interface ObservableLongValue

get

Modifier and Type	Method	Description
long	get()	Returns the current value of this ObservableLongValue.

Methods declared in interface ObservableValue

addListener, flatMap, map, orElse, removeListener, subscribe, subscribe, when

Modifier and Type	Method	Description
void	addListener(ChangeListener<? super Number> listener)	Adds a ChangeListener which will be notified whenever the value of the ObservableValue changes.
default <U> ObservableValue<U>	flatMap(Function<? super Number, ? extends ObservableValue<? extends U>> mapper)	Returns an ObservableValue that holds the value of an ObservableValue produced by applying the given mapping function on this value.
default <U> ObservableValue<U>	map(Function<? super Number, ? extends U> mapper)	Returns an ObservableValue that holds the result of applying the given mapping function on this value.
default ObservableValue<Number>	orElse(Number constant)	Returns an ObservableValue that holds this value, or the given constant if it is null.
void	removeListener(ChangeListener<? super Number> listener)	Removes the given listener from the list of listeners that are notified whenever the value of the ObservableValue changes.
default Subscription	subscribe(BiConsumer<? super Number, ? super Number> changeSubscriber)	Creates a Subscription on this ObservableValue which calls the given changeSubscriber with the old and new value whenever its value changes.
default Subscription	subscribe(Consumer<? super Number> valueSubscriber)	Creates a Subscription on this ObservableValue which immediately provides the current value to the given valueSubscriber, followed by any subsequent values whenever its value changes.
default ObservableValue<Number>	when(ObservableValue<Boolean> condition)	Returns an ObservableValue that holds this value and is updated only when condition holds true.

Methods declared in interface Property

bind, isBound, unbind

Modifier and Type	Method	Description
void	bind(ObservableValue<? extends Number> observable)	Create a unidirection binding for this Property.
boolean	isBound()	Can be used to check, if a Property is bound.
void	unbind()	Remove the unidirectional binding for this Property.

Methods declared in interface ReadOnlyProperty

getBean, getName

Modifier and Type	Method	Description
Object	getBean()	Returns the Object that contains this property.
String	getName()	Returns the name of this property.

Methods declared in interface WritableLongValue

get, set

Modifier and Type	Method	Description
long	get()	Get the wrapped value.
void	set(long value)	Set the wrapped value.

Methods declared in interface WritableValue

getValue

Modifier and Type	Method	Description
Number	getValue()	Get the wrapped value.

Constructor Details

LongProperty

public LongProperty()

Creates a default LongProperty.

Method Details

setValue

public void setValue(Number v)

Set the wrapped value.

Specified by:

setValue in interface WritableLongValue

Specified by:

setValue in interface WritableValue<Number>

Parameters:

v - The new value

bindBidirectional

public void bindBidirectional(Property<Number> other)

Create a bidirectional binding between this 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.

Specified by:

bindBidirectional in interface Property<Number>

Parameters:

other - the other Property

unbindBidirectional

public void unbindBidirectional(Property<Number> other)

Removes a bidirectional binding between this 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.bindBidirectional(property2);
    property2.unbindBidirectional(property1);

Specified by:

unbindBidirectional in interface Property<Number>

Parameters:

other - the other Property

toString

public String toString()

Returns a string representation of this LongProperty object.

Overrides:

toString in class ReadOnlyLongProperty

Returns:

a string representation of this LongProperty object.

longProperty

public static LongProperty longProperty(Property<Long> property)

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

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

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

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

Parameters:

property - The source Property

Returns:

A LongProperty that wraps the Property

Throws:

NullPointerException - if property is null

Since:

JavaFX 8.0

See Also:

• asObject()

asObject

public ObjectProperty<Long> asObject()

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

Overrides:

asObject in class ReadOnlyLongProperty

Returns:

the new ObjectProperty

Since:

JavaFX 8.0