Gtk2::RadioButton

NAME

Gtk2::RadioButton − wrapper for GtkRadioButton

SYNOPSIS

# first group
$foo1 = Gtk2::RadioButton−>new (undef, 'Foo One');
$foo2 = Gtk2::RadioButton−>new ($foo1, 'Foo Two');
$foo3 = Gtk2::RadioButton−>new ($foo2, 'Foo Three');
# second group, using the group reference
$bar1 = Gtk2::RadioButton−>new (undef, 'Bar One');
$group = $bar1−>get_group;
$bar2 = Gtk2::RadioButton−>new ($group, 'Bar Two');
$bar3 = Gtk2::RadioButton−>new ($group, 'Bar Three');
# move bar3 from the bar group to the foo group.
$bar−>set_group ($foo−>get_group);
# iterate over the widgets in the group
$group = $foo1−>get_group;
foreach my $r (@$group) {
$r−>set_sensitive ($whatever);
}

DESCRIPTION

A single radio button performs the same basic function as a Gtk2::CheckButton, 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 Gtk2::RadioButton is one way of giving the user a choice from many options; Gtk2::OptionMenu and Gtk2::ComboBox (added in gtk+ 2.4) are alternatives.

Each constructor can take either a group or widget from that group where the group is wanted; this is an enhancement over the C API. Nevertheless, the _from_widget forms are provided for completeness.

HIERARCHY

Glib::Object
+−−−−Glib::InitiallyUnowned
+−−−−Gtk2::Object
+−−−−Gtk2::Widget
+−−−−Gtk2::Container
+−−−−Gtk2::Bin
+−−−−Gtk2::Button
+−−−−Gtk2::ToggleButton
+−−−−Gtk2::CheckButton
+−−−−Gtk2::RadioButton

INTERFACES

Glib::Object::_Unregistered::AtkImplementorIface
Gtk2::Buildable
Gtk2::Activatable

METHODS

widget = Gtk2::RadioButton−>new ($member_or_listref=undef, $label=undef)

$member_or_listref (scalar) reference to radiobutton group or a Gtk2::RadioButton belonging to that group.

$label (string)

Create a radio button. If $label is provided, it will be interpreted as a mnemonic. If $member_or_listref is undef, the radio button will be created in a new group.

widget = Gtk2::RadioButton−>new_from_widget ($group, $label=undef)

$group (Gtk2::RadioButton or undef)

$label (string)

widget = Gtk2::RadioButton−>new_with_label ($member_or_listref=undef, $label=undef)

$member_or_listref (scalar) reference to radiobutton group or a Gtk2::RadioButton belonging to that group.

$label (string)

Create a radio button with a plain text label, which will not be interpreted as a mnemonic.

widget = Gtk2::RadioButton−>new_with_label_from_widget ($group, $label=undef)

$group (Gtk2::RadioButton or undef)

$label (string)

widget = Gtk2::RadioButton−>new_with_mnemonic ($member_or_listref=undef, $label=undef)

$member_or_listref (scalar) reference to radiobutton group or a Gtk2::RadioButton belonging to that group.

$label (string)

Create a radio button with a mnemonic; this is an alias for "new".

widget = Gtk2::RadioButton−>new_with_mnemonic_from_widget ($group, $label=undef)

$group (Gtk2::RadioButton or undef)

$label (string)

arrayref = $radio_button−>get_group
Return a reference to the radio group to which $radio_button belongs. The group is a reference to an array of widget references; the array is not magical, that is, it will not be updated automatically if the group changes; call "get_group" each time you want to use the group.

$radio_button−>set_group ($member_or_listref)

$member_or_listref (scalar) reference to the group or a Gtk2::RadioButton belonging to that group.

Assign $radio_button to a new group.

PROPERTIES

’group’ (Gtk2::RadioButton : default undef : writable / private)

The radio button whose group this widget belongs to.

SIGNALS

group-changed (Gtk2::RadioButton)

SEE ALSO

Gtk2, Glib::Object, Glib::InitiallyUnowned, Gtk2::Object, Gtk2::Widget, Gtk2::Container, Gtk2::Bin, Gtk2::Button, Gtk2::ToggleButton, Gtk2::CheckButton

COPYRIGHT

Copyright (C) 2003−2011 by the gtk2−perl team.

This software is licensed under the LGPL. See Gtk2 for a full notice.