Класс ComboBoxTableCell<S,T>

javafx.scene.control.cell.ComboBoxTableCell<S,T>

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

All Implemented Interfaces:: Styleable, EventTarget, Skinnable

public class ComboBoxTableCell<S,T> extends TableCell<S,T>

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

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

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

Since:: JavaFX 2.2

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

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

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

tableColumn, tableRow, tableView

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

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

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

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

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

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

getTableColumn, getTableRow, getTableView, tableColumnProperty, tableRowProperty, tableViewProperty, updateTableColumn, updateTableRow, updateTableView

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

См. также:

getConverter()
setConverter(StringConverter)
converterProperty()

comboBoxEditable

public final BooleanProperty comboBoxEditableProperty

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

См. также:

isComboBoxEditable()
setComboBoxEditable(boolean)
comboBoxEditableProperty()

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

ComboBoxTableCell

public ComboBoxTableCell()

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

ComboBoxTableCell

@SafeVarargs public ComboBoxTableCell(T... items)

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

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

ComboBoxTableCell

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

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

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

ComboBoxTableCell

public ComboBoxTableCell(ObservableList<T> items)

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

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

ComboBoxTableCell

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

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

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

forTableColumn

@SafeVarargs public static <S, T> Callback<TableColumn<S,T>,TableCell<S,T>> forTableColumn(T... items)

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

Параметры типа:: S — тип обобщённого типа TableView; T — тип элементов, содержащихся в TableColumn.
Параметры:: items — Нуль или более элементов, которые будут показаны пользователю при отображении меню ComboBox. Эти элементы должны быть того же типа, что и TableColumn. Разработчик должен установить event handlers для прослушивания событий редактирования в TableColumn и соответствующим образом реагировать. Методы, представляющие интерес, включают setOnEditStart, setOnEditCommit и setOnEditCancel.
Возвращает:: Callback, который вернёт TableCell, способный работать с типом элемента, содержащегося в TableColumn.

forTableColumn

@SafeVarargs public static <S, T> Callback<TableColumn<S,T>,TableCell<S,T>> forTableColumn(StringConverter<T> converter, T... items)

Параметры типа:: S — тип обобщённого типа TableView; T — тип элементов, содержащихся в TableColumn.
Параметры:: converter — StringConverter для преобразования заданного элемента (типа T) в строку для отображения пользователю.; items — Нуль или более элементов, которые будут показаны пользователю при отображении меню ComboBox. Эти элементы должны быть того же типа, что и TableColumn. Разработчик должен установить event handlers для прослушивания событий редактирования в TableColumn и соответствующим образом реагировать. Методы, представляющие интерес, включают setOnEditStart, setOnEditCommit и setOnEditCancel.
Возвращает:: Callback, который вернёт TableCell, способный работать с типом элемента, содержащегося в TableColumn.

forTableColumn

public static <S, T> Callback<TableColumn<S,T>,TableCell<S,T>> forTableColumn(ObservableList<T> items)

Параметры типа:: S — тип обобщённого типа TableView; T — тип элементов, содержащихся в TableColumn.
Параметры:: items — Нуль или более элементов, которые будут показаны пользователю при отображении меню ComboBox. Эти элементы должны быть того же типа, что и TableColumn. Разработчик должен установить event handlers для прослушивания событий редактирования в TableColumn и соответствующим образом реагировать. Методы, представляющие интерес, включают setOnEditStart, setOnEditCommit и setOnEditCancel.
Возвращает:: Callback, который вернёт TableCell, способный работать с типом элемента, содержащегося в TableColumn.

forTableColumn

public static <S, T> Callback<TableColumn<S,T>,TableCell<S,T>> forTableColumn(StringConverter<T> converter, ObservableList<T> items)

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

Type Parameters:: S - Тип дженерика TableView; T - Тип элементов, содержащихся в TableColumn.
Parameters:: converter - StringConverter для преобразования заданного элемента (типа T) в строку для отображения пользователю.; items - Ноль или более элементов, которые будут показаны пользователю, когда меню ComboBox отображается. Эти элементы должны быть того же типа, что и TableColumn. Обратите внимание, что разработчик должен установить event handlers для прослушивания событий редактирования в TableColumn и соответствующего реагирования. Методы, представляющие интерес, включают setOnEditStart, setOnEditCommit и setOnEditCancel.
Returns:: Callback, возвращающий TableCell, способный работать с типом элемента, содержащегося в TableColumn.

converterProperty

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

Свойство StringConverter.

Returns:

свойство StringConverter

See Also:

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 при отображении пользователю.

Returns:

свойство, представляющее возможность редактирования 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()

Возвращает элементы, отображаемые в ComboBox при его отображении.

Returns:: элементы, отображаемые в этом ComboBox при его отображении

updateItem

public void updateItem(T item, boolean empty)

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

Очень важно, чтобы подклассы Cell должным образом переопределяли метод 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. Если мы этого не сделаем, почти гарантированно, что конечные пользователи увидят графические артефакты в ячейках неожиданно.

Overrides:: updateItem в классе Cell<T>
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.