Класс CheckBoxListCell<T>

public class CheckBoxListCell<T>
extends ListCell<T>

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

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

  Тип	Свойство и описание
  ObjectProperty<StringConverter<T>>	converter Свойство StringConverter.
  ObjectProperty<Callback<T,ObservableValue<Boolean>>>	selectedStateCallback Свойство, представляющее Callback, к которому привязано отображаемое на экране свойство CheckBox.

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

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

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

  Конструктор и описание
  CheckBoxListCell() Создаёт CheckBoxListCell по умолчанию.
  CheckBoxListCell(Callback<T,ObservableValue<Boolean>> getSelectedProperty) Создаёт CheckBoxListCell по умолчанию.
  CheckBoxListCell(Callback<T,ObservableValue<Boolean>> getSelectedProperty, StringConverter<T> converter) Создаёт CheckBoxListCell с пользовательским преобразователем строк.

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

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

  Модификатор и тип	Метод и описание
  ObjectProperty<StringConverter<T>>	converterProperty() Свойство StringConverter.
  static <T> Callback<ListView<T>,ListCell<T>>	forListView(Callback<T,ObservableValue<Boolean>> getSelectedProperty) Создаёт фабрику ячеек для использования в элементах управления ListView.
  static <T> Callback<ListView<T>,ListCell<T>>	forListView(Callback<T,ObservableValue<Boolean>> getSelectedProperty, StringConverter<T> converter) Создаёт фабрику ячеек для использования в элементах управления ListView.
  StringConverter<T>	getConverter() Возвращает StringConverter, используемый в этой ячейке.
  Callback<T,ObservableValue<Boolean>>	getSelectedStateCallback() Возвращает Callback, к которому привязан отображаемый на экране CheckBox.
  ObjectProperty<Callback<T,ObservableValue<Boolean>>>	selectedStateCallbackProperty() Свойство, представляющее Callback, к которому привязано отображаемое на экране свойство CheckBox.
  void	setConverter(StringConverter<T> value) Устанавливает StringConverter для использования в этой ячейке.
  void	setSelectedStateCallback(Callback<T,ObservableValue<Boolean>> value) Устанавливает Callback, к которому привязано отображаемое на экране свойство CheckBox.
  void	updateItem(T item, boolean empty) Метод updateItem не должен вызываться разработчиками, но это лучший метод для переопределения разработчиками, чтобы позволить им настроить визуальные элементы ячейки.

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

    cancelEdit, commitEdit, createDefaultSkin, executeAccessibleAction, getListView, listViewProperty, queryAccessibleAttribute, startEdit, 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.

  • selectedStateCallback

    public final ObjectProperty<Callback<T,ObservableValue<Boolean>>> selectedStateCallbackProperty

    Свойство, представляющее Callback, привязанное к флажку CheckBox, отображаемому на экране.

    См. также:

    getSelectedStateCallback(), setSelectedStateCallback(Callback)

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

  • CheckBoxListCell

    public CheckBoxListCell()

    Создаёт стандартный CheckBoxListCell.

  • CheckBoxListCell

    public CheckBoxListCell(Callback<T,ObservableValue<Boolean>> getSelectedProperty)

    Создаёт стандартный CheckBoxListCell.

    Параметры:

    getSelectedProperty - Callback, который вернёт ObservableValue<Boolean>, исходя из элемента списка ListView.

  • CheckBoxListCell

    public CheckBoxListCell(Callback<T,ObservableValue<Boolean>> getSelectedProperty,
                            StringConverter<T> converter)

    Создаёт CheckBoxListCell с пользовательским конвертером строк.

    Параметры:

    getSelectedProperty - Callback, который вернёт ObservableValue<Boolean>, исходя из элемента списка ListView.

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

  • forListView

    public static <T> Callback<ListView<T>,ListCell<T>> forListView(Callback<T,ObservableValue<Boolean>> getSelectedProperty)

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

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

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

    Параметры:

    getSelectedProperty - Callback, который, получив объект типа T (значение из списка ListView<T>.items), вернёт ObservableValue<Boolean>, представляющее, выбран ли данный элемент. Это ObservableValue будет привязано двунаправленно (CheckBox в ячейке будет устанавливать/снимать этот флажок на основе взаимодействия пользователя, а CheckBox будет отражать состояние ObservableValue, если оно изменится внешне).

    Возвращает:

    Callback, который вернёт ListCell, способную работать с типом элементов внутри списка элементов ListView.

  • forListView

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

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

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

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

    Параметры:

    getSelectedProperty - Callback, который, получив объект типа T (значение из списка ListView<T>.items), вернёт ObservableValue<Boolean>, представляющее, выбран ли данный элемент. Это ObservableValue будет привязано двунаправленно (CheckBox в ячейке будет устанавливать/снимать этот флажок на основе взаимодействия пользователя, а CheckBox будет отражать состояние ObservableValue, если оно изменится внешне).

    Возвращает:

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

  • selectedStateCallbackProperty

    public final ObjectProperty<Callback<T,ObservableValue<Boolean>>> selectedStateCallbackProperty()

    Свойство, представляющее Callback, привязанное к флажку CheckBox, отображаемому на экране.

    См. также:

    getSelectedStateCallback(), setSelectedStateCallback(Callback)

  • setSelectedStateCallback

    public final void setSelectedStateCallback(Callback<T,ObservableValue<Boolean>> value)

    Устанавливает Callback, привязанный к флажку CheckBox, отображаемому на экране.

  • getSelectedStateCallback

    public final Callback<T,ObservableValue<Boolean>> getSelectedStateCallback()

    Возвращает Callback, привязанный к флажку CheckBox, отображаемому на экране.

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