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
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
, Incrementing
anddecrementing
the value, with one or more steps per call,Converting
text input from the user (via the Spinnereditor
,- Converting
objects to user-readable strings
for display on screen
SpinnerValueFactory classes for some common types are provided with JavaFX, including:
-
Property Summary
TypePropertyDescriptionfinal ObjectProperty<StringConverter<T>>
final ObjectProperty<T>
Represents the current value of the SpinnerValueFactory, or null if no value has been set.final BooleanProperty
The wrapAround property is used to specify whether the value factory should be circular. -
Nested Class Summary
Modifier and TypeClassDescriptionstatic class
ASpinnerValueFactory
implementation designed to iterate through double values.static class
ASpinnerValueFactory
implementation designed to iterate through integer values.static class
ASpinnerValueFactory
implementation designed to iterate through a list of values. -
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionfinal ObjectProperty<StringConverter<T>>
abstract void
decrement
(int steps) Attempts to decrement thevalue
by the given number of steps.final StringConverter<T>
Gets the value of the property converter.final T
getValue()
Gets the value of the property value.abstract void
increment
(int steps) Attempts to omcrement thevalue
by the given number of steps.final boolean
Gets the value of the property wrapAround.final void
setConverter
(StringConverter<T> newValue) Sets the value of the property converter.final void
Sets the value of the property value.final void
setWrapAround
(boolean value) Sets the value of the property wrapAround.final ObjectProperty<T>
Represents the current value of the SpinnerValueFactory, or null if no value has been set.final BooleanProperty
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:
-
converter
Converts the user-typed input (when the Spinner iseditable
) to an object of type T, such that the input may be retrieved via thevalue
property.- See Also:
-
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:
-
-
Constructor Details
-
SpinnerValueFactory
public SpinnerValueFactory()Creates a default SpinnerValueFactory.
-
-
Method Details
-
decrement
public abstract void decrement(int steps) Attempts to decrement thevalue
by 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 thevalue
by 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:
-
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 thevalue
property.- See Also:
-
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:
-