GtkRadioButton

A toggle button of which only one in a group may be active.

Object Hierarchy

GObject
`-- GtkObject
       `-- GtkWidget
              `-- GtkContainer
                     `-- GtkBin
                            `-- GtkButton
                                   `-- GtkToggleButton
                                          `-- GtkCheckButton
                                                 `-- GtkRadioButton

Description

A single radio button performs the same basic function as a GtkCheckButton, 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 GtkRadioButton is one way of giving the user a choice from many options.

Radio button widgets are created with new GtkRadioButton(), passing null as the argument if this is the first radio button in a group.

To retrieve the group a GtkRadioButton is assigned to, use get_group() .

To remove a GtkRadioButton from one group and make it part of a new one, use set_group() .

Constructors

GtkRadioButton ([GtkRadioButton group [, string text [, bool use_underline = true]]]);

-- Creates a new radio button.

Methods

get_group()
  Returns the group members.
group()
  DEPRECATED
set_group()
  Sets the group of the button.

Signals

"group-changed"
  A widget has been added/removed from the group.