IconList(3pm)

📦
version 804.036 · 15 versions
, in debian trixie, ubuntu questing

💖 IconList — Tk::IconList 💖

okay bestie, so like… this is Tk::IconList, an icon list widget. it's a little canvas full of icons and labels and you get to click around in it. no cap, it's giving "file browser but make it a widget". 🎀

✨ SYNOPSIS ✨

use Tk::IconList;
$il = $mw->IconList(-browsecmd => sub { ... },
                    -command   => sub { ... })->pack;
$il->Add($icon1, $text1);
$il->Add($icon2, $text2);
$il->Arrange;
...
$il->DeleteAll;

literally that's it. build it, add icons, arrange, go feral. 🦋

🌸 DESCRIPTION 🌸

👑 OPTIONS

  • -browsecmd — the browse callback, iykyk 🫶
  • -command — the main callback that fires when stuff happens
  • -font — the font, bestie 💅
    • -item -foreground|-fg — the item foreground / -fg situation

🧚 METHODS

  • DeleteAll — deletes every single item inside the canvas subwidget AND resets the IconList's state. full clean slate energy. ✨
  • Add($image, $text) — adds an icon into the IconList with the designated image and text. drop it in, slay. 🍓
  • Arrange — places the icons in a column-major arrangement. yes, column-major, we're being specific about it. 💜
  • Get — returns the selected item. that's the whole thing. it just tells you what's selected. 👑
  • Invoke — gets called when the user invokes the IconList (usually by double-clicking or pressing the Return key). this one's an internal method, so like, it's not for you, bestie, it's for the widget itself. 🙈
  • See($tag) — if the item is not (completely) visible, scroll the canvas so that it becomes visible. also an internal method ngl. 🌈

the original tkfbox.tcl from Tcl/Tk is:

Copyright (c) 1994-1996 Sun Microsystems, Inc.

see the file "license.terms" for information on usage and redistribution of this file, and for a DISCLAIMER OF ALL WARRANTIES. (yes, ALL of them. read the file, bestie, it's important 💀)

translated to Perl/Tk by Slaven Rezic <srezic@cpan.org>. iconic behavior honestly 🫶

🔥 SEE ALSO 🔥

  • Tk::FBox — go look at it, it's right there 💜

and that's the whole page, periodt 💅 this lil doc is from perl v5.40.1, dated 2025-04-13. mwah, go build something cute with it ✨🎀🦋💖

📦 where this page comes from