Класс ChoiceBox<T>

javafx.scene.control.ChoiceBox<T>

Type Parameters:: T - тип элемента, содержащегося в ChoiceBox

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

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

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

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

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

Пример:

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

Since:: JavaFX 2.0

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

Тип	Свойство	Описание
`final ObjectProperty<StringConverter<T>>`	`converter`	Позволяет указать способ представления объектов в списке элементов.
`final ObjectProperty<ObservableList<T>>`	`items`	Элементы для отображения в раскрывающемся списке.
`final ObjectProperty<EventHandler<ActionEvent>>`	`onAction`	Действие ChoiceBox, которое вызывается всякий раз, когда изменяется свойство ChoiceBox `value`.
`final ObjectProperty<EventHandler<Event>>`	`onHidden`	Вызывается сразу после того, как всплывающее окно `ChoiceBox` было скрыто.
`final ObjectProperty<EventHandler<Event>>`	`onHiding`	Вызывается непосредственно перед скрытием всплывающего окна `ChoiceBox`.
`final ObjectProperty<EventHandler<Event>>`	`onShowing`	Вызывается непосредственно перед отображением всплывающего окна `ChoiceBox`.
`final ObjectProperty<EventHandler<Event>>`	`onShown`	Вызывается сразу после отображения всплывающего окна `ChoiceBox`.
`final ObjectProperty<SingleSelectionModel<T>>`	`selectionModel`	Модель выбора для ChoiceBox.
`final ReadOnlyBooleanProperty`	`showing`	Указывает, отображается ли список вариантов пользователю.
`final 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, focusVisible, focusWithin, hover, id, inputMethodRequests, layoutBounds, layoutX, layoutY, localToParentTransform, localToSceneTransform, managed, mouseTransparent, nodeOrientation, onContextMenuRequested, onDragDetected, onDragDone, onDragDropped, onDragEntered, onDragExited, onDragOver, onInputMethodTextChanged, onKeyPressed, onKeyReleased, onKeyTyped, onMouseClicked, onMouseDragEntered, onMouseDragExited, onMouseDragged, onMouseDragOver, onMouseDragReleased, onMouseEntered, onMouseExited, onMouseMoved, onMousePressed, onMouseReleased, onRotate, onRotationFinished, onRotationStarted, onScrollFinished, onScroll, onScrollStarted, onSwipeDown, onSwipeLeft, onSwipeRight, onSwipeUp, onTouchMoved, onTouchPressed, onTouchReleased, onTouchStationary, onZoomFinished, onZoom, onZoomStarted, opacity, parent, pickOnBounds, pressed, rotate, rotationAxis, scaleX, scaleY, scaleZ, scene, style, translateX, translateY, translateZ, viewOrder, visible

Сводка полей

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

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

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

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

computeMaxHeight, computeMaxWidth, computeMinHeight, computeMinWidth, contextMenuProperty, createDefaultSkin, getClassCssMetaData, getContextMenu, getControlCssMetaData, getCssMetaData, getInitialFocusTraversable, getSkin, getTooltip, isResizable, setContextMenu, setSkin, 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, focusVisibleProperty, focusWithinProperty, getAccessibleHelp, getAccessibleRole, getAccessibleRoleDescription, getAccessibleText, getBlendMode, getBoundsInLocal, getBoundsInParent, getCacheHint, getClip, getContentBias, getCursor, getDepthTest, getEffect, getEffectiveNodeOrientation, getEventDispatcher, getId, getInitialCursor, getInputMethodRequests, getLayoutBounds, getLayoutX, getLayoutY, getLocalToParentTransform, getLocalToSceneTransform, getNodeOrientation, getOnContextMenuRequested, getOnDragDetected, getOnDragDone, getOnDragDropped, getOnDragEntered, getOnDragExited, getOnDragOver, getOnInputMethodTextChanged, getOnKeyPressed, getOnKeyReleased, getOnKeyTyped, getOnMouseClicked, getOnMouseDragEntered, getOnMouseDragExited, getOnMouseDragged, getOnMouseDragOver, getOnMouseDragReleased, getOnMouseEntered, getOnMouseExited, getOnMouseMoved, getOnMousePressed, getOnMouseReleased, getOnRotate, getOnRotationFinished, getOnRotationStarted, getOnScroll, getOnScrollFinished, getOnScrollStarted, getOnSwipeDown, getOnSwipeLeft, getOnSwipeRight, getOnSwipeUp, getOnTouchMoved, getOnTouchPressed, getOnTouchReleased, getOnTouchStationary, getOnZoom, getOnZoomFinished, getOnZoomStarted, getOpacity, getParent, getProperties, getPseudoClassStates, getRotate, getRotationAxis, getScaleX, getScaleY, getScaleZ, getScene, getStyle, getStyleableParent, getStyleClass, getTransforms, getTranslateX, getTranslateY, getTranslateZ, getTypeSelector, getUserData, getViewOrder, hasProperties, hoverProperty, idProperty, inputMethodRequestsProperty, intersects, intersects, isCache, isDisable, isDisabled, isFocused, isFocusTraversable, isFocusVisible, isFocusWithin, isHover, isManaged, isMouseTransparent, isPickOnBounds, isPressed, isVisible, layoutBoundsProperty, layoutXProperty, layoutYProperty, localToParent, localToParent, localToParent, localToParent, localToParent, localToParentTransformProperty, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToSceneTransformProperty, localToScreen, localToScreen, localToScreen, localToScreen, localToScreen, lookup, lookupAll, managedProperty, mouseTransparentProperty, nodeOrientationProperty, notifyAccessibleAttributeChanged, onContextMenuRequestedProperty, onDragDetectedProperty, onDragDoneProperty, onDragDroppedProperty, onDragEnteredProperty, onDragExitedProperty, onDragOverProperty, onInputMethodTextChangedProperty, onKeyPressedProperty, onKeyReleasedProperty, onKeyTypedProperty, onMouseClickedProperty, onMouseDragEnteredProperty, onMouseDragExitedProperty, onMouseDraggedProperty, onMouseDragOverProperty, onMouseDragReleasedProperty, onMouseEnteredProperty, onMouseExitedProperty, onMouseMovedProperty, onMousePressedProperty, onMouseReleasedProperty, onRotateProperty, onRotationFinishedProperty, onRotationStartedProperty, onScrollFinishedProperty, onScrollProperty, onScrollStartedProperty, onSwipeDownProperty, onSwipeLeftProperty, onSwipeRightProperty, onSwipeUpProperty, onTouchMovedProperty, onTouchPressedProperty, onTouchReleasedProperty, onTouchStationaryProperty, onZoomFinishedProperty, onZoomProperty, onZoomStartedProperty, opacityProperty, parentProperty, parentToLocal, parentToLocal, parentToLocal, parentToLocal, parentToLocal, pickOnBoundsProperty, pressedProperty, pseudoClassStateChanged, queryAccessibleAttribute, relocate, removeEventFilter, removeEventHandler, requestFocus, requestFocusTraversal, 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. Обычно основное взаимодействие с моделью выделения заключается в явном указании элемента в списке items, который должен быть выбран, или в прослушивании изменений выделения для получения информации о выбранном элементе.

См. также:

showing

public final ReadOnlyBooleanProperty showingProperty

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

См. также:

items

public final ObjectProperty<ObservableList<T>> itemsProperty

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

См. также:

converter

public final ObjectProperty<StringConverter<T>> converterProperty

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

С:

JavaFX 2.1

См. также:

value

public final ObjectProperty<T> valueProperty

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

С:

JavaFX 2.1

См. также:

onAction

public final ObjectProperty<EventHandler<ActionEvent>> onActionProperty

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

С:

JavaFX 8u60

См. также:

onShowing

public final ObjectProperty<EventHandler<Event>> onShowingProperty

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

С:

JavaFX 8u60

См. также:

onShown

public final ObjectProperty<EventHandler<Event>> onShownProperty

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

С:

JavaFX 8u60

См. также:

onHiding

public final ObjectProperty<EventHandler<Event>> onHidingProperty

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

Since:

JavaFX 8u60

See Also:

onHidden

public final ObjectProperty<EventHandler<Event>> onHiddenProperty

Вызывается сразу после того, как всплывающее окно ChoiceBox было скрыто.

Since:

JavaFX 8u60

See Also:

Подробное описание полей

ON_SHOWING

public static final EventType<Event> ON_SHOWING

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

Since:: JavaFX 8u60

ON_SHOWN

public static final EventType<Event> ON_SHOWN

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

Since:: JavaFX 8u60

ON_HIDING

public static final EventType<Event> ON_HIDING

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

Since:: JavaFX 8u60

ON_HIDDEN

public static final EventType<Event> ON_HIDDEN

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

Since:: JavaFX 8u60

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

ChoiceBox

public ChoiceBox()

Создаёт новый ChoiceBox с пустым списком элементов.

ChoiceBox

public ChoiceBox(ObservableList<T> items)

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

Parameters:: items - набор элементов

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

setSelectionModel

public final void setSelectionModel(SingleSelectionModel<T> value)

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

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

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

Parameters:

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

See Also:

getSelectionModel

public final SingleSelectionModel<T> getSelectionModel()

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

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

Returns:

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

See Also:

selectionModelProperty

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

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

Возвращает:

свойство selectionModel

См. также:

isShowing

public final boolean isShowing()

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

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

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

Возвращает:

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

См. также:

showingProperty

public final ReadOnlyBooleanProperty showingProperty()

Возвращает:

свойство showing

См. также:

setItems

public final void setItems(ObservableList<T> value)

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

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

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

Параметры:

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

См. также:

getItems

public final ObservableList<T> getItems()

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

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

Возвращает:

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

См. также:

itemsProperty

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

Возвращает:

свойство items

См. также:

converterProperty

public final ObjectProperty<StringConverter<T>> converterProperty()

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

Возвращает:

свойство преобразователя строк

С:

JavaFX 2.1

См. также:

setConverter

public final void setConverter(StringConverter<T> value)

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

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

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

Параметры:

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

С момента:

JavaFX 2.1

См. также:

getConverter

public final StringConverter<T> getConverter()

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

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

Возвращает:

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

С момента:

JavaFX 2.1

См. также:

valueProperty

public final ObjectProperty<T> valueProperty()

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

Возвращает:

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

С момента:

JavaFX 2.1

См. также:

setValue

public final void setValue(T value)

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

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

Параметры:

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

С момента:

JavaFX 2.1

См. также:

getValue

public final T getValue()

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

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

Возвращает:

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

С момента:

JavaFX 2.1

См. также:

onActionProperty

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

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

Возвращает:

свойство действия

С момента:

JavaFX 8u60

См. также:

END_OF_DOCUMENT_MARKER

setOnAction

public final void setOnAction(EventHandler<ActionEvent> value)

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

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

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

Параметры:

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

С:

JavaFX 8u60

См. также:

getOnAction

public final EventHandler<ActionEvent> getOnAction()

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

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

Возвращает:

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

С:

JavaFX 8u60

См. также:

onShowingProperty

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

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

Возвращает:

свойство on showing

С:

JavaFX 8u60

См. также:

setOnShowing

public final void setOnShowing(EventHandler<Event> value)

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

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

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

Параметры:

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

С:

JavaFX 8u60

См. также:

getOnShowing

public final EventHandler<Event> getOnShowing()

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

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

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

Возвращает:

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

С:

JavaFX 8u60

См. также:

onShownProperty

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

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

Возвращает:

свойство on shown

С:

JavaFX 8u60

См. также:

setOnShown

public final void setOnShown(EventHandler<Event> value)

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

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

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

Параметры:

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

С:

JavaFX 8u60

См. также:

getOnShown

public final EventHandler<Event> getOnShown()

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

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

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

Возвращает:

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

С:

JavaFX 8u60

См. также:

onHidingProperty

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

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

Возвращает:

свойство onHiding

С:

JavaFX 8u60

См. также:

setOnHiding

public final void setOnHiding(EventHandler<Event> value)

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

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

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

Параметры:

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

С:

JavaFX 8u60

См. также:

getOnHiding

public final EventHandler<Event> getOnHiding()

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

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

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

Возвращает:

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

С:

JavaFX 8u60

См. также:

onHiddenProperty

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

Вызывается сразу после того, как всплывающее окно ChoiceBox было скрыто.

Возвращает:

свойство onHidden

С:

JavaFX 8u60

См. также:

setOnHidden

public final void setOnHidden(EventHandler<Event> value)

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

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

Вызывается сразу после того, как всплывающее окно ChoiceBox было скрыто.

Параметры:

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

С:

JavaFX 8u60

См. также:

getOnHidden

public final EventHandler<Event> getOnHidden()

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

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

Вызывается сразу после того, как всплывающее окно ChoiceBox было скрыто.

Возвращает:

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

С:

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.