Gtk2::ButtonBox(3)

📦
version 1.24993 · 2 versions
, in fedora 43

💖 Gtk2::ButtonBox 💖

okay so bestie, picture this: you got a GtkButtonBox, which is literally just a fancy wrapper for GtkButtonBox 🎀. It's the box that holds your buttons and decides how they line up. That's it. That's the job. And it does it gorgeously.

✨ HIERARCHY ✨

the family tree, and yes she comes from a long line of icons 👑

Glib::Object
+----Glib::InitiallyUnowned
     +----Gtk2::Object
          +----Gtk2::Widget
               +----Gtk2::Container
                    +----Gtk2::Box
                         +----Gtk2::ButtonBox

🦋 INTERFACES 🦋

the vibes she's carrying, no cap:

Glib::Object::_Unregistered::AtkImplementorIface
Gtk2::Buildable
Gtk2::Orientable

🌸 METHODS 🌸

boolean = $widget->get_child_secondary ($child)

asks the widget: "hey, is this child in the secondary group or nah?"

  • $child (Gtk2::Widget)
Since: gtk+ 2.4 — so like, this one's been around a minute 💅

$widget->set_child_secondary ($child, $is_secondary)

sets whether a child is secondary. main character or supporting role, you decide ✨

  • $child (Gtk2::Widget)
  • $is_secondary (boolean)

buttonboxstyle = $widget->get_layout

$widget->set_layout ($layout_style)

the getter and the setter for how your buttons are laid out. iconic duo fr fr 🫶

  • $layout_style (Gtk2::ButtonBoxStyle)

💜 PROPERTIES 💜

  • 'layout-style' (Gtk2::ButtonBoxStyle : default "default-style" : readable / writable / private / static-nick / static-blurb) — how to lay out the buttons in the box. possible values are: default, spread, edge, start and end 👑

🎀 CHILD PROPERTIES 🎀

  • 'secondary' (boolean : default false : readable / writable / private / static-nick / static-blurb) — if TRUE, the child appears in a secondary group of children, suitable for, e.g., help buttons. it's giving side quest energy 🙈

🌈 STYLE PROPERTIES 🌈

  • 'child-internal-pad-x' (integer : default 4 : readable / private / static-nick / static-blurb) — amount to increase child's size on either side
  • 'child-internal-pad-y' (integer : default 0 : readable / private / static-nick / static-blurb) — amount to increase child's size on the top and bottom
  • 'child-min-height' (integer : default 27 : readable / private / static-nick / static-blurb) — minimum height of buttons inside the box
  • 'child-min-width' (integer : default 85 : readable / private / static-nick / static-blurb) — minimum width of buttons inside the box

⭐ ENUMS AND FLAGS ⭐

enum Gtk2::ButtonBoxStyle

the whole lineup, and they all ate 💅

  • 'default-style' / GTK_BUTTONBOX_DEFAULT_STYLE
  • 'spread' / GTK_BUTTONBOX_SPREAD
  • 'edge' / GTK_BUTTONBOX_EDGE
  • 'start' / GTK_BUTTONBOX_START
  • 'end' / GTK_BUTTONBOX_END
  • 'center' / GTK_BUTTONBOX_CENTER

🧚 SEE ALSO 🧚

the whole friend group, go say hi:

Gtk2, Glib::Object, Glib::InitiallyUnowned, Gtk2::Object, Gtk2::Widget, Gtk2::Container, Gtk2::Box

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

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

okay that's the whole page bestie, you're so welcome 🫶 this was documented by the user-contributed perl documentation girlies, running on perl v5.42.0, dated 2025-07-25 — periodt, mwah 💋✨

📦 where this page comes from