Класс ToggleButton

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

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

Тип	Свойство	Описание
`final BooleanProperty`	`selected`	Указывает, выбран ли этот переключатель.
`final 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, 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

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

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

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

Модификатор и тип	Метод	Описание
`void`	`fire()`	Вызывается, когда пользовательский жест указывает на то, что для этого `ButtonBase` должно произойти событие.
`protected Pos`	`getInitialAlignment()`	Возвращает начальное состояние выравнивания этого элемента управления, для использования движком JavaFX CSS для корректной установки его начального значения.
`final ToggleGroup`	`getToggleGroup()`	Возвращает значение свойства `toggleGroup`.
`final boolean`	`isSelected()`	Возвращает значение свойства `selected`.
`final BooleanProperty`	`selectedProperty()`	Указывает, выбран ли этот переключатель.
`final void`	`setSelected(boolean value)`	Устанавливает значение свойства `selected`.
`final void`	`setToggleGroup(ToggleGroup value)`	Устанавливает значение свойства `toggleGroup`.
`final ObjectProperty<ToggleGroup>`	`toggleGroupProperty()`	`ToggleGroup`, к которому принадлежит этот `ToggleButton`.

Методы, объявленные в классе 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, 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, 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, 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

Методы, объявленные в интерфейсе javafx.scene.control.Toggle

getProperties, getUserData, setUserData

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

selected

public final BooleanProperty selectedProperty

Указывает, выбрана ли эта кнопка переключения. Это можно изменять программно.

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

selectedProperty в интерфейсе Toggle

Возвращает:

выбранное свойство

См. также:

isSelected()
setSelected(boolean)
selectedProperty()

toggleGroup

public final ObjectProperty<ToggleGroup> toggleGroupProperty

Группа ToggleGroup, к которой принадлежит эта ToggleButton. ToggleButton может принадлежать только одной группе одновременно. Если группа изменяется, то кнопка удаляется из старой группы перед добавлением в новую.

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

toggleGroupProperty в интерфейсе Toggle

Возвращает:

свойство группы переключения

См. также:

getToggleGroup()
setToggleGroup(ToggleGroup)
toggleGroupProperty()

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

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 - значение свойства selected

См. также:

isSelected()
selectedProperty()

isSelected

public final boolean isSelected()

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

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

isSelected в интерфейсе Toggle

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

Указывает, выбрана ли эта кнопка переключения. Это можно изменять программно.

Возвращает:

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

См. также:

setSelected(boolean)
selectedProperty()

selectedProperty

public final BooleanProperty selectedProperty()

Указывает, выбрана ли эта кнопка переключения. Это можно изменять программно.

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

selectedProperty в интерфейсе Toggle

Возвращает:

свойство selected

См. также:

isSelected()
setSelected(boolean)

setToggleGroup

public final void setToggleGroup(ToggleGroup value)

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

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

setToggleGroup в интерфейсе Toggle

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

Параметры:

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

См. также:

getToggleGroup()
toggleGroupProperty()

getToggleGroup

public final ToggleGroup getToggleGroup()

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

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

getToggleGroup в интерфейсе Toggle

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

Возвращает:

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

См. также:

setToggleGroup(ToggleGroup)
toggleGroupProperty()

toggleGroupProperty

public final ObjectProperty<ToggleGroup> toggleGroupProperty()

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

toggleGroupProperty в интерфейсе Toggle

Возвращает:

свойство toggleGroup

См. также:

getToggleGroup()
setToggleGroup(ToggleGroup)

fire

public void fire()

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

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

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

getInitialAlignment

protected Pos getInitialAlignment()

Возвращает начальное состояние выравнивания этого элемента управления, используемое движком JavaFX CSS для правильной установки его начального значения. Этот метод переопределён для использования Pos.CENTER по умолчанию.

Переопределяет:: getInitialAlignment в классе Labeled
Возвращает:: начальное состояние выравнивания этого элемента управления
С момента:: 9

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