Класс ToggleButton

javafx.scene.control.ToggleButton

Все реализованные интерфейсы:: Styleable, EventTarget, Skinnable, Toggle

Прямые известные подклассы:: RadioButton

public class ToggleButton extends ButtonBase implements Toggle

Кнопка переключения — это специализированный элемент управления, который может быть выбран. Обычно кнопка переключения отображается аналогично кнопке (Button). Однако это два разных типа элементов управления. Кнопка (Button) — это кнопка «команды», которая вызывает функцию при нажатии. Кнопка переключения (ToggleButton) — это просто элемент управления с булевым значением, указывающим, выбран ли он.

Кнопки переключения также могут быть объединены в группы. По умолчанию кнопка переключения не входит в группу. Если они находятся в группе, только одна кнопка переключения в группе может быть выбрана одновременно. Чтобы поместить две кнопки переключения в одну группу, просто присвойте им одинаковое значение для ToggleGroup.

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

Пример:

 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);

Анализ мнемоники по умолчанию включен для ToggleButton.

С:: JavaFX 2.0

Резюме свойств

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

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

Резюме конструкторов

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

Резюме методов

Модификатор и тип	Метод	Описание
`void`	`fire()`	Вызывается, когда пользовательское действие указывает, что для этой кнопки переключения должно произойти событие.
`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()`	Группа переключения (Toggle Group), к которой принадлежит эта кнопка переключения.

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

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

getProperties, getUserData, setUserData

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

selected

public final BooleanProperty selectedProperty

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

Определено:

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

Возвращает:

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

См. также:

toggleGroup

public final ObjectProperty<ToggleGroup> toggleGroupProperty

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

Определено:

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

Возвращает:

свойство toggle group

См. также:

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

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

public final boolean isSelected()

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

Определено:

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

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

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

Возвращает:

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

См. также:

selectedProperty

public final BooleanProperty selectedProperty()

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

Определено:

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

Возвращает:

свойство selected

См. также:

setToggleGroup

public final void setToggleGroup(ToggleGroup value)

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

Определено:

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

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

Параметры:

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

См. также:

getToggleGroup

public final ToggleGroup getToggleGroup()

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

Определено:

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

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

Возвращает:

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

См. также:

toggleGroupProperty

public final ObjectProperty<ToggleGroup> toggleGroupProperty()

Определено:

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

Возвращает:

свойство 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.