Класс ChoiceBox<T>
- javafx.scene.Node
-
- javafx.scene.Parent
-
- javafx.scene.layout.Region
-
- javafx.scene.control.Control
-
- javafx.scene.control.ChoiceBox<T>
Все реализованные интерфейсы:
@DefaultProperty(value="items") public class ChoiceBox<T> extends Control
По умолчанию в Комбобоксе нет выбранного элемента, если не указано иное. Хотя Комбобокс позволит пользователю выбирать только из предопределённого списка, разработчик может указать выбранный элемент, отличный от имеющегося в предопределённом списке. Это необходимо для нескольких важных случаев использования.
Это означает, что настройка Комбобокса не зависит от порядка. Вы можете сначала указать элементы, а затем выбранный элемент, или сначала выбранный элемент, а затем элементы. В любом случае это будет работать правильно.
Выбор элементов Комбобокса обрабатывается SelectionModel Как и в ListView и ComboBox, можно изменить используемую SelectionModel, хотя это, скорее всего, редко меняется. Комбобокс поддерживает только модель единственного выбора, поэтому используемая по умолчанию - SingleSelectionModel.
import javafx.scene.control.ChoiceBox;
ChoiceBox cb = new ChoiceBox();
cb.getItems().addAll("item1", "item2", "item3");
С момента:
JavaFX 2.0
-
Краткое описание свойств
Все методыМетоды экземпляровКонкретные методы Тип Свойство и описание ObjectProperty<StringConverter<T>>converterПозволяет указать, как представлять объекты в списке элементов.ObjectProperty<ObservableList<T>>itemsЭлементы для отображения в комбобоксе.ObjectProperty<SingleSelectionModel<T>>selectionModelМодель выбора для Комбобокса.ReadOnlyBooleanPropertyshowingУказывает, отображается ли выпадающий список вариантов пользователю.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, 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, visible
-
-
Краткое описание полей
-
Поля, унаследованные от класса 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()Позволяет указать, как представлять объекты в списке элементов.protected Skin<?>createDefaultSkin()Создаёт новый экземпляр по умолчанию для этой управляющей кнопки.voidexecuteAccessibleAction(AccessibleAction action, Object... parameters)Этот метод вызывается вспомогательной технологией для запроса выполнения действия, указанного в аргументе.StringConverter<T>getConverter()Возвращает значение свойства конвертера.ObservableList<T>getItems()Возвращает значение свойства items.SingleSelectionModel<T>getSelectionModel()Возвращает значение свойства selectionModel.TgetValue()Возвращает значение свойства value.voidhide()Закрывает список вариантов.booleanisShowing()Возвращает значение свойства showing.ObjectProperty<ObservableList<T>>itemsProperty()Элементы для отображения в комбобоксе.ObjectqueryAccessibleAttribute(AccessibleAttribute attribute, Object... parameters)* Обработка доступности * *ObjectProperty<SingleSelectionModel<T>>selectionModelProperty()Модель выбора для Комбобокса.voidsetConverter(StringConverter<T> value)Устанавливает значение свойства конвертера.voidsetItems(ObservableList<T> value)Устанавливает значение свойства items.voidsetSelectionModel(SingleSelectionModel<T> value)Устанавливает значение свойства selectionModel.voidsetValue(T value)Устанавливает значение свойства value.voidshow()Открывает список вариантов.ReadOnlyBooleanPropertyshowingProperty()Указывает, отображается ли выпадающий список вариантов пользователю.ObjectProperty<T>valueProperty()Значение этого Комбобокса определяется как выбранный элемент в модели выбора Комбобокса.-
Методы, унаследованные от класса javafx.scene.control.Control
computeMaxHeight, computeMaxWidth, computeMinHeight, computeMinWidth, computePrefHeight, computePrefWidth, contextMenuProperty, getBaselineOffset, getClassCssMetaData, getContextMenu, getControlCssMetaData, getCssMetaData, getSkin, getTooltip, isResizable, layoutChildren, setContextMenu, setSkin, setTooltip, skinProperty, tooltipProperty
-
Методы, унаследованные от класса javafx.scene.layout.Region
backgroundProperty, borderProperty, cacheShapeProperty, centerShapeProperty, getBackground, getBorder, getHeight, getInsets, getMaxHeight, getMaxWidth, getMinHeight, getMinWidth, getOpaqueInsets, getPadding, getPrefHeight, getPrefWidth, getShape, getUserAgentStylesheet, getWidth, heightProperty, insetsProperty, isCacheShape, isCenterShape, isScaleShape, isSnapToPixel, layoutInArea, layoutInArea, layoutInArea, layoutInArea, maxHeight, maxHeightProperty, maxWidth, maxWidthProperty, minHeight, minHeightProperty, minWidth, minWidthProperty, opaqueInsetsProperty, paddingProperty, positionInArea, positionInArea, prefHeight, prefHeightProperty, prefWidth, prefWidthProperty, resize, scaleShapeProperty, setBackground, setBorder, setCacheShape, setCenterShape, setHeight, setMaxHeight, setMaxSize, setMaxWidth, setMinHeight, setMinSize, setMinWidth, setOpaqueInsets, setPadding, setPrefHeight, setPrefSize, setPrefWidth, setScaleShape, setShape, setSnapToPixel, setWidth, shapeProperty, snappedBottomInset, snappedLeftInset, snappedRightInset, snappedTopInset, snapPosition, snapSize, snapSpace, snapToPixelProperty, widthProperty
-
Методы, унаследованные от класса javafx.scene.Parent
getChildren, getChildrenUnmodifiable, getManagedChildren, getStylesheets, isNeedsLayout, layout, lookup, needsLayoutProperty, requestLayout, requestParentLayout, setNeedsLayout, updateBounds
-
Методы, унаследованные от класса javafx.scene.Node
accessibleHelpProperty, accessibleRoleDescriptionProperty, accessibleRoleProperty, accessibleTextProperty, addEventFilter, addEventHandler, applyCss, autosize, blendModeProperty, boundsInLocalProperty, boundsInParentProperty, buildEventDispatchChain, cacheHintProperty, cacheProperty, clipProperty, computeAreaInScreen, contains, contains, cursorProperty, depthTestProperty, disabledProperty, disableProperty, effectiveNodeOrientationProperty, effectProperty, eventDispatcherProperty, fireEvent, focusedProperty, focusTraversableProperty, getAccessibleHelp, getAccessibleRole, getAccessibleRoleDescription, getAccessibleText, getBlendMode, getBoundsInLocal, getBoundsInParent, getCacheHint, getClip, getContentBias, getCursor, getDepthTest, getEffect, getEffectiveNodeOrientation, getEventDispatcher, getId, 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, hasProperties, hoverProperty, idProperty, inputMethodRequestsProperty, intersects, intersects, isCache, isDisable, isDisabled, isFocused, isFocusTraversable, isHover, isManaged, isMouseTransparent, isPickOnBounds, isPressed, isVisible, layoutBoundsProperty, layoutXProperty, layoutYProperty, localToParent, localToParent, localToParent, localToParent, localToParent, localToParentTransformProperty, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToSceneTransformProperty, localToScreen, localToScreen, localToScreen, localToScreen, localToScreen, lookupAll, managedProperty, mouseTransparentProperty, nodeOrientationProperty, notifyAccessibleAttributeChanged, onContextMenuRequestedProperty, onDragDetectedProperty, onDragDoneProperty, onDragDroppedProperty, onDragEnteredProperty, onDragExitedProperty, onDragOverProperty, onInputMethodTextChangedProperty, onKeyPressedProperty, onKeyReleasedProperty, onKeyTypedProperty, onMouseClickedProperty, onMouseDragEnteredProperty, onMouseDragExitedProperty, onMouseDraggedProperty, onMouseDragOverProperty, onMouseDragReleasedProperty, onMouseEnteredProperty, onMouseExitedProperty, onMouseMovedProperty, onMousePressedProperty, onMouseReleasedProperty, onRotateProperty, onRotationFinishedProperty, onRotationStartedProperty, onScrollFinishedProperty, onScrollProperty, onScrollStartedProperty, onSwipeDownProperty, onSwipeLeftProperty, onSwipeRightProperty, onSwipeUpProperty, onTouchMovedProperty, onTouchPressedProperty, onTouchReleasedProperty, onTouchStationaryProperty, onZoomFinishedProperty, onZoomProperty, onZoomStartedProperty, opacityProperty, parentProperty, parentToLocal, parentToLocal, parentToLocal, parentToLocal, parentToLocal, pickOnBoundsProperty, pressedProperty, pseudoClassStateChanged, relocate, removeEventFilter, removeEventHandler, requestFocus, resizeRelocate, rotateProperty, rotationAxisProperty, scaleXProperty, scaleYProperty, scaleZProperty, sceneProperty, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, screenToLocal, screenToLocal, screenToLocal, setAccessibleHelp, setAccessibleRole, setAccessibleRoleDescription, setAccessibleText, setBlendMode, setCache, setCacheHint, setClip, setCursor, setDepthTest, setDisable, setDisabled, setEffect, setEventDispatcher, setEventHandler, setFocused, setFocusTraversable, setHover, setId, setInputMethodRequests, setLayoutX, setLayoutY, setManaged, setMouseTransparent, setNodeOrientation, setOnContextMenuRequested, setOnDragDetected, setOnDragDone, setOnDragDropped, setOnDragEntered, setOnDragExited, setOnDragOver, setOnInputMethodTextChanged, setOnKeyPressed, setOnKeyReleased, setOnKeyTyped, setOnMouseClicked, setOnMouseDragEntered, setOnMouseDragExited, setOnMouseDragged, setOnMouseDragOver, setOnMouseDragReleased, setOnMouseEntered, setOnMouseExited, setOnMouseMoved, setOnMousePressed, setOnMouseReleased, setOnRotate, setOnRotationFinished, setOnRotationStarted, setOnScroll, setOnScrollFinished, setOnScrollStarted, setOnSwipeDown, setOnSwipeLeft, setOnSwipeRight, setOnSwipeUp, setOnTouchMoved, setOnTouchPressed, setOnTouchReleased, setOnTouchStationary, setOnZoom, setOnZoomFinished, setOnZoomStarted, setOpacity, setPickOnBounds, setPressed, setRotate, setRotationAxis, setScaleX, setScaleY, setScaleZ, setStyle, setTranslateX, setTranslateY, setTranslateZ, setUserData, setVisible, snapshot, snapshot, startDragAndDrop, startFullDrag, styleProperty, toBack, toFront, toString, translateXProperty, translateYProperty, translateZProperty, usesMirroring, visibleProperty
-
-
Подробное описание свойств
-
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
Элементы для отображения в поле выбора. Выбранный элемент (как указано в модели выбора) всегда должен быть одним из этих элементов.См. также:
-
converter
public ObjectProperty<StringConverter<T>> converterProperty
Позволяет указать, как представлять объекты в списке items. Когда установлен StringConverter, не вызывается метод toString объекта, а вместо этого вызывается toString(object T), передавая объекты из списка items. Это полезно при использовании доменных объектов в ChoiceBox, так как это свойство позволяет настроить представление. Также можно задать любой из предварительно созданных конвертеров, доступных в пакетеjavafx.util.converter.С:
JavaFX 2.1
См. также:
-
value
public ObjectProperty<T> valueProperty
Значение ChoiceBox определяется как выбранный элемент в модели выбора ChoiceBox. valueProperty синхронизируется с selectedItem. Это свойство позволяет осуществлять двунаправленную привязку внешних свойств к ChoiceBox и соответственно обновлять модель выбора.С:
JavaFX 2.1
См. также:
-
-
Подробное описание конструкторов
-
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. Обычно основное взаимодействие с моделью выбора заключается в явном указании, какой элемент в списке элементов должен быть выбран, или в прослушивании изменений выбора, чтобы узнать, какой элемент был выбран.
-
isShowing
public final boolean isShowing()
Получает значение свойства showing.Описание свойства:
Указывает, отображается ли раскрывающийся список вариантов пользователю. Это свойство только для чтения, которое должно изменяться с помощью методов #show и #hide.
-
showingProperty
public final ReadOnlyBooleanProperty showingProperty()
Указывает, отображается ли раскрывающийся список вариантов пользователю. Это свойство только для чтения, которое должно изменяться с помощью методов #show и #hide.См. также:
-
setItems
public final void setItems(ObservableList<T> value)
Устанавливает значение свойства items.Описание свойства:
Элементы, которые должны отображаться в раскрывающемся списке. Выбранный элемент (как указано в модели выбора) должен всегда быть одним из этих элементов.
-
getItems
public final ObservableList<T> getItems()
Получает значение свойства items.Описание свойства:
Элементы, которые должны отображаться в раскрывающемся списке. Выбранный элемент (как указано в модели выбора) должен всегда быть одним из этих элементов.
-
itemsProperty
public final ObjectProperty<ObservableList<T>> itemsProperty()
Элементы, которые должны отображаться в раскрывающемся списке. Выбранный элемент (как указано в модели выбора) должен всегда быть одним из этих элементов.См. также:
-
converterProperty
public ObjectProperty<StringConverter<T>> converterProperty()
Позволяет указать, как представлять объекты в списке элементов. Если установлен StringConverter, то не вызывается метод toString объекта, а вызывается метод toString(object 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.С:
JavaFX 2.1
-
getConverter
public final StringConverter<T> getConverter()
Получает значение свойства converter.Описание свойства:
Позволяет указать, как представлять объекты в списке элементов. Если установлен StringConverter, то не вызывается метод toString объекта, а вызывается метод toString(object T), передавая объекты из списка элементов. Это полезно при использовании доменных объектов в ChoiceBox, так как это свойство позволяет настроить представление. Также можно установить любой из предварительно созданных конвертеров, доступных в пакете
javafx.util.converter.С:
JavaFX 2.1
-
valueProperty
public ObjectProperty<T> valueProperty()
Значение этого ChoiceBox определяется как выбранный элемент в модели выбора ChoiceBox. Свойство valueProperty синхронизируется с selectedItem. Это свойство позволяет осуществлять двустороннее связывание внешних свойств с ChoiceBox и соответствующим образом обновляет модель выбора.С:
JavaFX 2.1
См. также:
-
setValue
public final void setValue(T value)
Устанавливает значение свойства value.Описание свойства:
Значение этого ChoiceBox определяется как выбранный элемент в модели выбора ChoiceBox. Свойство valueProperty синхронизируется с selectedItem. Это свойство позволяет осуществлять двустороннее связывание внешних свойств с ChoiceBox и соответствующим образом обновляет модель выбора.
С:
JavaFX 2.1
-
getValue
public final T getValue()
Получает значение свойства value.Описание свойства:
Значение этого ChoiceBox определяется как выбранный элемент в модели выбора ChoiceBox. Свойство valueProperty синхронизируется с selectedItem. Это свойство позволяет осуществлять двустороннее связывание внешних свойств с ChoiceBox и соответствующим образом обновляет модель выбора.
С:
JavaFX 2.1
-
show
public void show()
Открывает список вариантов.
-
hide
public void hide()
Закрывает список вариантов.
-
createDefaultSkin
protected Skin<?> createDefaultSkin()
Создает новый экземпляр стандартной темы для этого элемента управления. Этот метод вызывается для создания темы для элемента управления, если тема не предоставлена через CSS-fx-skinили явно установлена в подклассе с помощьюsetSkin(...).Переопределяет:
createDefaultSkinв классеControlВозвращает:
новый экземпляр стандартной темы для этого элемента управления. Если null, то у элемента управления не будет темы, если она не предоставлена через css.
-
queryAccessibleAttribute
public Object queryAccessibleAttribute(AccessibleAttribute attribute, Object... parameters)* Обработка доступности * *Переопределяет:
queryAccessibleAttributeв классеControlПараметры:
attribute- запрашиваемый атрибутВозвращает:
значение запрошенного атрибута
См. также:
-
executeAccessibleAction
public void executeAccessibleAction(AccessibleAction action, Object... parameters)Описание скопировано из класса:NodeЭтот метод вызывается технологией вспомогательных средств, чтобы запросить выполнение действия, указанного в аргументе.Этот метод обычно переопределяется подклассами для реализации действий, необходимых для определённой роли.
Если определённое действие не обрабатывается, должна вызываться реализация суперкласса.Переопределяет:
executeAccessibleActionв классеControlПараметры:
action- действие для выполненияСм. также:
-
© 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.