Gtk2::ListStore(3)

📦
version 1.24993 · 2 versions
, in fedora 43

💖 NAME 💖

Gtk2::ListStore — it's the wrapper for GtkListStore, bestie. This is the Gtk2::ListStore(3) manual page, and yes we are reading it together like it's a group chat at 2am. 🦋

🌈 HIERARCHY 🌈

Here's the family tree, and she's an only child:

Glib::Object
+----Gtk2::ListStore

✨ INTERFACES ✨

The way she collects interfaces like friendship bracelets, honestly iconic:

  • Gtk2::TreeModel
  • Gtk2::TreeDragSource
  • Gtk2::TreeDragDest
  • Gtk2::TreeSortable
  • Gtk2::Buildable

🎀 METHODS 🎀

liststore = Gtk2::ListStore->new (...)

  • ... — (list) of strings 👑

So you just hand her a list of strings and she's born. Slay.

treeiter = $list_store->append

$list_store->clear

$list_store->set_column_types (...)

  • ... — (list) of strings

Give her the column types and she's set up fr fr.

$list_store->set ($iter, $col1, $val1, ...)

  • $iter — (Gtk2::TreeIter)
  • $col1 — (integer) the first column number
  • $val1 — (scalar) the first value
  • ... — (list) pairs of column numbers and values

Pairs, bestie. Column number, then value. Column number, then value. That's the whole vibe. 🫶

treeiter = $list_store->insert ($position)

  • $position — (integer)

treeiter = $list_store->insert_after ($sibling)

  • $sibling — (Gtk2::TreeIter or undef)

treeiter = $list_store->insert_before ($sibling)

  • $sibling — (Gtk2::TreeIter or undef)

treeiter = $list_store->insert_with_values ($position, ...)

  • $position — (integer) position to insert the new row
  • ... — (list) pairs of column numbers and values

Okay so this is literally insert followed by set, EXCEPT — and this is the important part — insert_with_values emits only the row-inserted signal. Not row-inserted, row-changed, and (if the store is sorted) rows-reordered like you'd get in the multiple-operation case. And because emitting the rows-reordered signal over and over can affect the performance of your program, insert_with_values should generally be preferred when you're inserting rows in a sorted list store. Performance queen behavior. 👑

Since: gtk+ 2.6

boolean = $list_store->iter_is_valid ($iter)

  • $iter — (Gtk2::TreeIter)

Since: gtk+ 2.2

$store->move_after ($iter, $position)

  • $iter — (Gtk2::TreeIter)
  • $position — (Gtk2::TreeIter or undef)

Since: gtk+ 2.2

$store->move_before ($iter, $position)

  • $iter — (Gtk2::TreeIter)
  • $position — (Gtk2::TreeIter or undef)

Since: gtk+ 2.2

treeiter = $list_store->prepend

boolean = $list_store->remove ($iter)

  • $iter — (Gtk2::TreeIter)

The return is always a boolean, in the style of Gtk 2.2.x and up, even when you're running on Gtk 2.0.x. She's consistent like that. ✨

$store->reorder (...)

  • ... — (list) of integers, the reordered positions

She reorders the store to follow the order indicated by new_order. Heads up though: this function only works with unsorted stores. And you gotta pass a list of positions — one for each item in the list. No skipping, bestie, one per item, periodt.

Since: gtk+ 2.2

$store->swap ($a, $b)

  • $a — (Gtk2::TreeIter)
  • $b — (Gtk2::TreeIter)

Since: gtk+ 2.2

$list_store->set_value ($iter, $col, $val)

  • $iter — (Gtk2::TreeIter)
  • $val — (scalar)
  • $col — (integer)

Yes the bullets are in that order but the signature up top is the real one — $iter, $col, $val. Iykyk. 💅

🌸 SEE ALSO 🌸

  • Gtk2
  • Glib::Object

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

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

And that's the whole page, bestie! This was perl v5.42.0, dated 2025-07-25, filed under Gtk2::ListStore(3). Go forth and build your list store, you absolute main character. 🦋💖🎀

📦 where this page comes from