Gtk2::RadioButton(3)

📦
version 1.24993 · 2 versions
, in fedora 43

💖 Gtk2::RadioButton — the manual, but make it cute

okay bestie, so this is the page for Gtk2::RadioButton(3), straight out of the User Contributed Perl Documentation (yes that's the manual name, it's giving "the people's docs" and honestly? iconic). It's the Perl wrapper for GtkRadioButton and it is so much easier than it sounds. sit with me, we're doing this together 🫶

✨ NAME ✨

Gtk2::RadioButton — it's the wrapper for GtkRadioButton, no cap.

🎀 SYNOPSIS 🎀

here's the vibe, copied exactly because code is sacred:

# 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);
}

look at that. clean. organized. main character energy fr fr 🔥

🌸 DESCRIPTION 🌸

so a single radio button on its own? lowkey does the same basic job as a Gtk2::CheckButton, which makes sense because its position in the object hierarchy reflects that (more on that in a sec). it's only when you group a bunch of radio buttons together that they level up into a whole different UI component in their own right. the way that group transforms them? obsessed. 💅

every radio button is a member of some group of radio buttons. and here's the tea: when one gets selected, all the other radio buttons in the same group get deselected. that's the whole point. a Gtk2::RadioButton is one way to let the user choose from many options — Gtk2::OptionMenu and Gtk2::ComboBox (added in gtk+ 2.4) are the alternatives if you wanna switch it up.

each constructor can take either a group, or a widget from that group, wherever the group is wanted — that's an enhancement over the C API, we love an upgrade ✨. still, the _from_widget forms are provided for completeness, so they're there if you want them.

🦋 HIERARCHY 🦋

the family tree, and yes we're respecting our elders:

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

every ancestor up there matters, bestie. don't skip your lineage 😌

🧚 INTERFACES 🧚

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

👑 METHODS 👑

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

  • $member_or_listref (scalar) — a reference to a radiobutton group, or a Gtk2::RadioButton that belongs to that group.
  • $label (string)

creates a radio button, periodt. if you pass $label, it gets interpreted as a mnemonic. and if $member_or_listref is undef? congrats, the radio button gets created in a brand new group. fresh start energy 🌈

💜 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) — a reference to a radiobutton group, or a Gtk2::RadioButton that belongs to that group.
  • $label (string)

creates a radio button with a plain text label, and this one will not be interpreted as a mnemonic. what you type is what you get, no tricks 🎀

💜 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) — a reference to a radiobutton group, or a Gtk2::RadioButton that belongs to that group.
  • $label (string)

creates a radio button with a mnemonic — and heads up, this one is literally just an alias for new. same thing, different name, iykyk.

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

  • $group (Gtk2::RadioButton or undef)
  • $label (string)

💜 arrayref = $radio_button->get_group

returns a reference to the radio group that $radio_button belongs to. important part bestie: the group is a reference to an array of widget references, and that array is not magical — meaning it will not update itself automatically if the group changes. so call get_group every single time you want to use the group. don't be lazy about it, it will not do the work for you 😭

💜 $radio_button->set_group ($member_or_listref)

  • $member_or_listref (scalar) — a reference to the group, or a Gtk2::RadioButton that belongs to that group.

assigns $radio_button to a new group. moving day! 🚚✨

🌟 PROPERTIES 🌟

  • 'group' (Gtk2::RadioButton : default undef : writable / private / static-nick / static-blurb)
    • 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 (C) 2003-2011 by the gtk2-perl team. 💖

this software is licensed under the LGPL. see Gtk2 for the full notice.

and that's the whole page, bestie, you ate that 🎀✨ this was perl v5.42.0, dated 2025-07-25, and it's Gtk2::RadioButton(3) signing off — go build something cute with your radio groups, ily 💅💜

📦 where this page comes from