gtk2::treeiter(3pm) [debian man page]

Gtk2::TreeIter(3pm)					User Contributed Perl Documentation				       Gtk2::TreeIter(3pm)

NAME

       Gtk2::TreeIter - wrapper for GtkTreeIter

HIERARCHY

	 Glib::Boxed
	 +----Gtk2::TreeIter

SYNOPSIS

	 package MyCustomListStore;

	 use Glib::Object::Subclass
	     Glib::Object::,
	     interfaces => [ Gtk2::TreeModel:: ],
	     ;

	 ...

	 sub set {
	     my $list = shift;
	     my $iter = shift; # a Gtk2::TreeIter

	     # this method needs access to the internal representation
	     # of the iter, as the model implementation sees it:
	     my $arrayref = $iter->to_arrayref ($list->{stamp});
	     ...
	 }

DESCRIPTION

       The methods described here are only of use in custom Gtk2::TreeModel implementations; they are not safe to be used on generic iters or in
       application code.  See "CREATING A CUSTOM TREE MODEL" in Gtk2::TreeModel for more information.

METHODS

   treeiter = Gtk2::TreeIter->new_from_arrayref ($sv_iter)
       o   $sv_iter (scalar)

       Create a new Gtk2::TreeIter from the "internal" array reference representation used by custom Gtk2::TreeModel implementations.  This is the
       complement to Gtk2::TreeIter::to_arrayref(), and is used when you need to create and return a new iter from a method that is not one of the
       Gtk2::TreeModelIface interface vfuncs.  See "CREATING A CUSTOM TREE MODEL" in Gtk2::TreeModel for more information.

   $iter->set ($from)
       o   $from (scalar)

       Set the contents of $iter.  $from can be either another Gtk2::TreeIter or an "internal" arrayref form as above.

       Often you create a new iter instead of modifying an existing one, but "set" lets you to implement things in the style of the "remove"
       method of Gtk2::ListStore and Gtk2::TreeStore.

       A set can also explicitly invalidate an iter by zapping its stamp, so nobody can accidentally use it again.

	   $iter->set ([0,0,undef,undef]);

   scalar = $iter->to_arrayref ($stamp)
       o   $stamp (integer)

       Convert a boxed Gtk2::TreeIter reference into the "internal" array reference representation used by custom Gtk2::TreeModel implementations.
       This is necessary when you need to get to the data inside your iters in methods which are not the vfuncs of the Gtk2::TreeModelIface
       interface.  The stamp must match; this protects the binding code from potential memory faults when attempting to convert an iter that
       doesn't actually belong to your model.  See "CREATING A CUSTOM TREE MODEL" in Gtk2::TreeModel for more information.

SEE ALSO

       Gtk2, Glib::Boxed, Gtk2::TreeModel

COPYRIGHT

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

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

perl v5.14.2							    2012-05-27						       Gtk2::TreeIter(3pm)

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

NAME

       Gtk2::ListStore

HIERARCHY

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

INTERFACES

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

METHODS

   liststore = Gtk2::ListStore->new (...)
       o   ... (list) of strings

   treeiter = $list_store->append
   $list_store->clear
   $list_store->set_column_types (...)
       o   ... (list) of strings

   $list_store->set ($iter, $col1, $val1, ...)
       o   $iter (Gtk2::TreeIter)

       o   $col1 (integer) the first column number

       o   $val1 (scalar) the first value

       o   ... (list) pairs of column numbers and values

   treeiter = $list_store->insert ($position)
       o   $position (integer)

   treeiter = $list_store->insert_after ($sibling)
       o   $sibling (Gtk2::TreeIter or undef)

   treeiter = $list_store->insert_before ($sibling)
       o   $sibling (Gtk2::TreeIter or undef)

   treeiter = $list_store->insert_with_values ($position, ...)
       o   $position (integer) position to insert the new row

       o   ... (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)
       o   $iter (Gtk2::TreeIter)

       Since: gtk+ 2.2

   $store->move_after ($iter, $position)
       o   $iter (Gtk2::TreeIter)

       o   $position (Gtk2::TreeIter or undef)

       Since: gtk+ 2.2

   $store->move_before ($iter, $position)
       o   $iter (Gtk2::TreeIter)

       o   $position (Gtk2::TreeIter or undef)

       Since: gtk+ 2.2

   treeiter = $list_store->prepend
   boolean = $list_store->remove ($iter)
       o   $iter (Gtk2::TreeIter)

   $store->reorder (...)
       o   ... (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)
       o   $a (Gtk2::TreeIter)

       o   $b (Gtk2::TreeIter)

       Since: gtk+ 2.2

   $list_store->set_value ($iter, $col, $val)
       o   $iter (Gtk2::TreeIter)

       o   $val (scalar)

       o   $col (integer)

SEE ALSO

       Gtk2, Glib::Object

COPYRIGHT

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

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

perl v5.12.1							    2010-07-05							Gtk2::ListStore(3)