Класс ComboBoxListCell<T>

javafx.scene.control.cell.ComboBoxListCell<T>

Type Parameters:: T - Тип элементов, содержащихся в ListView.

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

public class ComboBoxListCell<T>
extends ListCell<T>

Класс, содержащий реализацию ListCell, которая отображает узел ComboBox внутри ячейки.

По умолчанию ComboBoxListCell отображается как Label при отсутствии редактирования и как ComboBox в режиме редактирования. По умолчанию ComboBox будет занимать всю ширину ячейки списка.

Для создания ComboBoxListCell необходимо указать один или более элементов, которые будут отображаться пользователю при отображении меню ComboBox. Эти элементы должны быть того же типа, что и элементы в списке ListView, чтобы при выборе они заменяли существующее значение в списке items.

Since:: JavaFX 2.2

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

Свойства
Тип	Свойство	Описание
`BooleanProperty`	`comboBoxEditable`	Свойство, представляющее собой возможность редактирования ComboBox при отображении пользователю.
`ObjectProperty<StringConverter<T>>`	`converter`	Свойство `StringConverter`.

Свойства, объявленные в классе javafx.scene.control.ListCell

listView

Свойства, объявленные в классе javafx.scene.control.IndexedCell

index

Свойства, объявленные в классе javafx.scene.control.Cell

editable, editing, empty, item, selected

Свойства, объявленные в классе javafx.scene.control.Labeled

alignment, contentDisplay, ellipsisString, font, graphic, graphicTextGap, labelPadding, lineSpacing, mnemonicParsing, textAlignment, textFill, textOverrun, text, underline, wrapText

Свойства, объявленные в классе 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

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

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

USE_COMPUTED_SIZE, USE_PREF_SIZE

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

BASELINE_OFFSET_SAME_AS_HEIGHT

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

Конструкторы
Конструктор	Описание
`ComboBoxListCell()`	Создаёт ComboBoxListCell по умолчанию со списком элементов.
`ComboBoxListCell(ObservableList<T> items)`	Создаёт экземпляр `ComboBoxListCell` по умолчанию с заданными элементами для заполнения `ComboBox` при его отображении.
`ComboBoxListCell(StringConverter<T> converter, ObservableList<T> items)`	Создаёт экземпляр `ComboBoxListCell` с заданными элементами для заполнения `ComboBox` при его отображении и `StringConverter` для преобразования элемента в читаемый вид.
`ComboBoxListCell(StringConverter<T> converter, T... items)`	Создаёт экземпляр `ComboBoxListCell` с заданными элементами для заполнения `ComboBox` при его отображении и `StringConverter` для преобразования элемента в читаемый вид.
`ComboBoxListCell(T... items)`	Создаёт экземпляр `ComboBoxListCell` по умолчанию с заданными элементами для заполнения `ComboBox` при его отображении.

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

Модификатор и тип	Метод	Описание
`BooleanProperty`	`comboBoxEditableProperty()`	Свойство, определяющее, является ли ComboBox редактируемым при отображении пользователю.
`ObjectProperty<StringConverter<T>>`	`converterProperty()`	Свойство `StringConverter`.
`static <T> Callback<ListView<T>,ListCell<T>>`	`forListView(ObservableList<T> items)`	Создаёт фабрику ячеек ComboBox для использования в элементах управления `ListView`.
`static <T> Callback<ListView<T>,ListCell<T>>`	`forListView(StringConverter<T> converter, ObservableList<T> items)`	Создаёт фабрику ячеек ComboBox для использования в элементах управления `ListView`.
`static <T> Callback<ListView<T>,ListCell<T>>`	`forListView(StringConverter<T> converter, T... items)`	Создаёт фабрику ячеек ComboBox для использования в элементах управления `ListView`.
`static <T> Callback<ListView<T>,ListCell<T>>`	`forListView(T... items)`	Создаёт фабрику ячеек ComboBox для использования в элементах управления `ListView`.
`StringConverter<T>`	`getConverter()`	Возвращает `StringConverter`, используемый в этой ячейке.
`ObservableList<T>`	`getItems()`	Возвращает элементы, отображаемые в ChoiceBox при его отображении.
`boolean`	`isComboBoxEditable()`	Возвращает true, если ComboBox редактируемый.
`void`	`setComboBoxEditable(boolean value)`	Настраивает ComboBox для редактирования (разрешает ввод пользователем вне списка опций в выпадающем списке).
`void`	`setConverter(StringConverter<T> value)`	Устанавливает `StringConverter` для использования в этой ячейке.

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

getListView, listViewProperty, updateListView

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

getIndex, indexProperty, updateIndex

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

cancelEdit, commitEdit, editableProperty, editingProperty, emptyProperty, getInitialFocusTraversable, getItem, isEditable, isEditing, isEmpty, isItemChanged, isSelected, itemProperty, selectedProperty, setEditable, setItem, startEdit, updateItem, updateSelected

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

alignmentProperty, contentDisplayProperty, ellipsisStringProperty, fontProperty, getAlignment, getClassCssMetaData, getContentBias, getContentDisplay, getControlCssMetaData, getEllipsisString, getFont, getGraphic, getGraphicTextGap, getInitialAlignment, getLabelPadding, getLineSpacing, getText, getTextAlignment, getTextFill, getTextOverrun, graphicProperty, graphicTextGapProperty, isMnemonicParsing, isUnderline, isWrapText, labelPaddingProperty, lineSpacingProperty, mnemonicParsingProperty, setAlignment, setContentDisplay, setEllipsisString, setFont, setGraphic, setGraphicTextGap, setLineSpacing, setMnemonicParsing, setText, setTextAlignment, setTextFill, setTextOverrun, setUnderline, setWrapText, textAlignmentProperty, textFillProperty, textOverrunProperty, textProperty, underlineProperty, wrapTextProperty

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

computeMaxHeight, computeMaxWidth, computeMinHeight, computeMinWidth, contextMenuProperty, createDefaultSkin, getContextMenu, getCssMetaData, 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, 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

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

converter

public final ObjectProperty<StringConverter<T>> converterProperty

Свойство StringConverter.

См. также:: getConverter(), setConverter(StringConverter)

comboBoxEditable

public final BooleanProperty comboBoxEditableProperty

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

См. также:: isComboBoxEditable(), setComboBoxEditable(boolean)

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

ComboBoxListCell

public ComboBoxListCell()

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

ComboBoxListCell

@SafeVarargs public ComboBoxListCell(T... items)

Создаёт экземпляр стандартного ComboBoxListCell с заданными элементами, которые используются для заполнения ComboBox при его отображении.

Параметры:: items - Элементы, отображаемые в всплывающем меню ComboBox при выборе пользователем.

ComboBoxListCell

@SafeVarargs public ComboBoxListCell(StringConverter<T> converter, T... items)

Создаёт экземпляр ComboBoxListCell с заданными элементами, которые используются для заполнения ComboBox при его отображении, и StringConverter, используемым для преобразования элемента в читаемую пользователем форму.

Параметры:: converter - StringConverter, преобразующий элемент типа T в удобочитаемую строку для отображения в всплывающем меню ComboBox.; items - Элементы, отображаемые во всплывающем меню ComboBox при выборе пользователем.

ComboBoxListCell

public ComboBoxListCell(ObservableList<T> items)

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

Параметры:: items - Элементы, отображаемые во всплывающем меню ComboBox при выборе пользователем.

ComboBoxListCell

public ComboBoxListCell(StringConverter<T> converter, ObservableList<T> items)

Параметры:: converter - StringConverter, преобразующий элемент типа T в удобочитаемую строку для отображения во всплывающем меню ComboBox.; items - Элементы, отображаемые во всплывающем меню ComboBox при выборе пользователем.

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

forListView

@SafeVarargs public static <T> Callback<ListView<T>,ListCell<T>> forListView(T... items)

Создаёт фабрику ячеек ComboBox для использования в элементах управления ListView. По умолчанию ComboBoxCell отображается как Label при отсутствии редактирования и как ComboBox в режиме редактирования. ComboBox по умолчанию растягивается, чтобы заполнить всю ячейку списка.

Параметры типа:: T - Тип элементов, содержащихся в ListView.
Параметры:: items - Ноль или более элементов, которые будут показаны пользователю при отображении меню ComboBox. Эти элементы должны быть того же типа, что и элементы списка ListView, чтобы при выборе они заменяли существующее значение в списке items.
Возвращает:: Callback, возвращающий ячейку списка, способную работать с типом элемента, содержащегося в ListView.

forListView

@SafeVarargs public static <T> Callback<ListView<T>,ListCell<T>> forListView(StringConverter<T> converter, T... items)

Параметры типа:: T - Тип элементов, содержащихся в ListView.
Параметры:: converter - StringConverter для преобразования заданного элемента (типа T) в строку для отображения пользователю.; items - Ноль или более элементов, которые будут показаны пользователю при отображении меню ComboBox. Эти элементы должны быть того же типа, что и элементы списка ListView, чтобы при выборе они заменяли существующее значение в списке items.
Возвращает:: Callback, возвращающий ячейку списка, способную работать с типом элемента, содержащегося в ListView.

forListView

public static <T> Callback<ListView<T>,ListCell<T>> forListView(ObservableList<T> items)

Параметры типа:: T - Тип элементов, содержащихся в ListView.
Параметры:: items - ObservableList, содержащий ноль или более элементов, которые будут показаны пользователю при отображении меню ComboBox. Эти элементы должны быть того же типа, что и элементы ListView, чтобы при выборе они заменяли существующее значение в списке items.
Возвращает:: Callback, возвращающий ячейку списка, способную работать с типом элемента, содержащегося в ListView.

forListView

public static <T> Callback<ListView<T>,ListCell<T>> forListView(StringConverter<T> converter, ObservableList<T> items)

Параметры типа:: T - Тип элементов, содержащихся в ListView.
Параметры:: converter - StringConverter для преобразования заданного элемента (типа T) в строку для отображения пользователю.; items - ObservableList, содержащий ноль или более элементов, которые будут показаны пользователю при отображении меню ComboBox. Эти элементы должны быть того же типа, что и элементы ListView, чтобы при выборе они заменяли существующее значение в списке items.
Возвращает:: Callback, возвращающий ячейку списка, способную работать с типом элемента, содержащегося в ListView.

converterProperty

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

Свойство StringConverter.

См. также:: getConverter(), setConverter(StringConverter)

setConverter

public final void setConverter(StringConverter<T> value)

Устанавливает StringConverter для использования в этой ячейке.

Parameters:: value - StringConverter, используемый в этой ячейке

getConverter

public final StringConverter<T> getConverter()

Возвращает StringConverter, используемый в этой ячейке.

Returns:: StringConverter, используемый в этой ячейке

comboBoxEditableProperty

public final BooleanProperty comboBoxEditableProperty()

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

See Also:: isComboBoxEditable(), setComboBoxEditable(boolean)

setComboBoxEditable

public final void setComboBoxEditable(boolean value)

Настраивает ComboBox для редактирования (чтобы разрешить ввод пользователем вне списка опций выпадающего списка).

Parameters:: value - значение редактируемости для этого ComboBox

isComboBoxEditable

public final boolean isComboBoxEditable()

Возвращает true, если ComboBox редактируется.

Returns:: true, если ComboBox редактируется

getItems

public ObservableList<T> getItems()

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

Returns:: элементы, которые должны отображаться в раскрывающемся списке ChoiceBox.

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