6.2.69 radio-button

Superclass: check-button atk-implementor-iface activatable buildable

A single radio button performs the same basic function as a check-button, as its position in the object hierarchy reflects. It is only when multiple radio buttons are grouped together that they become a different user interface component in their own right.

Every radio button is a member of some group of radio buttons. When one is selected, all other radio buttons in the same group are deselected. A radio-button is one way of giving the user a choice from many options.

To group radio buttons into one group, set radio-button-group to one of the radio buttons of the group.

Slots:

• group. Type: radio-button. Accessor: radio-button-group. Write-only.

  A button of the radio button group that this radio button belongs to

Signals:

• "group-changed". Signature: (instance radio-button) => void. Options: run-first.

  Emitted when the group of radio buttons that a radio button belongs to changes. This is emitted when a radio button switches from being alone to being part of a group of 2 or more buttons, or vice-versa, and when a button is moved from one group of 2 or more buttons to a different one, but not when the composition of the group that a button belongs to changes.