Gnome2::IconList(3)

📦
version 1.048 · 2 versions
, in fedora 43

💖 Gnome2::IconList — bestie edition 💖

okay so this is Gnome2::IconList, aka the perl wrapper for GnomeIconList ✨ it's the widget that lays out a whole lil grid of icons with text labels under them, and this page is literally everything you can do with it. no cap. 👑

🌸 HIERARCHY 🌸

so like, here's the family tree, and yes she comes from a long line of iconic ancestors:

Glib::Object
+----Glib::InitiallyUnowned
     +----Gtk2::Object
          +----Gtk2::Widget
               +----Gtk2::Container
                    +----Gtk2::Layout
                         +----Gnome2::Canvas
                              +----Gnome2::IconList

🦋 INTERFACES 🦋

she also implements these two, for the record:

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

✨ METHODS ✨

k so here's every single method, no skips, we're doing the whole list 💅

  • widget = Gnome2::IconList->new ($icon_width, $adj, $flags) — the constructor, the birth of a legend 🎀
    • $icon_width (integer)
    • $adj (Gtk2::Adjustment)
    • $flags (Gnome2::IconListFlags)
  • integer = $gil->append ($icon_filename, $text) — tack a new icon onto the end, get back its index 🔥
    • $icon_filename (string)
    • $text (string)
  • integer = $gil->append_pixbuf ($im, $icon_filename, $text) — same energy as append but you're handing over a pixbuf directly 🖼️
    • $im (Gtk2::Gdk::Pixbuf)
    • $icon_filename (string)
    • $text (string)
  • $gil->clear — wipe the whole thing. poof. gone. 💀
  • $gil->set_col_spacing ($pixels) — how much breathing room between columns
    • $pixels (integer)
  • integer = $gil->find_icon_from_filename ($filename) — hunts down the icon with that filename and gives you its index 🔍
    • $filename (string)
  • $gil->focus_icon ($idx) — put the focus on the icon at that index
    • $idx (integer)
  • $gil->freeze — freeze updates so you can do a bunch of stuff without it flickering everywhere 🧊
  • $gil->set_hadjustment ($hadj) — set the horizontal adjustment
    • $hadj (Gtk2::Adjustment)
  • integer = $gil->get_icon_at ($x, $y) — which icon is chillin' at those coordinates?
    • $x (integer)
    • $y (integer)
  • $gil->set_icon_border ($pixels) — border around each icon, in pixels
    • $pixels (integer)
  • string = $gil->get_icon_filename ($idx) — gimme the filename of the icon at that index
    • $idx (integer)
  • visibility = $gil->icon_is_visible ($pos) — is the icon at that position actually visible rn?
    • $pos (integer)
  • object = $gil->get_icon_pixbuf_item ($idx) — grab the pixbuf item for that index
    • $idx (integer)
  • icontextitem = $gil->get_icon_text_item ($idx) — grab the text item for that index
    • $idx (integer)
  • $gil->set_icon_width ($w) — set how wide each icon is
    • $w (integer)
  • $gil->insert ($pos, $icon_filename, $text) — shove a new icon in at a specific spot, not just the end 📌
    • $pos (integer)
    • $icon_filename (string)
    • $text (string)
  • $gil->insert_pixbuf ($pos, $im, $icon_filename, $text) — insert with a pixbuf, at a position, you get it 💫
    • $pos (integer)
    • $im (Gtk2::Gdk::Pixbuf)
    • $icon_filename (string)
    • $text (string)
  • integer = $gil->get_items_per_line — how many icons fit per line
  • $gil->moveto ($pos, $yalign) — scroll/jump to that position with that vertical alignment
    • $pos (integer)
    • $yalign (double)
  • integer = $gil->get_num_icons — the icon headcount 🧮
  • $gil->remove ($pos) — yeet the icon at that position
    • $pos (integer)
  • $gil->set_row_spacing ($pixels) — vertical gap between rows
    • $pixels (integer)
  • $gil->select_all — selects every single icon, all of them, the whole squad 🫶
Since: libgnomeui 2.8
  • $gil->select_icon ($pos) — select just the one at that position
    • $pos (integer)
  • list = $gil->get_selection — returns a list of integers. that's the selection, bestie.
  • selectionmode = $gil->get_selection_mode — what mode is the selection in rn
  • $gil->set_selection_mode ($mode) — set the selection mode
    • $mode (Gtk2::SelectionMode)
  • $gil->set_separators ($sep) — set the separator string
    • $sep (string)
  • $gil->set_text_spacing ($pixels) — spacing for the text, in pixels
    • $pixels (integer)
  • $gil->thaw — unfreeze, let the updates flow again 🌊
  • integer = $gil->unselect_all — deselect everything, returns an integer
  • $gil->unselect_icon ($pos) — unselect the one at that position
    • $pos (integer)
  • $gil->set_vadjustment ($vadj) — set the vertical adjustment
    • $vadj (Gtk2::Adjustment)

🔔 SIGNALS 🔔

the vibes she emits, in order:

focus-icon (Gnome2::IconList, integer)
move-cursor (Gnome2::IconList, Gtk2::DirectionType, boolean)
select-icon (Gnome2::IconList, integer, Gtk2::Gdk::Event)
boolean = text-changed (Gnome2::IconList, integer, string)
toggle-cursor-selection (Gnome2::IconList)
unselect-icon (Gnome2::IconList, integer, Gtk2::Gdk::Event)

🌈 ENUMS AND FLAGS 🌈

enum Gtk2::DirectionType

  • 'tab-forward' / GTK_DIR_TAB_FORWARD
  • 'tab-backward' / GTK_DIR_TAB_BACKWARD
  • 'up' / GTK_DIR_UP
  • 'down' / GTK_DIR_DOWN
  • 'left' / GTK_DIR_LEFT
  • 'right' / GTK_DIR_RIGHT

enum Gtk2::SelectionMode

  • 'none' / GTK_SELECTION_NONE
  • 'single' / GTK_SELECTION_SINGLE
  • 'browse' / GTK_SELECTION_BROWSE
  • 'multiple' / GTK_SELECTION_MULTIPLE
  • 'extended' / GTK_SELECTION_EXTENDED

enum Gtk2::Visibility

  • 'none' / GTK_VISIBILITY_NONE
  • 'partial' / GTK_VISIBILITY_PARTIAL
  • 'full' / GTK_VISIBILITY_FULL

👀 SEE ALSO 👀

go read these next, they're all part of the same friend group:

Gnome2, Glib::Object, Glib::InitiallyUnowned, Gtk2::Object, Gtk2::Widget, Gtk2::Container, Gtk2::Layout, Gnome2::Canvas

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

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

and that's the whole page bestie, you ate it 💅 this doc dropped with perl v5.42.0 on 2025-07-25, from the User Contributed Perl Documentation collection — stan the gtk2-perl girlies, they did that 🎀✨🦋

📦 where this page comes from