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 theconverter
property.final T
getValue()
Gets the value of thevalue
property.abstract void
increment
(int steps) Attempts to omcrement thevalue
by the given number of steps.final boolean
Gets the value of thewrapAround
property.final void
setConverter
(StringConverter<T> newValue) Sets the value of theconverter
property.final void
Sets the value of thevalue
property.final void
setWrapAround
(boolean value) Sets the value of thewrapAround
property.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
-
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).
-
-
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 thevalue
property.- Property description:
- Represents the current value of the SpinnerValueFactory, or null if no value has been set.
- Returns:
- the value of the
value
property - See Also:
-
setValue
Sets the value of thevalue
property.- Property description:
- Represents the current value of the SpinnerValueFactory, or null if no value has been set.
- Parameters:
newValue
- the value for thevalue
property- See Also:
-
valueProperty
Represents the current value of the SpinnerValueFactory, or null if no value has been set.- Returns:
- the
value
property - See Also:
-
getConverter
Gets the value of theconverter
property. -
setConverter
Sets the value of theconverter
property. -
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.- Returns:
- the
converter
property - See Also:
-
setWrapAround
public final void setWrapAround(boolean value) Sets the value of thewrapAround
property.- 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).
- Parameters:
value
- the value for thewrapAround
property- See Also:
-
isWrapAround
public final boolean isWrapAround()Gets the value of thewrapAround
property.- 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).
- Returns:
- the value of the
wrapAround
property - See Also:
-
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).- Returns:
- the
wrapAround
property - See Also:
-