Класс Spinner<T>

javafx.scene.control.Spinner<T>

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

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

public class Spinner<T> extends Control

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

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

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

Пример:

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

С:

JavaFX 8u40

См. также:

SpinnerValueFactory

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

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

Поля, объявленные в классе 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 с заданной фабрикой значений.

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

Modifier and Type	Method	Description
`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)` и передавая аргумент steps в него.
`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)` и передавая аргумент steps в него.
`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()`	Фабрика значений — модель, лежащая в основе элемента управления JavaFX Spinner. Без установленной фабрики значений Spinner непригоден для использования.
`final ReadOnlyObjectProperty<T>`	`valueProperty()`	Свойство value в Spinner — это только для чтения, так как оно связано со свойством SpinnerValueFactory `value property`.

Methods declared in class javafx.scene.control.Control

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

Methods declared in class 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

Methods declared in class javafx.scene.Parent

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

Methods declared in class 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, 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

Methods declared in class java.lang.Object

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

Methods declared in interface javafx.css.Styleable

getStyleableNode

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

значение

public final ReadOnlyObjectProperty<T> valueProperty

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

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

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

См. также:

getValue()
valueProperty()

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

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

public final BooleanProperty editableProperty

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

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

false

См. также:

isEditable()
setEditable(boolean)
editableProperty()

редактор

public final ReadOnlyObjectProperty<TextField> editorProperty

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

См. также:

getEditor()
editorProperty()

promptText

public final StringProperty promptTextProperty

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

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

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

С:

См. также:

getPromptText()
setPromptText(String)
promptTextProperty()

initialDelay

public final ObjectProperty<Duration> initialDelayProperty

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

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

300 мс

С:

См. также:

getInitialDelay()
setInitialDelay(Duration)
initialDelayProperty()

repeatDelay

public final ObjectProperty<Duration> repeatDelayProperty

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

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

60 мс

С:

См. также:

getRepeatDelay()
setRepeatDelay(Duration)
repeatDelayProperty()

Подробности поля

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

Spinner

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

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

Спиннер

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

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

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

Спиннер

public Spinner(ObservableList<T> items)

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

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

Спиннер

public Spinner(SpinnerValueFactory<T> valueFactory)

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

Параметры:: 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 в Спиннере является только для чтения, так как оно привязано к value property фабрики значений Спиннера. Если изменится value factory, это свойство value будет отвязано от старой фабрики значений и привязано к новой.

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

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

Возвращает:

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

См. также:

valueProperty()

valueProperty

public final ReadOnlyObjectProperty<T> valueProperty()

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

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

Возвращает:

свойство value

См. также:

getValue()

setValueFactory

public final void setValueFactory(SpinnerValueFactory<T> value)

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

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

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

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

Параметры:

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

См. также:

getValueFactory()
valueFactoryProperty()

getValueFactory

public final SpinnerValueFactory<T> getValueFactory()

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

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

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

Возвращает:

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

См. также:

setValueFactory(SpinnerValueFactory)
valueFactoryProperty()

valueFactoryProperty

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

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

Возвращает:

свойство valueFactory

См. также:

getValueFactory()
setValueFactory(SpinnerValueFactory)

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

isEditable

public final boolean isEditable()

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

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

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

false

Возвращает:

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

См. также:

setEditable(boolean)
editableProperty()

editableProperty

public final BooleanProperty editableProperty()

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

false

Возвращает:

свойство editable

См. также:

isEditable()
setEditable(boolean)

editorProperty

public final ReadOnlyObjectProperty<TextField> editorProperty()

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

Возвращает:

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

См. также:

getEditor()

getEditor

public final TextField getEditor()

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

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

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

Возвращает:

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

См. также:

editorProperty()

promptTextProperty

public final StringProperty promptTextProperty()

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

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

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

Возвращает:

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

С:

См. также:

getPromptText()
setPromptText(String)

getPromptText

public final String getPromptText()

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

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

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

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

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

Возвращает:

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

С:

См. также:

setPromptText(String)
promptTextProperty()

setPromptText

public final void setPromptText(String value)

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

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

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

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

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

Параметры:

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

С:

См. также:

getPromptText()
promptTextProperty()

initialDelayProperty

public final ObjectProperty<Duration> initialDelayProperty()

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

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

300мс

Возвращает:

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

С:

См. также:

getInitialDelay()
setInitialDelay(Duration)

setInitialDelay

public final void setInitialDelay(Duration value)

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

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

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

300мс

Параметры:

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

С:

См. также:

getInitialDelay()
initialDelayProperty()

getInitialDelay

public final Duration getInitialDelay()

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

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

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

300мс

Возвращает:

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

С:

См. также:

setInitialDelay(Duration)
initialDelayProperty()

repeatDelayProperty

public final ObjectProperty<Duration> repeatDelayProperty()

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

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

60мс

Возвращает:

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

С:

См. также:

getRepeatDelay()
setRepeatDelay(Duration)

setRepeatDelay

public final void setRepeatDelay(Duration value)

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

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

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

60мс

Параметры:

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

С:

См. также:

getRepeatDelay()
repeatDelayProperty()

getRepeatDelay

public final Duration getRepeatDelay()

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

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

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

60мс

Возвращает:

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

С:

См. также:

setRepeatDelay(Duration)
repeatDelayProperty()

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.