< prev index next >
modules/javafx.base/src/main/java/javafx/beans/binding/Bindings.java
Print this page
*** 313,322 ****
--- 313,323 ----
}
/**
* Helper function to create a custom {@link ObjectBinding}.
*
+ * @param <T> the type of the wrapped {@code Object}
* @param func The function that calculates the value of this binding
* @param dependencies The dependencies of this binding
* @return The generated binding
* @since JavaFX 2.1
*/
*** 404,413 ****
--- 405,415 ----
* <p>
* All classes and properties used in a select-binding have to be public.
*
* Note: since 8.0, JavaBeans properties are supported and might be in the chain.
*
+ * @param <T> the type of the wrapped {@code Object}
* @param root
* The root {@link javafx.beans.value.ObservableValue}
* @param steps
* The property names to reach the final property
* @return the created {@link ObjectBinding}
*** 542,554 ****
* be reached (due to {@code b} not having a {@code c} property,
* {@code b} being {@code null}, or {@code c} not being the right type etc.).
* <p>
* All classes and properties used in a select-binding have to be public.
*
! * If root has JavaFX properties, this call is equivalent to {@link #select(javafx.beans.value.ObservableValue, java.lang.String[]),
* with the {@code root} and {@code step[0]} being substituted with the relevant property object.
*
* @param root
* The root bean.
* @param steps
* The property names to reach the final property. The first step
* must be specified as it marks the property of the root bean.
--- 544,557 ----
* be reached (due to {@code b} not having a {@code c} property,
* {@code b} being {@code null}, or {@code c} not being the right type etc.).
* <p>
* All classes and properties used in a select-binding have to be public.
*
! * If root has JavaFX properties, this call is equivalent to {@link #select(javafx.beans.value.ObservableValue, java.lang.String[])},
* with the {@code root} and {@code step[0]} being substituted with the relevant property object.
*
+ * @param <T> the type of the wrapped {@code Object}
* @param root
* The root bean.
* @param steps
* The property names to reach the final property. The first step
* must be specified as it marks the property of the root bean.
*** 565,575 ****
* be reached (due to {@code b} not having a {@code c} property,
* {@code b} being {@code null}, or {@code c} not being a {@code Number} etc.).
* <p>
* All classes and properties used in a select-binding have to be public.
*
! * If root has JavaFX properties, this call is equivalent to {@link #selectDouble(javafx.beans.value.ObservableValue, java.lang.String[]),
* with the {@code root} and {@code step[0]} being substituted with the relevant property object.
*
* @param root
* The root bean.
* @param steps
--- 568,578 ----
* be reached (due to {@code b} not having a {@code c} property,
* {@code b} being {@code null}, or {@code c} not being a {@code Number} etc.).
* <p>
* All classes and properties used in a select-binding have to be public.
*
! * If root has JavaFX properties, this call is equivalent to {@link #selectDouble(javafx.beans.value.ObservableValue, java.lang.String[])},
* with the {@code root} and {@code step[0]} being substituted with the relevant property object.
*
* @param root
* The root bean.
* @param steps
*** 588,598 ****
* be reached (due to {@code b} not having a {@code c} property,
* {@code b} being {@code null}, or {@code c} not being a {@code Number} etc.).
* <p>
* All classes and properties used in a select-binding have to be public.
*
! * If root has JavaFX properties, this call is equivalent to {@link #selectFloat(javafx.beans.value.ObservableValue, java.lang.String[]),
* with the {@code root} and {@code step[0]} being substituted with the relevant property object.
*
* @param root
* The root bean.
* @param steps
--- 591,601 ----
* be reached (due to {@code b} not having a {@code c} property,
* {@code b} being {@code null}, or {@code c} not being a {@code Number} etc.).
* <p>
* All classes and properties used in a select-binding have to be public.
*
! * If root has JavaFX properties, this call is equivalent to {@link #selectFloat(javafx.beans.value.ObservableValue, java.lang.String[])},
* with the {@code root} and {@code step[0]} being substituted with the relevant property object.
*
* @param root
* The root bean.
* @param steps
*** 611,621 ****
* be reached (due to {@code b} not having a {@code c} property,
* {@code b} being {@code null}, or {@code c} not being a {@code Number} etc.).
* <p>
* All classes and properties used in a select-binding have to be public.
*
! * If root has JavaFX properties, this call is equivalent to {@link #selectInteger(javafx.beans.value.ObservableValue, java.lang.String[]),
* with the {@code root} and {@code step[0]} being substituted with the relevant property object.
*
* @param root
* The root bean.
* @param steps
--- 614,624 ----
* be reached (due to {@code b} not having a {@code c} property,
* {@code b} being {@code null}, or {@code c} not being a {@code Number} etc.).
* <p>
* All classes and properties used in a select-binding have to be public.
*
! * If root has JavaFX properties, this call is equivalent to {@link #selectInteger(javafx.beans.value.ObservableValue, java.lang.String[])},
* with the {@code root} and {@code step[0]} being substituted with the relevant property object.
*
* @param root
* The root bean.
* @param steps
*** 634,644 ****
* be reached (due to {@code b} not having a {@code c} property,
* {@code b} being {@code null}, or {@code c} not being a {@code Number} etc.).
* <p>
* All classes and properties used in a select-binding have to be public.
*
! * If root has JavaFX properties, this call is equivalent to {@link #selectLong(javafx.beans.value.ObservableValue, java.lang.String[]),
* with the {@code root} and {@code step[0]} being substituted with the relevant property object.
*
* @param root
* The root bean.
* @param steps
--- 637,647 ----
* be reached (due to {@code b} not having a {@code c} property,
* {@code b} being {@code null}, or {@code c} not being a {@code Number} etc.).
* <p>
* All classes and properties used in a select-binding have to be public.
*
! * If root has JavaFX properties, this call is equivalent to {@link #selectLong(javafx.beans.value.ObservableValue, java.lang.String[])},
* with the {@code root} and {@code step[0]} being substituted with the relevant property object.
*
* @param root
* The root bean.
* @param steps
*** 657,667 ****
* be reached (due to {@code b} not having a {@code c} property,
* {@code b} being {@code null}, or {@code c} not being a {@code boolean} etc.).
* <p>
* All classes and properties used in a select-binding have to be public.
*
! * If root has JavaFX properties, this call is equivalent to {@link #selectBoolean(javafx.beans.value.ObservableValue, java.lang.String[]),
* with the {@code root} and {@code step[0]} being substituted with the relevant property object.
*
* @param root
* The root bean.
* @param steps
--- 660,670 ----
* be reached (due to {@code b} not having a {@code c} property,
* {@code b} being {@code null}, or {@code c} not being a {@code boolean} etc.).
* <p>
* All classes and properties used in a select-binding have to be public.
*
! * If root has JavaFX properties, this call is equivalent to {@link #selectBoolean(javafx.beans.value.ObservableValue, java.lang.String[])},
* with the {@code root} and {@code step[0]} being substituted with the relevant property object.
*
* @param root
* The root bean.
* @param steps
*** 680,690 ****
* be reached (due to {@code b} not having a {@code c} property,
* {@code b} being {@code null}, or {@code c} not being a {@code String} etc.).
* <p>
* All classes and properties used in a select-binding have to be public.
*
! * If root has JavaFX properties, this call is equivalent to {@link #selectString(javafx.beans.value.ObservableValue, java.lang.String[]),
* with the {@code root} and {@code step[0]} being substituted with the relevant property object.
*
* @param root
* The root bean.
* @param steps
--- 683,693 ----
* be reached (due to {@code b} not having a {@code c} property,
* {@code b} being {@code null}, or {@code c} not being a {@code String} etc.).
* <p>
* All classes and properties used in a select-binding have to be public.
*
! * If root has JavaFX properties, this call is equivalent to {@link #selectString(javafx.beans.value.ObservableValue, java.lang.String[])},
* with the {@code root} and {@code step[0]} being substituted with the relevant property object.
*
* @param root
* The root bean.
* @param steps
*** 843,852 ****
--- 846,856 ----
* linked to another property with a bidirectional binding can still be set
* (usually bindings would throw an exception). Secondly bidirectional
* bindings are calculated eagerly, i.e. a bound property is updated
* immediately.
*
+ * @param <T> the type of the wrapped {@code Object}
* @param stringProperty
* the {@code String} {@code Property}
* @param otherProperty
* the other (non-{@code String}) {@code Property}
* @param converter
*** 6001,6011 ****
* @param op the {@code ObservableList}
* @param index the position in the {@code List}
* @param <E> the type of the {@code List} elements
* @return the new {@code ObjectBinding}
* @throws NullPointerException if the {@code ObservableList} is {@code null}
! * @throws IllegalArgumentException if (@code index < 0}
* @since JavaFX 2.1
*/
public static <E> ObjectBinding<E> valueAt(final ObservableList<E> op, final int index) {
if (op == null) {
throw new NullPointerException("List cannot be null.");
--- 6005,6015 ----
* @param op the {@code ObservableList}
* @param index the position in the {@code List}
* @param <E> the type of the {@code List} elements
* @return the new {@code ObjectBinding}
* @throws NullPointerException if the {@code ObservableList} is {@code null}
! * @throws IllegalArgumentException if (@code index < 0}
* @since JavaFX 2.1
*/
public static <E> ObjectBinding<E> valueAt(final ObservableList<E> op, final int index) {
if (op == null) {
throw new NullPointerException("List cannot be null.");
*** 6108,6118 ****
*
* @param op the {@code ObservableList}
* @param index the position in the {@code List}
* @return the new {@code BooleanBinding}
* @throws NullPointerException if the {@code ObservableList} is {@code null}
! * @throws IllegalArgumentException if (@code index < 0}
* @since JavaFX 2.1
*/
public static BooleanBinding booleanValueAt(final ObservableList<Boolean> op, final int index) {
if (op == null) {
throw new NullPointerException("List cannot be null.");
--- 6112,6122 ----
*
* @param op the {@code ObservableList}
* @param index the position in the {@code List}
* @return the new {@code BooleanBinding}
* @throws NullPointerException if the {@code ObservableList} is {@code null}
! * @throws IllegalArgumentException if (@code index < 0}
* @since JavaFX 2.1
*/
public static BooleanBinding booleanValueAt(final ObservableList<Boolean> op, final int index) {
if (op == null) {
throw new NullPointerException("List cannot be null.");
*** 6223,6233 ****
*
* @param op the {@code ObservableList}
* @param index the position in the {@code List}
* @return the new {@code DoubleBinding}
* @throws NullPointerException if the {@code ObservableList} is {@code null}
! * @throws IllegalArgumentException if (@code index < 0}
* @since JavaFX 2.1
*/
public static DoubleBinding doubleValueAt(final ObservableList<? extends Number> op, final int index) {
if (op == null) {
throw new NullPointerException("List cannot be null.");
--- 6227,6237 ----
*
* @param op the {@code ObservableList}
* @param index the position in the {@code List}
* @return the new {@code DoubleBinding}
* @throws NullPointerException if the {@code ObservableList} is {@code null}
! * @throws IllegalArgumentException if (@code index < 0}
* @since JavaFX 2.1
*/
public static DoubleBinding doubleValueAt(final ObservableList<? extends Number> op, final int index) {
if (op == null) {
throw new NullPointerException("List cannot be null.");
*** 6338,6348 ****
*
* @param op the {@code ObservableList}
* @param index the position in the {@code List}
* @return the new {@code FloatBinding}
* @throws NullPointerException if the {@code ObservableList} is {@code null}
! * @throws IllegalArgumentException if (@code index < 0}
* @since JavaFX 2.1
*/
public static FloatBinding floatValueAt(final ObservableList<? extends Number> op, final int index) {
if (op == null) {
throw new NullPointerException("List cannot be null.");
--- 6342,6352 ----
*
* @param op the {@code ObservableList}
* @param index the position in the {@code List}
* @return the new {@code FloatBinding}
* @throws NullPointerException if the {@code ObservableList} is {@code null}
! * @throws IllegalArgumentException if (@code index < 0}
* @since JavaFX 2.1
*/
public static FloatBinding floatValueAt(final ObservableList<? extends Number> op, final int index) {
if (op == null) {
throw new NullPointerException("List cannot be null.");
*** 6453,6463 ****
*
* @param op the {@code ObservableList}
* @param index the position in the {@code List}
* @return the new {@code IntegerBinding}
* @throws NullPointerException if the {@code ObservableList} is {@code null}
! * @throws IllegalArgumentException if (@code index < 0}
* @since JavaFX 2.1
*/
public static IntegerBinding integerValueAt(final ObservableList<? extends Number> op, final int index) {
if (op == null) {
throw new NullPointerException("List cannot be null.");
--- 6457,6467 ----
*
* @param op the {@code ObservableList}
* @param index the position in the {@code List}
* @return the new {@code IntegerBinding}
* @throws NullPointerException if the {@code ObservableList} is {@code null}
! * @throws IllegalArgumentException if (@code index < 0}
* @since JavaFX 2.1
*/
public static IntegerBinding integerValueAt(final ObservableList<? extends Number> op, final int index) {
if (op == null) {
throw new NullPointerException("List cannot be null.");
*** 6568,6578 ****
*
* @param op the {@code ObservableList}
* @param index the position in the {@code List}
* @return the new {@code LongBinding}
* @throws NullPointerException if the {@code ObservableList} is {@code null}
! * @throws IllegalArgumentException if (@code index < 0}
* @since JavaFX 2.1
*/
public static LongBinding longValueAt(final ObservableList<? extends Number> op, final int index) {
if (op == null) {
throw new NullPointerException("List cannot be null.");
--- 6572,6582 ----
*
* @param op the {@code ObservableList}
* @param index the position in the {@code List}
* @return the new {@code LongBinding}
* @throws NullPointerException if the {@code ObservableList} is {@code null}
! * @throws IllegalArgumentException if (@code index < 0}
* @since JavaFX 2.1
*/
public static LongBinding longValueAt(final ObservableList<? extends Number> op, final int index) {
if (op == null) {
throw new NullPointerException("List cannot be null.");
*** 6683,6693 ****
*
* @param op the {@code ObservableList}
* @param index the position in the {@code List}
* @return the new {@code StringBinding}
* @throws NullPointerException if the {@code ObservableList} is {@code null}
! * @throws IllegalArgumentException if (@code index < 0}
* @since JavaFX 2.1
*/
public static StringBinding stringValueAt(final ObservableList<String> op, final int index) {
if (op == null) {
throw new NullPointerException("List cannot be null.");
--- 6687,6697 ----
*
* @param op the {@code ObservableList}
* @param index the position in the {@code List}
* @return the new {@code StringBinding}
* @throws NullPointerException if the {@code ObservableList} is {@code null}
! * @throws IllegalArgumentException if (@code index < 0}
* @since JavaFX 2.1
*/
public static StringBinding stringValueAt(final ObservableList<String> op, final int index) {
if (op == null) {
throw new NullPointerException("List cannot be null.");
*** 6948,6958 ****
*
* @param op the {@code ObservableArray}
* @param index the position in the {@code ObservableArray}
* @return the new {@code FloatBinding}
* @throws NullPointerException if the {@code ObservableArray} is {@code null}
! * @throws IllegalArgumentException if (@code index < 0}
* @since JavaFX 8.0
*/
public static FloatBinding floatValueAt(final ObservableFloatArray op, final int index) {
if (op == null) {
throw new NullPointerException("Array cannot be null.");
--- 6952,6962 ----
*
* @param op the {@code ObservableArray}
* @param index the position in the {@code ObservableArray}
* @return the new {@code FloatBinding}
* @throws NullPointerException if the {@code ObservableArray} is {@code null}
! * @throws IllegalArgumentException if (@code index < 0}
* @since JavaFX 8.0
*/
public static FloatBinding floatValueAt(final ObservableFloatArray op, final int index) {
if (op == null) {
throw new NullPointerException("Array cannot be null.");
*** 7053,7063 ****
*
* @param op the {@code ObservableArray}
* @param index the position in the {@code ObservableArray}
* @return the new {@code IntegerBinding}
* @throws NullPointerException if the {@code ObservableArray} is {@code null}
! * @throws IllegalArgumentException if (@code index < 0}
* @since JavaFX 8.0
*/
public static IntegerBinding integerValueAt(final ObservableIntegerArray op, final int index) {
if (op == null) {
throw new NullPointerException("Array cannot be null.");
--- 7057,7067 ----
*
* @param op the {@code ObservableArray}
* @param index the position in the {@code ObservableArray}
* @return the new {@code IntegerBinding}
* @throws NullPointerException if the {@code ObservableArray} is {@code null}
! * @throws IllegalArgumentException if (@code index < 0}
* @since JavaFX 8.0
*/
public static IntegerBinding integerValueAt(final ObservableIntegerArray op, final int index) {
if (op == null) {
throw new NullPointerException("Array cannot be null.");
< prev index next >