IconList(3) User Contributed Perl Documentation IconList(3)

# [NAME](#NAME)

Tk::IconList - an icon list widget

# [SYNOPSIS](#SYNOPSIS)

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

# [DESCRIPTION](#DESCRIPTION)

## [OPTIONS](#OPTIONS)

[-browsecmd](#browsecmd)

[-command](#command)

[-font](#font)

-item -foreground|-fg

## [METHODS](#METHODS)

[DeleteAll](#DeleteAll)

Deletes all the items inside the canvas subwidget and reset the IconList's state.

[Add($image, $text)](#Add%28$image,)

Adds an icon into the IconList with the designated image and text.

[Arrange](#Arrange)

Places the icons in a column-major arrangement.

[Get](#Get)

Return the selected item.

[Invoke](#Invoke)

Gets called when the user invokes the IconList (usually by double-clicking or pressing the Return key) (internal method).

[See($tag)](#See%28$tag%29)

If the item is not (completely) visible, scroll the canvas so that it becomes visible (internal method).

# [COPYRIGHT](#COPYRIGHT)

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.

Translated to Perl/Tk by Slaven Rezic <srezic@cpan.org>.

# [SEE ALSO](#SEE_ALSO)

Tk::FBox.

2026-10-26 perl v5.44.0

---

Document: Tk::IconList(3pm) from perl-tk 804.036-r13 (Chainguard OS)
Source: https://github.com/eserte/perl-tk