Spec-Zone.ru › OpenJavaFX 11
Модуль javafx.controls
Пакет javafx.scene.control.cell

Класс TextFieldTableCell<S,​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.TableCell<S,​T>
                    • javafx.scene.control.cell.TextFieldTableCell<S,​T>
    • Параметры типа:
      S - Тип обобщённого типа TableView
      T - Тип элементов, содержащихся в TableColumn.
      Все реализованные интерфейсы:
      Styleable, EventTarget, Skinnable
      public class TextFieldTableCell<S,​T>
      extends TableCell<S,​T>
      Класс, содержащий реализацию TableCell, который отображает узел TextField внутри ячейки.

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

      С момента:
      JavaFX 2.2
  • Краткое описание свойств

    Свойства
    Тип Свойство Описание
    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, 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
  • Краткое описание конструкторов

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

    Все методыСтатические методыМетоды экземпляровКонкретные методы
    Модификатор и тип Метод Описание
    void cancelEdit()
    Вызовите эту функцию, чтобы перейти из состояния редактирования в состояние нередактирования, не сохраняя входные данные пользователя.
    ObjectProperty<StringConverter<T>> converterProperty()
    Свойство StringConverter.
    static <S> Callback<TableColumn<S,​String>,​TableCell<S,​String>> forTableColumn()
    Предоставляет TextField, который позволяет редактировать содержимое ячейки при двойном щелчке по ячейке или при вызове TableView.edit(int, javafx.scene.control.TableColumn).
    static <S,​T>
    Callback<TableColumn<S,​T>,​TableCell<S,​T>>
    forTableColumn​(StringConverter<T> converter)
    Предоставляет TextField, который позволяет редактировать содержимое ячейки при двойном щелчке по ячейке или при вызове TableView.edit(int, javafx.scene.control.TableColumn).
    StringConverter<T> getConverter()
    Возвращает StringConverter, используемый в этой ячейке.
    void setConverter​(StringConverter<T> value)
    Устанавливает StringConverter для использования в этой ячейке.
    void startEdit()
    Вызовите эту функцию, чтобы перейти из состояния нередактирования в состояние редактирования, если ячейка редактируема.
    void updateItem​(T item, boolean empty)
    Метод updateItem не должен вызываться разработчиками, но это лучший метод для переопределения разработчиками, чтобы позволить им настраивать визуализацию ячейки.
    • Методы, унаследованные от класса javafx.scene.control.TableCell

      commitEdit, createDefaultSkin, executeAccessibleAction, getTableColumn, getTableRow, getTableView, layoutChildren, queryAccessibleAttribute, tableColumnProperty, tableRowProperty, tableViewProperty, updateSelected, updateTableColumn, updateTableRow, updateTableView
    • Методы, унаследованные от класса javafx.scene.control.IndexedCell

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

      editableProperty, editingProperty, emptyProperty, getInitialFocusTraversable, 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, 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
  • Подробное описание свойства

    • converter

      public final ObjectProperty<StringConverter<T>> converterProperty
      Свойство StringConverter.
      Возвращает:
      свойство StringConverter
  • Подробное описание конструктора

    • TextFieldTableCell

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

      public TextFieldTableCell​(StringConverter<T> converter)
      Создает TextFieldTableCell, предоставляющий TextField при входе в режим редактирования, позволяющий редактировать содержимое ячейки. Этот метод будет работать с любым экземпляром TableColumn, независимо от его типа обобщения. Однако для этого необходимо предоставить StringConverter, который преобразует заданную строку (из того, что ввел пользователь) в экземпляр типа T. Этот элемент затем будет передан в обратный вызов TableColumn.onEditCommitProperty().
      Параметры:
      converter - converter, который может преобразовать заданную строку (из того, что ввел пользователь) в экземпляр типа T.
  • Подробное описание метода

    • forTableColumn

      public static <S> Callback<TableColumn<S,​String>,​TableCell<S,​String>> forTableColumn()
      Предоставляет TextField, который позволяет редактировать содержимое ячейки при двойном щелчке по ячейке или при вызове TableView.edit(int, javafx.scene.control.TableColumn). Этот метод будет работать только с экземплярами TableColumn типа String.
      Типы параметров:
      S - Тип обобщенного типа TableView
      Возвращает:
      Callback, который можно вставить в cell factory property TableColumn для включения текстового редактирования содержимого.
    • forTableColumn

      public static <S,​T> Callback<TableColumn<S,​T>,​TableCell<S,​T>> forTableColumn​(StringConverter<T> converter)
      Предоставляет TextField, который позволяет редактировать содержимое ячейки при двойном щелчке по ячейке или при вызове TableView.edit(int, javafx.scene.control.TableColumn). Этот метод будет работать с любым экземпляром TableColumn, независимо от его типа обобщения. Однако для этого необходимо предоставить StringConverter, который преобразует заданную строку (из того, что ввел пользователь) в экземпляр типа T. Этот элемент затем будет передан в обратный вызов TableColumn.onEditCommitProperty().
      Типы параметров:
      S - Тип обобщенного типа TableView
      T - Тип элементов, содержащихся в TableColumn
      Параметры:
      converter - StringConverter, который может преобразовать заданную строку (из того, что ввел пользователь) в экземпляр типа T.
      Возвращает:
      Callback, который можно вставить в cell factory property TableColumn для включения текстового редактирования содержимого.
    • converterProperty

      public final ObjectProperty<StringConverter<T>> converterProperty()
      Свойство StringConverter.
      Возвращает:
      свойство StringConverter
    • setConverter

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

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

      public void startEdit()
      Вызовите эту функцию, чтобы перейти из состояния без редактирования в состояние редактирования, если ячейка доступна для редактирования. Если эта ячейка уже находится в состоянии редактирования, она в нем останется.
      Переопределяет:
      startEdit в классе TableCell<S,​T>
    • cancelEdit

      public void cancelEdit()
      Вызовите эту функцию, чтобы перейти из состояния редактирования в состояние без редактирования без сохранения введенных пользователем данных.
      Переопределяет:
      cancelEdit в классе TableCell<S,​T>
    • updateItem

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