Класс CheckBox

javafx.scene.control.CheckBox

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

public class CheckBox extends ButtonBase

Элемент управления для выбора, обычно отображаемый в виде поля с галочкой или отметкой, если выбран. Элемент CheckBox может находиться в одном из трех состояний:

выбран: неопределенный == false, выбранный == true
не выбран: неопределенный == false, выбранный == false
неопределенный: неопределенный == true

Если CheckBox выбран, то по определению он также определен. При выборе CheckBox обычно отображается отметка «галочка» или «тире». CheckBox находится в этом состоянии, если selected — true, а indeterminate — false.

CheckBox не выбран, если selected — false, а indeterminate — false.

CheckBox неопределен, если indeterminate — true, независимо от состояния selected. Типичное отображение — дефис или тире, чтобы показать неопределенное или неопределяемое состояние CheckBox. Это удобно для создания древовидных структур на основе три-состоятельных чекбоксов, например, где неопределённые чекбоксы обычно означают «наследовать настройки от родителя».

Переменная allowIndeterminate, если она true, позволяет пользователю переключаться между состояниями неопределенности. Если она false, CheckBox не находится в состоянии неопределенности, и пользователь может изменить только состояние выбранности.

Пример:

 CheckBox cb = new CheckBox("a checkbox");
 cb.setSelected(true);

MnemonicParsing включен по умолчанию для CheckBox.

С тех пор:: JavaFX 2.0

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

Тип	Свойство	Описание
`final BooleanProperty`	`allowIndeterminate`	Определяет, будет ли пользователь переключать CheckBox между всеми тремя состояниями: выбран, не выбран и неопределенный.
`final BooleanProperty`	`indeterminate`	Определяет, находится ли CheckBox в состоянии неопределенности.
`final BooleanProperty`	`selected`	Указывает, выбран ли этот CheckBox.

Свойства, объявленные в классе javafx.scene.control.ButtonBase

armed, onAction

Свойства, объявленные в классе 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, focusVisible, focusWithin, 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

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

Конструктор	Описание
`CheckBox()`	Создаёт чекбокс с пустой строкой в качестве метки.
`CheckBox(String text)`	Создаёт чекбокс с указанным текстом в качестве метки.

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

Модификатор и тип	Метод	Описание
`final BooleanProperty`	`allowIndeterminateProperty()`	Определяет, будет ли пользователь переключать CheckBox между всеми тремя состояниями: выбран, не выбран и неопределенный.
`void`	`fire()`	Переключает состояние `CheckBox`.
`final BooleanProperty`	`indeterminateProperty()`	Определяет, находится ли CheckBox в состоянии неопределенности.
`final boolean`	`isAllowIndeterminate()`	Возвращает значение свойства `allowIndeterminate`.
`final boolean`	`isIndeterminate()`	Возвращает значение свойства `indeterminate`.
`final boolean`	`isSelected()`	Возвращает значение свойства `selected`.
`final BooleanProperty`	`selectedProperty()`	Указывает, выбран ли этот CheckBox.
`final void`	`setAllowIndeterminate(boolean value)`	Устанавливает значение свойства `allowIndeterminate`.
`final void`	`setIndeterminate(boolean value)`	Устанавливает значение свойства `indeterminate`.
`final void`	`setSelected(boolean value)`	Устанавливает значение свойства `selected`.

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

arm, armedProperty, disarm, getOnAction, isArmed, onActionProperty, setOnAction

Методы, объявленные в классе 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, getInitialFocusTraversable, getSkin, getTooltip, isResizable, setContextMenu, setSkin, 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, focusVisibleProperty, focusWithinProperty, 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, isFocusVisible, isFocusWithin, 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.css.Styleable

getStyleableNode

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

неопределенное

public final BooleanProperty indeterminateProperty

Определяет, находится ли CheckBox в неопределенном состоянии.

См. также:

isIndeterminate()
setIndeterminate(boolean)
indeterminateProperty()

выбранный

public final BooleanProperty selectedProperty

Указывает, выбрано ли это поле CheckBox.

См. также:

isSelected()
setSelected(boolean)
selectedProperty()

разрешитьНеопределенное

public final BooleanProperty allowIndeterminateProperty

Определяет, должен ли пользователь, переключая CheckBox, переходить через все три состояния: выбрано, не выбрано и неопределенно. Если true, то все три состояния будут циклически проходить; если false, то будут проходить только состояния выбрано и не выбрано.

См. также:

isAllowIndeterminate()
setAllowIndeterminate(boolean)
allowIndeterminateProperty()

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

CheckBox

public CheckBox()

Создает чекбокс со строкой без текста в качестве метки.

CheckBox

public CheckBox(String text)

Создает чекбокс с заданным текстом в качестве метки.

Параметры:: text - Строка текста для метки.

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

setIndeterminate

public final void setIndeterminate(boolean value)

Устанавливает значение свойства indeterminate.

Описание свойства:

Определяет, находится ли CheckBox в неопределенном состоянии.

Параметры:

value - значение для свойства indeterminate

См. также:

isIndeterminate()
indeterminateProperty()

isIndeterminate

public final boolean isIndeterminate()

Получает значение свойства indeterminate.

Описание свойства:

Определяет, находится ли CheckBox в неопределенном состоянии.

Возвращает:

значение свойства indeterminate

См. также:

setIndeterminate(boolean)
indeterminateProperty()

indeterminateProperty

public final BooleanProperty indeterminateProperty()

Определяет, находится ли CheckBox в неопределенном состоянии.

Возвращает:

свойство indeterminate

См. также:

isIndeterminate()
setIndeterminate(boolean)

setSelected

public final void setSelected(boolean value)

Устанавливает значение свойства selected.

Описание свойства:

Указывает, выбрано ли это поле CheckBox.

Параметры:

value - значение для свойства selected

См. также:

isSelected()
selectedProperty()

isSelected

public final boolean isSelected()

Получает значение свойства selected.

Описание свойства:

Указывает, выбрано ли это поле CheckBox.

Возвращает:

значение свойства selected

См. также:

setSelected(boolean)
selectedProperty()

selectedProperty

public final BooleanProperty selectedProperty()

Указывает, выбрано ли это поле CheckBox.

Возвращает:

свойство selected

См. также:

isSelected()
setSelected(boolean)

setAllowIndeterminate

public final void setAllowIndeterminate(boolean value)

Устанавливает значение свойства allowIndeterminate.

Описание свойства:

Параметры:

value - значение для свойства allowIndeterminate

См. также:

isAllowIndeterminate()
allowIndeterminateProperty()

isAllowIndeterminate

public final boolean isAllowIndeterminate()

Получает значение свойства allowIndeterminate.

Описание свойства:

Возвращает:

значение свойства allowIndeterminate

См. также:

setAllowIndeterminate(boolean)
allowIndeterminateProperty()

allowIndeterminateProperty

public final BooleanProperty allowIndeterminateProperty()

Возвращает:

свойство allowIndeterminate

См. также:

isAllowIndeterminate()
setAllowIndeterminate(boolean)

fire

public void fire()

Переключает состояние CheckBox. Если allowIndeterminate равно true, то каждое обращение к этой функции будет переводить CheckBox через состояния выбрано, не выбрано и неопределенно. Если allowIndeterminate равно false, то CheckBox будет переходить только через состояния выбрано и не выбрано, и принудительно indeterminate будет равно false.

Определено в:: fire в классе ButtonBase

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