Spec-Zone.ru › OpenJavaFX 11
Модуль javafx.controls
Пакет javafx.scene.control

Класс ToggleButton

  • 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.ToggleButton
    • Все реализованные интерфейсы:
      Styleable, EventTarget, Skinnable, Toggle
      Непосредственные подклассы:
      RadioButton
      public class ToggleButton
extends ButtonBase
implements Toggle
      ToggleButton — это специализированный элемент управления, который может быть выбран. Обычно ToggleButton отображается аналогично кнопке. Однако это два разных типа элементов управления. Кнопка — это кнопка «команды», которая вызывает функцию при нажатии. ToggleButton, с другой стороны, — это просто элемент управления с логическим значением, указывающим, выбран ли он.

      ToggleButton также может быть размещён в группах. По умолчанию ToggleButton не входит в группу. При группировке только один ToggleButton в группе может быть выбран одновременно. Чтобы поместить два ToggleButtons в одну группу, просто назначьте им одинаковое значение для ToggleGroup.

      В отличие от RadioButtons, ToggleButtons в ToggleGroup не пытаются принудительно выбрать хотя бы один выбранный ToggleButton в группе. То есть, если ToggleButton выбран, нажатие на него приведет к его отмене. С RadioButton нажатие на выбранную кнопку в группе не повлияет на выбор.

      Пример:

      
 ToggleButton tb1 = new ToggleButton("toggle button 1");
 ToggleButton tb2 = new ToggleButton("toggle button 2");
 ToggleButton tb3 = new ToggleButton("toggle button 3");
 ToggleGroup group = new ToggleGroup();
 tb1.setToggleGroup(group);
 tb2.setToggleGroup(group);
 tb3.setToggleGroup(group);

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

      С тех пор:
      JavaFX 2.0

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

    Свойства
    Тип Свойство Описание
    BooleanProperty selected
    Указывает, выбрана ли эта кнопка переключения.
    ObjectProperty<ToggleGroup> toggleGroup
    Группа ToggleGroup, к которой принадлежит эта ToggleButton.

    • Наследованные свойства от класса 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

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

    Конструкторы
    Конструктор Описание
    ToggleButton()
    Создаёт кнопку переключения с пустой строкой в качестве метки.
    ToggleButton​(String text)
    Создаёт кнопку переключения с указанным текстом в качестве метки.
    ToggleButton​(String text, Node graphic)
    Создаёт кнопку переключения с указанным текстом и иконкой в качестве метки.

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

    Все методыМетоды экземпляраКонкретные методы
    Модификатор и тип Метод Описание
    protected Skin<?> createDefaultSkin()
    Создаёт новый экземпляр стандартной темы для данного элемента управления.
    void fire()
    Вызывается, когда пользовательский жест указывает, что для этого ButtonBase должен произойти событие.
    protected Pos getInitialAlignment()
    Возвращает начальное состояние выравнивания этого элемента управления, для использования движком JavaFX CSS для правильной установки его начального значения.
    ToggleGroup getToggleGroup()
    Получает значение свойства toggleGroup.
    boolean isSelected()
    Получает значение свойства selected.
    Object queryAccessibleAttribute​(AccessibleAttribute attribute, Object... parameters)
    Этот метод вызывается средствами вспомогательной технологии для запроса значения атрибута.
    BooleanProperty selectedProperty()
    Указывает, выбрана ли эта кнопка переключения.
    void setSelected​(boolean value)
    Устанавливает значение свойства selected.
    void setToggleGroup​(ToggleGroup value)
    Устанавливает значение свойства toggleGroup.
    ObjectProperty<ToggleGroup> toggleGroupProperty()
    Группа ToggleGroup, к которой принадлежит эта ToggleButton.

    • Наследованные методы от класса 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, 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

    • Наследованные методы от интерфейса javafx.scene.control.Toggle

      getProperties, getUserData, setUserData

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

    • selected

      public final BooleanProperty selectedProperty
      Указывает, выбрана ли эта кнопка переключения. Это можно изменить программно.
      Определено:
      selectedProperty в интерфейсе Toggle
      См. также:
      isSelected(), setSelected(boolean)

    • toggleGroup

      public final ObjectProperty<ToggleGroup> toggleGroupProperty
      Группа ToggleGroup, к которой принадлежит эта ToggleButton. Одна ToggleButton может принадлежать только одной группе в любое время. Если группа изменена, кнопка удаляется из старой группы перед добавлением в новую.
      Определено:
      toggleGroupProperty в интерфейсе Toggle
      См. также:
      getToggleGroup(), setToggleGroup(ToggleGroup)

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

    • ToggleButton

      public ToggleButton()
      Создает кнопку переключения с пустой строкой в качестве метки.

    • ToggleButton

      public ToggleButton​(String text)
      Создаёт кнопку переключения с указанным текстом в качестве метки.
      Параметры:
      text - Строка текста для метки.

    • ToggleButton

      public ToggleButton​(String text,
                    Node graphic)
      Создаёт кнопку переключения с указанным текстом и иконкой для метки.
      Параметры:
      text - Строка текста для метки.
      graphic - иконка для метки.

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

    • setSelected

      public final void setSelected​(boolean value)
      Устанавливает значение свойства selected.
      Определено:
      setSelected в интерфейсе Toggle
      Описание свойства:
      Указывает, выбрана ли эта кнопка переключения. Это можно изменить программно.
      Параметры:
      value - true, чтобы сделать эту Toggle выбранной.

    • isSelected

      public final boolean isSelected()
      Возвращает значение свойства selected.
      Определено:
      isSelected в интерфейсе Toggle
      Описание свойства:
      Указывает, выбрана ли эта кнопка переключения. Это можно изменить программно.
      Возвращает:
      true, если эта Toggle выбрана.

    • selectedProperty

      public final BooleanProperty selectedProperty()
      Указывает, выбрана ли эта кнопка переключения. Это можно изменить программно.
      Определено:
      selectedProperty в интерфейсе Toggle
      См. также:
      isSelected(), setSelected(boolean)

    • setToggleGroup

      public final void setToggleGroup​(ToggleGroup value)
      Устанавливает значение свойства toggleGroup.
      Определено:
      setToggleGroup в интерфейсе Toggle
      Описание свойства:
      Группа ToggleGroup, к которой принадлежит эта ToggleButton. Одна ToggleButton может принадлежать только одной группе в любое время. Если группа изменена, кнопка удаляется из старой группы перед добавлением в новую.
      Параметры:
      value - Новая ToggleGroup.

    • getToggleGroup

      public final ToggleGroup getToggleGroup()
      Возвращает значение свойства toggleGroup.
      Определено:
      getToggleGroup в интерфейсе Toggle
      Описание свойства:
      Группа ToggleGroup, к которой принадлежит эта ToggleButton. Одна ToggleButton может принадлежать только одной группе в любое время. Если группа изменена, кнопка удаляется из старой группы перед добавлением в новую.
      Возвращает:
      Группа ToggleGroup, к которой принадлежит эта Toggle.

    • toggleGroupProperty

      public final ObjectProperty<ToggleGroup> toggleGroupProperty()
      Группа ToggleGroup, к которой принадлежит эта ToggleButton. Одна ToggleButton может принадлежать только одной группе в любое время. Если группа изменена, кнопка удаляется из старой группы перед добавлением в новую.
      Определено:
      toggleGroupProperty в интерфейсе Toggle
      См. также:
      getToggleGroup(), setToggleGroup(ToggleGroup)

    • fire

      public void fire()
      Вызывается, когда пользовательское действие указывает, что для этой ButtonBase должно произойти событие.

      Если вызывается, этот метод будет выполнен независимо от состояния ButtonBase.arm().

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

    • createDefaultSkin

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

    • getInitialAlignment

      protected Pos getInitialAlignment()
      Возвращает начальное состояние выравнивания этого элемента управления, для использования движком JavaFX CSS для правильной установки его начального значения. Этот метод переопределяется для начального использования Pos.CENTER.
      Переопределяет:
      getInitialAlignment в классе Labeled
      Возвращает:
      начальное состояние выравнивания этого элемента управления
      С:
      9

    • 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