ChoiceBox

java.lang.Object
- javafx.scene.Node
- - javafx.scene.Parent
  - - javafx.scene.layout.Region
    - - javafx.scene.control.Control
      - javafx.scene.control.ChoiceBox<T>

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

Styleable, EventTarget, Skinnable
```
@DefaultProperty("items")
public class ChoiceBox<T>
extends Control
```
Компонент ChoiceBox используется для предоставления пользователю относительно небольшого набора предопределенных вариантов для выбора. ChoiceBox, при отображении, отображает пользователю эти варианты и позволяет выбрать ровно один. При скрытии отображается текущий выбранный вариант.
По умолчанию, ChoiceBox не имеет выбранного элемента, если не указано иное. Хотя ChoiceBox позволит пользователю выбирать только из предопределенного списка, разработчик может указать выбранный элемент, отличным от того, что доступно в предопределенном списке. Это необходимо для нескольких важных случаев использования.

Это означает, что конфигурация ChoiceBox не зависит от порядка. Вы можете либо указать элементы, а затем выбранный элемент, либо указать выбранный элемент, а затем элементы. В любом случае все будет работать корректно.

Выбор элементов ChoiceBox обрабатывается SelectionModel Как и в ListView и ComboBox, можно изменить SelectionModel, используемый, хотя это, вероятно, редко используется. ChoiceBox поддерживает только модель единственного выбора, поэтому по умолчанию используется SingleSelectionModel.
```
 import javafx.scene.control.ChoiceBox;

 ChoiceBox cb = new ChoiceBox();
 cb.getItems().addAll("item1", "item2", "item3");
 
```
С момента:

JavaFX 2.0

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

Свойства
Тип	Свойство	Описание
`ObjectProperty<StringConverter<T>>`	`converter`	Позволяет указать способ представления объектов в списке элементов.
`ObjectProperty<ObservableList<T>>`	`items`	Элементы для отображения в ChoiceBox.
`ObjectProperty<EventHandler<ActionEvent>>`	`onAction`	Действие ChoiceBox, которое вызывается всякий раз, когда изменяется свойство ChoiceBox `value`.
`ObjectProperty<EventHandler<Event>>`	`onHidden`	Вызывается сразу после того, как всплывающее окно `ChoiceBox` было скрыто.
`ObjectProperty<EventHandler<Event>>`	`onHiding`	Вызывается непосредственно перед скрытием всплывающего окна `ChoiceBox`.
`ObjectProperty<EventHandler<Event>>`	`onShowing`	Вызывается непосредственно перед отображением всплывающего окна `ChoiceBox`.
`ObjectProperty<EventHandler<Event>>`	`onShown`	Вызывается сразу после отображения всплывающего окна `ChoiceBox`.
`ObjectProperty<SingleSelectionModel<T>>`	`selectionModel`	Модель выбора для ChoiceBox.
`ReadOnlyBooleanProperty`	`showing`	Указывает, отображается ли раскрывающийся список выбора пользователю.
`ObjectProperty<T>`	`value`	Значение ChoiceBox определяется как выбранный элемент в модели выбора ChoiceBox.

Наследованные свойства из класса 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 EventType<Event>`	`ON_HIDDEN`	Вызывается при скрытии всплывающего окна ChoiceBox.
`static EventType<Event>`	`ON_HIDING`	Вызывается, когда всплывающее окно ChoiceBox будет скрыто.
`static EventType<Event>`	`ON_SHOWING`	Вызывается перед отображением всплывающего окна ChoiceBox после нажатия пользователем или иного взаимодействия с ChoiceBox.
`static EventType<Event>`	`ON_SHOWN`	Вызывается после отображения всплывающего окна ChoiceBox.

Наследованные поля из класса javafx.scene.layout.Region
USE_COMPUTED_SIZE, USE_PREF_SIZE

Наследованные поля из класса javafx.scene.Node
BASELINE_OFFSET_SAME_AS_HEIGHT

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

Конструкторы
Конструктор	Описание
`ChoiceBox()`	Создает новый ChoiceBox с пустым списком элементов.
`ChoiceBox(ObservableList<T> items)`	Создает новый ChoiceBox с заданным набором элементов.

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

Все методыМетоды экземпляраКонкретные методы
Модификатор и тип	Метод	Описание
`ObjectProperty<StringConverter<T>>`	`converterProperty()`	Позволяет указать, как представлять объекты в списке элементов.
`protected Skin<?>`	`createDefaultSkin()`	Создает новый экземпляр стандартной темы для данного элемента управления.
`void`	`executeAccessibleAction(AccessibleAction action, Object... parameters)`	Этот метод вызывается средствами вспомогательной технологии для выполнения действия, указанного в аргументе.
`StringConverter<T>`	`getConverter()`	Получает значение свойства преобразователя.
`ObservableList<T>`	`getItems()`	Получает значение свойства элементов.
`EventHandler<ActionEvent>`	`getOnAction()`	Получает значение свойства onAction.
`EventHandler<Event>`	`getOnHidden()`	Получает значение свойства onHidden.
`EventHandler<Event>`	`getOnHiding()`	Получает значение свойства onHiding.
`EventHandler<Event>`	`getOnShowing()`	Получает значение свойства onShowing.
`EventHandler<Event>`	`getOnShown()`	Получает значение свойства onShown.
`SingleSelectionModel<T>`	`getSelectionModel()`	Получает значение свойства selectionModel.
`T`	`getValue()`	Получает значение свойства value.
`void`	`hide()`	Закрывает список вариантов.
`boolean`	`isShowing()`	Получает значение свойства showing.
`ObjectProperty<ObservableList<T>>`	`itemsProperty()`	Элементы для отображения в поле выбора.
`ObjectProperty<EventHandler<ActionEvent>>`	`onActionProperty()`	Действие ChoiceBox, которое вызывается всякий раз, когда изменяется свойство ChoiceBox `value`.
`ObjectProperty<EventHandler<Event>>`	`onHiddenProperty()`	Вызывается сразу после скрытия всплывающего окна `ChoiceBox`.
`ObjectProperty<EventHandler<Event>>`	`onHidingProperty()`	Вызывается непосредственно перед скрытием всплывающего окна `ChoiceBox`.
`ObjectProperty<EventHandler<Event>>`	`onShowingProperty()`	Вызывается непосредственно перед отображением всплывающего окна `ChoiceBox`.
`ObjectProperty<EventHandler<Event>>`	`onShownProperty()`	Вызывается сразу после отображения всплывающего окна `ChoiceBox`.
`Object`	`queryAccessibleAttribute(AccessibleAttribute attribute, Object... parameters)`	Этот метод вызывается средствами вспомогательной технологии для запроса значения атрибута.
`ObjectProperty<SingleSelectionModel<T>>`	`selectionModelProperty()`	Модель выбора для ChoiceBox.
`void`	`setConverter(StringConverter<T> value)`	Устанавливает значение свойства преобразователя.
`void`	`setItems(ObservableList<T> value)`	Устанавливает значение свойства элементов.
`void`	`setOnAction(EventHandler<ActionEvent> value)`	Устанавливает значение свойства onAction.
`void`	`setOnHidden(EventHandler<Event> value)`	Устанавливает значение свойства onHidden.
`void`	`setOnHiding(EventHandler<Event> value)`	Устанавливает значение свойства onHiding.
`void`	`setOnShowing(EventHandler<Event> value)`	Устанавливает значение свойства onShowing.
`void`	`setOnShown(EventHandler<Event> value)`	Устанавливает значение свойства onShown.
`void`	`setSelectionModel(SingleSelectionModel<T> value)`	Устанавливает значение свойства selectionModel.
`void`	`setValue(T value)`	Устанавливает значение свойства value.
`void`	`show()`	Открывает список вариантов.
`ReadOnlyBooleanProperty`	`showingProperty()`	Указывает, отображается ли выпадающий список вариантов пользователю.
`ObjectProperty<T>`	`valueProperty()`	Значение данного ChoiceBox определяется как выбранный элемент в модели выбора ChoiceBox.

Методы, унаследованные от класса javafx.scene.control.Control
computeMaxHeight, computeMaxWidth, computeMinHeight, computeMinWidth, computePrefHeight, computePrefWidth, contextMenuProperty, getBaselineOffset, getClassCssMetaData, getContextMenu, getControlCssMetaData, 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

Подробности свойства
- selectionModel
```
public final ObjectProperty<SingleSelectionModel<T>> selectionModelProperty
```
  Модель выбора для ChoiceBox. Можно выбрать только один элемент, поэтому ChoiceBox поддерживает только SingleSelectionModel. Обычно основное взаимодействие с моделью выбора заключается в явном указании элемента в списке элементов, который должен быть выбран, или в прослушивании изменений выбора, чтобы узнать, какой элемент был выбран.
  
  См. также:
  
  getSelectionModel(), setSelectionModel(SingleSelectionModel)
- showing
```
public final ReadOnlyBooleanProperty showingProperty
```
  Указывает, отображается ли раскрывающееся меню с выбором элементов пользователю. Это свойство только для чтения, которое должно изменяться с помощью методов #show и #hide.
  
  См. также:
  
  isShowing()
- items
```
public final ObjectProperty<ObservableList<T>> itemsProperty
```
  Элементы, которые должны отображаться в поле выбора. Выбранный элемент (как указано в модели выбора) всегда должен быть одним из этих элементов.
  
  См. также:
  
  getItems(), setItems(ObservableList)
- converter
```
public ObjectProperty<StringConverter<T>> converterProperty
```
  Позволяет указать, как представлять объекты в списке элементов. При установке StringConverter не вызывается метод toString объекта, а вместо этого вызывается toString(object T), передавая объекты из списка элементов. Это полезно при использовании доменных объектов в ChoiceBox, так как это свойство позволяет настраивать представление. Также можно устанавливать любые предварительно созданные конвертеры, доступные в пакете javafx.util.converter.
  
  С момента:
  
  JavaFX 2.1
  
  См. также:
  
  getConverter(), setConverter(StringConverter)
- value
```
public ObjectProperty<T> valueProperty
```
  Значение этого ChoiceBox определяется как выбранный элемент в модели выбора ChoiceBox. Свойство valueProperty синхронизировано с selectedItem. Это свойство позволяет двунаправленно привязывать внешние свойства к ChoiceBox и соответственно обновлять модель выбора.
  
  С момента:
  
  JavaFX 2.1
  
  См. также:
  
  getValue(), setValue(T)
- onAction
```
public final ObjectProperty<EventHandler<ActionEvent>> onActionProperty
```
  Действие ChoiceBox, которое вызывается всякий раз, когда изменяется свойство ChoiceBox value. Это может произойти из-за программного изменения свойства значения или при выборе пользователем элемента в всплывающем меню.
  
  С момента:
  
  JavaFX 8u60
  
  См. также:
  
  getOnAction(), setOnAction(EventHandler)
- onShowing
```
public final ObjectProperty<EventHandler<Event>> onShowingProperty
```
  Вызывается непосредственно перед отображением всплывающего меню ChoiceBox.
  
  С момента:
  
  JavaFX 8u60
  
  См. также:
  
  getOnShowing(), setOnShowing(EventHandler)
- onShown
```
public final ObjectProperty<EventHandler<Event>> onShownProperty
```
  Вызывается сразу после отображения всплывающего меню ChoiceBox.
  
  С момента:
  
  JavaFX 8u60
  
  См. также:
  
  getOnShown(), setOnShown(EventHandler)
- onHiding
```
public final ObjectProperty<EventHandler<Event>> onHidingProperty
```
  Вызывается непосредственно перед скрытием всплывающего меню ChoiceBox.
  
  С момента:
  
  JavaFX 8u60
  
  См. также:
  
  getOnHiding(), setOnHiding(EventHandler)
- onHidden
```
public final ObjectProperty<EventHandler<Event>> onHiddenProperty
```
  Вызывается сразу после скрытия всплывающего меню ChoiceBox.
  
  С момента:
  
  JavaFX 8u60
  
  См. также:
  
  getOnHidden(), setOnHidden(EventHandler)

Подробности поля
- ON_SHOWING
```
public static final EventType<Event> ON_SHOWING
```
  Вызывается перед отображением всплывающего меню ChoiceBox после нажатия пользователем или другого взаимодействия с ChoiceBox.
  
  С момента:
  
  JavaFX 8u60
- ON_SHOWN
```
public static final EventType<Event> ON_SHOWN
```
  Вызывается после отображения всплывающего меню ChoiceBox.
  
  С момента:
  
  JavaFX 8u60
- ON_HIDING
```
public static final EventType<Event> ON_HIDING
```
  Вызывается, когда всплывающее меню ChoiceBox будет скрыто.
  
  С момента:
  
  JavaFX 8u60
- ON_HIDDEN
```
public static final EventType<Event> ON_HIDDEN
```
  Вызывается, когда всплывающее меню ChoiceBox было скрыто.
  
  С момента:
  
  JavaFX 8u60

Подробности конструктора
- ChoiceBox
```
public ChoiceBox()
```
  Создает новый ChoiceBox с пустым списком элементов.
- ChoiceBox
```
public ChoiceBox(ObservableList<T> items)
```
  Создает новый ChoiceBox со заданным набором элементов. Поскольку он наблюдаемый, содержимое этого списка может изменяться со временем, и ChoiceBox будет обновляться соответственно.
  
  Параметры:
  
  items - набор элементов

Подробное описание методов
- setSelectionModel
```
public final void setSelectionModel(SingleSelectionModel<T> value)
```
  Устанавливает значение свойства selectionModel.
  
  Описание свойства:
  
  Модель выбора для ChoiceBox. Можно выбрать только один элемент, поэтому ChoiceBox поддерживает только SingleSelectionModel. Обычно основное взаимодействие с моделью выбора заключается в явном указании, какой элемент в списке элементов должен быть выбран, или в прослушивании изменений в выборе, чтобы узнать, какой элемент был выбран.
- getSelectionModel
```
public final SingleSelectionModel<T> getSelectionModel()
```
  Получает значение свойства selectionModel.
  
  Описание свойства:
  
  Модель выбора для ChoiceBox. Можно выбрать только один элемент, поэтому ChoiceBox поддерживает только SingleSelectionModel. Обычно основное взаимодействие с моделью выбора заключается в явном указании, какой элемент в списке элементов должен быть выбран, или в прослушивании изменений в выборе, чтобы узнать, какой элемент был выбран.
- selectionModelProperty
```
public final ObjectProperty<SingleSelectionModel<T>> selectionModelProperty()
```
  Модель выбора для ChoiceBox. Можно выбрать только один элемент, поэтому ChoiceBox поддерживает только SingleSelectionModel. Обычно основное взаимодействие с моделью выбора заключается в явном указании, какой элемент в списке элементов должен быть выбран, или в прослушивании изменений в выборе, чтобы узнать, какой элемент был выбран.
  
  См. также:
  
  getSelectionModel(), setSelectionModel(SingleSelectionModel)
- isShowing
```
public final boolean isShowing()
```
  Получает значение свойства showing.
  
  Описание свойства:
  
  Указывает, отображается ли выпадающий список вариантов пользователю. Это свойство только для чтения, которое должно управляться методами #show и #hide.
- showingProperty
```
public final ReadOnlyBooleanProperty showingProperty()
```
  Указывает, отображается ли выпадающий список вариантов пользователю. Это свойство только для чтения, которое должно управляться методами #show и #hide.
  
  См. также:
  
  isShowing()
- setItems
```
public final void setItems(ObservableList<T> value)
```
  Устанавливает значение свойства items.
  
  Описание свойства:
  
  Элементы, которые должны отображаться в поле выбора. Выбранный элемент (как указано в модели выбора) всегда должен быть одним из этих элементов.
- getItems
```
public final ObservableList<T> getItems()
```
  Получает значение свойства items.
  
  Описание свойства:
  
  Элементы, которые должны отображаться в поле выбора. Выбранный элемент (как указано в модели выбора) всегда должен быть одним из этих элементов.
- itemsProperty
```
public final ObjectProperty<ObservableList<T>> itemsProperty()
```
  Элементы, которые должны отображаться в поле выбора. Выбранный элемент (как указано в модели выбора) всегда должен быть одним из этих элементов.
  
  См. также:
  
  getItems(), setItems(ObservableList)
- converterProperty
```
public ObjectProperty<StringConverter<T>> converterProperty()
```
  Позволяет указать, как представлять объекты в списке элементов. При установке StringConverter не вызывается метод toString объекта, а вместо этого вызывается toString(object T), передавая объекты в список элементов. Это полезно при использовании доменных объектов в ChoiceBox, так как это свойство позволяет настроить представление. Также можно установить любой из предварительно созданных конвертеров, доступных в пакете javafx.util.converter.
  
  С:
  
  JavaFX 2.1
  
  См. также:
  
  getConverter(), setConverter(StringConverter)
- setConverter
```
public final void setConverter(StringConverter<T> value)
```
  Устанавливает значение свойства converter.
  
  Описание свойства:
  
  Позволяет указать, как представлять объекты в списке элементов. При установке StringConverter не вызывается метод toString объекта, а вместо этого вызывается toString(object T), передавая объекты в список элементов. Это полезно при использовании доменных объектов в ChoiceBox, так как это свойство позволяет настроить представление. Также можно установить любой из предварительно созданных конвертеров, доступных в пакете javafx.util.converter.
  
  С:
  
  JavaFX 2.1
- getConverter
```
public final StringConverter<T> getConverter()
```
  Получает значение свойства converter.
  
  Описание свойства:
  
  Позволяет указать, как представлять объекты в списке элементов. При установке StringConverter не вызывается метод toString объекта, а вместо этого вызывается toString(object T), передавая объекты в список элементов. Это полезно при использовании доменных объектов в ChoiceBox, так как это свойство позволяет настроить представление. Также можно установить любой из предварительно созданных конвертеров, доступных в пакете javafx.util.converter.
  
  С:
  
  JavaFX 2.1
- valueProperty
```
public ObjectProperty<T> valueProperty()
```
  Значение этого ChoiceBox определяется как выбранный элемент в модели выбора ChoiceBox. valueProperty синхронизируется с selectedItem. Это свойство позволяет для двунаправленной привязки внешних свойств к ChoiceBox и обновляет модель выбора соответственно.
  
  С:
  
  JavaFX 2.1
  
  См. также:
  
  getValue(), setValue(T)
- setValue
```
public final void setValue(T value)
```
  Устанавливает значение свойства value.
  
  Описание свойства:
  
  Значение этого ChoiceBox определяется как выбранный элемент в модели выбора ChoiceBox. valueProperty синхронизируется с selectedItem. Это свойство позволяет для двунаправленной привязки внешних свойств к ChoiceBox и обновляет модель выбора соответственно.
  
  С:
  
  JavaFX 2.1
- getValue
```
public final T getValue()
```
  Получает значение свойства value.
  
  Описание свойства:
  
  Значение этого ChoiceBox определяется как выбранный элемент в модели выбора ChoiceBox. valueProperty синхронизируется с selectedItem. Это свойство позволяет для двунаправленной привязки внешних свойств к ChoiceBox и обновляет модель выбора соответственно.
  
  С:
  
  JavaFX 2.1
- onActionProperty
```
public final ObjectProperty<EventHandler<ActionEvent>> onActionProperty()
```
  Действие ChoiceBox, которое вызывается всякий раз, когда изменяется свойство ChoiceBox value. Это может быть вызвано программно изменением свойства значения или при выборе пользователем элемента в всплывающем меню.
  
  С:
  
  JavaFX 8u60
  
  См. также:
  
  getOnAction(), setOnAction(EventHandler)
- setOnAction
```
public final void setOnAction(EventHandler<ActionEvent> value)
```
  Устанавливает значение свойства onAction.
  
  Описание свойства:
  
  Действие ChoiceBox, которое вызывается всякий раз, когда изменяется свойство ChoiceBox value. Это может быть вызвано программно изменением свойства значения или при выборе пользователем элемента в всплывающем меню.
  
  С:
  
  JavaFX 8u60
- getOnAction
```
public final EventHandler<ActionEvent> getOnAction()
```
  Получает значение свойства onAction.
  
  Описание свойства:
  
  Действие ChoiceBox, которое вызывается всякий раз, когда изменяется свойство ChoiceBox value. Это может быть вызвано программно изменением свойства значения или при выборе пользователем элемента в всплывающем меню.
  
  С:
  
  JavaFX 8u60
- onShowingProperty
```
public final ObjectProperty<EventHandler<Event>> onShowingProperty()
```
  Вызывается непосредственно перед отображением ChoiceBox всплывающего меню.
  
  С:
  
  JavaFX 8u60
  
  См. также:
  
  getOnShowing(), setOnShowing(EventHandler)
- setOnShowing
```
public final void setOnShowing(EventHandler<Event> value)
```
  Устанавливает значение свойства onShowing.
  
  Описание свойства:
  
  Вызывается непосредственно перед отображением ChoiceBox всплывающего меню.
  
  С:
  
  JavaFX 8u60
- getOnShowing
```
public final EventHandler<Event> getOnShowing()
```
  Получает значение свойства onShowing.
  
  Описание свойства:
  
  Вызывается непосредственно перед отображением ChoiceBox всплывающего меню.
  
  С:
  
  JavaFX 8u60

- onShownProperty
```
public final ObjectProperty<EventHandler<Event>> onShownProperty()
```
  Вызывается сразу после отображения всплывающего окна ChoiceBox.
  
  Since:
  
  JavaFX 8u60
  
  См. также:
  
  getOnShown(), setOnShown(EventHandler)
- setOnShown
```
public final void setOnShown(EventHandler<Event> value)
```
  Устанавливает значение свойства onShown.
  
  Описание свойства:
  
  Вызывается сразу после отображения всплывающего окна ChoiceBox.
  
  Since:
  
  JavaFX 8u60
- getOnShown
```
public final EventHandler<Event> getOnShown()
```
  Получает значение свойства onShown.
  
  Описание свойства:
  
  Вызывается сразу после отображения всплывающего окна ChoiceBox.
  
  Since:
  
  JavaFX 8u60
- onHidingProperty
```
public final ObjectProperty<EventHandler<Event>> onHidingProperty()
```
  Вызывается непосредственно перед скрытием всплывающего окна ChoiceBox.
  
  Since:
  
  JavaFX 8u60
  
  См. также:
  
  getOnHiding(), setOnHiding(EventHandler)
- setOnHiding
```
public final void setOnHiding(EventHandler<Event> value)
```
  Устанавливает значение свойства onHiding.
  
  Описание свойства:
  
  Вызывается непосредственно перед скрытием всплывающего окна ChoiceBox.
  
  Since:
  
  JavaFX 8u60
- getOnHiding
```
public final EventHandler<Event> getOnHiding()
```
  Получает значение свойства onHiding.
  
  Описание свойства:
  
  Вызывается непосредственно перед скрытием всплывающего окна ChoiceBox.
  
  Since:
  
  JavaFX 8u60
- onHiddenProperty
```
public final ObjectProperty<EventHandler<Event>> onHiddenProperty()
```
  Вызывается сразу после скрытия всплывающего окна ChoiceBox.
  
  Since:
  
  JavaFX 8u60
  
  См. также:
  
  getOnHidden(), setOnHidden(EventHandler)
- setOnHidden
```
public final void setOnHidden(EventHandler<Event> value)
```
  Устанавливает значение свойства onHidden.
  
  Описание свойства:
  
  Вызывается сразу после скрытия всплывающего окна ChoiceBox.
  
  Since:
  
  JavaFX 8u60
- getOnHidden
```
public final EventHandler<Event> getOnHidden()
```
  Получает значение свойства onHidden.
  
  Описание свойства:
  
  Вызывается сразу после скрытия всплывающего окна ChoiceBox.
  
  Since:
  
  JavaFX 8u60
- show
```
public void show()
```
  Открывает список вариантов.
- hide
```
public void hide()
```
  Закрывает список вариантов.
- createDefaultSkin
```
protected Skin<?> createDefaultSkin()
```
  Создает новый экземпляр стандартной темы для этого элемента управления. Это вызывается для создания темы элемента управления, если тема не задана через CSS -fx-skin или не задана явно в подклассе с setSkin(...).
  
  Overrides:
  
  createDefaultSkin в классе Control
  
  Возвращает:
  
  новый экземпляр стандартной темы для этого элемента управления. Если null, значит у элемента управления нет темы, если таковая не задана через css.
- queryAccessibleAttribute
```
public Object queryAccessibleAttribute(AccessibleAttribute attribute,
                                       Object... parameters)
```
  Этот метод вызывается вспомогательной технологией для запроса значения атрибута.
  Этот метод обычно переопределяется подклассами для реализации атрибутов, необходимых для определенного роли.
  Если определенный атрибут не обрабатывается, должна вызываться реализация базового класса.
  
  Overrides:
  
  queryAccessibleAttribute в классе Control
  
  Параметры:
  
  attribute - запрашиваемый атрибут
  
  parameters - необязательный список параметров
  
  Возвращает:
  
  значение запрашиваемого атрибута
  
  См. также:
  
  AccessibleAttribute
- executeAccessibleAction
```
public void executeAccessibleAction(AccessibleAction action,
                                    Object... parameters)
```
  Этот метод вызывается вспомогательной технологией для выполнения действия, указанного аргументом.
  Этот метод обычно переопределяется подклассами для реализации действий, необходимых для определенной роли.
  Если определенное действие не обрабатывается, должна вызываться реализация базового класса.
  
  Overrides:
  
  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.

Класс ChoiceBox<T>

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

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

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

Наследованные свойства из класса javafx.scene.Parent

Наследованные свойства из класса javafx.scene.Node

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

Наследованные поля из класса javafx.scene.layout.Region

Наследованные поля из класса javafx.scene.Node

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

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

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

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

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

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

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

Методы, унаследованные от интерфейса javafx.css.Styleable

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

selectionModel

showing

items

converter

value

onAction

onShowing

onShown

onHiding

onHidden

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

ON_SHOWING

ON_SHOWN

ON_HIDING

ON_HIDDEN

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

ChoiceBox

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

setSelectionModel

getSelectionModel

selectionModelProperty

isShowing

showingProperty

setItems

getItems

itemsProperty

converterProperty

setConverter

getConverter

valueProperty

setValue

getValue

onActionProperty

setOnAction

getOnAction

onShowingProperty

setOnShowing

getOnShowing

onShownProperty

setOnShown

getOnShown

onHidingProperty

setOnHiding

getOnHiding

onHiddenProperty

setOnHidden

getOnHidden

show

hide

createDefaultSkin

queryAccessibleAttribute

executeAccessibleAction