Класс CheckBoxTreeTableCell<S,T>
- 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.TreeTableCell<S,T>
-
- javafx.scene.control.cell.CheckBoxTreeTableCell<S,T>
Параметры типа:
T - Тип элементов, содержащихся в TreeTableColumn.
Все реализованные интерфейсы:
public class CheckBoxTreeTableCell<S,T> extends TreeTableCell<S,T>
TreeTableCell, отображающий узел CheckBox внутри ячейки, необязательно с меткой, указывающей, что представляет собой флажок. По умолчанию CheckBoxTreeTableCell отображается с флагом, центрированным в TreeTableColumn. Если требуется метка, необходимо указать не null экземпляр StringConverter в конструкторе CheckBoxTreeTableCell(Callback, StringConverter).
Для создания экземпляра этого класса необходимо предоставить Callback, который, получив объект типа T, вернёт ObservableProperty<Boolean>, представляющий собой значение, указывающее, выбран ли данный элемент или нет. Это ObservableValue будет привязано двунаправленно (это означает, что флажок в ячейке будет устанавливать/снимать этот параметр на основе взаимодействий пользователя, а флажок будет отражать состояние ObservableValue, если оно изменится внешним образом).
Обратите внимание, что CheckBoxTreeTableCell отображает флажок «в режиме реального времени», что означает, что флажок всегда интерактивен и может быть непосредственно переключен пользователем. Это означает, что не обязательно, чтобы ячейка вошла в состояние editing state (обычно это происходит при двойном щелчке по ячейке). Побочным эффектом этого является то, что обычные обратные вызовы редактирования (например, on edit commit) не будут вызваны. Если вам нужно получить уведомления об изменениях, рекомендуется напрямую наблюдать за булевыми значениями, которые обрабатывает флажок.
С:
JavaFX 8.0
-
Краткое описание свойств
Все методыМетоды экземпляраКонкретные методы Тип Свойство и описание ObjectProperty<StringConverter<T>>converterСвойствоStringConverter.ObjectProperty<Callback<Integer,ObservableValue<Boolean>>>selectedStateCallbackСвойство, представляющееCallback, к которому привязан отображаемый на экране флажок.-
Свойства, унаследованные от класса javafx.scene.control.TreeTableCell
tableColumn, tableRow, treeTableView
-
Свойства, унаследованные от класса 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, visible
-
-
Краткое описание полей
-
Поля, унаследованные от класса javafx.scene.layout.Region
USE_COMPUTED_SIZE, USE_PREF_SIZE
-
Поля, унаследованные от класса javafx.scene.Node
BASELINE_OFFSET_SAME_AS_HEIGHT
-
-
Краткое описание конструкторов
Конструкторы Конструктор и описание CheckBoxTreeTableCell()Создаёт CheckBoxTreeTableCell по умолчанию.CheckBoxTreeTableCell(Callback<Integer,ObservableValue<Boolean>> getSelectedProperty)Создаёт CheckBoxTreeTableCell по умолчанию с пользовательскимCallbackдля получения ObservableValue для заданного индекса ячейки.CheckBoxTreeTableCell(Callback<Integer,ObservableValue<Boolean>> getSelectedProperty, StringConverter<T> converter)Создаёт CheckBoxTreeTableCell с пользовательским преобразователем строк.
-
Краткое описание методов
Все методыСтатические методыМетоды экземпляраКонкретные методы Модификатор и тип Метод и описание ObjectProperty<StringConverter<T>>converterProperty()СвойствоStringConverter.static <S,T> Callback<TreeTableColumn<S,T>,TreeTableCell<S,T>>forTreeTableColumn(Callback<Integer,ObservableValue<Boolean>> getSelectedProperty)Создаёт фабрику ячеек для использования вTreeTableColumnфабрике ячеек.static <S,T> Callback<TreeTableColumn<S,T>,TreeTableCell<S,T>>forTreeTableColumn(Callback<Integer,ObservableValue<Boolean>> getSelectedProperty, boolean showLabel)Создаёт фабрику ячеек для использования вTreeTableColumnфабрике ячеек.static <S,T> Callback<TreeTableColumn<S,T>,TreeTableCell<S,T>>forTreeTableColumn(Callback<Integer,ObservableValue<Boolean>> getSelectedProperty, StringConverter<T> converter)Создаёт фабрику ячеек для использования вTreeTableColumnфабрике ячеек.static <S> Callback<TreeTableColumn<S,Boolean>,TreeTableCell<S,Boolean>>forTreeTableColumn(TreeTableColumn<S,Boolean> column)Создаёт фабрику ячеек для использования вTreeTableColumnфабрике ячеек.StringConverter<T>getConverter()Возвращает используемый в этой ячейкеStringConverter.Callback<Integer,ObservableValue<Boolean>>getSelectedStateCallback()ВозвращаетCallback, к которому привязан отображаемый на экране флажок.ObjectProperty<Callback<Integer,ObservableValue<Boolean>>>selectedStateCallbackProperty()Свойство, представляющееCallback, к которому привязан отображаемый на экране флажок.voidsetConverter(StringConverter<T> value)Устанавливает используемый в этой ячейкеStringConverter.voidsetSelectedStateCallback(Callback<Integer,ObservableValue<Boolean>> value)УстанавливаетCallback, к которому привязан отображаемый на экране флажок.voidupdateItem(T item, boolean empty)Метод updateItem не должен вызываться разработчиками, но это лучший метод для переопределения разработчиками, чтобы они могли настроить визуальные элементы ячейки.-
Методы, унаследованные от класса javafx.scene.control.TreeTableCell
cancelEdit, commitEdit, createDefaultSkin, executeAccessibleAction, getTableColumn, getTreeTableRow, getTreeTableView, layoutChildren, queryAccessibleAttribute, startEdit, tableColumnProperty, tableRowProperty, treeTableViewProperty, updateSelected, updateTreeTableColumn, updateTreeTableRow, updateTreeTableView
-
Методы, унаследованные от класса javafx.scene.control.IndexedCell
getIndex, indexProperty, updateIndex
-
Методы, унаследованные от класса javafx.scene.control.Cell
editableProperty, editingProperty, emptyProperty, getItem, isEditable, isEditing, isEmpty, isItemChanged, isSelected, itemProperty, selectedProperty, setEditable, setItem
-
Методы, унаследованные от класса javafx.scene.control.Labeled
alignmentProperty, contentDisplayProperty, ellipsisStringProperty, fontProperty, getAlignment, getClassCssMetaData, getContentBias, getContentDisplay, getControlCssMetaData, getEllipsisString, getFont, getGraphic, getGraphicTextGap, 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, toString, underlineProperty, wrapTextProperty
-
Методы, унаследованные от класса javafx.scene.control.Control
computeMaxHeight, computeMaxWidth, computeMinHeight, computeMinWidth, computePrefHeight, computePrefWidth, contextMenuProperty, getBaselineOffset, getContextMenu, getCssMetaData, getSkin, getTooltip, isResizable, setContextMenu, setSkin, setTooltip, skinProperty, tooltipProperty
-
Методы, унаследованные от класса javafx.scene.layout.Region
backgroundProperty, borderProperty, cacheShapeProperty, centerShapeProperty, 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, snapSize, snapSpace, snapToPixelProperty, widthProperty
-
Методы, унаследованные от класса javafx.scene.Parent
getChildren, getChildrenUnmodifiable, getManagedChildren, getStylesheets, isNeedsLayout, layout, lookup, 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, fireEvent, focusedProperty, focusTraversableProperty, getAccessibleHelp, getAccessibleRole, getAccessibleRoleDescription, getAccessibleText, getBlendMode, getBoundsInLocal, getBoundsInParent, getCacheHint, getClip, getCursor, getDepthTest, getEffect, getEffectiveNodeOrientation, getEventDispatcher, getId, 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, 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, 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, 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, setVisible, snapshot, snapshot, startDragAndDrop, startFullDrag, styleProperty, toBack, toFront, translateXProperty, translateYProperty, translateZProperty, usesMirroring, visibleProperty
-
-
Подробное описание свойства
-
converter
public final ObjectProperty<StringConverter<T>> converterProperty
СвойствоStringConverter.
-
selectedStateCallback
public final ObjectProperty<Callback<Integer,ObservableValue<Boolean>>> selectedStateCallbackProperty
Свойство, представляющееCallback, привязанный к элементу CheckBox, отображаемому на экране.
-
-
Подробное описание конструктора
-
CheckBoxTreeTableCell
public CheckBoxTreeTableCell()
Создаёт стандартный CheckBoxTreeTableCell.
-
CheckBoxTreeTableCell
public CheckBoxTreeTableCell(Callback<Integer,ObservableValue<Boolean>> getSelectedProperty)
Создаёт стандартный CheckBoxTreeTableCell с пользовательскимCallbackдля получения ObservableValue для заданного индекса ячейки.Параметры:
getSelectedProperty-Callback, который вернётObservableValueдля заданного индекса из TreeTableColumn.
-
CheckBoxTreeTableCell
public CheckBoxTreeTableCell(Callback<Integer,ObservableValue<Boolean>> getSelectedProperty, StringConverter<T> converter)Создаёт CheckBoxTreeTableCell с пользовательским конвертером строк.Параметры:
getSelectedProperty-Callback, который вернётObservableValueдля заданного индекса из TreeTableColumn.
-
-
Подробное описание метода
-
forTreeTableColumn
public static <S> Callback<TreeTableColumn<S,Boolean>,TreeTableCell<S,Boolean>> forTreeTableColumn(TreeTableColumn<S,Boolean> column)
Создаёт фабрику ячеек для использования в фабрике ячеекTreeTableColumn. Данный метод требует, чтобы TreeTableColumn был типаBoolean.При использовании в TreeTableColumn, CheckBoxCell отображается с центрированным CheckBox в столбце.
ObservableValue<Boolean>, содержащаяся в каждой ячейке столбца, будет двунаправленно привязана. Это означает, что CheckBox в ячейке будет устанавливать/сбрасывать это свойство в зависимости от взаимодействия пользователя, а CheckBox будет отражать состояниеObservableValue<Boolean>, если оно изменится внешним образом.Возвращает:
Callback, который вернётTreeTableCell, способный работать с типом элемента, содержащегося в TreeTableColumn.
-
forTreeTableColumn
public static <S,T> Callback<TreeTableColumn<S,T>,TreeTableCell<S,T>> forTreeTableColumn(Callback<Integer,ObservableValue<Boolean>> getSelectedProperty)
Создаёт фабрику ячеек для использования в фабрике ячеекTreeTableColumn. Данный метод требует, чтобы TreeTableColumn был типаObservableValue<Boolean>.При использовании в TreeTableColumn, CheckBoxCell отображается с центрированным CheckBox в столбце.
Параметры типа:
T- Тип элементов, содержащихся в экземпляреTreeTableColumn.Параметры:
getSelectedProperty- Callback, который, получив объект типаTreeTableColumn<S,T>, вернётObservableValue<Boolean>, представляющий собой выбор элемента. ЭтоObservableValue<Boolean>будет двунаправленно привязано (это означает, что CheckBox в ячейке будет устанавливать/сбрасывать это свойство в зависимости от взаимодействия пользователя, а CheckBox будет отражать состояниеObservableValue<Boolean>, если оно изменится внешним образом).Возвращает:
Callback, который вернётTreeTableCell, способный работать с типом элемента, содержащегося в TreeTableColumn.
-
forTreeTableColumn
public static <S,T> Callback<TreeTableColumn<S,T>,TreeTableCell<S,T>> forTreeTableColumn(Callback<Integer,ObservableValue<Boolean>> getSelectedProperty, boolean showLabel)Создаёт фабрику ячеек для использования в фабрике ячеекTreeTableColumn. Данный метод требует, чтобы TreeTableColumn был типаObservableValue<Boolean>.При использовании в TreeTableColumn, CheckBoxCell отображается с центрированным CheckBox в столбце.
Параметры типа:
T- Тип элементов, содержащихся в экземпляреTreeTableColumn.Параметры:
getSelectedProperty- Callback, который, получив объект типаTreeTableColumn<S,T>, вернётObservableValue<Boolean>, представляющий собой выбор элемента. ЭтоObservableValue<Boolean>будет двунаправленно привязано (это означает, что CheckBox в ячейке будет устанавливать/сбрасывать это свойство в зависимости от взаимодействия пользователя, а CheckBox будет отражать состояниеObservableValue<Boolean>, если оно изменится внешним образом).Возвращает:
Callback, который вернётTreeTableCell, способный работать с типом элемента, содержащегося в TreeTableColumn.
-
forTreeTableColumn
public static <S,T> Callback<TreeTableColumn<S,T>,TreeTableCell<S,T>> forTreeTableColumn(Callback<Integer,ObservableValue<Boolean>> getSelectedProperty, StringConverter<T> converter)Создаёт фабрику ячеек для использования в фабрике ячеекTreeTableColumn. Данный метод требует, чтобы TreeTableColumn был типаObservableValue<Boolean>.При использовании в TreeTableColumn, CheckBoxCell отображается с центрированным CheckBox в столбце.
Параметры типа:
T- Тип элементов, содержащихся в экземпляреTreeTableColumn.Параметры:
getSelectedProperty- Callback, который, получив объект типаTreeTableColumn<S,T>, вернётObservableValue<Boolean>, представляющий собой выбор элемента. ЭтоObservableValue<Boolean>будет двунаправленно привязано (это означает, что CheckBox в ячейке будет устанавливать/сбрасывать это свойство в зависимости от взаимодействия пользователя, а CheckBox будет отражать состояниеObservableValue<Boolean>, если оно изменится внешним образом).Возвращает:
Callback, который вернётTreeTableCell, способный работать с типом элемента, содержащегося в TreeTableColumn.
-
converterProperty
public final ObjectProperty<StringConverter<T>> converterProperty()
СвойствоStringConverter.
-
setConverter
public final void setConverter(StringConverter<T> value)
УстанавливаетStringConverter, используемый в этой ячейке.
-
getConverter
public final StringConverter<T> getConverter()
ВозвращаетStringConverter, используемый в этой ячейке.
-
selectedStateCallbackProperty
public final ObjectProperty<Callback<Integer,ObservableValue<Boolean>>> selectedStateCallbackProperty()
Свойство, представляющееCallback, привязанный к элементу CheckBox, отображаемому на экране.
-
setSelectedStateCallback
public final void setSelectedStateCallback(Callback<Integer,ObservableValue<Boolean>> value)
УстанавливаетCallback, привязанный к элементу CheckBox, отображаемому на экране.
-
getSelectedStateCallback
public final Callback<Integer,ObservableValue<Boolean>> getSelectedStateCallback()
ВозвращаетCallback, привязанный к элементу CheckBox, отображаемому на экране.
-
updateItem
public void updateItem(T item, boolean empty)Метод updateItem не должен вызываться разработчиками, но это лучший метод для переопределения, позволяющий настроить визуальные элементы ячейки. Для пояснения, разработчики никогда не должны вызывать этот метод в своём коде (они должны предоставить его управлению UI, например, элементу управленияListView), чтобы вызвать этот метод. Однако цель метода updateItem состоит в том, чтобы разработчики при указании пользовательских фабрик ячеек (опять же, как ListViewcell 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. Если мы этого не сделаем, почти гарантировано, что конечные пользователи увидят графические артефакты в ячейках непредвиденным образом.
Переопределяет:
updateItemв классеCell<T>Параметры:
item- Новый элемент для ячейки.
-
© 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.