---
name: "Gtk2::List"
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::List"
---

# Gtk2::List(3pm)

wrapper for GtkList

## NAME

Gtk2::List - wrapper for GtkList

## DESCRIPTION

Gtk2::List is deprecated; use Gtk2::TreeView and a Gtk2::ListStore instead.

Gtk2::List is included in Gtk2-Perl only because Gtk2::Combo still makes use of it, and Gtk2::Combo's replacement, Gtk2::ComboBox, didn't appear in gtk+ until 2.4.0.

## HIERARCHY

```
  Glib::Object
  +----Glib::InitiallyUnowned
       +----Gtk2::Object
            +----Gtk2::Widget
                 +----Gtk2::Container
                      +----Gtk2::List
```

## INTERFACES

```
  Glib::Object::_Unregistered::AtkImplementorIface
  Gtk2::Buildable
```

## METHODS

### widget = Gtk2::List-\>new

### $list-\>append\_items (...)

- •

  ... (list) of Gtk2::ListItem's to be appended

### integer = $list-\>child\_position ($child)

- •

  `$child` (Gtk2::Widget)

### $list-\>clear\_items ($start, $end)

- •

  `$start` (integer)

- •

  `$end` (integer)

### $list-\>end\_drag\_selection

### $list-\>end\_selection

### $list-\>extend\_selection ($scroll\_type, $position, $auto\_start\_selection)

- •

  `$scroll_type` (Gtk2::ScrollType)

- •

  `$position` (double)

- •

  `$auto_start_selection` (boolean)

### $list-\>insert\_items ($position, ...)

- •

  `$position` (integer)

- •

  ... (list) of Gtk2::ListItem's to be inserted

### $list-\>prepend\_items (..., $list\_item)

- •

  ... (list) of Gtk2::ListItem's to be prepended

- •

  `$list_item` (Gtk2::ListItem)

### $list-\>remove\_items (..., $list\_item)

- •

  ... (list) of Gtk2::ListItem's to be removed

- •

  `$list_item` (Gtk2::ListItem)

### $list-\>scroll\_horizontal ($scroll\_type, $position)

- •

  `$scroll_type` (Gtk2::ScrollType)

- •

  `$position` (double)

### $list-\>scroll\_vertical ($scroll\_type, $position)

- •

  `$scroll_type` (Gtk2::ScrollType)

- •

  `$position` (double)

### $list-\>select\_all

### $list-\>select\_child ($child)

- •

  `$child` (Gtk2::Widget)

### $list-\>select\_item ($item)

- •

  `$item` (integer)

### $list-\>set\_selection\_mode ($mode)

- •

  `$mode` (Gtk2::SelectionMode)

### $list-\>start\_selection

### $list-\>toggle\_add\_mode

### $list-\>toggle\_focus\_row

### $list-\>toggle\_row ($item)

- •

  `$item` (Gtk2::Widget)

### $list-\>undo\_selection

### $list-\>unselect\_all

### $list-\>unselect\_child ($child)

- •

  `$child` (Gtk2::Widget)

### $list-\>unselect\_item ($item)

- •

  `$item` (integer)

## PROPERTIES

- 'selection-mode' (Gtk2::SelectionMode : default "none" : readable / writable / private)

  ## SIGNALS

- **select-child** (Gtk2::List, Gtk2::Widget)

  - **selection-changed** (Gtk2::List)

  - **unselect-child** (Gtk2::List, Gtk2::Widget)

  ## ENUMS AND FLAGS

### enum Gtk2::ScrollType

- •

  'none' / 'GTK\_SCROLL\_NONE'

- •

  'jump' / 'GTK\_SCROLL\_JUMP'

- •

  'step-backward' / 'GTK\_SCROLL\_STEP\_BACKWARD'

- •

  'step-forward' / 'GTK\_SCROLL\_STEP\_FORWARD'

- •

  'page-backward' / 'GTK\_SCROLL\_PAGE\_BACKWARD'

- •

  'page-forward' / 'GTK\_SCROLL\_PAGE\_FORWARD'

- •

  'step-up' / 'GTK\_SCROLL\_STEP\_UP'

- •

  'step-down' / 'GTK\_SCROLL\_STEP\_DOWN'

- •

  'page-up' / 'GTK\_SCROLL\_PAGE\_UP'

- •

  'page-down' / 'GTK\_SCROLL\_PAGE\_DOWN'

- •

  'step-left' / 'GTK\_SCROLL\_STEP\_LEFT'

- •

  'step-right' / 'GTK\_SCROLL\_STEP\_RIGHT'

- •

  'page-left' / 'GTK\_SCROLL\_PAGE\_LEFT'

- •

  'page-right' / 'GTK\_SCROLL\_PAGE\_RIGHT'

- •

  'start' / 'GTK\_SCROLL\_START'

- •

  'end' / 'GTK\_SCROLL\_END'

### enum Gtk2::SelectionMode

- •

  'none' / 'GTK\_SELECTION\_NONE'

- •

  'single' / 'GTK\_SELECTION\_SINGLE'

- •

  'browse' / 'GTK\_SELECTION\_BROWSE'

- •

  'multiple' / 'GTK\_SELECTION\_MULTIPLE'

- •

  'extended' / 'GTK\_SELECTION\_EXTENDED'

## SEE ALSO

Gtk2, Glib::Object, Glib::InitiallyUnowned, Gtk2::Object, Gtk2::Widget, Gtk2::Container

## COPYRIGHT

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

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