Класс ChoiceBoxTreeCell<T>
- Параметры типа:
-
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
Краткое описание свойств
| Тип | Свойство | Описание |
|---|---|---|
final ObjectProperty<StringConverter<T>> |
converter |
Свойство StringConverter. |
Свойства, объявленные в классе javafx.scene.control.TreeCell
disclosureNode, treeItem, treeView
Свойства, объявленные в классе javafx.scene.control.IndexedCell
index
Свойства, объявленные в классе 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, 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
Краткое описание полей
Поля, объявленные в классе javafx.scene.layout.Region
USE_COMPUTED_SIZE, USE_PREF_SIZE
Поля, объявленные в классе javafx.scene.Node
BASELINE_OFFSET_SAME_AS_HEIGHT
Краткое описание конструкторов
| Конструктор | Описание |
|---|---|
ChoiceBoxTreeCell() |
Создаёт по умолчанию ChoiceBoxTreeCell со списком элементов. |
ChoiceBoxTreeCell |
Создаёт экземпляр ChoiceBoxTreeCell по умолчанию, используя переданные элементы для заполнения ChoiceBox при его отображении. |
ChoiceBoxTreeCell |
Создаёт экземпляр ChoiceBoxTreeCell, используя переданные элементы для заполнения ChoiceBox при его отображении, и StringConverter для преобразования элементов в читаемый вид. |
ChoiceBoxTreeCell |
Создаёт экземпляр ChoiceBoxTreeCell, используя переданные элементы для заполнения ChoiceBox при его отображении, и StringConverter для преобразования элементов в читаемый вид. |
ChoiceBoxTreeCell |
Создаёт по умолчанию экземпляр ChoiceBoxTreeCell со списком элементов для заполнения ChoiceBox при отображении. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
final ObjectProperty<StringConverter<T>> |
converterProperty() |
Свойство StringConverter. |
static <T> Callback<TreeView<T>, |
forTreeView |
Создаёт фабрику ячеек ChoiceBox для использования в элементах управления TreeView. |
static <T> Callback<TreeView<T>, |
forTreeView |
Создаёт фабрику ячеек ChoiceBox для использования в элементах управления TreeView. |
static <T> Callback<TreeView<T>, |
forTreeView |
Создаёт фабрику ячеек ChoiceBox для использования в элементах управления TreeView. |
static <T> Callback<TreeView<T>, |
forTreeView |
Создаёт фабрику ячеек ChoiceBox для использования в элементах управления TreeView. |
final StringConverter<T> |
getConverter() |
Возвращает StringConverter, используемый в этой ячейке. |
ObservableList<T> |
getItems() |
Возвращает элементы, которые будут отображаться в ChoiceBox при отображении. |
final void |
setConverter |
Устанавливает StringConverter для использования в этой ячейке. |
void |
updateItem |
Метод 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, getSkin, getTooltip, isResizable, setContextMenu, setSkin, setTooltip, skinProperty, tooltipProperty
Методы, объявленные в классе javafx.scene.layout.Region
backgroundProperty, borderProperty, cacheShapeProperty, centerShapeProperty, computePrefHeight, computePrefWidth, getBackground, getBorder, getHeight, getInsets, getMaxHeight, getMaxWidth, getMinHeight, getMinWidth, getOpaqueInsets, getPadding, getPrefHeight, getPrefWidth, getShape, getUserAgentStylesheet, getWidth, heightProperty, insetsProperty, isCacheShape, isCenterShape, isScaleShape, isSnapToPixel, layoutInArea, layoutInArea, layoutInArea, layoutInArea, maxHeight, maxHeightProperty, maxWidth, maxWidthProperty, minHeight, minHeightProperty, minWidth, minWidthProperty, opaqueInsetsProperty, paddingProperty, positionInArea, positionInArea, prefHeight, prefHeightProperty, prefWidth, prefWidthProperty, resize, scaleShapeProperty, setBackground, setBorder, setCacheShape, setCenterShape, setHeight, setMaxHeight, setMaxSize, setMaxWidth, setMinHeight, setMinSize, setMinWidth, setOpaqueInsets, setPadding, setPrefHeight, setPrefSize, setPrefWidth, setScaleShape, setShape, setSnapToPixel, setWidth, shapeProperty, snappedBottomInset, snappedLeftInset, snappedRightInset, snappedTopInset, snapPosition, snapPositionX, snapPositionY, snapSize, snapSizeX, snapSizeY, snapSpace, snapSpaceX, snapSpaceY, snapToPixelProperty, widthProperty
Методы, объявленные в классе javafx.scene.Parent
getBaselineOffset, getChildren, getChildrenUnmodifiable, getManagedChildren, getStylesheets, isNeedsLayout, layout, layoutChildren, needsLayoutProperty, requestLayout, requestParentLayout, setNeedsLayout, updateBounds
Методы, объявленные в классе javafx.scene.Node
accessibleHelpProperty, accessibleRoleDescriptionProperty, accessibleRoleProperty, accessibleTextProperty, addEventFilter, addEventHandler, applyCss, autosize, blendModeProperty, boundsInLocalProperty, boundsInParentProperty, buildEventDispatchChain, cacheHintProperty, cacheProperty, clipProperty, computeAreaInScreen, contains, contains, cursorProperty, depthTestProperty, disabledProperty, disableProperty, effectiveNodeOrientationProperty, effectProperty, eventDispatcherProperty, executeAccessibleAction, fireEvent, focusedProperty, focusTraversableProperty, focusVisibleProperty, focusWithinProperty, getAccessibleHelp, getAccessibleRole, getAccessibleRoleDescription, getAccessibleText, getBlendMode, getBoundsInLocal, getBoundsInParent, getCacheHint, getClip, 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
Методы, объявленные в классе java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
Методы, объявленные в интерфейсе javafx.css.Styleable
getStyleableNode
Подробное описание свойств
converter
public final ObjectProperty<StringConverter<T>> converterProperty
StringConverter.Подробное описание конструкторов
ChoiceBoxTreeCell
public 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)
ChoiceBoxTreeCell с заданными элементами, которые используются для заполнения ChoiceBox при его отображении, и StringConverter, используемым для преобразования элемента в удобочитаемую форму.- Параметры:
-
converter-Callback, который может преобразовывать элемент типа T в удобочитаемую строку для отображения во всплывающем меню ChoiceBox. -
items- Элементы для отображения во всплывающем меню ChoiceBox при выборе пользователем.
Подробное описание методов
forTreeView
@SafeVarargs public static <T> Callback<TreeView<T>,TreeCell<T>> forTreeView(T... items)
TreeView. По умолчанию, ChoiceBoxCell отображается как Label при отсутствии редактирования, и как ChoiceBox при редактировании. ChoiceBox, по умолчанию, растягивается на всю ширину ячейки дерева.- Параметры типа:
-
T- Тип элементов, содержащихся в TreeView. - Параметры:
-
items- Ноль или более элементов, которые будут показаны пользователю при отображении менюChoiceBox. Эти элементы должны быть того же типа, что и TreeView<T>, чтобы при выборе они заменяли текущее значение в свойствеvalueTreeItem. - Возвращает:
- A
Callbackwhich will return a TreeCell that can work on the type of element in the TreeView.
forTreeView
public static <T> Callback<TreeView<T>,TreeCell<T>> forTreeView(ObservableList<T> items)
TreeView. По умолчанию, ChoiceBoxCell отображается как Label при отсутствии редактирования и как ChoiceBox при редактировании. По умолчанию ChoiceBox заполняет всю ячейку дерева, за исключением отступов и узлов раскрытия ячейки (т.е. стрелки).- Параметры типа:
-
T- Тип элементовTreeItem, содержащихся в TreeView. - Параметры:
-
items-ObservableListсодержащий ноль или более элементов, которые будут показаны пользователю, когда раскрыто менюChoiceBox. Эти элементы должны быть того же типа, что и у параметризованного типа TreeView, чтобы при выборе они заменяли существующее значение в редактируемом элементеTreeItem(как указано вTreeView.editingItemProperty()). - Возвращает:
- A
Callbackwhich will return a TreeCell that can work on the type of element in the TreeView.
forTreeView
@SafeVarargs public static <T> Callback<TreeView<T>,TreeCell<T>> forTreeView(StringConverter<T> converter, T... items)
TreeView. По умолчанию, ChoiceBoxCell отображается как Label при отсутствии редактирования, и как ChoiceBox при редактировании. ChoiceBox, по умолчанию, растягивается на всю ширину ячейки дерева.- Параметры типа:
-
T- Тип элементов, содержащихся в TreeView. - Параметры:
-
converter-StringConverterдля преобразования данного элемента (типа T) в строку для отображения пользователю. -
items- Ноль или более элементов, которые будут показаны пользователю при отображении менюChoiceBox. Эти элементы должны быть того же типа, что и TreeView<T>, чтобы при выборе они заменяли существующее значение в свойстве TreeItemvalue. - Возвращает:
- A
Callbackwhich will return a TreeCell that can work on the type of element in the TreeView.
forTreeView
public static <T> Callback<TreeView<T>,TreeCell<T>> forTreeView(StringConverter<T> converter, ObservableList<T> items)
TreeView. По умолчанию, ChoiceBoxCell отображается как Label при отсутствии редактирования и как ChoiceBox при редактировании. По умолчанию ChoiceBox заполняет всю ячейку дерева, за исключением отступов и узлов раскрытия ячейки (т.е. стрелки).- Параметры типа:
-
T- Тип элементов, содержащихся в TreeView. - Параметры:
-
converter-StringConverterдля преобразования заданного элемента (типа T) в строку для отображения пользователю. -
items-ObservableListсодержащий ноль или более элементов, которые будут показаны пользователю, когда раскрыто менюChoiceBox. Эти элементы должны быть того же типа, что и у параметризованного типа TreeView, чтобы при выборе они заменяли существующее значение в редактируемом элементеTreeItem(как указано вTreeView.editingItemProperty()). - Возвращает:
- A
Callbackwhich will return a TreeCell that can work on the type of element in the TreeView.
converterProperty
public final ObjectProperty<StringConverter<T>> converterProperty()
StringConverter.- Возвращает:
- свойство
StringConverter - См. также:
setConverter
public final void setConverter(StringConverter<T> value)
StringConverter, который будет использоваться в этой ячейке.- Параметры:
-
value-StringConverter, который будет использоваться в этой ячейке
getConverter
public final StringConverter<T> getConverter()
StringConverter, используемый в этой ячейке.- Возвращает:
-
StringConverter, используемый в этой ячейке
getItems
public ObservableList<T> getItems()
- Возвращает:
- элементы, которые должны отображаться в раскрывающемся списке ChoiceBox при его отображении
updateItem
public void updateItem(T item, boolean empty)
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. Если мы этого не сделаем, почти гарантированно, что конечные пользователи увидят графические артефакты в ячейках неожиданно.
- Параметры:
-
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.