Spec-Zone.ru › OpenJavaFX 11
Модуль javafx.controls
Пакет javafx.scene.control

Класс Spinner<T>

  • java.lang.Object
    • javafx.scene.Node
      • javafx.scene.Parent
        • javafx.scene.layout.Region
          • javafx.scene.control.Control
            • 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 UI.

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

    • SpinnerValueFactory.IntegerSpinnerValueFactory
    • SpinnerValueFactory.DoubleSpinnerValueFactory
    • SpinnerValueFactory.ListSpinnerValueFactory

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

    С:
    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.
    protected Skin<?> createDefaultSkin()
    Создаёт новый экземпляр стандартной темы для этого элемента управления.
    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.
    void executeAccessibleAction​(AccessibleAction action, Object... parameters)
    Этот метод вызывается средствами вспомогательной технологии для запроса выполнения действия, указанного в аргументе.
    static List<CssMetaData<? extends Styleable,​?>> getClassCssMetaData()
    List<CssMetaData<? extends Styleable,​?>> getControlCssMetaData()
    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, если текст подсказки не отображается.
    Object queryAccessibleAttribute​(AccessibleAttribute attribute, Object... parameters)
    Этот метод вызывается средствами вспомогательной технологии для запроса значения атрибута.
    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()
    Value factory — модель, лежащая в основе элемента управления JavaFX Spinner. Без установленного value factory Spinner неприменим.
    ReadOnlyObjectProperty<T> valueProperty()
    Свойство value Spinner — только для чтения, так как оно привязано к SpinnerValueFactory value property.

    • Наследованные методы из класса javafx.scene.control.Control

      computeMaxHeight, computeMaxWidth, computeMinHeight, computeMinWidth, computePrefHeight, computePrefWidth, contextMenuProperty, getBaselineOffset, getContextMenu, getCssMetaData, getInitialFocusTraversable, getSkin, getTooltip, isResizable, layoutChildren, setContextMenu, setSkin, setTooltip, skinProperty, tooltipProperty

    • Наследованные методы из класса javafx.scene.layout.Region

      backgroundProperty, borderProperty, cacheShapeProperty, centerShapeProperty, 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

      getChildren, getChildrenUnmodifiable, getManagedChildren, getStylesheets, isNeedsLayout, layout, lookup, 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, 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, getStyleClass, 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, 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, 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.css.Styleable

      getStyleableNode

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

    • value

      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 значения, при этом в один вызов может быть несколько шагов,
      • Обработку текстового ввода пользователя (через редактор Spinner editor),
      • Преобразование objects to user-readable strings для отображения на экране.
      См. также:
      getValueFactory(), setValueFactory(SpinnerValueFactory)

    • editable

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

    • editor

      public final ReadOnlyObjectProperty<TextField> editorProperty
      Редактор, используемый элементом управления Spinner.
      См. также:
      getEditor()

    • promptText

      public final StringProperty promptTextProperty
      Текст подсказки, отображаемый в Spinner или null, если текст подсказки не отображается.
      С тех пор:
      9
      См. также:
      getPromptText(), setPromptText(String)

    • initialDelay

      public final ObjectProperty<Duration> initialDelayProperty
      Время, в течение которого кнопка должна быть нажата на кнопке стрелки, прежде чем произойдут следующие изменения значения. Время следующих шагов устанавливается с помощью repeat delay.
      Значение по умолчанию:
      300мс
      С тех пор:
      11
      См. также:
      getInitialDelay(), setInitialDelay(Duration)

    • repeatDelay

      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)
      Создаёт экземпляр Spinner с value factory, установленным как экземпляр SpinnerValueFactory.IntegerSpinnerValueFactory. Обратите внимание, что если вызван этот конструктор, единственно допустимым типом обобщения для экземпляра Spinner является Integer, т. е. Spinner<Integer>.
      Параметры:
      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 - Минимальное допустимое вещественное значение для Spinner.
      max - Максимальное допустимое вещественное значение для Spinner.
      initialValue - Значение Spinner при первом создании, должно быть в пределах min и max, в противном случае будет использовано минимальное значение.

    • Spinner

      public Spinner​(double min,
               double max,
               double initialValue,
               double amountToStepBy)
      Создаёт экземпляр Spinner с value factory, установленным как экземпляр SpinnerValueFactory.DoubleSpinnerValueFactory. Обратите внимание, что если вызван этот конструктор, единственно допустимым типом обобщения для экземпляра Spinner является Double, т. е. Spinner<Double>.
      Параметры:
      min - Минимальное допустимое вещественное значение для Spinner.
      max - Максимальное допустимое вещественное значение для Spinner.
      initialValue - Значение Spinner при первом создании, должно быть в пределах min и max, в противном случае будет использовано минимальное значение.
      amountToStepBy - Приращение при инкременте/декременте.

    • Spinner

      public Spinner​(ObservableList<T> items)
      Создаёт экземпляр Spinner с value factory, установленным как экземпляр SpinnerValueFactory.ListSpinnerValueFactory. Spinner value property будет установлен на первый элемент списка, если такой существует, иначе на null.
      Параметры:
      items - Список элементов, по которым будет происходить навигация в Spinner.

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

    • createDefaultSkin

      protected Skin<?> createDefaultSkin()
      Создает новый экземпляр стандартной темы для этого элемента управления. Вызывается для создания темы для элемента управления, если тема не задана через CSS -fx-skin или явно не установлена в подклассе с помощью setSkin(...).
      Переопределяет:
      createDefaultSkin в классе Control
      Возвращает:
      новый экземпляр стандартной темы для этого элемента управления. Если null, то элемент управления не будет иметь тему, если она не задана через css.

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

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

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

    • valueProperty

      public final ReadOnlyObjectProperty<T> valueProperty()
      Свойство value для Spinner является только для чтения, так как оно связано со SpinnerValueFactory value property. Если свойство value factory изменится, это свойство value будет отвязано от старой фабрики значений и привязано к новой.

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

       
 Object newValue = ...;
 spinner.getValueFactory().setValue(newValue);
      См. также:
      getValue()

    • setValueFactory

      public final void setValueFactory​(SpinnerValueFactory<T> value)
      Устанавливает значение свойства valueFactory.
      Описание свойства:
      Фабрика значений — это модель, лежащая в основе элемента управления JavaFX Spinner — без установленной фабрики значений Spinner неприменим. Фабрика значений отвечает за практически все аспекты Spinner, в том числе:
      • Представление текущего состояния value,
      • Incrementing и decrementing значение с одним или несколькими шагами за вызов,
      • Converting текстового ввода пользователя (через Spinner editor,
      • Преобразование objects to user-readable strings для отображения на экране

    • getValueFactory

      public final SpinnerValueFactory<T> getValueFactory()
      Получает значение свойства valueFactory.
      Описание свойства:
      Фабрика значений — это модель, лежащая в основе элемента управления JavaFX Spinner — без установленной фабрики значений Spinner неприменим. Фабрика значений отвечает за практически все аспекты Spinner, в том числе:
      • Представление текущего состояния value,
      • Incrementing и decrementing значение с одним или несколькими шагами за вызов,
      • Converting текстового ввода пользователя (через Spinner editor,
      • Преобразование objects to user-readable strings для отображения на экране

    • valueFactoryProperty

      public final ObjectProperty<SpinnerValueFactory<T>> valueFactoryProperty()
      Фабрика значений — это модель, лежащая в основе элемента управления JavaFX Spinner — без установленной фабрики значений Spinner неприменим. Фабрика значений отвечает за практически все аспекты Spinner, в том числе:
      • Представление текущего состояния value,
      • Incrementing и decrementing значение с одним или несколькими шагами за вызов,
      • Converting текстового ввода пользователя (через Spinner editor,
      • Преобразование objects to user-readable strings для отображения на экране
      См. также:
      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). Если значение является допустимым, оно останется значением. Если оно недействительно, фабрика значений должна соответствующим образом отреагировать и отменить это изменение.

    • isEditable

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

    • editableProperty

      public final BooleanProperty editableProperty()
      Свойство editable используется для указания возможности ввода пользователем данных в Spinner editor. Если editable равно true, пользовательский ввод будет принят после того, как пользователь наберёт данные и нажмёт Enter. В этот момент ввод передаётся в SpinnerValueFactory converter StringConverter.fromString(String) метод. Возвращаемое значение этого вызова (типа T) затем отправляется в SpinnerValueFactory.setValue(Object) метод. Если значение является допустимым, оно останется в качестве значения. Если оно недопустимо, фабрике значений необходимо будет отреагировать соответствующим образом и отменить это изменение.
      См. также:
      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()

    • getControlCssMetaData

      public List<CssMetaData<? extends Styleable,​?>> getControlCssMetaData()
      Переопределяет:
      getControlCssMetaData в классе Control
      Возвращает:
      неизменяемый список стилизуемых свойств элементов управления css

    • queryAccessibleAttribute

      public Object queryAccessibleAttribute​(AccessibleAttribute attribute,
                                       Object... parameters)
      Этот метод вызывается технологией вспомогательных средств для запроса значения атрибута.

      Этот метод обычно переопределяется подклассами для реализации атрибутов, необходимых для определённого роли.
      Если конкретный атрибут не обрабатывается, необходимо вызвать реализацию суперкласса.

      Переопределяет:
      queryAccessibleAttribute в классе Control
      Параметры:
      attribute - запрашиваемый атрибут
      parameters - необязательный список параметров
      Возвращает:
      значение запрошенного атрибута
      См. также:
      AccessibleAttribute

    • executeAccessibleAction

      public void executeAccessibleAction​(AccessibleAction action,
                                    Object... parameters)
      Этот метод вызывается технологией вспомогательных средств для запроса выполнения действия, указанного в аргументе.

      Этот метод обычно переопределяется подклассами для реализации действий, необходимых для определённого роли.
      Если конкретное действие не обрабатывается, необходимо вызвать реализацию суперкласса.

      Переопределяет:
      executeAccessibleAction в классе Control
      Параметры:
      action - действие для выполнения
      parameters - необязательный список параметров
      См. также:
      AccessibleAction

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API