Gtk2::Builder(3)

💖 Gtk2::Builder — the wrapper for GtkBuilder 💖

okay bestie, so this is Gtk2::Builder, a wrapper for GtkBuilder — it's the little glue layer in gtk2-perl that lets you build your whole UI from a description file instead of typing out a million widget constructors by hand. it's giving automation queen. ✨

---

🌸 HIERARCHY 🌸

  Glib::Object
  +----Gtk2::Builder

so it's a Glib::Object at heart, and Builder is its direct glow-up child. 💅

---

✨ METHODS ✨

• builder = Gtk2::Builder->new — make a fresh Builder. no args, just vibes. 🎀
• integer = $builder->add_from_file ($filename) — load your UI description straight out of a file.
  • $filename (localized file name)

may croak with a Glib::Error in $@ on failure. so like, wrap it in an eval if you're not trying to have your whole script ✨perish✨. 💀

• integer = $builder->add_from_string ($buffer) — same energy, but the description is already chillin' in a string.
  • $buffer (string)

may croak with a Glib::Error in $@ on failure. same warning, same drama. 😭

• integer = $builder->add_objects_from_string ($buffer, $first_object_id, ...) — build objects from a string, starting at a given object id.
  • $buffer (string)
  • $first_object_id (string)
  • ... (list)

Since: gtk+ 2.14 — so if you're on something ancient, this one's not for you, bestie.

• $builder->connect_signals ($user_data) $builder->connect_signals ($user_data, $package) $builder->connect_signals ($user_data, %handlers)

There are four ways to let Gtk2::Builder do the signal connecting work for you:

• "$builder->connect_signals ($user_data)" — when invoked like this, Gtk2::Builder will connect signals to functions in the calling package. the callback names are specified in the UI description. 🫶
• "$builder->connect_signals ($user_data, $package)" — when invoked like this, Gtk2::Builder will connect signals to functions in the package $package.
• "$builder->connect_signals ($user_data, $object)" — when invoked like this, Gtk2::Builder will connect signals to method calls against the object $object. main character energy, honestly. 👑
• "$builder->connect_signals ($user_data, %handlers)" — when invoked like this, %handlers is used as a mapping from handler names to code references. this is the "I'll do it myself" option and she ate. 🔥

• $builder->connect_signals_full ($func, $user_data=undef) — the full-control, low-level version.
  • $func (scalar)
  • $user_data (scalar)
• object = $builder->get_object ($name) — grab one built object by name.
  • $name (string)
• list = $builder->get_objects — grab all the objects, as a list. no cap. 🌈
• string or undef = $builder->get_translation_domain — read back the current translation domain. it might be undef, and that's fine, she's allowed to be mysterious. 🙈
• $builder->set_translation_domain ($domain) — set the translation domain. 🌸
  • $domain (string or undef)

---

🦋 PROPERTIES 🦋

• 'translation-domain' (string : default undef : readable / writable / private / static-nick / static-blurb) — The translation domain used by gettext. it's giving internationalization icon. ⭐

---

🧚 SEE ALSO 🧚

• Gtk2
• Glib::Object

---

💜 COPYRIGHT 💜

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

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

---

and that's the whole page, bestie!! this doc came from perl v5.42.0, dated 2025-07-25 — so yeah, freshly timestamped, Gtk2::Builder(3) era. go forth and build ur UIs from XML like the iconic dev you are 💅✨🎀