Класс CheckBox

javafx.scene.control.CheckBox

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

public class CheckBox
extends ButtonBase

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

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

Если CheckBox выбран, то он по определению определён. В выбранном состоянии CheckBox, как правило, отображается с "галочкой" или "значком". CheckBox находится в таком состоянии, если selected истинно, а indeterminate ложно.

CheckBox не выбран, если selected ложно, а indeterminate ложно.

CheckBox неопределён, если indeterminate истинно, независимо от состояния selected. Обычно такое состояние отображается с тире или минусом, чтобы указать неопределённое или неопределяемое состояние CheckBox. Это удобно для построения древовидных структур с CheckBox, где неопределённые CheckBox обычно означают "наследование настроек от родителя".

Переменная allowIndeterminate, если она истинна, позволяет пользователю переключаться в неопределённое состояние. Если она ложна, CheckBox не находится в неопределённом состоянии, и пользователь может изменять только состояние checked.

Пример:

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

Обработка мнемонических обозначений включена по умолчанию для CheckBox.

С момента:: JavaFX 2.0

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

Свойства
Тип	Свойство	Описание
`BooleanProperty`	`allowIndeterminate`	Определяет, следует ли пользователю, переключающему CheckBox, циклически переходить между всеми тремя состояниями: выбранным, невыбранным и неопределённым.
`BooleanProperty`	`indeterminate`	Определяет, находится ли CheckBox в состоянии неопределённости.
`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, 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 с пустой строкой в качестве метки.
`CheckBox(String text)`	Создаёт CheckBox со указанным текстом в качестве метки.

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

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

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

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

public final BooleanProperty indeterminateProperty

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

См. также:: isIndeterminate(), setIndeterminate(boolean)

выбрано

public final BooleanProperty selectedProperty

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

См. также:: isSelected(), setSelected(boolean)

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

public final BooleanProperty allowIndeterminateProperty

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

См. также:: isAllowIndeterminate(), setAllowIndeterminate(boolean)

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

CheckBox

public CheckBox()

Создает флажок с пустой строкой в качестве метки.

CheckBox

public CheckBox(String text)

Создает флажок со значением указанного текста в качестве метки.

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

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

setIndeterminate

public final void setIndeterminate(boolean value)

Устанавливает значение свойства неопределенного.

Описание свойства:: Определяет, находится ли флажок в неопределенном состоянии.

isIndeterminate

public final boolean isIndeterminate()

Получает значение свойства неопределенного.

Описание свойства:: Определяет, находится ли флажок в неопределенном состоянии.

indeterminateProperty

public final BooleanProperty indeterminateProperty()

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

См. также:: isIndeterminate(), setIndeterminate(boolean)

setSelected

public final void setSelected(boolean value)

Устанавливает значение свойства выбранного.

Описание свойства:: Указывает, выбран ли этот флажок.

isSelected

public final boolean isSelected()

Получает значение свойства выбранного.

Описание свойства:: Указывает, выбран ли этот флажок.

selectedProperty

public final BooleanProperty selectedProperty()

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

См. также:: isSelected(), setSelected(boolean)

setAllowIndeterminate

public final void setAllowIndeterminate(boolean value)

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

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

isAllowIndeterminate

public final boolean isAllowIndeterminate()

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

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

allowIndeterminateProperty

public final BooleanProperty allowIndeterminateProperty()

См. также:: isAllowIndeterminate(), setAllowIndeterminate(boolean)

fire

public void fire()

Переключает состояние CheckBox. Если allowIndeterminate равно true, то каждое обращение к этой функции будет перемещать флажок по состояниям выбранный, не выбранный и неопределенный. Если allowIndeterminate равно false, то флажок будет циклически переключаться только между состояниями выбранный и не выбранный, и значение неопределенный будет принудительно установлено в 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.