Spec-Zone.ru › OpenJavaFX 17

Класс ComboBoxTreeCell<T>

java.lang.Object
javafx.scene.Node
javafx.scene.Parent
javafx.scene.layout.Region
javafx.scene.control.Control
javafx.scene.control.Labeled
javafx.scene.control.Cell<T>
javafx.scene.control.IndexedCell<T>
javafx.scene.control.TreeCell<T>
javafx.scene.control.cell.ComboBoxTreeCell<T>
Type Parameters:
T - Тип TreeItems, содержащихся в TreeView.
All Implemented Interfaces:
Styleable, EventTarget, Skinnable
public class ComboBoxTreeCell<T>
extends TreeCell<T>
Класс, содержащий реализацию TreeCell, которая отображает узел ComboBox внутри ячейки.

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

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

Since:
JavaFX 2.2

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

Свойства
Тип Свойство Описание
BooleanProperty comboBoxEditable
Свойство, определяющее, является ли ComboBox, отображаемый пользователю, редактируемым.
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

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

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

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

Модификатор и тип Метод Описание
BooleanProperty comboBoxEditableProperty()
Свойство, определяющее, является ли ComboBox редактируемым при отображении пользователю.
ObjectProperty<StringConverter<T>> converterProperty()
Свойство StringConverter.
static <T> Callback<TreeView<T>,​TreeCell<T>> forTreeView​(ObservableList<T> items)
Создает фабрику ячеек ComboBox для использования в элементах управления TreeView.
static <T> Callback<TreeView<T>,​TreeCell<T>> forTreeView​(StringConverter<T> converter, ObservableList<T> items)
Создает фабрику ячеек ComboBox для использования в элементах управления TreeView.
static <T> Callback<TreeView<T>,​TreeCell<T>> forTreeView​(StringConverter<T> converter, T... items)
Создает фабрику ячеек ComboBox для использования в элементах управления TreeView.
static <T> Callback<TreeView<T>,​TreeCell<T>> forTreeView​(T... items)
Создает фабрику ячеек ComboBox для использования в элементах управления TreeView.
StringConverter<T> getConverter()
Возвращает StringConverter, используемый в этой ячейке.
ObservableList<T> getItems()
Возвращает элементы, отображаемые в ComboBox при его отображении.
boolean isComboBoxEditable()
Возвращает true, если ComboBox редактируемый.
void setComboBoxEditable​(boolean value)
Настраивает ComboBox для редактирования (чтобы разрешить ввод пользователем вне опций, предоставляемых в раскрывающемся списке).
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)

comboBoxEditable

public final BooleanProperty comboBoxEditableProperty
Свойство, определяющее, является ли ComboBox редактируемым при отображении пользователю.
См. также:
isComboBoxEditable(), setComboBoxEditable(boolean)

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

ComboBoxTreeCell

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

ComboBoxTreeCell

@SafeVarargs public ComboBoxTreeCell(T... items)
Создаёт экземпляр ComboBoxTreeCell по умолчанию с заданными элементами для заполнения ComboBox при отображении.
Параметры:
items - Элементы для отображения в всплывающем меню ComboBox при выборе пользователем.

ComboBoxTreeCell

@SafeVarargs public ComboBoxTreeCell(StringConverter<T> converter, T... items)
Создаёт экземпляр ComboBoxTreeCell с заданными элементами для заполнения ComboBox при отображении и StringConverter для преобразования элемента в читаемую пользователем форму.
Параметры:
converter - StringConverter, преобразующий элемент типа T в строку, отображаемую пользователю во всплывающем меню ComboBox.
items - Элементы для отображения во всплывающем меню ComboBox при выборе пользователем.

ComboBoxTreeCell

public ComboBoxTreeCell(ObservableList<T> items)
Создаёт экземпляр ComboBoxTreeCell по умолчанию с заданными элементами для заполнения ComboBox при отображении.
Параметры:
items - Элементы для отображения во всплывающем меню ComboBox при выборе пользователем.

ComboBoxTreeCell

public ComboBoxTreeCell(StringConverter<T> converter, ObservableList<T> items)
Создаёт экземпляр ComboBoxTreeCell с заданными элементами для заполнения ComboBox при отображении и StringConverter для преобразования элемента в читаемую пользователем форму.
Параметры:
converter - StringConverter, преобразующий элемент типа T в строку, отображаемую пользователю во всплывающем меню ComboBox.
items - Элементы для отображения во всплывающем меню ComboBox при выборе пользователем.

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

forTreeView

@SafeVarargs public static <T> Callback<TreeView<T>,TreeCell<T>> forTreeView​(T... items)
Создаёт фабрику ячеек ComboBox для использования в элементах управления TreeView. По умолчанию ComboBoxCell отображается как Label при отсутствии редактирования и как ComboBox в режиме редактирования. По умолчанию ComboBox заполняет всю ячейку дерева.
Параметры типа:
T - Тип элементов, содержащихся в TreeView.
Параметры:
items - Ноль или более элементов, которые будут отображаться пользователю при отображении меню ComboBox. Эти элементы должны быть того же типа, что и TreeView<T>, так что при выборе они заменяют существующее значение в свойстве TreeItem value.
Возвращает:
Callback, возвращающий ячейку дерева, способную работать с типом элемента, содержащегося в TreeView.

forTreeView

public static <T> Callback<TreeView<T>,TreeCell<T>> forTreeView​(ObservableList<T> items)
Создаёт фабрику ячеек ComboBox для использования в элементах управления TreeView. По умолчанию ComboBoxCell отображается как Label при отсутствии редактирования и как ComboBox в режиме редактирования. По умолчанию ComboBox занимает всю ширину ячейки дерева, за исключением отступов для ячейки дерева и узла раскрытия (т.е. стрелки).
Параметры типа:
T - Тип элементов TreeItem, содержащихся в TreeView.
Параметры:
items - ObservableList, содержащий ноль или более элементов, которые будут отображаться пользователю при отображении меню ComboBox. Эти элементы должны быть того же типа, что и у параметра дженерика TreeView, так что при выборе они заменяют существующее значение в TreeItem который редактируется (как указано в TreeView.editingItemProperty().
Возвращает:
Callback, возвращающий ячейку дерева, способную работать с типом элемента, содержащегося в TreeView.

forTreeView

@SafeVarargs public static <T> Callback<TreeView<T>,TreeCell<T>> forTreeView​(StringConverter<T> converter, T... items)
Создаёт фабрику ячеек ComboBox для использования в элементах управления TreeView. По умолчанию ComboBoxCell отображается как Label при отсутствии редактирования и как ComboBox в режиме редактирования. По умолчанию ComboBox заполняет всю ширину ячейки дерева.
Параметры типа:
T - Тип элементов, содержащихся в TreeView.
Параметры:
converter - StringConverter для преобразования данного элемента (типа T) в строку для отображения пользователю.
items - Ноль или более элементов, которые будут отображаться пользователю при отображении меню ComboBox. Эти элементы должны быть того же типа, что и TreeView<T>, так что при выборе они заменяют существующее значение в свойстве TreeItem value.
Возвращает:
Callback, возвращающий ячейку дерева, способную работать с типом элемента, содержащегося в TreeView.

forTreeView

public static <T> Callback<TreeView<T>,TreeCell<T>> forTreeView​(StringConverter<T> converter, ObservableList<T> items)
Создаёт фабрику ячеек ComboBox для использования в элементах управления TreeView. По умолчанию ComboBoxCell отображается как Label при отсутствии редактирования и как ComboBox в режиме редактирования. По умолчанию ComboBox занимает всю ширину ячейки дерева.
Параметры типа:
T - Тип элементов, содержащихся в TreeView.
Параметры:
converter - StringConverter для преобразования данного элемента (типа T) в строку для отображения пользователю.
items - ObservableList, содержащий ноль или более элементов, которые будут отображаться пользователю при отображении меню ComboBox. Эти элементы должны быть того же типа, что и у параметра дженерика TreeView, так что при выборе они заменяют существующее значение в TreeItem который редактируется (как указано в TreeView.editingItemProperty().
Возвращает:
Callback, возвращающий ячейку дерева, способную работать с типом элемента, содержащегося в TreeView.

converterProperty

public final ObjectProperty<StringConverter<T>> converterProperty()
Свойство StringConverter.
См. также:
getConverter(), setConverter(StringConverter)

setConverter

public final void setConverter(StringConverter<T> value)
Устанавливает StringConverter для использования в этой ячейке.
Параметры:
value - StringConverter для использования в этой ячейке

getConverter

public final StringConverter<T> getConverter()
Возвращает StringConverter, используемый в этой ячейке.
Возвращает:
StringConverter, используемый в этой ячейке

comboBoxEditableProperty

public final BooleanProperty comboBoxEditableProperty()
Свойство, определяющее, является ли ComboBox редактируемым при отображении пользователю.
См. также:
isComboBoxEditable(), setComboBoxEditable(boolean)

setComboBoxEditable

public final void setComboBoxEditable(boolean value)
Настраивает ComboBox как редактируемый (разрешая ввод пользователем данных за пределами списка опций выпадающего списка).
Параметры:
value - значение редактируемости, устанавливаемое для этого ComboBox

isComboBoxEditable

public final boolean isComboBoxEditable()
Возвращает true, если ComboBox редактируемый.
Возвращает:
true, если ComboBox редактируемый

getItems

public ObservableList<T> getItems()
Возвращает элементы, отображаемые в ComboBox при его отображении.
Возвращает:
элементы, отображаемые в этом ComboBox при отображении

updateItem

public void updateItem(T item, boolean empty)
Метод updateItem не должен вызываться разработчиками, но является лучшим методом для переопределения разработчиками, чтобы настроить визуализацию ячейки. Для уточнения, разработчики никогда не должны вызывать этот метод в своем коде (они должны оставить его на усмотрение UI-контроллера, такого как контроллер 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());
     }
 }
 

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

  1. Мы вызываем супер.updateItem(T, boolean) метод. Если этого не сделать, свойства элемента и пустого состояния не установятся правильно, и у вас, вероятно, возникнут графические проблемы.
  2. Мы проверяем условие empty, и если оно истинно, устанавливаем свойства текста и графики в 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.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API