Class IntegerProperty

java.lang.Object

javafx.beans.binding.NumberExpressionBase

javafx.beans.binding.IntegerExpression

javafx.beans.property.ReadOnlyIntegerProperty

javafx.beans.property.IntegerProperty

All Implemented Interfaces:

NumberExpression, Observable, Property<Number>, ReadOnlyProperty<Number>, ObservableIntegerValue, ObservableNumberValue, ObservableValue<Number>, WritableIntegerValue, WritableNumberValue, WritableValue<Number>

Direct Known Subclasses:

IntegerPropertyBase, JavaBeanIntegerProperty

public abstract class IntegerProperty
extends ReadOnlyIntegerProperty
implements Property<Number>, WritableIntegerValue

This class defines a Property wrapping an int value.

The value of an IntegerProperty can be get and set with ObservableIntegerValue.get(), IntegerExpression.getValue(), WritableIntegerValue.set(int), 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 IntegerProperty 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:

• ObservableIntegerValue
• WritableIntegerValue
• ReadOnlyIntegerProperty
• Property

Constructor Summary

Constructors

Constructor	Description
IntegerProperty()	Creates a default IntegerProperty.

Method Summary

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

Methods declared in class ReadOnlyIntegerProperty

readOnlyIntegerProperty

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

Methods declared in class IntegerExpression

add, add, add, add, divide, divide, divide, divide, doubleValue, floatValue, getValue, integerExpression, integerExpression, intValue, 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.
IntegerBinding	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.
IntegerBinding	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.
Integer	getValue()	Returns the current value of this ObservableValue
static IntegerExpression	integerExpression(ObservableIntegerValue value)	Returns a IntegerExpression that wraps a ObservableIntegerValue.
static <T extends Number> IntegerExpression	integerExpression(ObservableValue<T> value)	Returns an IntegerExpression that wraps an ObservableValue.
int	intValue()	Returns the value of this ObservableNumberValue as an int .
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.
IntegerBinding	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.
IntegerBinding	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.
IntegerBinding	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 ObservableIntegerValue

get

Modifier and Type	Method	Description
int	get()	Returns the current value of this ObservableIntegerValue.

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 WritableIntegerValue

get, set

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

Methods declared in interface WritableValue

getValue

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

Constructor Details

IntegerProperty

public IntegerProperty()

Creates a default IntegerProperty.

Method Details

setValue

public void setValue(Number v)

Set the wrapped value.

Specified by:

setValue in interface WritableIntegerValue

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 IntegerProperty object.

Overrides:

toString in class ReadOnlyIntegerProperty

Returns:

a string representation of this IntegerProperty object.

integerProperty

public static IntegerProperty integerProperty(Property<Integer> property)

Returns a IntegerProperty 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<Integer> and a IntegerProperty.

  IntegerProperty integerProperty = new SimpleIntegerProperty(1);
  ObjectProperty<Integer> objectProperty = new SimpleObjectProperty<>(2);

  // Need to keep the reference as bidirectional binding uses weak references
  IntegerProperty objectAsInteger = IntegerProperty.integerProperty(objectProperty);

  integerProperty.bindBidirectional(objectAsInteger);

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

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

Parameters:

property - The source Property

Returns:

A IntegerProperty that wraps the Property

Throws:

NullPointerException - if property is null

Since:

JavaFX 8.0

See Also:

• asObject()

asObject

public ObjectProperty<Integer> asObject()

Creates an ObjectProperty that bidirectionally bound to this IntegerProperty. If the value of this IntegerProperty changes, the value of the ObjectProperty will be updated automatically and vice-versa.

Can be used for binding an ObjectProperty to IntegerProperty.

  IntegerProperty integerProperty = new SimpleIntegerProperty(1);
  ObjectProperty<Integer> objectProperty = new SimpleObjectProperty<>(2);

  objectProperty.bind(integerProperty.asObject());

Overrides:

asObject in class ReadOnlyIntegerProperty

Returns:

the new ObjectProperty

Since:

JavaFX 8.0