Класс ChoiceBox<T>

javafx.scene.control.ChoiceBox<T>

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

@DefaultProperty("items")
public class ChoiceBox<T>
extends Control

Выбор из списка используется для предоставления пользователю относительно небольшого набора предопределенных вариантов, из которых он может выбрать. ChoiceBox, при отображении, покажет пользователю эти варианты и позволит ему выбрать ровно один вариант. При скрытии отображается текущий выбранный вариант.

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

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

Пример:

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

С тех пор как:: JavaFX 2.0

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

Свойства
Тип	Свойство	Описание
`ObjectProperty<StringConverter<T>>`	`converter`	Позволяет указать способ представления объектов в списке элементов.
`ObjectProperty<ObservableList<T>>`	`items`	Элементы, отображаемые в раскрывающемся списке.
`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()`	Позволяет указать способ представления объектов в списке элементов.
`StringConverter<T>`	`getConverter()`	Получает значение преобразователя свойств.
`ObservableList<T>`	`getItems()`	Получает значение свойства items.
`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`.
`ObjectProperty<SingleSelectionModel<T>>`	`selectionModelProperty()`	Модель выбора для ChoiceBox.
`void`	`setConverter(StringConverter<T> value)`	Устанавливает значение преобразователя свойств.
`void`	`setItems(ObservableList<T> value)`	Устанавливает значение свойства items.
`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, contextMenuProperty, createDefaultSkin, getClassCssMetaData, getContextMenu, getControlCssMetaData, getCssMetaData, getInitialFocusTraversable, getTooltip, isResizable, setContextMenu, setTooltip, skinProperty, tooltipProperty

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

backgroundProperty, borderProperty, cacheShapeProperty, centerShapeProperty, computePrefHeight, computePrefWidth, getBackground, getBorder, getHeight, getInsets, getMaxHeight, getMaxWidth, getMinHeight, getMinWidth, getOpaqueInsets, getPadding, getPrefHeight, getPrefWidth, getShape, getUserAgentStylesheet, getWidth, heightProperty, insetsProperty, isCacheShape, isCenterShape, isScaleShape, isSnapToPixel, layoutInArea, layoutInArea, layoutInArea, layoutInArea, maxHeight, maxHeightProperty, maxWidth, maxWidthProperty, minHeight, minHeightProperty, minWidth, minWidthProperty, opaqueInsetsProperty, paddingProperty, positionInArea, positionInArea, prefHeight, prefHeightProperty, prefWidth, prefWidthProperty, resize, scaleShapeProperty, setBackground, setBorder, setCacheShape, setCenterShape, setHeight, setMaxHeight, setMaxSize, setMaxWidth, setMinHeight, setMinSize, setMinWidth, setOpaqueInsets, setPadding, setPrefHeight, setPrefSize, setPrefWidth, setScaleShape, setShape, setSnapToPixel, setWidth, shapeProperty, snappedBottomInset, snappedLeftInset, snappedRightInset, snappedTopInset, snapPosition, snapPositionX, snapPositionY, snapSize, snapSizeX, snapSizeY, snapSpace, snapSpaceX, snapSpaceY, snapToPixelProperty, widthProperty

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

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

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

accessibleHelpProperty, accessibleRoleDescriptionProperty, accessibleRoleProperty, accessibleTextProperty, addEventFilter, addEventHandler, applyCss, autosize, blendModeProperty, boundsInLocalProperty, boundsInParentProperty, buildEventDispatchChain, cacheHintProperty, cacheProperty, clipProperty, computeAreaInScreen, contains, contains, cursorProperty, depthTestProperty, disabledProperty, disableProperty, effectiveNodeOrientationProperty, effectProperty, eventDispatcherProperty, executeAccessibleAction, fireEvent, focusedProperty, focusTraversableProperty, 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, 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, lookup, lookupAll, managedProperty, mouseTransparentProperty, nodeOrientationProperty, notifyAccessibleAttributeChanged, onContextMenuRequestedProperty, onDragDetectedProperty, onDragDoneProperty, onDragDroppedProperty, onDragEnteredProperty, onDragExitedProperty, onDragOverProperty, onInputMethodTextChangedProperty, onKeyPressedProperty, onKeyReleasedProperty, onKeyTypedProperty, onMouseClickedProperty, onMouseDragEnteredProperty, onMouseDragExitedProperty, onMouseDraggedProperty, onMouseDragOverProperty, onMouseDragReleasedProperty, onMouseEnteredProperty, onMouseExitedProperty, onMouseMovedProperty, onMousePressedProperty, onMouseReleasedProperty, onRotateProperty, onRotationFinishedProperty, onRotationStartedProperty, onScrollFinishedProperty, onScrollProperty, onScrollStartedProperty, onSwipeDownProperty, onSwipeLeftProperty, onSwipeRightProperty, onSwipeUpProperty, onTouchMovedProperty, onTouchPressedProperty, onTouchReleasedProperty, onTouchStationaryProperty, onZoomFinishedProperty, onZoomProperty, onZoomStartedProperty, opacityProperty, parentProperty, parentToLocal, parentToLocal, parentToLocal, parentToLocal, parentToLocal, pickOnBoundsProperty, pressedProperty, pseudoClassStateChanged, queryAccessibleAttribute, relocate, removeEventFilter, removeEventHandler, requestFocus, resizeRelocate, rotateProperty, rotationAxisProperty, scaleXProperty, scaleYProperty, scaleZProperty, sceneProperty, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, screenToLocal, screenToLocal, screenToLocal, setAccessibleHelp, setAccessibleRole, setAccessibleRoleDescription, setAccessibleText, setBlendMode, setCache, setCacheHint, setClip, setCursor, setDepthTest, setDisable, setDisabled, setEffect, setEventDispatcher, setEventHandler, setFocused, setFocusTraversable, setHover, setId, setInputMethodRequests, setLayoutX, setLayoutY, setManaged, setMouseTransparent, setNodeOrientation, setOnContextMenuRequested, setOnDragDetected, setOnDragDone, setOnDragDropped, setOnDragEntered, setOnDragExited, setOnDragOver, setOnInputMethodTextChanged, setOnKeyPressed, setOnKeyReleased, setOnKeyTyped, setOnMouseClicked, setOnMouseDragEntered, setOnMouseDragExited, setOnMouseDragged, setOnMouseDragOver, setOnMouseDragReleased, setOnMouseEntered, setOnMouseExited, setOnMouseMoved, setOnMousePressed, setOnMouseReleased, setOnRotate, setOnRotationFinished, setOnRotationStarted, setOnScroll, setOnScrollFinished, setOnScrollStarted, setOnSwipeDown, setOnSwipeLeft, setOnSwipeRight, setOnSwipeUp, setOnTouchMoved, setOnTouchPressed, setOnTouchReleased, setOnTouchStationary, setOnZoom, setOnZoomFinished, setOnZoomStarted, setOpacity, setPickOnBounds, setPressed, setRotate, setRotationAxis, setScaleX, setScaleY, setScaleZ, setStyle, setTranslateX, setTranslateY, setTranslateZ, setUserData, setViewOrder, setVisible, snapshot, snapshot, startDragAndDrop, startFullDrag, styleProperty, toBack, toFront, toString, translateXProperty, translateYProperty, translateZProperty, usesMirroring, viewOrderProperty, visibleProperty

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

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

Методы, объявленные в интерфейсе javafx.scene.control.Skinnable

getSkin, setSkin

Методы, объявленные в интерфейсе javafx.css.Styleable

getStyleableNode, getStyleClass

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

selectionModel

public final ObjectProperty<SingleSelectionModel<T>> selectionModelProperty

Модель выбора для ChoiceBox. Можно выбрать только один элемент, поэтому ChoiceBox поддерживает только SingleSelectionModel. Обычно основное взаимодействие с моделью выбора заключается в явном задании элемента в списке items, который должен быть выбран, или в прослушивании изменений выбора, чтобы узнать, какой элемент был выбран.

См. также:: getSelectionModel(), setSelectionModel(SingleSelectionModel)

showing

public final ReadOnlyBooleanProperty showingProperty

Указывает, отображается ли выпадающий список выбора пользователю. Это свойство только для чтения, которое должно изменяться с помощью методов #show и #hide.

См. также:: isShowing()

items

public final ObjectProperty<ObservableList<T>> itemsProperty

Элементы, которые должны отображаться в ChoiceBox. Выбранный элемент (как указано в модели выбора) всегда должен быть одним из этих элементов.

См. также:: getItems(), setItems(ObservableList)

converter

public ObjectProperty<StringConverter<T>> converterProperty

Позволяет указать, как представлять объекты в списке items. Если установлен StringConverter, не вызывается метод toString объекта, а вместо этого вызывается его метод toString(object T), передавая объекты из списка items. Это полезно при использовании доменных объектов в 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, которое вызывается всякий раз, когда изменяется свойство value 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. Обычно основное взаимодействие с моделью выбора заключается в явном задании элемента в списке items, который должен быть выбран, или в прослушивании изменений выбора, чтобы узнать, какой элемент был выбран.

getSelectionModel

public final SingleSelectionModel<T> getSelectionModel()

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

Описание свойства:: Модель выбора для ChoiceBox. Можно выбрать только один элемент, поэтому ChoiceBox поддерживает только SingleSelectionModel. Обычно основное взаимодействие с моделью выбора заключается в явном задании элемента в списке items, который должен быть выбран, или в прослушивании изменений выбора, чтобы узнать, какой элемент был выбран.

selectionModelProperty

public final ObjectProperty<SingleSelectionModel<T>> selectionModelProperty()

См. также:: getSelectionModel(), setSelectionModel(SingleSelectionModel)

isShowing

public final boolean isShowing()

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

Описание свойства:: Указывает, отображается ли выпадающий список выбора пользователю. Это свойство только для чтения, которое должно изменяться с помощью методов #show и #hide.

showingProperty

public final ReadOnlyBooleanProperty showingProperty()

См. также:: isShowing()

setItems

public final void setItems(ObservableList<T> value)

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

Описание свойства:: Элементы, которые должны отображаться в ChoiceBox. Выбранный элемент (как указано в модели выбора) всегда должен быть одним из этих элементов.

getItems

public final ObservableList<T> getItems()

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

Описание свойства:: Элементы, которые должны отображаться в ChoiceBox. Выбранный элемент (как указано в модели выбора) всегда должен быть одним из этих элементов.

itemsProperty

public final ObjectProperty<ObservableList<T>> itemsProperty()

См. также:: getItems(), setItems(ObservableList)

END_OF_DOCUMENT_MARKER

converterProperty

public ObjectProperty<StringConverter<T>> converterProperty()

Позволяет указать, как представлять объекты в списке элементов. Когда установлен StringConverter, не вызывается метод toString объекта, а вместо этого вызывается toString(object T), передавая объекты из списка элементов. Это полезно при использовании доменных объектов в ChoiceBox, так как это свойство позволяет настроить представление. Также можно установить любой из предустановленных конвертеров, доступных в пакете javafx.util.converter.

Since:: JavaFX 2.1
See Also:: getConverter(), setConverter(StringConverter)

setConverter

public final void setConverter(StringConverter<T> value)

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

Описание свойства:: Позволяет указать, как представлять объекты в списке элементов. Когда установлен StringConverter, не вызывается метод toString объекта, а вместо этого вызывается toString(object T), передавая объекты из списка элементов. Это полезно при использовании доменных объектов в ChoiceBox, так как это свойство позволяет настроить представление. Также можно установить любой из предустановленных конвертеров, доступных в пакете javafx.util.converter.
Since:: JavaFX 2.1

getConverter

public final StringConverter<T> getConverter()

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

Описание свойства:: Позволяет указать, как представлять объекты в списке элементов. Когда установлен StringConverter, не вызывается метод toString объекта, а вместо этого вызывается toString(object T), передавая объекты из списка элементов. Это полезно при использовании доменных объектов в ChoiceBox, так как это свойство позволяет настроить представление. Также можно установить любой из предустановленных конвертеров, доступных в пакете javafx.util.converter.
Since:: JavaFX 2.1

valueProperty

public ObjectProperty<T> valueProperty()

Значение этого ChoiceBox определяется как выбранный элемент в модели выбора ChoiceBox. valueProperty синхронизируется с selectedItem. Это свойство позволяет выполнять двустороннее связывание внешних свойств с ChoiceBox и соответственно обновлять модель выбора.

Since:: JavaFX 2.1
См. также:: getValue(), setValue(T)

setValue

public final void setValue(T value)

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

Описание свойства:: Значение этого ChoiceBox определяется как выбранный элемент в модели выбора ChoiceBox. valueProperty синхронизируется с selectedItem. Это свойство позволяет выполнять двустороннее связывание внешних свойств с ChoiceBox и соответственно обновлять модель выбора.
Since:: JavaFX 2.1

getValue

public final T getValue()

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

Описание свойства:: Значение этого ChoiceBox определяется как выбранный элемент в модели выбора ChoiceBox. valueProperty синхронизируется с selectedItem. Это свойство позволяет выполнять двустороннее связывание внешних свойств с ChoiceBox и соответственно обновлять модель выбора.
Since:: JavaFX 2.1

onActionProperty

public final ObjectProperty<EventHandler<ActionEvent>> onActionProperty()

Действие ChoiceBox, которое вызывается всякий раз, когда свойство ChoiceBox value изменяется. Это может быть вызвано программным изменением свойства value или при выборе пользователем элемента в всплывающем меню.

Since:: JavaFX 8u60
См. также:: getOnAction(), setOnAction(EventHandler)

setOnAction

public final void setOnAction(EventHandler<ActionEvent> value)

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

Описание свойства:: Действие ChoiceBox, которое вызывается всякий раз, когда свойство ChoiceBox value изменяется. Это может быть вызвано программным изменением свойства value или при выборе пользователем элемента в всплывающем меню.
Since:: JavaFX 8u60

getOnAction

public final EventHandler<ActionEvent> getOnAction()

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

Описание свойства:: Действие ChoiceBox, которое вызывается всякий раз, когда свойство ChoiceBox value изменяется. Это может быть вызвано программным изменением свойства value или при выборе пользователем элемента в всплывающем меню.
Since:: JavaFX 8u60

onShowingProperty

public final ObjectProperty<EventHandler<Event>> onShowingProperty()

Вызывается непосредственно перед отображением всплывающего меню ChoiceBox.

Since:: JavaFX 8u60
См. также:: getOnShowing(), setOnShowing(EventHandler)

setOnShowing

public final void setOnShowing(EventHandler<Event> value)

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

Описание свойства:: Вызывается непосредственно перед отображением всплывающего меню ChoiceBox.
Since:: JavaFX 8u60

getOnShowing

public final EventHandler<Event> getOnShowing()

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

Описание свойства:: Вызывается непосредственно перед отображением всплывающего меню ChoiceBox.
Since:: 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()

Закрывает список выбора.

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