Класс ComboBoxListCell<T>

public class ComboBoxListCell<T>
extends ListCell<T>

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

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

  Тип	Свойство и описание
  BooleanProperty	comboBoxEditable Свойство, представляющее, является ли ComboBox редактируемым при отображении пользователю.
  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

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

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

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

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

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

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

  • comboBoxEditable

    public final BooleanProperty comboBoxEditableProperty

    Свойство, определяющее, является ли ComboBox редактируемым при отображении пользователю.

    См. также:

    isComboBoxEditable(), setComboBoxEditable(boolean)

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

  • ComboBoxListCell

    public ComboBoxListCell()

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

  • ComboBoxListCell

    @SafeVarargs
    public ComboBoxListCell(T... items)

    Создаёт стандартный экземпляр ComboBoxListCell с заданными элементами для заполнения ComboBox при отображении.

    Параметры:

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

  • ComboBoxListCell

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

    Создаёт экземпляр ComboBoxListCell с заданными элементами для заполнения ComboBox при отображении и StringConverter для преобразования элементов в удобочитаемый вид.

    Параметры:

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

  • ComboBoxListCell

    public ComboBoxListCell(ObservableList<T> items)

    Создаёт стандартный экземпляр ComboBoxListCell с заданными элементами для заполнения ComboBox при отображении.

    Параметры:

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

  • ComboBoxListCell

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

    Создаёт экземпляр ComboBoxListCell с заданными элементами для заполнения ComboBox при отображении и StringConverter для преобразования элементов в удобочитаемый вид.

    Параметры:

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

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

  • forListView

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

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

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

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

    Параметры:

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

    Возвращает:

    A Callback, возвращающий ListCell, работающий с типом элемента, содержащегося в ListView.

  • forListView

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

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

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

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

    Параметры:

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

    Возвращает:

    A Callback, возвращающий ListCell, работающий с типом элемента, содержащегося в ListView.

  • forListView

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

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

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

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

    Параметры:

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

    Возвращает:

    A Callback, возвращающий ListCell, работающий с типом элемента, содержащегося в ListView.

  • forListView

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

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

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

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

    Параметры:

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

    Возвращает:

    A 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, используемый в этой ячейке.

  • comboBoxEditableProperty

    public final BooleanProperty comboBoxEditableProperty()

    Свойство, определяющее, является ли ComboBox редактируемым при отображении пользователю.

    См. также:

    isComboBoxEditable(), setComboBoxEditable(boolean)

  • setComboBoxEditable

    public final void setComboBoxEditable(boolean value)

    Настраивает ComboBox для редактирования (чтобы разрешить ввод пользователем вне опций, предоставленных в выпадающем списке).

  • isComboBoxEditable

    public final boolean isComboBoxEditable()

    Возвращает true, если ComboBox редактируемый.

  • 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 - Новый элемент для ячейки.