Spec-Zone.ru › OpenJavaFX 11
Модуль javafx.controls
Пакет 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 может находиться в одном из трех состояний:
      • выбран: неопределенно == ложь, выбран == истина
      • не выбран: неопределенно == ложь, выбран == ложь
      • неопределенно: неопределенно == истина
      Если 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.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, 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 циклически проходить через все три состояния: выбрано, не выбрано и неопределено.
    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, 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, toString, underlineProperty, wrapTextProperty

    • Унаследованные методы от класса javafx.scene.control.Control

      computeMaxHeight, computeMaxWidth, computeMinHeight, computeMinWidth, computePrefHeight, computePrefWidth, contextMenuProperty, getBaselineOffset, getContextMenu, getCssMetaData, getInitialFocusTraversable, 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, snapPositionX, snapPositionY, snapSize, snapSizeX, snapSizeY, snapSpace, snapSpaceX, snapSpaceY, 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, 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, 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, setViewOrder, setVisible, snapshot, snapshot, startDragAndDrop, startFullDrag, styleProperty, toBack, toFront, translateXProperty, translateYProperty, translateZProperty, usesMirroring, viewOrderProperty, visibleProperty

    • Унаследованные методы от класса java.lang.Object

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

    • Унаследованные методы от интерфейса javafx.css.Styleable

      getStyleableNode

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

    • 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 - запрашиваемый атрибут
      parameters - необязательный список параметров
      Возвращает:
      значение для запрошенного атрибута
      См. также:
      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