gtk.RadioButton — a choice of one of multiple check buttons.
gobject.GObject+-- gtk.Object +-- gtk.Widget +-- gtk.Container +-- gtk.Bin +-- gtk.Button +-- gtk.ToggleButton +-- gtk.CheckButton +-- gtk.RadioButton
performs the same basic function as a
as it's 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
is used to give the user a choice of one of many options.
Radio button widgets are created with gtk.RadioButton() passing
None as the
group (first) argument
if this is the first radio button in a group. In subsequent calls, pass a
reference to a
as the first argument to specify the group. The second (optional) argument
to gtk.RadioButton() is a
label that is used to specify the text of the button. The label text is
parsed for mnemonic characters (preceded by an underscore) to specify an
accelerator for the radiobutton. See
for more information on mnemonic accelerators.
|an existing |
|a string to use as the button text or
|a new |
Creates a new
widget with the label text specified by
it to the same group as
label is parsed for underscore characters that
indicate mnemonic accelerators. If
None, no label is created. If
None, the new radiobutton
becomes the first member of a new radiobutton group.
In PyGTK 2.4 and above the
parameter is available and defaults to
use_underline is set to
label text will not be parsed for mnemonic characters.
|the list of radiobuttons in the same group that
contains the radiobutton or |
get_group() method returns the list
of radiobuttons that are in the same group as the radiobutton or
None if the radiobutton is not in a group.
set_group() method adds the
radiobutton to the group of the radiobutton specified by
In PyGTK 2.6.2 and above, if
None the radiobutton is removed from its current
|the radiobutton that received the signal|
|the first user parameter (if any) specified
with the |
|additional user parameters (if any)|
This signal is available in GTK+ 2.4 and above.
The "group-changed" signal is emitted when a
is added to or removed from the group.