Класс Spinner<T>

javafx.scene.control.Spinner<T>

Параметры типа:: T - Тип всех значений, которые могут быть итерированы в Spinner. Обычные типы включают Integer и String.

Все реализуемые интерфейсы:: Styleable, EventTarget, Skinnable

public class Spinner<T>
extends Control

Однострочное текстовое поле, которое позволяет пользователю выбрать число или значение объекта из упорядоченной последовательности. Spinner обычно предоставляет пару маленьких кнопок со стрелками для перехода между элементами последовательности. Кнопки со стрелками вверх/вниз на клавиатуре также циклически просматривают элементы. Пользователю также может быть разрешено вводить (допустимое) значение напрямую в spinner. Хотя списки выпадающего меню предоставляют аналогичную функциональность, spinners иногда предпочтительнее, потому что они не требуют выпадающего списка, который может затенять важную информацию, а также потому, что они позволяют использовать такие функции, как wrapping, и упрощенное задание моделей «бесконечных» данных (класса SpinnerValueFactory, а не используя модель данных ObservableList, как во многих других элементах управления интерфейсом JavaFX.

Значение последовательности Spinner определяется его SpinnerValueFactory. Фабрику значений можно указать в качестве аргумента конструктора и изменить с помощью value factory property. Классы SpinnerValueFactory для некоторых распространённых типов предоставляются с JavaFX, включая:

Spinner имеет дочерний компонент TextField, который отвечает за отображение и, возможно, изменение текущего value Spinner, который называется editor. По умолчанию Spinner недопустим для редактирования, но ввод может быть принят, если editable property установлен в значение true. Редактор Spinner синхронизируется с фабрикой значений, прослушивая изменения в value property фабрики значений. Если пользователь изменил отображаемое в редакторе значение, возможно, что value Spinner отличается от значения редактора. Чтобы убедиться, что модель имеет то же значение, что и редактор, пользователь должен подтвердить редактирование с помощью клавиши Enter.

Пример:

Spinner spinner = new Spinner(0, 10, 5);

С:: JavaFX 8u40
См. также:: SpinnerValueFactory

Краткое описание свойств

Свойства
Тип	Свойство	Описание
`BooleanProperty`	`editable`	Свойство editable используется для указания возможности ввода пользователем в Spinner `editor`.
`ReadOnlyObjectProperty<TextField>`	`editor`	Редактор, используемый элементом управления Spinner.
`ObjectProperty<Duration>`	`initialDelay`	Длительность нажатия мыши на кнопке стрелки перед тем, как произойдет переход к следующему значению.
`StringProperty`	`promptText`	Текст подсказки, отображаемый в `Spinner`, или `null`, если текст подсказки не отображается.
`ObjectProperty<Duration>`	`repeatDelay`	Продолжительность нажатия мыши для каждого последующего шага после первого перехода значения.
`ObjectProperty<SpinnerValueFactory<T>>`	`valueFactory`	Фабрика значений — модель за элементом управления JavaFX Spinner — без установленной фабрики значений Spinner использовать нельзя.
`ReadOnlyObjectProperty<T>`	`value`	Свойство value в Spinner является свойством только для чтения, поскольку оно привязано к SpinnerValueFactory `value property`.

Свойства, объявленные в классе javafx.scene.control.Control

contextMenu, skin, tooltip

Свойства, объявленные в классе javafx.scene.layout.Region

background, border, cacheShape, centerShape, height, insets, maxHeight, maxWidth, minHeight, minWidth, opaqueInsets, padding, prefHeight, prefWidth, scaleShape, shape, snapToPixel, width

Свойства, объявленные в классе javafx.scene.Parent

needsLayout

Свойства, объявленные в классе javafx.scene.Node

accessibleHelp, accessibleRoleDescription, accessibleRole, accessibleText, blendMode, boundsInLocal, boundsInParent, cacheHint, cache, clip, cursor, depthTest, disabled, disable, effectiveNodeOrientation, effect, eventDispatcher, focused, focusTraversable, hover, id, inputMethodRequests, layoutBounds, layoutX, layoutY, localToParentTransform, localToSceneTransform, managed, mouseTransparent, nodeOrientation, onContextMenuRequested, onDragDetected, onDragDone, onDragDropped, onDragEntered, onDragExited, onDragOver, onInputMethodTextChanged, onKeyPressed, onKeyReleased, onKeyTyped, onMouseClicked, onMouseDragEntered, onMouseDragExited, onMouseDragged, onMouseDragOver, onMouseDragReleased, onMouseEntered, onMouseExited, onMouseMoved, onMousePressed, onMouseReleased, onRotate, onRotationFinished, onRotationStarted, onScrollFinished, onScroll, onScrollStarted, onSwipeDown, onSwipeLeft, onSwipeRight, onSwipeUp, onTouchMoved, onTouchPressed, onTouchReleased, onTouchStationary, onZoomFinished, onZoom, onZoomStarted, opacity, parent, pickOnBounds, pressed, rotate, rotationAxis, scaleX, scaleY, scaleZ, scene, style, translateX, translateY, translateZ, viewOrder, visible

Краткое описание полей

Поля
Модификатор и тип	Поле	Описание
`static String`	`STYLE_CLASS_ARROWS_ON_LEFT_HORIZONTAL`	Стрелки размещены слева от Spinner, направленные горизонтально (т.е.
`static String`	`STYLE_CLASS_ARROWS_ON_LEFT_VERTICAL`	Стрелки размещены слева от Spinner, направленные вертикально (т.е.
`static String`	`STYLE_CLASS_ARROWS_ON_RIGHT_HORIZONTAL`	Стрелки размещены справа от Spinner, направленные горизонтально (т.е.
`static String`	`STYLE_CLASS_SPLIT_ARROWS_HORIZONTAL`	Стрелка уменьшения размещена слева от Spinner, а увеличения — справа.
`static String`	`STYLE_CLASS_SPLIT_ARROWS_VERTICAL`	Стрелки размещены над и под spinner, занимая всю ширину.

Поля, объявленные в классе javafx.scene.layout.Region

USE_COMPUTED_SIZE, USE_PREF_SIZE

Поля, объявленные в классе javafx.scene.Node

BASELINE_OFFSET_SAME_AS_HEIGHT

Краткое описание конструкторов

Конструкторы
Конструктор	Описание
`Spinner()`	Создаёт экземпляр Spinner по умолчанию со стилем по умолчанию 'spinner' и нередактируемым редактором.
`Spinner(double min, double max, double initialValue)`	Создаёт экземпляр Spinner со свойством `value factory`, установленным в экземпляр `SpinnerValueFactory.DoubleSpinnerValueFactory`.
`Spinner(double min, double max, double initialValue, double amountToStepBy)`	Создаёт экземпляр Spinner со свойством `value factory`, установленным в экземпляр `SpinnerValueFactory.DoubleSpinnerValueFactory`.
`Spinner(int min, int max, int initialValue)`	Создаёт экземпляр Spinner со свойством `value factory`, установленным в экземпляр `SpinnerValueFactory.IntegerSpinnerValueFactory`.
`Spinner(int min, int max, int initialValue, int amountToStepBy)`	Создаёт экземпляр Spinner со свойством `value factory`, установленным в экземпляр `SpinnerValueFactory.IntegerSpinnerValueFactory`.
`Spinner(ObservableList<T> items)`	Создаёт экземпляр Spinner со свойством `value factory`, установленным в экземпляр `SpinnerValueFactory.ListSpinnerValueFactory`.
`Spinner(SpinnerValueFactory<T> valueFactory)`	Создаёт экземпляр Spinner с заданной фабрикой значений.

Краткое описание методов

Модификатор и тип	Метод	Описание
`void`	`cancelEdit()`	Если Spinner `editable`, вызов этого метода попытается заменить текст редактора последним сохранённым `value`.
`void`	`commitValue()`	Если Spinner `editable`, вызов этого метода попытается сохранить текущий текст и преобразовать его в `value`.
`void`	`decrement()`	Попытка декрементировать `value factory` на один шаг, вызвав метод `SpinnerValueFactory.decrement(int)` с аргументом один.
`void`	`decrement(int steps)`	Попытка декрементировать `value factory` на заданное количество шагов, вызвав метод `SpinnerValueFactory.decrement(int)` и передав ему аргумент steps.
`BooleanProperty`	`editableProperty()`	Свойство editable используется для указания возможности ввода пользователем текста в Spinner `editor`.
`ReadOnlyObjectProperty<TextField>`	`editorProperty()`	Редактор, используемый элементом управления Spinner.
`static List<CssMetaData<? extends Styleable,?>>`	`getClassCssMetaData()`
`TextField`	`getEditor()`	Получает значение свойства editor.
`Duration`	`getInitialDelay()`	Получает значение свойства initialDelay.
`String`	`getPromptText()`	Получает значение свойства promptText.
`Duration`	`getRepeatDelay()`	Получает значение свойства repeatDelay.
`T`	`getValue()`	Получает значение свойства value.
`SpinnerValueFactory<T>`	`getValueFactory()`	Получает значение свойства valueFactory.
`void`	`increment()`	Попытка инкрементировать `value factory` на один шаг, вызвав метод `SpinnerValueFactory.increment(int)` с аргументом один.
`void`	`increment(int steps)`	Попытка инкрементировать `value factory` на заданное количество шагов, вызвав метод `SpinnerValueFactory.increment(int)` и передав ему аргумент steps.
`ObjectProperty<Duration>`	`initialDelayProperty()`	Длительность нажатия на кнопку стрелки, перед тем как произойдут следующие шаги значения.
`boolean`	`isEditable()`	Получает значение свойства editable.
`StringProperty`	`promptTextProperty()`	Текст подсказки, отображаемый в `Spinner`, или `null`, если текст подсказки не отображается.
`ObjectProperty<Duration>`	`repeatDelayProperty()`	Длительность нажатия мыши для каждого последующего шага после первого шага значения.
`void`	`setEditable(boolean value)`	Устанавливает значение свойства editable.
`void`	`setInitialDelay(Duration value)`	Устанавливает значение свойства initialDelay.
`void`	`setPromptText(String value)`	Устанавливает значение свойства promptText.
`void`	`setRepeatDelay(Duration value)`	Устанавливает значение свойства repeatDelay.
`void`	`setValueFactory(SpinnerValueFactory<T> value)`	Устанавливает значение свойства valueFactory.
`ObjectProperty<SpinnerValueFactory<T>>`	`valueFactoryProperty()`	Фабрика значений — модель, лежащая в основе элемента управления JavaFX Spinner. Без установленной фабрики значений Spinner не может использоваться.
`ReadOnlyObjectProperty<T>`	`valueProperty()`	Свойство value Spinner является только для чтения, так как оно привязано к свойству SpinnerValueFactory `value property`.

Методы, объявленные в классе javafx.scene.control.Control

computeMaxHeight, computeMaxWidth, computeMinHeight, computeMinWidth, contextMenuProperty, createDefaultSkin, getContextMenu, getControlCssMetaData, getCssMetaData, getInitialFocusTraversable, getTooltip, isResizable, setContextMenu, setTooltip, skinProperty, tooltipProperty

Методы, объявленные в классе javafx.scene.layout.Region

backgroundProperty, borderProperty, cacheShapeProperty, centerShapeProperty, computePrefHeight, computePrefWidth, getBackground, getBorder, getHeight, getInsets, getMaxHeight, getMaxWidth, getMinHeight, getMinWidth, getOpaqueInsets, getPadding, getPrefHeight, getPrefWidth, getShape, getUserAgentStylesheet, getWidth, heightProperty, insetsProperty, isCacheShape, isCenterShape, isScaleShape, isSnapToPixel, layoutInArea, layoutInArea, layoutInArea, layoutInArea, maxHeight, maxHeightProperty, maxWidth, maxWidthProperty, minHeight, minHeightProperty, minWidth, minWidthProperty, opaqueInsetsProperty, paddingProperty, positionInArea, positionInArea, prefHeight, prefHeightProperty, prefWidth, prefWidthProperty, resize, scaleShapeProperty, setBackground, setBorder, setCacheShape, setCenterShape, setHeight, setMaxHeight, setMaxSize, setMaxWidth, setMinHeight, setMinSize, setMinWidth, setOpaqueInsets, setPadding, setPrefHeight, setPrefSize, setPrefWidth, setScaleShape, setShape, setSnapToPixel, setWidth, shapeProperty, snappedBottomInset, snappedLeftInset, snappedRightInset, snappedTopInset, snapPosition, snapPositionX, snapPositionY, snapSize, snapSizeX, snapSizeY, snapSpace, snapSpaceX, snapSpaceY, snapToPixelProperty, widthProperty

Методы, объявленные в классе javafx.scene.Parent

getBaselineOffset, getChildren, getChildrenUnmodifiable, getManagedChildren, getStylesheets, isNeedsLayout, layout, layoutChildren, needsLayoutProperty, requestLayout, requestParentLayout, setNeedsLayout, updateBounds

Методы, объявленные в классе javafx.scene.Node

accessibleHelpProperty, accessibleRoleDescriptionProperty, accessibleRoleProperty, accessibleTextProperty, addEventFilter, addEventHandler, applyCss, autosize, blendModeProperty, boundsInLocalProperty, boundsInParentProperty, buildEventDispatchChain, cacheHintProperty, cacheProperty, clipProperty, computeAreaInScreen, contains, contains, cursorProperty, depthTestProperty, disabledProperty, disableProperty, effectiveNodeOrientationProperty, effectProperty, eventDispatcherProperty, executeAccessibleAction, fireEvent, focusedProperty, focusTraversableProperty, getAccessibleHelp, getAccessibleRole, getAccessibleRoleDescription, getAccessibleText, getBlendMode, getBoundsInLocal, getBoundsInParent, getCacheHint, getClip, getContentBias, getCursor, getDepthTest, getEffect, getEffectiveNodeOrientation, getEventDispatcher, getId, getInitialCursor, getInputMethodRequests, getLayoutBounds, getLayoutX, getLayoutY, getLocalToParentTransform, getLocalToSceneTransform, getNodeOrientation, getOnContextMenuRequested, getOnDragDetected, getOnDragDone, getOnDragDropped, getOnDragEntered, getOnDragExited, getOnDragOver, getOnInputMethodTextChanged, getOnKeyPressed, getOnKeyReleased, getOnKeyTyped, getOnMouseClicked, getOnMouseDragEntered, getOnMouseDragExited, getOnMouseDragged, getOnMouseDragOver, getOnMouseDragReleased, getOnMouseEntered, getOnMouseExited, getOnMouseMoved, getOnMousePressed, getOnMouseReleased, getOnRotate, getOnRotationFinished, getOnRotationStarted, getOnScroll, getOnScrollFinished, getOnScrollStarted, getOnSwipeDown, getOnSwipeLeft, getOnSwipeRight, getOnSwipeUp, getOnTouchMoved, getOnTouchPressed, getOnTouchReleased, getOnTouchStationary, getOnZoom, getOnZoomFinished, getOnZoomStarted, getOpacity, getParent, getProperties, getPseudoClassStates, getRotate, getRotationAxis, getScaleX, getScaleY, getScaleZ, getScene, getStyle, getStyleableParent, getTransforms, getTranslateX, getTranslateY, getTranslateZ, getTypeSelector, getUserData, getViewOrder, hasProperties, hoverProperty, idProperty, inputMethodRequestsProperty, intersects, intersects, isCache, isDisable, isDisabled, isFocused, isFocusTraversable, isHover, isManaged, isMouseTransparent, isPickOnBounds, isPressed, isVisible, layoutBoundsProperty, layoutXProperty, layoutYProperty, localToParent, localToParent, localToParent, localToParent, localToParent, localToParentTransformProperty, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToSceneTransformProperty, localToScreen, localToScreen, localToScreen, localToScreen, localToScreen, lookup, lookupAll, managedProperty, mouseTransparentProperty, nodeOrientationProperty, notifyAccessibleAttributeChanged, onContextMenuRequestedProperty, onDragDetectedProperty, onDragDoneProperty, onDragDroppedProperty, onDragEnteredProperty, onDragExitedProperty, onDragOverProperty, onInputMethodTextChangedProperty, onKeyPressedProperty, onKeyReleasedProperty, onKeyTypedProperty, onMouseClickedProperty, onMouseDragEnteredProperty, onMouseDragExitedProperty, onMouseDraggedProperty, onMouseDragOverProperty, onMouseDragReleasedProperty, onMouseEnteredProperty, onMouseExitedProperty, onMouseMovedProperty, onMousePressedProperty, onMouseReleasedProperty, onRotateProperty, onRotationFinishedProperty, onRotationStartedProperty, onScrollFinishedProperty, onScrollProperty, onScrollStartedProperty, onSwipeDownProperty, onSwipeLeftProperty, onSwipeRightProperty, onSwipeUpProperty, onTouchMovedProperty, onTouchPressedProperty, onTouchReleasedProperty, onTouchStationaryProperty, onZoomFinishedProperty, onZoomProperty, onZoomStartedProperty, opacityProperty, parentProperty, parentToLocal, parentToLocal, parentToLocal, parentToLocal, parentToLocal, pickOnBoundsProperty, pressedProperty, pseudoClassStateChanged, queryAccessibleAttribute, relocate, removeEventFilter, removeEventHandler, requestFocus, resizeRelocate, rotateProperty, rotationAxisProperty, scaleXProperty, scaleYProperty, scaleZProperty, sceneProperty, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, screenToLocal, screenToLocal, screenToLocal, setAccessibleHelp, setAccessibleRole, setAccessibleRoleDescription, setAccessibleText, setBlendMode, setCache, setCacheHint, setClip, setCursor, setDepthTest, setDisable, setDisabled, setEffect, setEventDispatcher, setEventHandler, setFocused, setFocusTraversable, setHover, setId, setInputMethodRequests, setLayoutX, setLayoutY, setManaged, setMouseTransparent, setNodeOrientation, setOnContextMenuRequested, setOnDragDetected, setOnDragDone, setOnDragDropped, setOnDragEntered, setOnDragExited, setOnDragOver, setOnInputMethodTextChanged, setOnKeyPressed, setOnKeyReleased, setOnKeyTyped, setOnMouseClicked, setOnMouseDragEntered, setOnMouseDragExited, setOnMouseDragged, setOnMouseDragOver, setOnMouseDragReleased, setOnMouseEntered, setOnMouseExited, setOnMouseMoved, setOnMousePressed, setOnMouseReleased, setOnRotate, setOnRotationFinished, setOnRotationStarted, setOnScroll, setOnScrollFinished, setOnScrollStarted, setOnSwipeDown, setOnSwipeLeft, setOnSwipeRight, setOnSwipeUp, setOnTouchMoved, setOnTouchPressed, setOnTouchReleased, setOnTouchStationary, setOnZoom, setOnZoomFinished, setOnZoomStarted, setOpacity, setPickOnBounds, setPressed, setRotate, setRotationAxis, setScaleX, setScaleY, setScaleZ, setStyle, setTranslateX, setTranslateY, setTranslateZ, setUserData, setViewOrder, setVisible, snapshot, snapshot, startDragAndDrop, startFullDrag, styleProperty, toBack, toFront, toString, translateXProperty, translateYProperty, translateZProperty, usesMirroring, viewOrderProperty, visibleProperty

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Методы, объявленные в интерфейсе javafx.scene.control.Skinnable

getSkin, setSkin

Методы, объявленные в интерфейсе javafx.css.Styleable

getStyleableNode, getStyleClass

Подробное описание свойств

значение

public final ReadOnlyObjectProperty<T> valueProperty

Свойство value в Spinner является только для чтения, так как оно привязано к SpinnerValueFactory value property. Если свойство value factory изменится, это свойство value будет отвязано от старой фабрики значений и привязано к новой.

Если разработчики хотят изменить свойство value, они могут сделать это с помощью кода в следующем формате:

 
 Object newValue = ...;
 spinner.getValueFactory().setValue(newValue);

См. также:: getValue()

valueFactory

public final ObjectProperty<SpinnerValueFactory<T>> valueFactoryProperty

Фабрика значений — это модель, стоящая за элементом управления JavaFX Spinner — без установленной фабрики значений Spinner неработоспособен. Фабрика значений отвечает за практически все аспекты Spinner, включая:

Представление текущего состояния value,
Incrementing и decrementing значение, с одним или несколькими шагами за вызов,
Converting текстовый ввод от пользователя (через Spinner editor),
Преобразование objects to user-readable strings для отображения на экране

См. также:: getValueFactory(), setValueFactory(SpinnerValueFactory)

редактируемый

public final BooleanProperty editableProperty

Свойство editable используется для указания того, может ли пользователь вводить текст в Spinner editor. Если editable равно true, пользовательский ввод будет получен, как только пользователь введет текст и нажмет клавишу Enter. В этот момент ввод передается в SpinnerValueFactory converter StringConverter.fromString(String) метод. Возвращаемое значение этого вызова (типа T) затем отправляется в метод SpinnerValueFactory.setValue(Object). Если значение является допустимым, оно останется значением. Если оно недопустимо, фабрика значений должна соответствующим образом отреагировать и отменить это изменение.

Значение по умолчанию:: false
См. также:: isEditable(), setEditable(boolean)

редактор

public final ReadOnlyObjectProperty<TextField> editorProperty

Редактор, используемый элементом управления Spinner.

См. также:: getEditor()

текст подсказки

public final StringProperty promptTextProperty

Текст подсказки для отображения в Spinner или null, если текст подсказки не отображается.

Значение по умолчанию:: Пустая строка
С версии:: 9
См. также:: getPromptText(), setPromptText(String)

задержка при запуске

public final ObjectProperty<Duration> initialDelayProperty

Продолжительность нажатия на кнопку со стрелкой перед выполнением следующего шага значения. Продолжительность последующих шагов устанавливается с помощью repeat delay.

Значение по умолчанию:: 300мс
С версии:: 11
См. также:: getInitialDelay(), setInitialDelay(Duration)

задержка повторения

public final ObjectProperty<Duration> repeatDelayProperty

Продолжительность нажатия мыши на каждую последующую ступень после первого шага значения. Начальная продолжительность шага устанавливается с помощью initial delay.

Значение по умолчанию:: 60мс
С версии:: 11
См. также:: getRepeatDelay(), setRepeatDelay(Duration)

Подробное описание полей

STYLE_CLASS_ARROWS_ON_RIGHT_HORIZONTAL

public static final String STYLE_CLASS_ARROWS_ON_RIGHT_HORIZONTAL

Стрелки размещаются справа от Spinner, направленные горизонтально (т.е. влево и вправо).

См. также:: Значения константных полей

STYLE_CLASS_ARROWS_ON_LEFT_VERTICAL

public static final String STYLE_CLASS_ARROWS_ON_LEFT_VERTICAL

Стрелки размещаются слева от Spinner, направленные вертикально (т.е. вверх и вниз).

См. также:: Значения константных полей

STYLE_CLASS_ARROWS_ON_LEFT_HORIZONTAL

public static final String STYLE_CLASS_ARROWS_ON_LEFT_HORIZONTAL

Стрелки размещаются слева от Spinner, направленные горизонтально (т.е. влево и вправо).

См. также:: Значения константных полей

STYLE_CLASS_SPLIT_ARROWS_VERTICAL

public static final String STYLE_CLASS_SPLIT_ARROWS_VERTICAL

Стрелки размещаются над и под Spinner, занимая всю ширину.

См. также:: Значения константных полей

STYLE_CLASS_SPLIT_ARROWS_HORIZONTAL

public static final String STYLE_CLASS_SPLIT_ARROWS_HORIZONTAL

Стрелка уменьшения размещается слева от Spinner, а увеличения — справа.

См. также:: Значения константных полей

Подробное описание конструкторов

Spinner

public Spinner()

Создаёт экземпляр Spinner по умолчанию со стилем по умолчанию 'spinner' и нередактируемым редактором.

Spinner

public Spinner(int min, int max, int initialValue)

Создаёт экземпляр Spinner с value factory, установленным в экземпляр SpinnerValueFactory.IntegerSpinnerValueFactory. Обратите внимание, что если этот конструктор вызван, единственно допустимым типом обобщения для экземпляра Spinner является Integer, т.е. Spinner<Integer>.

Параметры:: min - Минимальное допустимое целое значение для Spinner.; max - Максимальное допустимое целое значение для Spinner.; initialValue - Значение Spinner при первом создании. Оно должно быть в пределах границ аргументов min и max, иначе будет использовано минимальное значение.

Spinner

public Spinner(int min, int max, int initialValue, int amountToStepBy)

Параметры:: min - Минимальное допустимое целое значение для Spinner.; max - Максимальное допустимое целое значение для Spinner.; initialValue - Значение Spinner при первом создании. Оно должно быть в пределах границ аргументов min и max, иначе будет использовано минимальное значение.; amountToStepBy - Величина приращения или убывания на один шаг.

Spinner

public Spinner(double min, double max, double initialValue)

Создаёт экземпляр Spinner с value factory, установленным в экземпляр SpinnerValueFactory.DoubleSpinnerValueFactory. Обратите внимание, что если этот конструктор вызван, единственно допустимым типом обобщения для экземпляра Spinner является Double, т.е. Spinner<Double>.

Параметры:: min - Минимальное допустимое значение типа double для Spinner.; max - Максимальное допустимое значение типа double для Spinner.; initialValue - Значение Spinner при первом создании. Оно должно быть в пределах границ аргументов min и max, иначе будет использовано минимальное значение.

Spinner

public Spinner(double min, double max, double initialValue, double amountToStepBy)

Параметры:: min - Минимальное допустимое значение типа double для Spinner.; max - Максимальное допустимое значение типа double для Spinner.; initialValue - Значение Spinner при первом создании. Оно должно быть в пределах границ аргументов min и max, иначе будет использовано минимальное значение.; amountToStepBy - Величина приращения или убывания на один шаг.

Спиннер

public Spinner(ObservableList<T> items)

Создаёт экземпляр Spinner с value factory, установленным как экземпляр SpinnerValueFactory.ListSpinnerValueFactory. Свойство Spinner value property будет установлено в первый элемент списка, если такой элемент существует, иначе в null.

Параметры:: items - Список элементов, которые будут перебираться в Спиннере.

Спиннер

public Spinner(SpinnerValueFactory<T> valueFactory)

Создаёт экземпляр Spinner с заданным фабрикой значений.

Параметры:: valueFactory - Использовать value factory.

Подробности методов

increment

public void increment()

Попытка инкрементировать value factory на один шаг, вызвав метод SpinnerValueFactory.increment(int) с аргументом один. Если фабрика значений равна null, выбрасывается IllegalStateException.

Исключения:: IllegalStateException - если фабрика значений, возвращённая вызовом getValueFactory(), равна null.

increment

public void increment(int steps)

Попытка инкрементировать value factory на заданное количество шагов, вызвав метод SpinnerValueFactory.increment(int) и передав аргумент steps. Если фабрика значений равна null, выбрасывается IllegalStateException.

Параметры:: steps - Количество инкрементов, которое должно быть выполнено для значения.
Исключения:: IllegalStateException - если фабрика значений, возвращённая вызовом getValueFactory(), равна null.

decrement

public void decrement()

Попытка декрементировать value factory на один шаг, вызвав метод SpinnerValueFactory.decrement(int) с аргументом один. Если фабрика значений равна null, выбрасывается IllegalStateException.

Исключения:: IllegalStateException - если фабрика значений, возвращённая вызовом getValueFactory(), равна null.

decrement

public void decrement(int steps)

Попытка декрементировать value factory на заданное количество шагов, вызвав метод SpinnerValueFactory.decrement(int) и передав аргумент steps. Если фабрика значений равна null, выбрасывается IllegalStateException.

Параметры:: steps - Количество декрементов, которое должно быть выполнено для значения.
Исключения:: IllegalStateException - если фабрика значений, возвращённая вызовом getValueFactory(), равна null.

commitValue

public final void commitValue()

Если Спиннер editable, вызов этого метода попытается сохранить текущий текст и преобразовать его в value.

С:: 9

cancelEdit

public final void cancelEdit()

Если Спиннер editable, вызов этого метода попытается заменить текст редактора на последний сохранённое значение value.

С:: 9

getValue

public final T getValue()

Получает значение свойства value.

Описание свойства:

Свойство value в Spinner является только для чтения, так как оно привязано к value property SpinnerValueFactory. Если value factory изменится, это свойство value будет разорвано связь со старой фабрикой значений и привязано к новой.

Если разработчики хотят изменить свойство value, они могут сделать это с помощью кода в следующей форме:

 
 Object newValue = ...;
 spinner.getValueFactory().setValue(newValue);

valueProperty

public final ReadOnlyObjectProperty<T> valueProperty()

Если разработчики хотят изменить свойство value, они могут сделать это с помощью кода в следующей форме:

 
 Object newValue = ...;
 spinner.getValueFactory().setValue(newValue);

См. также:: getValue()

setValueFactory

public final void setValueFactory(SpinnerValueFactory<T> value)

Устанавливает значение свойства valueFactory.

Описание свойства:

Фабрика значений является моделью за контролем JavaFX Spinner - без установленной фабрики значений Спиннер неприменим. Фабрика значений отвечает за почти все аспекты Спиннера, включая:

Представление текущего состояния value,
Incrementing и decrementing значение с одним или несколькими шагами за вызов,
Converting текстового ввода от пользователя (через Спиннер editor),
Преобразование objects to user-readable strings для отображения на экране

getValueFactory

public final SpinnerValueFactory<T> getValueFactory()

Получает значение свойства valueFactory.

Описание свойства:

Представление текущего состояния value,
Incrementing и decrementing значение с одним или несколькими шагами за вызов,
Converting текстового ввода от пользователя (через Спиннер editor),
Преобразование objects to user-readable strings для отображения на экране

valueFactoryProperty

public final ObjectProperty<SpinnerValueFactory<T>> valueFactoryProperty()

Представление текущего состояния value,
Incrementing и decrementing значение с одним или несколькими шагами за вызов,
Converting текстового ввода от пользователя (через Спиннер editor),
Преобразование objects to user-readable strings для отображения на экране

См. также:: getValueFactory(), setValueFactory(SpinnerValueFactory)

setEditable

public final void setEditable(boolean value)

Устанавливает значение свойства editable.

Описание свойства:: Свойство editable используется для указания того, может ли пользователь ввести текст в Спиннер editor. Если editable равно true, пользовательский ввод будет получен, когда пользователь наберёт и нажмёт Enter. В этот момент ввод передаётся методу converter SpinnerValueFactory StringConverter.fromString(String). Возвращённое значение из этого вызова (типа T) затем отправляется в метод SpinnerValueFactory.setValue(Object). Если значение допустимо, оно останется в качестве значения. Если оно недопустимо, фабрика значений должна отреагировать соответствующим образом и отменить это изменение.
Значение по умолчанию:: false

isEditable

public final boolean isEditable()

Получает значение свойства editable.

Описание свойства:: Свойство editable используется для указания того, может ли пользователь ввести текст в Спиннер editor. Если editable равно true, пользовательский ввод будет получен, когда пользователь наберёт и нажмёт Enter. В этот момент ввод передаётся методу converter SpinnerValueFactory StringConverter.fromString(String). Возвращённое значение из этого вызова (типа T) затем отправляется в метод SpinnerValueFactory.setValue(Object). Если значение допустимо, оно останется в качестве значения. Если оно недопустимо, фабрика значений должна отреагировать соответствующим образом и отменить это изменение.
Значение по умолчанию:: false

editableProperty

public final BooleanProperty editableProperty()

Свойство editable используется для указания возможности ввода пользователем данных в Spinner editor. Если editable равно true, ввод пользователя будет получен после ввода текста и нажатия клавиши Enter. В этот момент ввод передаётся в SpinnerValueFactory converter StringConverter.fromString(String) метод. Возвращаемое значение из этого вызова (типа T) затем отправляется в метод SpinnerValueFactory.setValue(Object). Если значение является допустимым, оно останется значением. Если оно недопустимое, фабрика значений должна соответствующим образом отреагировать и отменить это изменение.

Значение по умолчанию:: false
См. также:: isEditable(), setEditable(boolean)

editorProperty

public final ReadOnlyObjectProperty<TextField> editorProperty()

Редактор, используемый элементом управления Spinner.

См. также:: getEditor()

getEditor

public final TextField getEditor()

Возвращает значение свойства editor.

Описание свойства:: Редактор, используемый элементом управления Spinner.

promptTextProperty

public final StringProperty promptTextProperty()

Текст подсказки, отображаемый в Spinner, или null, если текст подсказки не отображается.

Значение по умолчанию:: Пустая строка
С версии:: 9
См. также:: getPromptText(), setPromptText(String)

getPromptText

public final String getPromptText()

Возвращает значение свойства promptText.

Описание свойства:: Текст подсказки, отображаемый в Spinner, или null, если текст подсказки не отображается.
Значение по умолчанию:: Пустая строка
С версии:: 9

setPromptText

public final void setPromptText(String value)

Устанавливает значение свойства promptText.

Описание свойства:: Текст подсказки, отображаемый в Spinner, или null, если текст подсказки не отображается.
Значение по умолчанию:: Пустая строка
С версии:: 9

initialDelayProperty

public final ObjectProperty<Duration> initialDelayProperty()

Продолжительность нажатия кнопки стрелки мышью, прежде чем произойдёт следующий шаг значения. Продолжительность последующего шага устанавливается с помощью repeat delay.

Значение по умолчанию:: 300мс
С версии:: 11
См. также:: getInitialDelay(), setInitialDelay(Duration)

setInitialDelay

public final void setInitialDelay(Duration value)

Устанавливает значение свойства initialDelay.

Описание свойства:: Продолжительность нажатия кнопки стрелки мышью, прежде чем произойдёт следующий шаг значения. Продолжительность последующего шага устанавливается с помощью repeat delay.
Значение по умолчанию:: 300мс
С версии:: 11

getInitialDelay

public final Duration getInitialDelay()

Возвращает значение свойства initialDelay.

Описание свойства:: Продолжительность нажатия кнопки стрелки мышью, прежде чем произойдёт следующий шаг значения. Продолжительность последующего шага устанавливается с помощью repeat delay.
Значение по умолчанию:: 300мс
С версии:: 11

repeatDelayProperty

public final ObjectProperty<Duration> repeatDelayProperty()

Продолжительность нажатия мыши на каждую последующую кнопку стрелки после первого шага значения. Продолжительность начального шага устанавливается с помощью initial delay.

Значение по умолчанию:: 60мс
С версии:: 11
См. также:: getRepeatDelay(), setRepeatDelay(Duration)

setRepeatDelay

public final void setRepeatDelay(Duration value)

Устанавливает значение свойства repeatDelay.

Описание свойства:: Продолжительность нажатия мыши на каждую последующую кнопку стрелки после первого шага значения. Продолжительность начального шага устанавливается с помощью initial delay.
Значение по умолчанию:: 60мс
С версии:: 11

getRepeatDelay

public final Duration getRepeatDelay()

Возвращает значение свойства repeatDelay.

Описание свойства:: Продолжительность нажатия мыши на каждую последующую кнопку стрелки после первого шага значения. Продолжительность начального шага устанавливается с помощью initial delay.
Значение по умолчанию:: 60мс
С версии:: 11

getClassCssMetaData

public static List<CssMetaData<? extends Styleable,?>> getClassCssMetaData()

© 2008, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from JavaFX API Documentation.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Java, JavaFX and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.