Класс ChoiceBoxTreeCell<T>

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

Type Parameters:: T - Тип TreeItems, содержащихся в TreeView.

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

public class ChoiceBoxTreeCell<T>
extends TreeCell<T>

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

По умолчанию, ChoiceBoxTreeCell отображается как Label при отсутствии редактирования и как ChoiceBox в режиме редактирования. ChoiceBox, по умолчанию, растягивается для заполнения всей ячейки дерева.

Для создания ChoiceBoxTreeCell необходимо предоставить один или несколько элементов, которые будут отображаться пользователю, когда появляется меню ChoiceBox. Эти элементы должны быть того же типа, что и TreeItems TreeView, так что при выборе они замещают существующее значение в TreeItem.valueProperty().

Since:: JavaFX 2.2

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

Свойства
Тип	Свойство	Описание
`ObjectProperty<StringConverter<T>>`	`converter`	Свойство `StringConverter`.

Свойства, унаследованные от класса javafx.scene.control.TreeCell

disclosureNode, treeItem, treeView

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

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

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

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

Модификатор и тип	Метод	Описание
`ObjectProperty<StringConverter<T>>`	`converterProperty()`	Свойство `StringConverter`.
`static <T> Callback<TreeView<T>,TreeCell<T>>`	`forTreeView(ObservableList<T> items)`	Создает фабрику ячеек ChoiceBox для использования в элементах управления `TreeView`.
`static <T> Callback<TreeView<T>,TreeCell<T>>`	`forTreeView(StringConverter<T> converter, ObservableList<T> items)`	Создает фабрику ячеек ChoiceBox для использования в элементах управления `TreeView`.
`static <T> Callback<TreeView<T>,TreeCell<T>>`	`forTreeView(StringConverter<T> converter, T... items)`	Создает фабрику ячеек ChoiceBox для использования в элементах управления `TreeView`.
`static <T> Callback<TreeView<T>,TreeCell<T>>`	`forTreeView(T... items)`	Создает фабрику ячеек ChoiceBox для использования в элементах управления `TreeView`.
`StringConverter<T>`	`getConverter()`	Возвращает `StringConverter`, используемый в этой ячейке.
`ObservableList<T>`	`getItems()`	Возвращает элементы, отображаемые в ChoiceBox при отображении.
`void`	`setConverter(StringConverter<T> value)`	Устанавливает `StringConverter`, который будет использоваться в этой ячейке.
`void`	`updateItem(T item, boolean empty)`	Метод updateItem не должен вызываться разработчиками, но он является лучшим методом для переопределения разработчиками, чтобы позволить им настроить визуализацию ячейки.

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

disclosureNodeProperty, getDisclosureNode, getTreeItem, getTreeView, setDisclosureNode, treeItemProperty, treeViewProperty, updateTreeItem, updateTreeView

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

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

ChoiceBoxTreeCell

public ChoiceBoxTreeCell()

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

ChoiceBoxTreeCell

@SafeVarargs public ChoiceBoxTreeCell(T... items)

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

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

ChoiceBoxTreeCell

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

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

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

ChoiceBoxTreeCell

public ChoiceBoxTreeCell(ObservableList<T> items)

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

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

ChoiceBoxTreeCell

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

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

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

forTreeView

@SafeVarargs public static <T> Callback<TreeView<T>,TreeCell<T>> forTreeView(T... items)

Создаёт фабрику ячеек ChoiceBox для использования в контролах TreeView. По умолчанию ChoiceBoxCell отображается как Label при отсутствии редактирования и как ChoiceBox при редактировании. ChoiceBox по умолчанию заполняет всю ячейку дерева.

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

forTreeView

public static <T> Callback<TreeView<T>,TreeCell<T>> forTreeView(ObservableList<T> items)

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

forTreeView

@SafeVarargs public static <T> Callback<TreeView<T>,TreeCell<T>> forTreeView(StringConverter<T> converter, T... items)

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

forTreeView

public static <T> Callback<TreeView<T>,TreeCell<T>> forTreeView(StringConverter<T> converter, ObservableList<T> items)

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

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, используемый в этой ячейке

getItems

public ObservableList<T> getItems()

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

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

updateItem

public void updateItem(T item, boolean empty)

Метод updateItem не должен вызываться разработчиками, но это лучший метод для переопределения разработчиками, чтобы позволить им настраивать визуальные элементы ячейки. Для уточнения, разработчики никогда не должны вызывать этот метод в своём коде (они должны позволить элементу пользовательского интерфейса, например, элементу управления ListView, вызывать этот метод). Однако, цель метода updateItem заключается в том, чтобы разработчики, при указании пользовательских фабрик ячеек (опять же, например, ListView cell factory), могли переопределить метод updateItem, чтобы разрешить полную настройку ячейки.

Очень важно, чтобы подклассы Cell правильно переопределяли метод updateItem, так как несоблюдение этого может привести к проблемам, таким как пустые ячейки или ячейки с неожиданным содержимым, появляющимся внутри них. Вот пример того, как правильно переопределить метод updateItem:

 protected void updateItem(T item, boolean empty) {
     super.updateItem(item, empty);

     if (empty || item == null) {
         setText(null);
         setGraphic(null);
     } else {
         setText(item.toString());
     }
 }

Обратите внимание на два важных момента в этом примере кода:

Мы вызываем метод super.updateItem(T, boolean). Если этого не сделать, свойства item и empty не устанавливаются корректно, и у вас, вероятно, возникнут графические проблемы.
Мы проверяем условие empty, и если оно истинно, устанавливаем свойства text и graphic в значение null. Если этого не сделать, практически гарантируется, что конечные пользователи увидят графические артефакты в ячейках неожиданно.

Parameters:: item - Новый элемент для ячейки.; empty - является ли эта ячейка данными из списка. Если она пуста, то она не представляет никаких данных домена, а используется для отображения пустой строки.

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