Gtk2::ListStore(3) User Contributed Perl Documentation Gtk2::ListStore(3)

Gtk2::ListStore - wrapper for GtkListStore

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

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

... (list) of strings

treeiter = $list_store->append

$list_store->set_column_types (...)

... (list) of strings

$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

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

Like doing insert followed by set, except that insert_with_values emits only the row-inserted signal, rather than row-inserted, row-changed, and, if the store is sorted, rows-reordered as in the multiple-operation case. Since emitting the rows-reordered signal repeatedly can affect the performance of the program, insert_with_values should generally be preferred when inserting rows in a sorted list store.

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 running on Gtk 2.0.x.

$store->reorder (...)

... (list) of integers the reordered posistions

Reorders store to follow the order indicated by new_order. Note that this function only works with unsorted stores.

A list of position should be passed, one for each item in the list.

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)

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.

2023-07-25 perl v5.38.0