Класс Spinner<T>

javafx.scene.control.Spinner<T>

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

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

public class Spinner<T> extends Control

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

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

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

Пример:

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

С:

JavaFX 8u40

См. также:

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

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

Свойства, объявленные в классе 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, focusVisible, focusWithin, 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 final String`	`STYLE_CLASS_ARROWS_ON_LEFT_HORIZONTAL`	Стрелки размещены слева от Spinner, направлены горизонтально (т.е.
`static final String`	`STYLE_CLASS_ARROWS_ON_LEFT_VERTICAL`	Стрелки размещены слева от Spinner, направлены вертикально (т.е.
`static final String`	`STYLE_CLASS_ARROWS_ON_RIGHT_HORIZONTAL`	Стрелки размещены справа от Spinner, направлены горизонтально (т.е.
`static final String`	`STYLE_CLASS_SPLIT_ARROWS_HORIZONTAL`	Стрелка уменьшения размещена слева от Spinner, а увеличения — справа.
`static final 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 с заданным значением value factory.

END_OF_DOCUMENT_MARKER

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

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

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

computeMaxHeight, computeMaxWidth, computeMinHeight, computeMinWidth, contextMenuProperty, createDefaultSkin, getContextMenu, getCssMetaData, getInitialFocusTraversable, getSkin, getTooltip, isResizable, setContextMenu, setSkin, 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, focusVisibleProperty, focusWithinProperty, 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, getStyleClass, getTransforms, getTranslateX, getTranslateY, getTranslateZ, getTypeSelector, getUserData, getViewOrder, hasProperties, hoverProperty, idProperty, inputMethodRequestsProperty, intersects, intersects, isCache, isDisable, isDisabled, isFocused, isFocusTraversable, isFocusVisible, isFocusWithin, 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, requestFocusTraversal, 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.css.Styleable

getStyleableNode

Подробности свойств

значение

public final ReadOnlyObjectProperty<T> valueProperty

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

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

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

См. также:

valueFactory

public final ObjectProperty<SpinnerValueFactory<T>> valueFactoryProperty

Value factory — это модель, лежащая в основе элемента управления JavaFX Spinner; без установленного value factory Spinner не может быть использован. Value factory отвечает за практически все аспекты Spinner, включая:

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

См. также:

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

public final BooleanProperty editableProperty

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

Значение по умолчанию:

false

См. также:

редактор

public final ReadOnlyObjectProperty<TextField> editorProperty

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

См. также:

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

public final StringProperty promptTextProperty

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

Значение по умолчанию:

Пустая строка

С момента:

См. также:

начальная задержка

public final ObjectProperty<Duration> initialDelayProperty

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

Значение по умолчанию:

300мс

С момента:

См. также:

задержка повтора

public final ObjectProperty<Duration> repeatDelayProperty

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

Значение по умолчанию:

60мс

С момента:

См. также:

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

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 - Количество для увеличения или уменьшения на каждом шаге.

Спиннер

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, в противном случае будет использовано минимальное значение.

Спиннер

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. Свойство value property Spinner будет установлено в первый элемент списка, если элемент существует, или null в противном случае.

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

Спиннер

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()

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

С момента:: 9

cancelEdit

public final void cancelEdit()

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

С момента:: 9

getValue

public final T getValue()

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

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

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

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

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

Возвращает:

значение свойства value

См. также:

valueProperty

public final ReadOnlyObjectProperty<T> valueProperty()

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

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

Возвращает:

свойство value

См. также:

setValueFactory

public final void setValueFactory(SpinnerValueFactory<T> value)

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

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

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

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

Параметры:

value - значение для свойства valueFactory

См. также:

getValueFactory

public final SpinnerValueFactory<T> getValueFactory()

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

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

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

Возвращает:

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

См. также:

valueFactoryProperty

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

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

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

Возвращает:

свойство valueFactory

См. также:

setEditable

public final void setEditable(boolean value)

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

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

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

Значение по умолчанию:

false

Параметры:

value - значение для свойства editable

См. также:

isEditable

public final boolean isEditable()

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

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

Значение по умолчанию:

false

Возвращает:

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

См. также:

editableProperty

public final BooleanProperty editableProperty()

Значение по умолчанию:

false

Возвращает:

свойство editable

См. также:

editorProperty

public final ReadOnlyObjectProperty<TextField> editorProperty()

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

Возвращает:

свойство редактора

См. также:

getEditor

public final TextField getEditor()

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

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

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

Возвращает:

значение свойства editor

См. также:

promptTextProperty

public final StringProperty promptTextProperty()

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

Значение по умолчанию:

Пустая строка

Возвращает:

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

С момента:

См. также:

getPromptText

public final String getPromptText()

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

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

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

Значение по умолчанию:

Пустая строка

Возвращает:

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

С момента:

См. также:

setPromptText

public final void setPromptText(String value)

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

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

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

Значение по умолчанию:

Пустая строка

Параметры:

value - значение для свойства promptText

С момента:

См. также:

initialDelayProperty

public final ObjectProperty<Duration> initialDelayProperty()

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

Значение по умолчанию:

300 мс

Возвращает:

свойство начальной задержки

С момента:

См. также:

setInitialDelay

public final void setInitialDelay(Duration value)

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

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

Значение по умолчанию:

300 мс

Параметры:

value - значение для свойства initialDelay

С момента:

См. также:

getInitialDelay

public final Duration getInitialDelay()

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

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

Значение по умолчанию:

300 мс

Возвращает:

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

С момента:

См. также:

repeatDelayProperty

public final ObjectProperty<Duration> repeatDelayProperty()

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

Значение по умолчанию:

60мс

Возвращает:

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

С версии:

См. также:

setRepeatDelay

public final void setRepeatDelay(Duration value)

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

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

Значение по умолчанию:

60мс

Параметры:

value - значение свойства repeatDelay

С версии:

См. также:

getRepeatDelay

public final Duration getRepeatDelay()

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

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

Значение по умолчанию:

60мс

Возвращает:

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

С версии:

См. также:

getClassCssMetaData

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

Получает CssMetaData, связанное с этим классом, которое может включать в себя CssMetaData его суперклассов.

Возвращает:: CssMetaData
С версии:: 11

getControlCssMetaData

public List<CssMetaData<? extends Styleable,?>> getControlCssMetaData()

Описание скопировано из класса: Control

Возвращает неизменяемый список стилизуемых CSS свойств элемента управления.

Переопределяет:: getControlCssMetaData в классе Control
Возвращает:: неизменяемый список стилизуемых CSS свойств элемента управления

© 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.