Gtk2::IconView(3)

📦

version 1.24993 · 2 versions

1.24993 · fedora 43 (latest)
1.24993 · fedora 44

✨ NAME ✨

okay so bestie, Gtk2::IconView — wrapper for GtkIconView. that's the whole assignment. this is the Gtk2::IconView(3) page from User Contributed Perl Documentation, and we're about to go through every method, property, style property, and signal like it's a group chat recap. no cap 💖

🦋 HIERARCHY 🦋

the family tree is giving legacy code royalty:

Glib::Object
+----Glib::InitiallyUnowned
     +----Gtk2::Object
          +----Gtk2::Widget
               +----Gtk2::Container
                    +----Gtk2::IconView

💅 INTERFACES 💅

it also rocks these interfaces, periodt:

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

🌸 METHODS 🌸

okay bestie, here's every method. keep your fave close and your $icon_view closer.

widget = Gtk2::IconView->new — brand new icon view, no model attached yet. fresh out the box ✨
widget = Gtk2::IconView->new_with_model ($model) — same energy, but you hand it a model right away.
- $model (Gtk2::TreeModel) — the model it rides with.
integer = $icon_view->get_column_spacing / $icon_view->set_column_spacing ($column_spacing) — get or set the space between grid columns.
- $column_spacing (integer) — the spacing value.
integer = $icon_view->get_columns / $icon_view->set_columns ($columns) — get or set how many columns to display.
- $columns (integer) — the column count.
(bx, by) = $icon_view->convert_widget_to_bin_window_coords ($wx, $wy) — converts widget coords to bin window coords.
- $wx (integer)
- $wy (integer)
- Since: gtk+ 2.12
pixmap = $icon_view->create_drag_icon ($path) — makes a drag icon from a path.
- $path (Gtk2::TreePath)
- Since: gtk+ 2.8
list = $icon_view->get_cursor — gets the cursor.
- Since: gtk+ 2.8
$icon_view->set_cursor ($path, $cell, $start_editing) — sets the cursor.
- $path (Gtk2::TreePath)
- $cell (Gtk2::CellRenderer or undef)
- $start_editing (boolean)
- Since: gtk+ 2.8
$icon_view->get_dest_item_at_pos ($drag_x, $drag_y) — gets the destination item at a position.
- $drag_x (integer)
- $drag_y (integer)
- Since: gtk+ 2.8
list = $icon_view->get_drag_dest_item — gets the drag destination item.
- Since: gtk+ 2.8
$icon_view->set_drag_dest_item ($path, $pos) — sets the drag destination item.
- $path (Gtk2::TreePath)
- $pos (Gtk2::IconView::DropPosition)
- Since: gtk+ 2.8
$icon_view->enable_model_drag_dest ($actions, ...) — enables model drag dest.
- $actions (Gtk2::Gdk::DragAction)
- ... (list) of Gtk2::TargetEntry's
- Since: gtk+ 2.8
$icon_view->enable_model_drag_source ($start_button_mask, $actions, ...) — enables model drag source.
- $start_button_mask (Gtk2::Gdk::ModifierType)
- $actions (Gtk2::Gdk::DragAction)
- ... (list) of Gtk2::TargetEntry's
- Since: gtk+ 2.8
$icon_view->item_activated ($path) — item activated.
- $path (Gtk2::TreePath)
$icon_view->get_item_at_pos ($x, $y) — gets the item at a position.
- $x (integer)
- $y (integer)
- Since: gtk+ 2.8
integer = $icon_view->get_item_column ($path) — gets the item column.
- $path (Gtk2::TreePath)
- Since: gtk+ 2.22
orientation = $icon_view->get_item_orientation — gets the item orientation.
- Since: gtk+ 2.22
$icon_view->set_item_orientation ($orientation) — sets the item orientation.
- $orientation (Gtk2::Orientation)
- Since: gtk+ 2.22
integer = $icon_view->get_item_padding — gets the item padding.
- Since: gtk+ 2.18
$icon_view->set_item_padding ($item_padding) — sets the item padding.
- $item_padding (integer)
- Since: gtk+ 2.18
integer = $icon_view->get_item_row ($path) — gets the item row.
- $path (Gtk2::TreePath)
- Since: gtk+ 2.22
integer = $icon_view->get_item_width / $icon_view->set_item_width ($item_width) — get or set the item width.
- $item_width (integer)
integer = $icon_view->get_margin / $icon_view->set_margin ($margin) — get or set the margin.
- $margin (integer)
integer = $icon_view->get_markup_column / $icon_view->set_markup_column ($column) — get or set the markup column.
- $column (integer)
treemodel = $icon_view->get_model / $icon_view->set_model ($model) — get or set the model.
- $model (Gtk2::TreeModel)
orientation = $icon_view->get_orientation / $icon_view->set_orientation ($orientation) — get or set the orientation.
- $orientation (Gtk2::Orientation)
treepath = $icon_view->get_path_at_pos ($x, $y) — gets the path at a position.
- $x (integer)
- $y (integer)
boolean = $icon_view->path_is_selected ($path) — checks if a path is selected.
- $path (Gtk2::TreePath)
integer = $icon_view->get_pixbuf_column / $icon_view->set_pixbuf_column ($column) — get or set the pixbuf column.
- $column (integer)
boolean = $icon_view->get_reorderable — gets whether it's reorderable.
- Since: gtk+ 2.8
$icon_view->set_reorderable ($reorderable) — sets whether it's reorderable.
- $reorderable (boolean)
- Since: gtk+ 2.8
integer = $icon_view->get_row_spacing / $icon_view->set_row_spacing ($row_spacing) — get or set the row spacing.
- $row_spacing (integer)
$icon_view->scroll_to_path ($path, $use_align=FALSE, $row_align=0.0, $col_align=0.0) — scrolls to a path.
- $path (Gtk2::TreePath)
- $use_align (boolean)
- $row_align (double)
- $col_align (double)
- Since: gtk+ 2.8
$icon_view->select_all — selects all. periodt.
$icon_view->select_path ($path) — selects a path.
- $path (Gtk2::TreePath)
$icon_view->selected_foreach ($func, $data=undef) — runs a function for each selected item.
- $func (scalar)
- $data (scalar)
list = $icon_view->get_selected_items — gets the selected items.
selectionmode = $icon_view->get_selection_mode / $icon_view->set_selection_mode ($mode) — get or set the selection mode.
- $mode (Gtk2::SelectionMode)
integer = $icon_view->get_spacing / $icon_view->set_spacing ($spacing) — get or set the spacing.
- $spacing (integer)
integer = $icon_view->get_text_column / $icon_view->set_text_column ($column) — get or set the text column.
- $column (integer)
$icon_view->set_tooltip_cell ($tooltip, $path, $cell) — sets the tooltip cell.
- $tooltip (Gtk2::Tooltip)
- $path (Gtk2::TreePath)
- $cell (Gtk2::CellRenderer)
- Since: gtk+ 2.12
integer = $icon_view->get_tooltip_column — gets the tooltip column.
- Since: gtk+ 2.12
$icon_view->set_tooltip_column ($column) — sets the tooltip column.
- $column (integer)
- Since: gtk+ 2.12
list = $icon_view->get_tooltip_context ($x, $y, $keyboard_tip) — gets the tooltip context.
- $x (integer)
- $y (integer)
- $keyboard_tip (boolean)
- Since: gtk+ 2.12
$icon_view->set_tooltip_item ($tooltip, $path) — sets the tooltip item.
- $tooltip (Gtk2::Tooltip)
- $path (Gtk2::TreePath)
- Since: gtk+ 2.12
$icon_view->unselect_all — unselects all.
$icon_view->unselect_path ($path) — unselects a path.
- $path (Gtk2::TreePath)
$icon_view->unset_model_drag_dest — unsets model drag dest.
- Since: gtk+ 2.8
$icon_view->unset_model_drag_source — unsets model drag source.
- Since: gtk+ 2.8
list = $icon_view->get_visible_range — gets the visible range.
- Since: gtk+ 2.8

🎀 PROPERTIES 🎀

these are the properties, bestie. each one is literally a vibe:

'column-spacing' (integer : default 6 : readable / writable / private / static-nick / static-blurb) — Space which is inserted between grid columns 💖
'columns' (integer : default -1 : readable / writable / private / static-nick / static-blurb) — Number of columns to display ✨
'item-orientation' (Gtk2::Orientation : default "vertical" : readable / writable / private / static-nick / static-blurb) — How the text and icon of each item are positioned relative to each other 🦋
'item-padding' (integer : default 6 : readable / writable / private / static-nick / static-blurb) — Padding around icon view items 🎀
'item-width' (integer : default -1 : readable / writable / private / static-nick / static-blurb) — The width used for each item 🌸
'margin' (integer : default 6 : readable / writable / private / static-nick / static-blurb) — Space which is inserted at the edges of the icon view 💅
'markup-column' (integer : default -1 : readable / writable / private / static-nick / static-blurb) — Model column used to retrieve the text if using Pango markup 🫶
'model' (Gtk2::TreeModel : default undef : readable / writable / private / static-nick / static-blurb) — The model for the icon view 😭
'orientation' (Gtk2::Orientation : default "vertical" : readable / writable / private / static-nick / static-blurb / deprecated) — How the text and icon of each item are positioned relative to each other. it's deprecated, bestie, so don't get too attached 💀
'pixbuf-column' (integer : default -1 : readable / writable / private / static-nick / static-blurb) — Model column used to retrieve the icon pixbuf from 🔥
'reorderable' (boolean : default false : readable / writable) — View is reorderable 👑
'row-spacing' (integer : default 6 : readable / writable / private / static-nick / static-blurb) — Space which is inserted between grid rows 🌈
'selection-mode' (Gtk2::SelectionMode : default "single" : readable / writable / private / static-nick / static-blurb) — The selection mode ⭐
'spacing' (integer : default 0 : readable / writable / private / static-nick / static-blurb) — Space which is inserted between cells of an item 💀
'text-column' (integer : default -1 : readable / writable / private / static-nick / static-blurb) — Model column used to retrieve the text from 🙈
'tooltip-column' (integer : default -1 : readable / writable / private / static-nick / static-blurb) — The column in the model containing the tooltip texts for the items 🍓

⭐ STYLE PROPERTIES ⭐

style properties, aka the lewk:

'selection-box-alpha' (Glib::UChar : default 64 : readable / private / static-nick / static-blurb) — Opacity of the selection box ✨
'selection-box-color' (Gtk2::Gdk::Color : default undef : readable / private / static-nick / static-blurb) — Color of the selection box 🌈

🔥 SIGNALS 🔥

the signals, no cap:

boolean = activate-cursor-item (Gtk2::IconView) — activate cursor item.
item-activated (Gtk2::IconView, Gtk2::TreePath) — item activated.
boolean = move-cursor (Gtk2::IconView, Gtk2::MovementStep, integer) — move cursor.
select-all (Gtk2::IconView) — select all.
select-cursor-item (Gtk2::IconView) — select cursor item.
selection-changed (Gtk2::IconView) — selection changed.
set-scroll-adjustments (Gtk2::IconView, Gtk2::Adjustment, Gtk2::Adjustment) — set scroll adjustments.
toggle-cursor-item (Gtk2::IconView) — toggle cursor item.
unselect-all (Gtk2::IconView) — unselect all.

✨ ENUMS AND FLAGS ✨

okay bestie, this is the part where we meet all the little named constants you'll be throwing around 💖 every single one of these shows up in two outfits: the lowercase perl string you actually type in your code, and the big shouty C constant underneath. same girl, different lewk. use whichever one your function is asking for and you're golden ✨

🦋 flags Gtk2::Gdk::DragAction

'default' / GDK_ACTION_DEFAULT — the baseline, the blueprint, the "we'll figure it out" of drag actions 💅
'copy' / GDK_ACTION_COPY — copy vibes, no cap
'move' / GDK_ACTION_MOVE — she moves, that's the whole thing
'link' / GDK_ACTION_LINK — the linking one, periodt
'private' / GDK_ACTION_PRIVATE — private mode, don't ask, don't tell 🙈
'ask' / GDK_ACTION_ASK — literally just asking, iconic behavior

🎀 flags Gtk2::Gdk::ModifierType

'shift-mask' / GDK_SHIFT_MASK — shift energy, she's here
'lock-mask' / GDK_LOCK_MASK — locked in 🔒
'control-mask' / GDK_CONTROL_MASK — control, as the name suggests, main character
'mod1-mask' / GDK_MOD1_MASK — mod1, no notes
'mod2-mask' / GDK_MOD2_MASK — mod2, also no notes
'mod3-mask' / GDK_MOD3_MASK — mod3, we stay consistent
'mod4-mask' / GDK_MOD4_MASK — mod4, the middle child
'mod5-mask' / GDK_MOD5_MASK — mod5, last of the mods 😭
'button1-mask' / GDK_BUTTON1_MASK — button 1 representation 💖
'button2-mask' / GDK_BUTTON2_MASK — button 2 representation
'button3-mask' / GDK_BUTTON3_MASK — button 3 representation
'button4-mask' / GDK_BUTTON4_MASK — button 4 representation
'button5-mask' / GDK_BUTTON5_MASK — button 5 representation, the whole set ate
'super-mask' / GDK_SUPER_MASK — super, obviously 💅
'hyper-mask' / GDK_HYPER_MASK — hyper, even more obviously
'meta-mask' / GDK_META_MASK — meta, she's meta about it
'release-mask' / GDK_RELEASE_MASK — the release one 🦋
'modifier-mask' / GDK_MODIFIER_MASK — the catch-all, the mother of all masks, the one that contains multitudes 👑

🌸 enum Gtk2::IconView::DropPosition

'no-drop' / GTK_ICON_VIEW_NO_DROP — absolutely not dropping, we said no 💀
'drop-into' / GTK_ICON_VIEW_DROP_INTO — drop into, cozy
'drop-left' / GTK_ICON_VIEW_DROP_LEFT — to the left, to the left 🎶
'drop-right' / GTK_ICON_VIEW_DROP_RIGHT — right side bestie
'drop-above' / GTK_ICON_VIEW_DROP_ABOVE — up top
'drop-below' / GTK_ICON_VIEW_DROP_BELOW — down low, keep it on the lowkey

⭐ enum Gtk2::MovementStep

'logical-positions' / GTK_MOVEMENT_LOGICAL_POSITIONS — logical positions, staying rational
'visual-positions' / GTK_MOVEMENT_VISUAL_POSITIONS — visual positions, aesthetics first ✨
'words' / GTK_MOVEMENT_WORDS — words. yes. those.
'display-lines' / GTK_MOVEMENT_DISPLAY_LINES — display lines, the lines you see
'display-line-ends' / GTK_MOVEMENT_DISPLAY_LINE_ENDS — the ends of those exact lines
'paragraphs' / GTK_MOVEMENT_PARAGRAPHS — paragraphs, she's long-winded fr
'paragraph-ends' / GTK_MOVEMENT_PARAGRAPH_ENDS — ends of the paragraphs
'pages' / GTK_MOVEMENT_PAGES — pages, turn turn turn
'buffer-ends' / GTK_MOVEMENT_BUFFER_ENDS — the very ends of the buffer 🫶
'horizontal-pages' / GTK_MOVEMENT_HORIZONTAL_PAGES — pages but sideways, lowkey a serve

🌈 enum Gtk2::Orientation

'horizontal' / GTK_ORIENTATION_HORIZONTAL — sideways, lying down, resting 💅
'vertical' / GTK_ORIENTATION_VERTICAL — standing up tall, posture immaculate

💜 enum Gtk2::SelectionMode

'none' / GTK_SELECTION_NONE — no selection, none, zero, nada 💀
'single' / GTK_SELECTION_SINGLE — one and only one, monogamous selection
'browse' / GTK_SELECTION_BROWSE — browse mode, she's shopping
'multiple' / GTK_SELECTION_MULTIPLE — multiple, polyamorous selection, we love
'extended' / GTK_SELECTION_EXTENDED — extended, the deluxe version 👑

🎀 SEE ALSO

Gtk2
Glib::Object
Glib::InitiallyUnowned
Gtk2::Object
Gtk2::Widget
Gtk2::Container

go read those too, iykyk 📚✨

💖 COPYRIGHT

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

and that's a wrap on the whole page bestie 🫶 this was Gtk2::IconView(3) from perl v5.42.0, dated 2025-07-25 — go build something iconic with it, ily, mwah 💅💖✨

📦 where this page comes from

fedora 43: perl-Gtk2 1.24993-23.fc43 · LicenseRef-Callaway-LGPLv2+
💖 girlified by deepseek-ai/DeepSeek-V4.1-Flash on 2026-10-14: a language model's rewrite of the original, under its terms