Gtk2::ListStore

Section: User Contributed Perl Documentation (3)
Updated: 2008-05-05
Index Return to Main Contents
 

NAME

Gtk2::ListStore  

HIERARCHY

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

 

INTERFACES

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

 

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)
 

$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-2008 by the gtk2-perl team.

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


 

Index

NAME
HIERARCHY
INTERFACES
METHODS
liststore = Gtk2::ListStore->new (...)
treeiter = $list_store->append
$list_store->clear
$list_store->set_column_types (...)
$list_store->set ($iter, $col1, $val1, ...)
treeiter = $list_store->insert ($position)
treeiter = $list_store->insert_after ($sibling)
treeiter = $list_store->insert_before ($sibling)
treeiter = $list_store->insert_with_values ($position, ...)
boolean = $list_store->iter_is_valid ($iter)
$store->move_after ($iter, $position)
$store->move_before ($iter, $position)
treeiter = $list_store->prepend
boolean = $list_store->remove ($iter)
$store->reorder (...)
$store->swap ($a, $b)
$list_store->set_value ($iter, $col, $val)
SEE ALSO
COPYRIGHT

linux.jgfs.net manual pages