ToggleButton (JavaFX 8) (original) (raw)

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, aToggleButton is not in a group. When in groups, only oneToggleButton at a time within that group can be selected. To put twoToggleButtons in the same group, simply assign them both the same value for ToggleGroup.

Unlike RadioButtons, ToggleButtons in aToggleGroup do not attempt to force at least one selectedToggleButton in the group. That is, if a ToggleButton is selected, clicking on it will cause it to become unselected. WithRadioButton, 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);