ChoiceBox (JavaFX 2.2)

java.lang. Объект
- javafx.scene. Узел
- - javafx.scene. Родитель
  - - javafx.scene.control. Управление
    - - javafx.scene.control. ChoiceBox <T>

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

EventTarget, Со сменными окнами
```
@DefaultProperty(value="items")
public class ChoiceBox<T>
extends Control
```
ChoiceBox используется для того, чтобы подарить пользователю относительно маленький набор предопределенных вариантов, из которых они могут выбрать. ChoiceBox, "показывая", выведет на экран пользователю эти варианты и позволит им выбирать точно один выбор. Если не показывая, текущий выбор выводится на экран.
ChoiceBox может быть сконфигурирован любой, чтобы поддерживать null как допустимый выбор, или запретить это. В случае, что это запрещается, всегда будет некоторый элемент, который выбирается, пока есть по крайней мере один определенный элемент. По умолчанию никакой элемент не выбирается если иначе не определено. В случае это null является приемлемым, запись значения по умолчанию может быть вставлена в список вариантов наверху, с именем, подобным "Ни одному", и локализовала для различных Локалей.
Хотя ChoiceBox только позволит пользователю выбирать из предопределенного списка, для разработчика возможно определить выбранный пункт, чтобы быть чем-то другим чем, что доступно в предопределенном списке. Это требуется для нескольких важных вариантов использования.
Это означает, что конфигурация ChoiceBox является независимым порядком. Можно или определить элементы и затем выбранный пункт, или можно определить выбранный пункт и затем элементы. Так или иначе будет функционировать правильно.
Выбор элемента ChoiceBox обрабатывается SelectionModel Как с ListView и ComboBox, возможно изменить SelectionModel это используется, хотя это, вероятно, будет редко изменяться. ChoiceBox поддерживает только единственную модель выбора, следовательно используемое значение по умолчанию является a SingleSelectionModel.
```
 import javafx.scene.control.ChoiceBox;

 ChoiceBox cb = new ChoiceBox();
 cb.getItems().addAll("item1", "item2", "item3");
 
```

Сводка свойства

Свойства
Ввести	Свойство и Описание
`ObjectProperty<StringConverter<T>>`	`преобразователь` Позволяет способу определить, как представить объекты в списке элементов.
`ObjectProperty<ObservableList<T>>`	`элементы` Элементы, чтобы вывести на экран в поле выбора.
`ObjectProperty<SingleSelectionModel<T>>`	`selectionModel` Модель выбора для ChoiceBox.
`ReadOnlyBooleanProperty`	`показ` Указывает, выводит ли выпадающее на экран список вариантов пользователю.
`ObjectProperty<T>`	`значение` Значение этого ChoiceBox определяется как выбранный пункт в модели выбора ChoiceBox.

Свойства, наследованные от class javafx.scene.control. Управление
contextMenu, height, maxHeight, maxWidth, minHeight, minWidth, prefHeight, prefWidth, skinClassName, skin, tooltip, width

Свойства, наследованные от class javafx.scene. Родитель
needsLayout

Свойства, наследованные от class javafx.scene. Узел
blendMode, boundsInLocal, boundsInParent, cacheHint, cache, clip, cursor, depthTest, disabled, disable, effect, eventDispatcher, focused, focusTraversable, hover, id, inputMethodRequests, layoutBounds, layoutX, layoutY, localToParentTransform, localToSceneTransform, managed, mouseTransparent, 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, visible

Полевая Сводка
- Поля, наследованные от class javafx.scene.control. Управление
  USE_COMPUTED_SIZE, USE_PREF_SIZE

Сводка конструктора

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

Сводка метода

Методы
Модификатор и Тип	Метод и Описание
`ObjectProperty<StringConverter<T>>`	`converterProperty()` Позволяет способу определить, как представить объекты в списке элементов.
`StringConverter<T>`	`getConverter()` Получает значение преобразователя свойства.
`ObservableList<T>`	`getItems()` Получает значение элементов свойства.
`SingleSelectionModel<T>`	`getSelectionModel()` Получает значение свойства selectionModel.
`T`	`getValue()` Получает значение значения свойства.
`void`	`hide()` Закрывает список вариантов.
`boolean`	`isShowing()` Получает значение показа свойства.
`ObjectProperty<ObservableList<T>>`	`itemsProperty()` Элементы, чтобы вывести на экран в поле выбора.
`ObjectProperty<SingleSelectionModel<T>>`	`selectionModelProperty()` Модель выбора для ChoiceBox.
`void`	`setConverter(StringConverter<T> value)` Устанавливает значение преобразователя свойства.
`void`	`setItems(ObservableList<T> value)` Устанавливает значение элементов свойства.
`void`	`setSelectionModel(SingleSelectionModel<T> value)` Устанавливает значение свойства selectionModel.
`void`	`setValue(T value)` Устанавливает значение значения свойства.
`void`	`show()` Открывает список вариантов.
`ReadOnlyBooleanProperty`	`showingProperty()` Указывает, выводит ли выпадающее на экран список вариантов пользователю.
`ObjectProperty<T>`	`valueProperty()` Значение этого ChoiceBox определяется как выбранный пункт в модели выбора ChoiceBox.

Методы, наследованные от class javafx.scene.control. Управление
computeMaxHeight, computeMaxWidth, computeMinHeight, computeMinWidth, computePrefHeight, computePrefWidth, contextMenuProperty, getBaselineOffset, getContextMenu, getHeight, getMaxHeight, getMaxWidth, getMinHeight, getMinWidth, getPrefHeight, getPrefWidth, getSkin, getTooltip, getUserAgentStylesheet, getWidth, heightProperty, intersects, isResizable, layoutChildren, maxHeight, maxHeightProperty, maxWidth, maxWidthProperty, minHeight, minHeightProperty, minWidth, minWidthProperty, prefHeight, prefHeightProperty, prefWidth, prefWidthProperty, resize, setContextMenu, setHeight, setMaxHeight, setMaxSize, setMaxWidth, setMinHeight, setMinSize, setMinWidth, setPrefHeight, setPrefSize, setPrefWidth, setSkin, setSkinClassName, setTooltip, setWidth, skinClassNameProperty, skinProperty, tooltipProperty, widthProperty

Методы, наследованные от class javafx.scene. Родитель
getChildren, getChildrenUnmodifiable, getManagedChildren, getStylesheets, isNeedsLayout, layout, lookup, needsLayoutProperty, requestLayout, setNeedsLayout

Методы, наследованные от class javafx.scene. Узел
addEventFilter, addEventHandler, autosize, blendModeProperty, boundsInLocalProperty, boundsInParentProperty, buildEventDispatchChain, cacheHintProperty, cacheProperty, clipProperty, contains, contains, cursorProperty, depthTestProperty, disabledProperty, disableProperty, effectProperty, eventDispatcherProperty, fireEvent, focusedProperty, focusTraversableProperty, getBlendMode, getBoundsInLocal, getBoundsInParent, getCacheHint, getClip, getContentBias, getCursor, getDepthTest, getEffect, getEventDispatcher, getId, getInputMethodRequests, getLayoutBounds, getLayoutX, getLayoutY, getLocalToParentTransform, getLocalToSceneTransform, 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, getRotate, getRotationAxis, getScaleX, getScaleY, getScaleZ, getScene, getStyle, getStyleClass, getTransforms, getTranslateX, getTranslateY, getTranslateZ, getUserData, hasProperties, hoverProperty, idProperty, inputMethodRequestsProperty, intersects, isCache, isDisable, isDisabled, isFocused, isFocusTraversable, isHover, isManaged, isMouseTransparent, isPickOnBounds, isPressed, isVisible, layoutBoundsProperty, layoutXProperty, layoutYProperty, localToParent, localToParent, localToParent, localToParentTransformProperty, localToScene, localToScene, localToScene, localToSceneTransformProperty, lookupAll, managedProperty, mouseTransparentProperty, 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, pickOnBoundsProperty, pressedProperty, relocate, removeEventFilter, removeEventHandler, requestFocus, resizeRelocate, rotateProperty, rotationAxisProperty, scaleXProperty, scaleYProperty, scaleZProperty, sceneProperty, sceneToLocal, sceneToLocal, sceneToLocal, setBlendMode, setCache, setCacheHint, setClip, setCursor, setDepthTest, setDisable, setDisabled, setEffect, setEventDispatcher, setEventHandler, setFocused, setFocusTraversable, setHover, setId, setInputMethodRequests, setLayoutX, setLayoutY, setManaged, setMouseTransparent, 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, setVisible, snapshot, snapshot, startDragAndDrop, startFullDrag, styleProperty, toBack, toFront, toString, translateXProperty, translateYProperty, translateZProperty, visibleProperty

Методы, наследованные от class java.lang. Объект
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Деталь свойства
  - selectionModel
```
public final ObjectProperty<SingleSelectionModel<T>> selectionModelProperty
```
    Модель выбора для ChoiceBox. Только единственный выбор может быть сделан, следовательно, ChoiceBox поддерживает только SingleSelectionModel. Обычно, основное взаимодействие с моделью выбора должно явно установить, какой элемент в списке элементов должен быть выбран, или слушать изменения в выборе, чтобы знать, какой элемент был выбран.
    
    См. Также:
    getSelectionModel(), setSelectionModel(SingleSelectionModel)
  - показ
```
public final ReadOnlyBooleanProperty showingProperty
```
    Указывает, выводит ли выпадающее на экран список вариантов пользователю. Это - свойство только для чтения, которым нужно управлять посредством методов #show И #hide.
    
    См. Также:
    isShowing()
  - элементы
```
public final ObjectProperty<ObservableList<T>> itemsProperty
```
    Элементы, чтобы вывести на экран в поле выбора. Выбранный пункт (как обозначено в модели выбора) должен всегда быть одним из этих элементов.
    
    См. Также:
    getItems(), setItems(ObservableList)
  - преобразователь
```
public ObjectProperty<StringConverter<T>> converterProperty
```
    Позволяет способу определить, как представить объекты в списке элементов. Когда StringConverter устанавливается, объект toString метод не вызывают, и вместо этого его toString (возразите, T) вызывается, передавая объекты в списке элементов. Это полезно при использовании объектов домена в ChoiceBox, поскольку это свойство учитывает настройку представления. Кроме того, любой из предварительно созданных Преобразователей, доступных в javafx.util.converter пакет может быть установлен.
    
    См. Также:
    getConverter(), setConverter(StringConverter)
  - значение
```
public ObjectProperty<T> valueProperty
```
    Значение этого ChoiceBox определяется как выбранный пункт в модели выбора ChoiceBox. valueProperty синхронизируется с selectedItem. Это свойство учитывает двунаправленную привязку внешних свойств к ChoiceBox и обновляет модель выбора соответственно.
    
    См. Также:
    getValue(), setValue(T)
- Деталь конструктора
  - 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()
```
    Получает значение показа свойства.
    
    Описание свойства:
    
    Указывает, выводит ли выпадающее на экран список вариантов пользователю. Это - свойство только для чтения, которым нужно управлять посредством методов #show И #hide.
  - showingProperty
```
public final ReadOnlyBooleanProperty showingProperty()
```
    Указывает, выводит ли выпадающее на экран список вариантов пользователю. Это - свойство только для чтения, которым нужно управлять посредством методов #show И #hide.
    
    См. Также:
    isShowing()
  - setItems
```
public final void setItems(ObservableList<T> value)
```
    Устанавливает значение элементов свойства.
    
    Описание свойства:
    
    Элементы, чтобы вывести на экран в поле выбора. Выбранный пункт (как обозначено в модели выбора) должен всегда быть одним из этих элементов.
  - getItems
```
public final ObservableList<T> getItems()
```
    Получает значение элементов свойства.
    
    Описание свойства:
    
    Элементы, чтобы вывести на экран в поле выбора. Выбранный пункт (как обозначено в модели выбора) должен всегда быть одним из этих элементов.
  - itemsProperty
```
public final ObjectProperty<ObservableList<T>> itemsProperty()
```
    Элементы, чтобы вывести на экран в поле выбора. Выбранный пункт (как обозначено в модели выбора) должен всегда быть одним из этих элементов.
    
    См. Также:
    getItems(), setItems(ObservableList)
  - converterProperty
```
public ObjectProperty<StringConverter<T>> converterProperty()
```
    Позволяет способу определить, как представить объекты в списке элементов. Когда StringConverter устанавливается, объект toString метод не вызывают, и вместо этого его toString (возразите, T) вызывается, передавая объекты в списке элементов. Это полезно при использовании объектов домена в ChoiceBox, поскольку это свойство учитывает настройку представления. Кроме того, любой из предварительно созданных Преобразователей, доступных в javafx.util.converter пакет может быть установлен.
    
    См. Также:
    getConverter(), setConverter(StringConverter)
  - setConverter
```
public final void setConverter(StringConverter<T> value)
```
    Устанавливает значение преобразователя свойства.
    
    Описание свойства:
    
    Позволяет способу определить, как представить объекты в списке элементов. Когда StringConverter устанавливается, объект toString метод не вызывают, и вместо этого его toString (возразите, T) вызывается, передавая объекты в списке элементов. Это полезно при использовании объектов домена в ChoiceBox, поскольку это свойство учитывает настройку представления. Кроме того, любой из предварительно созданных Преобразователей, доступных в javafx.util.converter пакет может быть установлен.
  - getConverter
```
public final StringConverter<T> getConverter()
```
    Получает значение преобразователя свойства.
    
    Описание свойства:
    
    Позволяет способу определить, как представить объекты в списке элементов. Когда StringConverter устанавливается, объект toString метод не вызывают, и вместо этого его toString (возразите, T) вызывается, передавая объекты в списке элементов. Это полезно при использовании объектов домена в ChoiceBox, поскольку это свойство учитывает настройку представления. Кроме того, любой из предварительно созданных Преобразователей, доступных в javafx.util.converter пакет может быть установлен.
  - valueProperty
```
public ObjectProperty<T> valueProperty()
```
    Значение этого ChoiceBox определяется как выбранный пункт в модели выбора ChoiceBox. valueProperty синхронизируется с selectedItem. Это свойство учитывает двунаправленную привязку внешних свойств к ChoiceBox и обновляет модель выбора соответственно.
    
    См. Также:
    getValue(), setValue(T)
  - setValue
```
public final void setValue(T value)
```
    Устанавливает значение значения свойства.
    
    Описание свойства:
    
    Значение этого ChoiceBox определяется как выбранный пункт в модели выбора ChoiceBox. valueProperty синхронизируется с selectedItem. Это свойство учитывает двунаправленную привязку внешних свойств к ChoiceBox и обновляет модель выбора соответственно.
  - getValue
```
public final T getValue()
```
    Получает значение значения свойства.
    
    Описание свойства:
    
    Значение этого ChoiceBox определяется как выбранный пункт в модели выбора ChoiceBox. valueProperty синхронизируется с selectedItem. Это свойство учитывает двунаправленную привязку внешних свойств к ChoiceBox и обновляет модель выбора соответственно.
  - показать
```
public void show()
```
    Открывает список вариантов.
  - скрыться
```
public void hide()
```
    Закрывает список вариантов.

Класс ChoiceBox <T>

Сводка свойства

Свойства, наследованные от class javafx.scene.control. Управление

Свойства, наследованные от class javafx.scene. Родитель

Свойства, наследованные от class javafx.scene. Узел

Полевая Сводка

Поля, наследованные от class javafx.scene.control. Управление

Сводка конструктора

Сводка метода

Методы, наследованные от class javafx.scene.control. Управление

Методы, наследованные от class javafx.scene. Родитель

Методы, наследованные от class javafx.scene. Узел

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

Деталь свойства

selectionModel

показ

элементы

преобразователь

значение

Деталь конструктора

ChoiceBox

ChoiceBox

Деталь метода

setSelectionModel

getSelectionModel

selectionModelProperty

isShowing

showingProperty

setItems

getItems

itemsProperty

converterProperty

setConverter

getConverter

valueProperty

setValue

getValue

показать

скрыться