Module javafx.controls
Package javafx.scene.control

Class RadioButton

  • All Implemented Interfaces:
    Styleable, EventTarget, Skinnable, Toggle

    public class RadioButton
extends ToggleButton

    RadioButtons create a series of items where only one item can be selected. RadioButtons are a specialized ToggleButton. When a RadioButton is pressed and released a ActionEvent is sent. Your application can perform some action based on this event by implementing an EventHandler to process the ActionEvent.

    Only one RadioButton can be selected when placed in a ToggleGroup. Clicking on a selected RadioButton will have no effect. A RadioButton that is not in a ToggleGroup can be selected and unselected. By default a RadioButton is not in a ToggleGroup. Calling ToggleGroup.getSelectedToggle() will return you the RadioButton that has been selected. 

     
    ToggleGroup group = new ToggleGroup();
    RadioButton button1 = new RadioButton("select first");
    button1.setToggleGroup(group);
    button1.setSelected(true);
    RadioButton button2 = new RadioButton("select second");
    button2.setToggleGroup(group);
    Since:
    JavaFX 2.0

    • Constructor Detail

      • RadioButton

        public RadioButton​()
        Creates a radio button with an empty string for its label.

      • RadioButton

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

    • Method Detail

      • fire

        public void fire​()
        Toggles the state of the radio button if and only if the RadioButton has not already selected or is not part of a ToggleGroup.
        Overrides:
        fire in class ToggleButton

      • createDefaultSkin

        protected Skin<?> createDefaultSkin​()
        Create a new instance of the default skin for this control. This is called to create a skin for the control if no skin is provided via CSS -fx-skin or set explicitly in a sub-class with setSkin(...).
        Overrides:
        createDefaultSkin in class ToggleButton
        Returns:
        new instance of default skin for this control. If null then the control will have no skin unless one is provided by css.

      • 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_LEFT initially.
        Overrides:
        getInitialAlignment in class ToggleButton
        Returns:
        the initial alignment state of this control
        Since:
        9