Gtk2::ListStore(3)

NAME
Gtk2::ListStore - wrapper for GtkListStore

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

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

METHODS

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

•   ... (list) of strings

  treeiter = $list_store->append

  $list_store->clear

  $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)

SEE ALSO
Gtk2, Glib::Object

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

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