---
name: "Gtk2::ListStore"
section: "3pm"
platform: "linux"
package: "libgtk2-perl-doc"
version: "2:1.24992-1"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/Gtk2::ListStore"
---

# Gtk2::ListStore(3pm)

wrapper for GtkListStore

## 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.