Класс TextFieldListCell<T>

public class TextFieldListCell<T>
extends ListCell<T>

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

  Все методыМетоды экземпляровКонкретные методы

  Тип	Свойство и описание
  ObjectProperty<StringConverter<T>>	converter Свойство StringConverter.

  • Свойства, унаследованные от класса javafx.scene.control.ListCell

    listView

  • Свойства, унаследованные от класса 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

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

  Конструкторы

  Конструктор и описание
  TextFieldListCell() Создаёт TextFieldListCell по умолчанию с нулевым конвертером.
  TextFieldListCell(StringConverter<T> converter) Создаёт TextFieldListCell, который предоставляет TextField при переходе в режим редактирования, что позволяет редактировать содержимое ячейки.

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

  Все методыСтатические методыМетоды экземпляровКонкретные методы

  Модификатор и тип	Метод и описание
  void	cancelEdit() Вызовите эту функцию, чтобы перейти из состояния редактирования в состояние без редактирования, не сохраняя введённый пользователем текст.
  ObjectProperty<StringConverter<T>>	converterProperty() Свойство StringConverter.
  static Callback<ListView<String>,ListCell<String>>	forListView() Предоставляет TextField, который позволяет редактировать содержимое ячейки при двойном щелчке по ячейке или при вызове ListView.edit(int).
  static <T> Callback<ListView<T>,ListCell<T>>	forListView(StringConverter<T> converter) Предоставляет TextField, который позволяет редактировать содержимое ячейки при двойном щелчке по ячейке или при вызове ListView.edit(int).
  StringConverter<T>	getConverter() Возвращает StringConverter, используемый в этой ячейке.
  void	setConverter(StringConverter<T> value) Устанавливает StringConverter для использования в этой ячейке.
  void	startEdit() Вызовите эту функцию, чтобы перейти из состояния без редактирования в состояние редактирования, если ячейка разрешает редактирование.
  void	updateItem(T item, boolean empty) Метод updateItem не должен вызываться разработчиками, но он является лучшим методом для переопределения разработчиками, чтобы позволить им настраивать визуализацию ячейки.

  • Методы, унаследованные от класса javafx.scene.control.ListCell

    commitEdit, createDefaultSkin, executeAccessibleAction, getListView, listViewProperty, queryAccessibleAttribute, updateListView

  • Методы, унаследованные от класса javafx.scene.control.IndexedCell

    getIndex, indexProperty, updateIndex

  • Методы, унаследованные от класса javafx.scene.control.Cell

    editableProperty, editingProperty, emptyProperty, getItem, isEditable, isEditing, isEmpty, isItemChanged, isSelected, itemProperty, selectedProperty, setEditable, setItem, updateSelected

  • Методы, унаследованные от класса 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, layoutChildren, 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

  • Методы, унаследованные от класса java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

• Подробное описание свойства

  • converter

    public final ObjectProperty<StringConverter<T>> converterProperty

    Свойство StringConverter.

• Подробное описание конструкторов

  • TextFieldListCell

    public TextFieldListCell()

    Создаёт стандартный TextFieldListCell с нулевым преобразователем. Без указанного StringConverter эта ячейка не сможет принимать ввод от TextField (так как не будет знать, как преобразовать это обратно в объект домена). Поэтому настоятельно рекомендуется не использовать этот конструктор, если вы не планируете установить преобразователь отдельно.

  • TextFieldListCell

    public TextFieldListCell(StringConverter<T> converter)

    Создаёт TextFieldListCell, который предоставляет TextField при переходе в режим редактирования, позволяющий редактировать содержимое ячейки. Этот метод будет работать с любым экземпляром ListView, независимо от его обобщённого типа. Однако для этого необходимо предоставить StringConverter, который преобразует заданную строку (из того, что ввёл пользователь) в экземпляр типа T. Этот элемент затем будет передан в обратный вызов ListView.onEditCommitProperty().

    Параметры:

    converter - converter, который может преобразовать заданную строку (из того, что ввёл пользователь) в экземпляр типа T.

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

  • forListView

    public static Callback<ListView<String>,ListCell<String>> forListView()

    Предоставляет TextField, который позволяет редактировать содержимое ячейки при двойном щелчке по ячейке или при вызове ListView.edit(int). Этот метод будет работать только с экземплярами ListView типа String.

    Возвращаемое значение:

    Callback, который можно вставить в cell factory property ListView, для включения текстового редактирования содержимого.

  • forListView

    public static <T> Callback<ListView<T>,ListCell<T>> forListView(StringConverter<T> converter)

    Предоставляет TextField, который позволяет редактировать содержимое ячейки при двойном щелчке по ячейке или при вызове ListView.edit(int). Этот метод будет работать с любым экземпляром ListView, независимо от его обобщённого типа. Однако для этого необходимо предоставить StringConverter, который преобразует заданную строку (из того, что ввёл пользователь) в экземпляр типа T. Этот элемент затем будет передан в обратный вызов ListView.onEditCommitProperty().

    Параметры:

    converter - StringConverter, который может преобразовать заданную строку (из того, что ввёл пользователь) в экземпляр типа T.

    Возвращаемое значение:

    Callback, который можно вставить в cell factory property ListView, для включения текстового редактирования содержимого.

  • converterProperty

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

    Свойство StringConverter.

  • setConverter

    public final void setConverter(StringConverter<T> value)

    Устанавливает StringConverter для использования в этой ячейке.

  • getConverter

    public final StringConverter<T> getConverter()

    Возвращает StringConverter, используемый в этой ячейке.

  • startEdit

    public void startEdit()

    Вызовите эту функцию, чтобы перейти из состояния без редактирования в состояние редактирования, если ячейка редактируема. Если эта ячейка уже находится в состоянии редактирования, она останется в нём.

    Переопределяет:

    startEdit в классе ListCell<T>

  • cancelEdit

    public void cancelEdit()

    Вызовите эту функцию, чтобы перейти из состояния редактирования в состояние без редактирования, не сохраняя пользовательский ввод.

    Переопределяет:

    cancelEdit в классе ListCell<T>

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

    Переопределяет:

    updateItem в классе Cell<T>

    Параметры:

    item - новый элемент для ячейки.