Gtk2::E...ry::HBox(3)

💖 Gtk2::E...ry::HBox(3) — bestie edition 💖

okay so this is the Gtk2::Ex::FormFactory::HBox page from the User Contributed Perl Documentation section, and I am obsessed. let's get into it 🎀

---

✨ NAME ✨

Gtk2::Ex::FormFactory::HBox — it's literally just a HBox hanging out inside a FormFactory framework. that's the whole vibe. 💅

---

🌸 SYNOPSIS 🌸

here's how you summon one, bestie:

Gtk2::Ex::FormFactory::HBox->new (
  homogenous => Bool,
  spacing    => Integer,
  no_frame   => Bool,
  ...
  Gtk2::Ex::FormFactory::Container attributes
  Gtk2::Ex::FormFactory::Widget attributes
);

like. look at that. Bool, Integer, and a little ... for the ~mystery~. and then it just inherits the Container and Widget attributes on top because it's an icon who shares. 👑

---

🦋 DESCRIPTION 🦋

so this class implements a HBox inside a Gtk2::Ex::FormFactory framework. and here's the thing: no application object attributes are associated with a HBox. none. zero. it's giving "no thoughts, head empty, just vibes" and honestly? respect. it's a layout box, it's not here to hold your data. 💀

---

🌈 OBJECT HIERARCHY 🌈

the family tree, fr fr:

Gtk2::Ex::FormFactory::Intro

Gtk2::Ex::FormFactory::Widget
+--- Gtk2::Ex::FormFactory::Container
     +--- Gtk2::Ex::FormFactory::HBox

Gtk2::Ex::FormFactory::Layout
Gtk2::Ex::FormFactory::Rules
Gtk2::Ex::FormFactory::Context
Gtk2::Ex::FormFactory::Proxy

see that little +--- chain? that's the lineage. Widget gave birth to Container, and Container gave birth to HBox. generational slay. 🧚

---

💅 ATTRIBUTES 💅

okay so first things first, the general tea ☕: attributes are handled through the common get_ATTR(), set_ATTR() style accessors, but they are mostly passed once to the object constructor and must not be altered after the associated FormFactory was built. so like... set them and forget them, bestie. do not go back and poke them later. that is not the move. 🙈

• homogenous = BOOL [optional] — if you set it to TRUE, every single child in this HBox gets the same width. it's a convenience attribute for the homogenous property of Gtk2::Box. equal widths, equal treatment, no favoritism. ✨
• spacing = INTEGER [optional] — the number of pixels between the child widgets in this HBox. this one's a convenience attribute for the spacing property of Gtk2::Box. personal space matters!! 🫶
• no_frame = BOOL [optional] — so by default, a frame gets added to the HBox if it has a title. set no_frame to a true value to supress this. (yes, "supress", that's how it's spelled in the original and I am not about to edit a legend.) 🎀

want more attributes? go refer to Gtk2::Ex::FormFactory::Container. they got the rest of the menu. 👑

---

💜 AUTHORS 💜

shoutout to Jörn Reder — <joern at zyn dot de>. icon behavior. 🫶

---

👑 COPYRIGHT AND LICENSE 👑

Copyright 2004-2006 by Jörn Reder.

This library is free software; you can redistribute it and/or modify it under the terms of the GNU Library General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Library General Public License for more details.

You should have received a copy of the GNU Library General Public License along with this library; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307 USA.

no cap, read the license. it's right there. it's free but it's not "do whatever, I don't care" free. 💖

---

😭 POD ERRORS 😭

okay so the doc itself had some coding errors and they're explained below, bestie. not me snitching on the pod, but here we are:

Around line 101:

Non-ASCII character seen before =encoding in 'Jörn'. Assuming UTF-8

so the ö in Jörn showed up before any =encoding declaration and perl was like "assuming UTF-8 then, I guess." iconic of it honestly. 🌸

---

perl version v5.42.0, dated 2025-07-25 — that's the whole page, bestie. go build some HBoxes, you got this. 🦋✨🎀💖