Класс CheckBoxListCell<T>

javafx.scene.control.cell.CheckBoxListCell<T>

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

Все реализуемые интерфейсы:: Styleable, EventTarget, Skinnable

public class CheckBoxListCell<T>
extends ListCell<T>

Класс, содержащий реализацию ListCell, которая отрисовывает узел CheckBox внутри ячейки, необязательно с меткой, указывающей, что представляет собой этот флажок.

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

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

Обратите внимание, что CheckBoxListCell отрисовывает CheckBox 'в режиме реального времени', что означает, что CheckBox всегда интерактивен и может быть непосредственно переключён пользователем. Это означает, что не требуется, чтобы ячейка переходила в режим редактирования editing state (обычно это происходит при двойном щелчке на ячейке). Побочным эффектом этого является то, что обычные обработчики редактирования (например, on edit commit) не будут вызваны. Если вам необходимо получить уведомления об изменениях, рекомендуется напрямую наблюдать за логическими параметрами, которые изменяются CheckBox.

Since:: JavaFX 2.2
See Also:: CheckBox, ListCell

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

Свойства
Тип	Свойство	Описание
`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, viewOrder, 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.

Методы, объявленные в классе javafx.scene.control.ListCell

getListView, listViewProperty, updateListView

Методы, объявленные в классе javafx.scene.control.IndexedCell

getIndex, indexProperty, updateIndex

Методы, объявленные в классе javafx.scene.control.Cell

cancelEdit, commitEdit, editableProperty, editingProperty, emptyProperty, getInitialFocusTraversable, getItem, isEditable, isEditing, isEmpty, isItemChanged, isSelected, itemProperty, selectedProperty, setEditable, setItem, startEdit, updateItem, updateSelected

Методы, объявленные в классе 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, underlineProperty, wrapTextProperty

Методы, объявленные в классе javafx.scene.control.Control

computeMaxHeight, computeMaxWidth, computeMinHeight, computeMinWidth, contextMenuProperty, createDefaultSkin, getContextMenu, getCssMetaData, getTooltip, isResizable, setContextMenu, setTooltip, skinProperty, tooltipProperty

Методы, объявленные в классе javafx.scene.layout.Region

backgroundProperty, borderProperty, cacheShapeProperty, centerShapeProperty, computePrefHeight, computePrefWidth, 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

getBaselineOffset, getChildren, getChildrenUnmodifiable, getManagedChildren, getStylesheets, isNeedsLayout, layout, layoutChildren, 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, executeAccessibleAction, 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, 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, lookup, 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, queryAccessibleAttribute, 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, toString, translateXProperty, translateYProperty, translateZProperty, usesMirroring, viewOrderProperty, visibleProperty

Методы, объявленные в классе java.lang.Object

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

Методы, объявленные в интерфейсе javafx.scene.control.Skinnable

getSkin, setSkin

Методы, объявленные в интерфейсе javafx.css.Styleable

getStyleableNode, getStyleClass

Подробности свойств

converter

public final ObjectProperty<StringConverter<T>> converterProperty

Свойство StringConverter.

См. также:: getConverter(), setConverter(StringConverter)

selectedStateCallback

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

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

См. также:: 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.; converter - Преобразователь строк, который для объекта типа T возвращает строку, используемую для визуального представления объекта.

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

forListView

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

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

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

forListView

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

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

converterProperty

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

Свойство StringConverter.

См. также:: getConverter(), setConverter(StringConverter)

setConverter

public final void setConverter(StringConverter<T> value)

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

Параметры:: value - StringConverter

getConverter

public final StringConverter<T> getConverter()

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

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

selectedStateCallbackProperty

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

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

См. также:: getSelectedStateCallback(), setSelectedStateCallback(Callback)

setSelectedStateCallback

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

Устанавливает Callback, к которому привязана отображаемая на экране галочка.

Параметры:: value - Callback

getSelectedStateCallback

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

Возвращает Callback, к которому привязана отображаемая на экране галочка.

Возвращает:: возвращает Callback, к которому привязана отображаемая на экране галочка

© 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.