Gnome2:...election(3)

💖 Gnome2::IconSelection — bestie edition 💖

okay so this is Gnome2::IconSelection, a lil Perl wrapper around GnomeIconSelection from the Gnome2 bindings. yes she's an old one, yes she still serves. it lives in the User Contributed Perl Documentation section of the manual, and honestly? iconic. 🎀

---

🌸 HIERARCHY 🌸

here's the family tree, and yes it's giving noble bloodline. every single ancestor, exactly as it is:

Glib::Object
+----Glib::InitiallyUnowned
     +----Gtk2::Object
          +----Gtk2::Widget
               +----Gtk2::Container
                    +----Gtk2::Box
                         +----Gtk2::VBox
                              +----Gnome2::IconSelection

she's a Gtk2::VBox girlie deep down. slay. 💅

---

🦋 INTERFACES 🦋

the interfaces she implements, no cap, all three of them:

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

---

✨ METHODS ✨

this is the main character section. every method, every arg, every type — nothing skipped, periodt.

• widget = Gnome2::IconSelection->new — spawn a brand new icon selection widget, fresh out the box. 🫶
• $gis->add_defaults — drop in the default icons, like the widget's lil starter pack.
• $gis->add_directory ($dir) — add a whole directory of icons.
  • $dir (string) — the directory you're pointing her at.
• widget = $gis->get_box — grab the box widget.
• $gis->clear ($not_shown) — wipe it clean.
  • $not_shown (boolean) — the boolean that decides what gets cleared, iykyk.
• widget = $gis->get_gil — hand over the gil widget. (yes, gil. that's the name. we don't question it. 😭)
• string = $gis->get_icon ($full_path) — get an icon back as a string.
  • $full_path (boolean) — boolean controlling whether you get the full path.
• $gis->select_icon ($filename) — select an icon by name.
  • $filename (string) — the file you wanna select.
• $gis->show_icons — show the icons, bestie. that's it. that's the method.
• $gis->stop_loading — halt the loading. done. no more. ✋

---

👑 SEE ALSO 👑

go read these too, they're the extended universe:

• Gnome2
• Glib::Object
• Glib::InitiallyUnowned
• Gtk2::Object
• Gtk2::Widget
• Gtk2::Container
• Gtk2::Box
• Gtk2::VBox

---

💜 COPYRIGHT 💜

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

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

no gatekeeping here — it's LGPL, go read the real notice in Gnome2 before you go wild.

---

and that's the whole page, bestie! 🎀 this one's from perl v5.42.0, dated 2025-07-25, filed under Gnome2:...election(3) — love that for her. stay slaying, go build something cute with your icon selection widget 🌈✨💖