Provided by: libgtk2-perl-doc_1.249-2_all bug

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.