Gtk2::ListStore

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.