Класс ChoiceBox<T>

javafx.scene.control.ChoiceBox<T>

All Implemented Interfaces:: Styleable, EventTarget, Skinnable

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

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

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

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

Пример:

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

Since:: JavaFX 2.0

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

Тип	Свойство	Описание
`ObjectProperty<StringConverter<T>>`	`converter`	Позволяет указать способ представления объектов в списке элементов.
`final ObjectProperty<ObservableList<T>>`	`items`	Элементы, которые нужно отобразить в комбобоксе.
`final ObjectProperty<EventHandler<ActionEvent>>`	`onAction`	Действие комбобокса, которое вызывается всякий раз, когда изменяется свойство `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`	Модель выбора для комбобокса.
`final ReadOnlyBooleanProperty`	`showing`	Указывает, отображается ли выпадающий список вариантов пользователю.
`ObjectProperty<T>`	`value`	Значение этого комбобокса определяется как выбранный элемент в модели выбора комбобокса.

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

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

USE_COMPUTED_SIZE, USE_PREF_SIZE

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

BASELINE_OFFSET_SAME_AS_HEIGHT

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

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

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

Модификатор и тип	Метод	Описание
`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, которое вызывается всякий раз, когда изменяется свойство ChoiceBox `value`.
`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()`	Указывает, отображается ли раскрывающийся список вариантов пользователю.
`ObjectProperty<T>`	`valueProperty()`	Значение этого ChoiceBox определено как выбранный элемент в модели выбора ChoiceBox.

Methods declared in class javafx.scene.control.Control

computeMaxHeight, computeMaxWidth, computeMinHeight, computeMinWidth, contextMenuProperty, createDefaultSkin, getClassCssMetaData, getContextMenu, getControlCssMetaData, getCssMetaData, getInitialFocusTraversable, getSkin, getTooltip, isResizable, setContextMenu, setSkin, setTooltip, skinProperty, tooltipProperty

Methods declared in class 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

Methods declared in class javafx.scene.Parent

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

Methods declared in class 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, 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

Methods declared in class java.lang.Object

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

Methods declared in interface javafx.css.Styleable

getStyleableNode

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

selectionModel

public final ObjectProperty<SingleSelectionModel<T>> selectionModelProperty

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

См. также:

getSelectionModel()
setSelectionModel(SingleSelectionModel)
selectionModelProperty()

showing

public final ReadOnlyBooleanProperty showingProperty

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

См. также:

isShowing()
showingProperty()

items

public final ObjectProperty<ObservableList<T>> itemsProperty

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

См. также:

getItems()
setItems(ObservableList)
itemsProperty()

converter

public ObjectProperty<StringConverter<T>> converterProperty

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

С:

JavaFX 2.1

См. также:

getConverter()
setConverter(StringConverter)
converterProperty()

value

public ObjectProperty<T> valueProperty

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

С:

JavaFX 2.1

См. также:

getValue()
setValue(T)
valueProperty()

onAction

public final ObjectProperty<EventHandler<ActionEvent>> onActionProperty

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

С:

JavaFX 8u60

См. также:

getOnAction()
setOnAction(EventHandler)
onActionProperty()

onShowing

public final ObjectProperty<EventHandler<Event>> onShowingProperty

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

С:

JavaFX 8u60

См. также:

getOnShowing()
setOnShowing(EventHandler)
onShowingProperty()

onShown

public final ObjectProperty<EventHandler<Event>> onShownProperty

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

С:

JavaFX 8u60

См. также:

getOnShown()
setOnShown(EventHandler)
onShownProperty()

onHiding

public final ObjectProperty<EventHandler<Event>> onHidingProperty

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

С:

JavaFX 8u60

См. также:

getOnHiding()
setOnHiding(EventHandler)
onHidingProperty()

onHidden

public final ObjectProperty<EventHandler<Event>> onHiddenProperty

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

С:

JavaFX 8u60

См. также:

getOnHidden()
setOnHidden(EventHandler)
onHiddenProperty()

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

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.

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

Параметры:

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

См. также:

getSelectionModel()
selectionModelProperty()

getSelectionModel

public final SingleSelectionModel<T> getSelectionModel()

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

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

Возвращает:

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

См. также:

setSelectionModel(SingleSelectionModel)
selectionModelProperty()

selectionModelProperty

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

Возвращает:

свойство selectionModel

См. также:

getSelectionModel()
setSelectionModel(SingleSelectionModel)

isShowing

public final boolean isShowing()

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

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

Возвращает:

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

См. также:

showingProperty()

showingProperty

public final ReadOnlyBooleanProperty showingProperty()

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

Возвращает:

свойство showing

См. также:

isShowing()

setItems

public final void setItems(ObservableList<T> value)

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

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

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

Параметры:

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

См. также:

getItems()
itemsProperty()

getItems

public final ObservableList<T> getItems()

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

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

Возвращает:

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

См. также:

setItems(ObservableList)
itemsProperty()

itemsProperty

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

Возвращает:

свойство items

См. также:

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.

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

Параметры:

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

С момента:

JavaFX 2.1

См. также:

getConverter()
converterProperty()

getConverter

public final StringConverter<T> getConverter()

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

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

Возвращает:

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

С момента:

JavaFX 2.1

См. также:

setConverter(StringConverter)
converterProperty()

valueProperty

public ObjectProperty<T> valueProperty()

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

Возвращает:

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

С момента:

JavaFX 2.1

См. также:

getValue()
setValue(T)

setValue

public final void setValue(T value)

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

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

Параметры:

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

С момента:

JavaFX 2.1

См. также:

getValue()
valueProperty()

getValue

public final T getValue()

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

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

Возвращает:

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

С момента:

JavaFX 2.1

См. также:

setValue(T)
valueProperty()

onActionProperty

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

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

Возвращает:

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

С момента:

JavaFX 8u60

См. также:

getOnAction()
setOnAction(EventHandler)

setOnAction

public final void setOnAction(EventHandler<ActionEvent> value)

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

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

Параметры:

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

С момента:

JavaFX 8u60

См. также:

getOnAction()
onActionProperty()

getOnAction

public final EventHandler<ActionEvent> getOnAction()

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

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

Возвращает:

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

С момента:

JavaFX 8u60

См. также:

setOnAction(EventHandler)
onActionProperty()

onShowingProperty

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

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

Возвращает:

свойство on showing

С момента:

JavaFX 8u60

См. также:

getOnShowing()
setOnShowing(EventHandler)

setOnShowing

public final void setOnShowing(EventHandler<Event> value)

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

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

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

Параметры:

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

С момента:

JavaFX 8u60

См. также:

getOnShowing()
onShowingProperty()

getOnShowing

public final EventHandler<Event> getOnShowing()

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

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

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

Возвращает:

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

С версии:

JavaFX 8u60

См. также:

setOnShowing(EventHandler)
onShowingProperty()

onShownProperty

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

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

Возвращает:

свойство on shown

С версии:

JavaFX 8u60

См. также:

getOnShown()
setOnShown(EventHandler)

setOnShown

public final void setOnShown(EventHandler<Event> value)

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

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

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

Параметры:

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

С версии:

JavaFX 8u60

См. также:

getOnShown()
onShownProperty()

getOnShown

public final EventHandler<Event> getOnShown()

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

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

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

Возвращает:

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

С версии:

JavaFX 8u60

См. также:

setOnShown(EventHandler)
onShownProperty()

onHidingProperty

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

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

Возвращает:

свойство on hiding

С версии:

JavaFX 8u60

См. также:

getOnHiding()
setOnHiding(EventHandler)

setOnHiding

public final void setOnHiding(EventHandler<Event> value)

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

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

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

Параметры:

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

С версии:

JavaFX 8u60

См. также:

getOnHiding()
onHidingProperty()

getOnHiding

public final EventHandler<Event> getOnHiding()

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

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

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

Возвращает:

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

С версии:

JavaFX 8u60

См. также:

setOnHiding(EventHandler)
onHidingProperty()

onHiddenProperty

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

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

Возвращает:

свойство on hidden

С версии:

JavaFX 8u60

См. также:

getOnHidden()
setOnHidden(EventHandler)

setOnHidden

public final void setOnHidden(EventHandler<Event> value)

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

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

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

Параметры:

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

С версии:

JavaFX 8u60

См. также:

getOnHidden()
onHiddenProperty()

getOnHidden

public final EventHandler<Event> getOnHidden()

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

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

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

Возвращает:

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

С версии:

JavaFX 8u60

См. также:

setOnHidden(EventHandler)
onHiddenProperty()

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.