java.lang.Object
javafx.scene.control.SpinnerValueFactory<T>
- Type Parameters:
T- The type of the data this value factory deals with, which must coincide with the type of the Spinner that the value factory is set on.
- Direct Known Subclasses:
SpinnerValueFactory.DoubleSpinnerValueFactory,SpinnerValueFactory.IntegerSpinnerValueFactory,SpinnerValueFactory.ListSpinnerValueFactory
public abstract class SpinnerValueFactory<T> extends Object
The SpinnerValueFactory is the model behind the JavaFX
Spinner control - without a value factory installed a
Spinner is unusable. It is the role of the value factory to handle almost all
aspects of the Spinner, including:
- Representing the current state of the
value, Incrementinganddecrementingthe value, with one or more steps per call,Convertingtext input from the user (via the Spinnereditor,- Converting
objects to user-readable stringsfor display on screen
SpinnerValueFactory classes for some common types are provided with JavaFX, including:
-
Property Summary
Properties Type Property Description ObjectProperty<StringConverter<T>>converterObjectProperty<T>valueRepresents the current value of the SpinnerValueFactory, or null if no value has been set.BooleanPropertywrapAroundThe wrapAround property is used to specify whether the value factory should be circular. -
Nested Class Summary
Nested Classes Modifier and Type Class Description static classSpinnerValueFactory.DoubleSpinnerValueFactoryASpinnerValueFactoryimplementation designed to iterate through double values.static classSpinnerValueFactory.IntegerSpinnerValueFactoryASpinnerValueFactoryimplementation designed to iterate through integer values.static classSpinnerValueFactory.ListSpinnerValueFactory<T>ASpinnerValueFactoryimplementation designed to iterate through a list of values. -
Constructor Summary
Constructors Constructor Description SpinnerValueFactory()Creates a default SpinnerValueFactory. -
Method Summary
Modifier and Type Method Description ObjectProperty<StringConverter<T>>converterProperty()abstract voiddecrement(int steps)Attempts to decrement thevalueby the given number of steps.StringConverter<T>getConverter()Gets the value of the property converter.TgetValue()Gets the value of the property value.abstract voidincrement(int steps)Attempts to omcrement thevalueby the given number of steps.booleanisWrapAround()Gets the value of the property wrapAround.voidsetConverter(StringConverter<T> newValue)Sets the value of the property converter.voidsetValue(T newValue)Sets the value of the property value.voidsetWrapAround(boolean value)Sets the value of the property wrapAround.ObjectProperty<T>valueProperty()Represents the current value of the SpinnerValueFactory, or null if no value has been set.BooleanPropertywrapAroundProperty()The wrapAround property is used to specify whether the value factory should be circular.
-
Property Details
-
value
Represents the current value of the SpinnerValueFactory, or null if no value has been set.- See Also:
getValue(),setValue(T)
-
converter
Converts the user-typed input (when the Spinner iseditable) to an object of type T, such that the input may be retrieved via thevalueproperty.- See Also:
getConverter(),setConverter(StringConverter)
-
wrapAround
The wrapAround property is used to specify whether the value factory should be circular. For example, should an integer-based value model increment from the maximum value back to the minimum value (and vice versa).- See Also:
isWrapAround(),setWrapAround(boolean)
-
-
Constructor Details
-
SpinnerValueFactory
public SpinnerValueFactory()Creates a default SpinnerValueFactory.
-
-
Method Details
-
decrement
public abstract void decrement(int steps)Attempts to decrement thevalueby the given number of steps.- Parameters:
steps- The number of decrements that should be performed on the value.
-
increment
public abstract void increment(int steps)Attempts to omcrement thevalueby the given number of steps.- Parameters:
steps- The number of increments that should be performed on the value.
-
getValue
Gets the value of the property value.- Property description:
- Represents the current value of the SpinnerValueFactory, or null if no value has been set.
-
setValue
Sets the value of the property value.- Property description:
- Represents the current value of the SpinnerValueFactory, or null if no value has been set.
-
valueProperty
Represents the current value of the SpinnerValueFactory, or null if no value has been set.- See Also:
getValue(),setValue(T)
-
getConverter
Gets the value of the property converter. -
setConverter
Sets the value of the property converter. -
converterProperty
Converts the user-typed input (when the Spinner iseditable) to an object of type T, such that the input may be retrieved via thevalueproperty.- See Also:
getConverter(),setConverter(StringConverter)
-
setWrapAround
public final void setWrapAround(boolean value)Sets the value of the property wrapAround.- Property description:
- The wrapAround property is used to specify whether the value factory should be circular. For example, should an integer-based value model increment from the maximum value back to the minimum value (and vice versa).
-
isWrapAround
public final boolean isWrapAround()Gets the value of the property wrapAround.- Property description:
- The wrapAround property is used to specify whether the value factory should be circular. For example, should an integer-based value model increment from the maximum value back to the minimum value (and vice versa).
-
wrapAroundProperty
The wrapAround property is used to specify whether the value factory should be circular. For example, should an integer-based value model increment from the maximum value back to the minimum value (and vice versa).- See Also:
isWrapAround(),setWrapAround(boolean)
-