Module javafx.controls
Package javafx.scene.control

Class 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
All Implemented Interfaces:
Styleable, EventTarget, Skinnable, Toggle
Direct Known Subclasses:
RadioButton
public class ToggleButton
extends ButtonBase
implements Toggle
A ToggleButton is a specialized control which has the ability to be selected. Typically a ToggleButton is rendered similarly to a Button. However, they are two different types of Controls. A Button is a "command" button which invokes a function when clicked. A ToggleButton on the other hand is simply a control with a Boolean indicating whether it has been selected.

ToggleButton can also be placed in groups. By default, a ToggleButton is not in a group. When in groups, only one ToggleButton at a time within that group can be selected. To put two ToggleButtons in the same group, simply assign them both the same value for ToggleGroup.

Unlike RadioButtons, ToggleButtons in a ToggleGroup do not attempt to force at least one selected ToggleButton in the group. That is, if a ToggleButton is selected, clicking on it will cause it to become unselected. With RadioButton, clicking on the selected button in the group will have no effect.

Example:

 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);
Image of the ToggleButton control

MnemonicParsing is enabled by default for ToggleButton.

Since:
JavaFX 2.0

  • Constructor Details

    • ToggleButton

      public ToggleButton()
      Creates a toggle button with an empty string for its label.

    • ToggleButton

      public ToggleButton​(String text)
      Creates a toggle button with the specified text as its label.
      Parameters:
      text - A text string for its label.

    • ToggleButton

      public ToggleButton​(String text, Node graphic)
      Creates a toggle button with the specified text and icon for its label.
      Parameters:
      text - A text string for its label.
      graphic - the icon for its label.

  • Method Details

    • getInitialAlignment

      protected Pos getInitialAlignment()
      Returns the initial alignment state of this control, for use by the JavaFX CSS engine to correctly set its initial value. This method is overridden to use Pos.CENTER initially.
      Overrides:
      getInitialAlignment in class Labeled
      Returns:
      the initial alignment state of this control
      Since:
      9