Spec-Zone.ru › OpenJavaFX 8
javafx.scene.control

Класс CheckBox

java.lang.Object
  • javafx.scene.Node
    • javafx.scene.Parent
      • javafx.scene.layout.Region
        • javafx.scene.control.Control
          • javafx.scene.control.Labeled
            • javafx.scene.control.ButtonBase
              • 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 обычно отображается отметка "галочка" или "чек". Элемент находится в этом состоянии, если selected = true и indeterminate = false.

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

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

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

Пример:

CheckBox cb = new CheckBox("a checkbox");
 cb.setIndeterminate(false);

Разбор мнемоники по умолчанию включён для 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, 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 циклически проходить через все три состояния: выбранный, не выбранный и неопределённый.
    protected Skin<?> createDefaultSkin()
    Создаёт новый экземпляр стандартной темы для данного элемента управления.
    void fire()
    Переключает состояние CheckBox.
    BooleanProperty indeterminateProperty()
    Определяет, находится ли CheckBox в неопределённом состоянии.
    boolean isAllowIndeterminate()
    Получает значение свойства allowIndeterminate.
    boolean isIndeterminate()
    Получает значение свойства indeterminate.
    boolean isSelected()
    Получает значение свойства selected.
    Object queryAccessibleAttribute(AccessibleAttribute attribute, Object... parameters)
    * Обработка доступности * *
    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, executeAccessibleAction, getOnAction, isArmed, onActionProperty, setOnAction
    • Наследуемые методы от класса 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
  • Подробное описание свойства

    • indeterminate

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

      См. также:

      isIndeterminate(), setIndeterminate(boolean)

    • selected

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

      См. также:

      isSelected(), setSelected(boolean)

    • allowIndeterminate

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

      См. также:

      isAllowIndeterminate(), setAllowIndeterminate(boolean)

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

    • CheckBox

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

      public CheckBox(String text)
      Создаёт поле CheckBox с указанным текстом в качестве метки.

      Параметры:

      text - Текстовая строка для метки.

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

    • setIndeterminate

      public final void setIndeterminate(boolean value)
      Устанавливает значение свойства indeterminate.

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

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

    • isIndeterminate

      public final boolean isIndeterminate()
      Получает значение свойства indeterminate.

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

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

    • indeterminateProperty

      public final BooleanProperty indeterminateProperty()
      Определяет, находится ли элемент CheckBox в неопределённом состоянии.

      См. также:

      isIndeterminate(), setIndeterminate(boolean)

    • setSelected

      public final void setSelected(boolean value)
      Устанавливает значение свойства selected.

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

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

    • isSelected

      public final boolean isSelected()
      Получает значение свойства selected.

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

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

    • selectedProperty

      public final BooleanProperty selectedProperty()
      Указывает, выбрано ли это поле CheckBox.

      См. также:

      isSelected(), setSelected(boolean)

    • setAllowIndeterminate

      public final void setAllowIndeterminate(boolean value)
      Устанавливает значение свойства allowIndeterminate.

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

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

    • isAllowIndeterminate

      public final boolean isAllowIndeterminate()
      Получает значение свойства allowIndeterminate.

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

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

    • allowIndeterminateProperty

      public final BooleanProperty allowIndeterminateProperty()
      Определяет, должен ли пользователь, переключающий CheckBox, переходить через все три состояния: выбранный, невыбранный и неопределённый. Если true, тогда все три состояния будут проходить; если false, тогда будут проходить только состояния выбранный и невыбранный.

      См. также:

      isAllowIndeterminate(), setAllowIndeterminate(boolean)

    • fire

      public void fire()
      Переключает состояние CheckBox. Если allowIndeterminate равно true, то каждый вызов этой функции переведёт CheckBox через состояния выбранный, невыбранный и неопределённый. Если allowIndeterminate равно false, тогда CheckBox будет переключаться только между выбранным и невыбранным состояниями, принудительно устанавливая indeterminate в false.

      Определено в:

      fire в классе ButtonBase

    • createDefaultSkin

      protected Skin<?> createDefaultSkin()
      Создаёт новый экземпляр стандартной темы для этого элемента управления. Вызывается для создания темы для элемента управления, если тема не предоставлена через CSS -fx-skin или явно задана в подклассе с setSkin(...).

      Переопределяет:

      createDefaultSkin в классе Control

      Возвращает:

      новый экземпляр стандартной темы для данного элемента управления. Если null, то у элемента управления не будет темы, если она не будет предоставлена через css.

    • queryAccessibleAttribute

      public Object queryAccessibleAttribute(AccessibleAttribute attribute,
                                             Object... parameters)
      * Обработка доступности * *

      Переопределяет:

      queryAccessibleAttribute в классе Control

      Параметры:

      attribute - запрашиваемый атрибут

      Возвращает:

      значение запрашиваемого атрибута

      См. также:

      AccessibleAttribute

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API