Класс 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. Это удобно для создания древовидных структур на основе трехпозиционных чекбоксов, например, где неопределенные чекбоксы обычно означают "наследовать настройки от родителя".

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

Пример:

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

МnemonicParsing включен по умолчанию для 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, textTruncated, 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, isTextTruncated, isUnderline, isWrapText, labelPaddingProperty, lineSpacingProperty, mnemonicParsingProperty, setAlignment, setContentDisplay, setEllipsisString, setFont, setGraphic, setGraphicTextGap, setLineSpacing, setMnemonicParsing, setText, setTextAlignment, setTextFill, setTextOverrun, setUnderline, setWrapText, textAlignmentProperty, textFillProperty, textOverrunProperty, textProperty, textTruncatedProperty, 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, requestFocusTraversal, 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 в неопределённом состоянии.

См. также:

выбранный

public final BooleanProperty selectedProperty

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

См. также:

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

public final BooleanProperty allowIndeterminateProperty

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

См. также:

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

CheckBox

public CheckBox()

Создаёт CheckBox с пустой строкой в качестве метки.

CheckBox

public CheckBox(String text)

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

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

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

setIndeterminate

public final void setIndeterminate(boolean value)

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

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

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

Параметры:

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

См. также:

isIndeterminate

public final boolean isIndeterminate()

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

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

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

Возвращает:

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

См. также:

indeterminateProperty

public final BooleanProperty indeterminateProperty()

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

Возвращает:

свойство indeterminate

См. также:

setSelected

public final void setSelected(boolean value)

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

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

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

Параметры:

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

См. также:

isSelected

public final boolean isSelected()

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

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

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

Возвращает:

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

См. также:

selectedProperty

public final BooleanProperty selectedProperty()

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

Возвращает:

свойство selected

См. также:

setAllowIndeterminate

public final void setAllowIndeterminate(boolean value)

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

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

Параметры:

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

См. также:

isAllowIndeterminate

public final boolean isAllowIndeterminate()

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

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

Возвращает:

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

См. также:

allowIndeterminateProperty

public final BooleanProperty allowIndeterminateProperty()

Возвращает:

свойство allowIndeterminate

См. также:

fire

public void fire()

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