Класс ChoiceBoxListCell<T>

public class ChoiceBoxListCell<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

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

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

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

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

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

  Модификатор и тип	Метод и описание
  void	cancelEdit() Вызовите эту функцию, чтобы перейти от состояния редактирования к состоянию без редактирования, не сохраняя никакого пользовательского ввода.
  ObjectProperty<StringConverter<T>>	converterProperty() Свойство StringConverter.
  static <T> Callback<ListView<T>,ListCell<T>>	forListView(ObservableList<T> items) Создаёт фабрику ячеек ChoiceBox для использования в элементах управления ListView.
  static <T> Callback<ListView<T>,ListCell<T>>	forListView(StringConverter<T> converter, ObservableList<T> items) Создаёт фабрику ячеек ChoiceBox для использования в элементах управления ListView.
  static <T> Callback<ListView<T>,ListCell<T>>	forListView(StringConverter<T> converter, T... items) Создаёт фабрику ячеек ChoiceBox для использования в элементах управления ListView.
  static <T> Callback<ListView<T>,ListCell<T>>	forListView(T... items) Создаёт фабрику ячеек ChoiceBox для использования в элементах управления ListView.
  StringConverter<T>	getConverter() Возвращает StringConverter, используемый в этой ячейке.
  ObservableList<T>	getItems() Возвращает элементы, которые должны быть отображены в ChoiceBox при его отображении.
  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.

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

  • ChoiceBoxListCell

    public ChoiceBoxListCell()

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

  • ChoiceBoxListCell

    @SafeVarargs
    public ChoiceBoxListCell(T... items)

    Создаёт стандартный экземпляр ChoiceBoxListCell с заданными элементами, которые используются для заполнения ChoiceBox при его отображении.

    Параметры:

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

  • ChoiceBoxListCell

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

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

    Параметры:

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

  • ChoiceBoxListCell

    public ChoiceBoxListCell(ObservableList<T> items)

    Создаёт стандартный экземпляр ChoiceBoxListCell с заданными элементами, которые используются для заполнения ChoiceBox при его отображении.

    Параметры:

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

  • ChoiceBoxListCell

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

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

    Параметры:

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

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

  • forListView

    @SafeVarargs
    public static <T> Callback<ListView<T>,ListCell<T>> forListView(T... items)

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

    Параметры типа:

    T - Тип элементов, содержащихся в ListView.

    Параметры:

    items - Ноль или более элементов, которые будут показаны пользователю при отображении меню ChoiceBox. Эти элементы должны быть того же типа, что и элементы списка ListView, таким образом, при выборе они заменяют текущее значение в списке items.

    Возвращает:

    Функцию-обработчик Callback, которая вернёт ListCell, способную работать с типом элемента, содержащегося в ListView.

  • forListView

    @SafeVarargs
    public static <T> Callback<ListView<T>,ListCell<T>> forListView(StringConverter<T> converter,
                                                                                  T... items)

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

    Параметры типа:

    T - Тип элементов, содержащихся в ListView.

    Параметры:

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

    Возвращает:

    Функцию-обработчик Callback, которая вернёт ListCell, способную работать с типом элемента, содержащегося в ListView.

  • forListView

    public static <T> Callback<ListView<T>,ListCell<T>> forListView(ObservableList<T> items)

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

    Параметры типа:

    T - Тип элементов, содержащихся в ListView.

    Параметры:

    items - ObservableList содержащий ноль или более элементов, которые будут отображаться пользователю при отображении меню ChoiceBox. Эти элементы должны быть того же типа, что и элементы последовательности ListView, так что при выборе они заменяют текущее значение в списке items.

    Возвращает:

    Функцию-обработчик Callback, которая вернёт ListCell, способную работать с типом элемента, содержащегося в ListView.

  • forListView

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

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

    Параметры типа:

    T - Тип элементов, содержащихся в ListView.

    Параметры:

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

    Возвращает:

    Функцию-обработчик Callback, которая вернёт ListCell, способную работать с типом элемента, содержащегося в 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, используемый в этой ячейке.

  • getItems

    public ObservableList<T> getItems()

    Возвращает элементы, которые будут отображаться в ChoiceBox при его отображении.

  • startEdit

    public void startEdit()

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

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

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

  • cancelEdit

    public void cancelEdit()

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

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

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

  • 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());
         }
     }

    Обратите внимание на два важных момента в этом примере кода:

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

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

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

    Параметры:

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