JavaFX 24 · javafx.beans.property.IntegerProperty · APIdia, the JavaDoc alternative

This class defines a Property wrapping an int value.

The value of an IntegerProperty can be get and set with get(), getValue(), set(int), and setValue(Number).

A property can be bound and unbound unidirectional with bind(ObservableValue) and unbind(). Bidirectional bindings can be created and removed with bindBidirectional(Property) and unbindBidirectional(Property).

The context of a IntegerProperty can be read with getBean() and getName().

Note

setting or binding this property to a null value will set the property to "0.0". See setValue(java.lang.Number).

Constructor Summary

Access	Constructor and Description
public	IntegerProperty() Creates a default `IntegerProperty`.

Method Summary

Modifier and Type	Method and Description
public ObjectProperty<Integer>	Returns: the new `ObjectProperty` asObject() Overrides javafx.beans.property.ReadOnlyIntegerProperty.asObject. Creates an `javafx.beans.property.ObjectProperty` that bidirectionally bound to this `IntegerProperty`.
public void	bindBidirectional(Property<Number> the other `Property` other) Implements javafx.beans.property.Property.bindBidirectional. Create a bidirectional binding between this `Property` and another one.
public static IntegerProperty	Returns: A `IntegerProperty` that wraps the `Property` integerProperty(final Property<Integer> The source `Property` property) Returns a `IntegerProperty` that wraps a `javafx.beans.property.Property` and is bidirectionally bound to it.
public void	setValue(Number The new value v) Implements javafx.beans.value.WritableValue.setValue, javafx.beans.value.WritableIntegerValue.setValue. Set the wrapped value.
public String	Returns: a string representation of this `IntegerProperty` object. toString() Overrides javafx.beans.property.ReadOnlyIntegerProperty.toString. Returns a string representation of this `IntegerProperty` object.
public void	unbindBidirectional(Property<Number> the other `Property` other) Implements javafx.beans.property.Property.unbindBidirectional. Removes a bidirectional binding between this `Property` and another one.

Inherited from javafx.beans.property.ReadOnlyIntegerProperty:: readOnlyIntegerProperty

Constructor Detail

IntegerProperty	back to summary
public IntegerProperty() Creates a default `IntegerProperty`.

Method Detail

asObject back to summary

asObject	back to summary
public ObjectProperty<Integer> asObject() Overrides javafx.beans.property.ReadOnlyIntegerProperty.asObject. Creates an `javafx.beans.property.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()); Returns:ObjectProperty<Integer> the new `ObjectProperty` Annotations @Override Since JavaFX 8.0

public ObjectProperty<Integer> asObject()

Overrides javafx.beans.property.ReadOnlyIntegerProperty.asObject.

Creates an javafx.beans.property.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());

Returns:ObjectProperty<Integer>

the new ObjectProperty

Annotations

@Override

Since

JavaFX 8.0

bindBidirectional back to summary

bindBidirectional	back to summary
public void bindBidirectional(Property<Number> other) Implements javafx.beans.property.Property.bindBidirectional. Doc from javafx.beans.property.Property.bindBidirectional. 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. Parameters other:Property<Number> the other `Property` Annotations @Override

public void bindBidirectional(Property<Number> other)

Implements javafx.beans.property.Property.bindBidirectional.

Doc from javafx.beans.property.Property.bindBidirectional.

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.

Parameters

other:Property<Number>: the other Property

Annotations

@Override

integerProperty back to summary

integerProperty	back to summary
public static IntegerProperty integerProperty(final Property<Integer> property) Returns a `IntegerProperty` that wraps a `javafx.beans.property.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:Property<Integer> The source `Property` Returns:IntegerProperty A `IntegerProperty` that wraps the `Property` Exceptions NullPointerException: if `property` is `null` Since JavaFX 8.0 See Also `asObject()`

public static IntegerProperty integerProperty(final Property<Integer> property)

Returns a IntegerProperty that wraps a javafx.beans.property.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:Property<Integer>: The source Property

Returns:IntegerProperty

A IntegerProperty that wraps the Property

Exceptions

NullPointerException:: if property is null

Since

JavaFX 8.0

See Also

asObject()

setValue	back to summary
public void setValue(Number v) Implements javafx.beans.value.WritableValue.setValue, javafx.beans.value.WritableIntegerValue.setValue. Doc from javafx.beans.value.WritableIntegerValue.setValue. Set the wrapped value. Note this method should accept null without throwing an exception, setting "0" instead. Parameters v:Number The new value Annotations @Override

setValue

back to summary

public void setValue(Number v)

Implements javafx.beans.value.WritableValue.setValue, javafx.beans.value.WritableIntegerValue.setValue.

Doc from javafx.beans.value.WritableIntegerValue.setValue.

Set the wrapped value.

Note

this method should accept null without throwing an exception, setting "0" instead.

Parameters

v:Number: The new value

Annotations

@Override

toString back to summary

toString	back to summary
public String toString() Overrides javafx.beans.property.ReadOnlyIntegerProperty.toString. Returns a string representation of this `IntegerProperty` object. Returns:String a string representation of this `IntegerProperty` object. Annotations @Override

public String toString()

Overrides javafx.beans.property.ReadOnlyIntegerProperty.toString.

Returns a string representation of this IntegerProperty object.

Returns:String

a string representation of this IntegerProperty object.

Annotations

@Override

unbindBidirectional back to summary

unbindBidirectional	back to summary
public void unbindBidirectional(Property<Number> other) Implements javafx.beans.property.Property.unbindBidirectional. Doc from javafx.beans.property.Property.unbindBidirectional. 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); Parameters other:Property<Number> the other `Property` Annotations @Override

public void unbindBidirectional(Property<Number> other)

Implements javafx.beans.property.Property.unbindBidirectional.

Doc from javafx.beans.property.Property.unbindBidirectional.

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

Parameters

other:Property<Number>: the other Property

Annotations

@Override

public abstract Class IntegerProperty

Constructor Summary

Method Summary

Constructor Detail

Method Detail