- 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.ListCell<T>
-
- Параметры типа:
-
T- Тип элемента, содержащегося в ListCell.
- Все реализуемые интерфейсы:
-
Styleable,EventTarget,Skinnable
- Прямые известные подклассы:
-
CheckBoxListCell,ChoiceBoxListCell,ComboBoxListCell,TextFieldListCell
public class ListCell<T> extends IndexedCell<T>
Тип
Cell, используемый в экземплярахListView. В дополнение к API, определённому в Cell иIndexedCell, ListCell более тесно связан с ListView, что позволяет лучше поддерживать события редактирования и т. п.ListView сохраняет выбор, указывающий, какие ячейки выбраны, и фокус, указывающий текущий владелец фокуса для каждого данного ListView. Для каждого свойства каждая ListCell содержит булево значение, отражающее, выбрана или сфокусирована ли эта конкретная ячейка. Для этого каждая ListCell имеет ссылку на ListView, в котором она используется. Каждая ListCell принадлежит одному и только одному ListView.
Обратите внимание, что в случае виртуализированных элементов управления, таких как ListView, когда у ячейки есть фокус, это не равнозначно фокусу приложения. Когда у ListCell есть фокус, это просто означает, что ячейка получит события клавиатуры в случае, если у владеющего ListView есть фокус. Разумеется, в случае, когда у ячейки установлен узел в свойстве
graphic, вполне законно для этого узла запросить и получить фокус, как обычно ожидается.- С момента:
- JavaFX 2.0
-
Краткое описание свойств
Свойства Тип Свойство Описание ReadOnlyObjectProperty<ListView<T>>listViewСвязанный с этой ячейкой ListView.-
Наследованные свойства от класса 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, 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
-
-
Краткое описание конструкторов
Конструкторы Конструктор Описание ListCell()Создает ListCell по умолчанию со стандартным классом стиля 'list-cell'.
-
Краткое описание методов
Все методыМетоды экземпляраКонкретные методы Модификатор и тип Метод Описание voidcancelEdit()Вызовите эту функцию, чтобы перейти из состояния редактирования в состояние нередактирования, не сохраняя пользовательский ввод.voidcommitEdit(T newValue)Вызовите эту функцию, когда это необходимо (в зависимости от требований пользовательского интерфейса редактирования ячейки), чтобы сделать две вещи: Отправить соответствующие события обратно в базовому элементу управления UI (например.protected Skin<?>createDefaultSkin()Создает новый экземпляр стандартной темы для этого элемента управления.voidexecuteAccessibleAction(AccessibleAction action, Object... parameters)Этот метод вызывается технологией вспомогательных средств для запроса выполнения действия, указанного в аргументе.ListView<T>getListView()Получает значение свойства listView.ReadOnlyObjectProperty<ListView<T>>listViewProperty()Связанный с этой ячейкой ListView.ObjectqueryAccessibleAttribute(AccessibleAttribute attribute, Object... parameters)Этот метод вызывается технологией вспомогательных средств для запроса значения атрибута.voidstartEdit()Вызовите эту функцию, чтобы перейти из состояния нередактирования в состояние редактирования, если ячейка редактируема.voidupdateListView(ListView<T> listView)Обновляет связанный с этой ячейкой ListView.-
Наследованные методы от класса javafx.scene.control.IndexedCell
getIndex, indexProperty, updateIndex
-
Наследованные методы от класса javafx.scene.control.Cell
editableProperty, editingProperty, emptyProperty, getInitialFocusTraversable, getItem, isEditable, isEditing, isEmpty, isItemChanged, isSelected, itemProperty, layoutChildren, selectedProperty, setEditable, setItem, updateItem, 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, 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, snapPositionX, snapPositionY, snapSize, snapSizeX, snapSizeY, snapSpace, snapSpaceX, snapSpaceY, 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, 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, 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, setViewOrder, setVisible, snapshot, snapshot, startDragAndDrop, startFullDrag, styleProperty, toBack, toFront, translateXProperty, translateYProperty, translateZProperty, usesMirroring, viewOrderProperty, visibleProperty
-
Наследованные методы от класса java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
-
Наследованные методы от интерфейса javafx.css.Styleable
getStyleableNode
-
-
Подробное описание свойства
-
listView
public final ReadOnlyObjectProperty<ListView<T>> listViewProperty
Список ListView, связанный с этим элементом.- См. также:
getListView()
-
-
Подробное описание конструкторов
-
ListCell
public ListCell()
Создаёт ListCell по умолчанию со стилем 'list-cell'.
-
-
Подробное описание методов
-
getListView
public final ListView<T> getListView()
Получает значение свойства listView.- Описание свойства:
- Список ListView, связанный с этим элементом.
-
listViewProperty
public final ReadOnlyObjectProperty<ListView<T>> listViewProperty()
Список ListView, связанный с этим элементом.- См. также:
getListView()
-
createDefaultSkin
protected Skin<?> createDefaultSkin()
Создаёт новый экземпляр стандартной темы для этого элемента управления. Вызывается для создания темы элемента управления, если тема не задана через CSS-fx-skinили явно в подклассе сsetSkin(...).- Переопределяет:
-
createDefaultSkinв классеControl - Возвращает:
- новый экземпляр стандартной темы для этого элемента управления. Если null, то у элемента управления не будет темы, если не задана через css.
-
startEdit
public void startEdit()
Вызовите эту функцию, чтобы перейти от состояния без редактирования к состоянию редактирования, если ячейка редактируема. Если ячейка уже находится в состоянии редактирования, она останется в нём.
-
commitEdit
public void commitEdit(T newValue)
Вызовите эту функцию, когда это необходимо (в зависимости от требований пользовательского интерфейса редактирования ячейки), чтобы сделать два дела:- Запустить соответствующие события обратно к элементу управления пользовательского интерфейса (например,
ListView). Это начнёт процесс сохранения этого изменения в соответствующем источнике данных/свойства (хотя это не гарантирует, что это будет выполнено успешно — это зависит от конкретного обработчика сохранения изменений). Для получения более подробной информации обратитесь к документации класса элемента управления пользовательским интерфейсом. - Начать переход от состояния редактирования к состоянию без редактирования.
В общем случае нет необходимости переопределять этот метод в пользовательских реализациях ячеек — достаточно просто вызвать этот метод, когда это необходимо (например, когда пользователь нажимает клавишу Enter, вы можете сделать что-то вроде
cell.commitEdit(converter.fromString(textField.getText()));)- Переопределяет:
-
commitEditв классеCell<T> - Параметры:
-
newValue— значение, введённое пользователем, которое должно быть сохранено соответствующим образом с учётом источника данных, лежащего в основе пользовательского интерфейса, и обработчика сохранения изменений элемента управления пользовательским интерфейсом.
- Запустить соответствующие события обратно к элементу управления пользовательского интерфейса (например,
-
cancelEdit
public void cancelEdit()
Вызовите эту функцию, чтобы перейти от состояния редактирования к состоянию без редактирования, не сохраняя никакого пользовательского ввода.- Переопределяет:
-
cancelEditв классеCell<T>
-
updateListView
public final void updateListView(ListView<T> listView)
Обновляет список ListView, связанный с этим элементом. Примечание: эта функция предназначена для использования экспертами, в первую очередь для тех, кто реализует новые темы. Разработчикам и дизайнерам обычно не нужно обращаться к этой функции напрямую.- Параметры:
-
listView— список ListView, связанный с этим элементом
-
queryAccessibleAttribute
public Object queryAccessibleAttribute(AccessibleAttribute attribute, Object... parameters)
Этот метод вызывается технологией вспомогательных средств для запроса значения атрибута.Этот метод обычно переопределяется подклассами для реализации атрибутов, необходимых для определённой роли.
Если конкретный атрибут не обрабатывается, необходимо вызвать реализацию базового класса.- Переопределяет:
-
queryAccessibleAttributeв классеControl - Параметры:
-
attribute— запрашиваемый атрибут -
parameters— необязательный список параметров - Возвращает:
- значение запрашиваемого атрибута
- См. также:
AccessibleAttribute
-
executeAccessibleAction
public void executeAccessibleAction(AccessibleAction action, Object... parameters)
Этот метод вызывается технологией вспомогательных средств для запроса выполнения действия, указанного аргументом.Этот метод обычно переопределяется подклассами для реализации действий, необходимых для определённой роли.
Если конкретное действие не обрабатывается, необходимо вызвать реализацию базового класса.- Переопределяет:
-
executeAccessibleActionв классеControl - Параметры:
-
action— действие для выполнения -
parameters— необязательный список параметров - См. также:
AccessibleAction
-
© 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.