.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "Gtk2::List 3"
.TH Gtk2::List 3 2023-07-25 "perl v5.38.0" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAME
Gtk2::List \- wrapper for GtkList
.SH DESCRIPTION
.IX Header "DESCRIPTION"
Gtk2::List is deprecated; use Gtk2::TreeView and a Gtk2::ListStore instead.
.PP
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.
.SH HIERARCHY
.IX Header "HIERARCHY"
.Vb 6
\&  Glib::Object
\&  +\-\-\-\-Glib::InitiallyUnowned
\&       +\-\-\-\-Gtk2::Object
\&            +\-\-\-\-Gtk2::Widget
\&                 +\-\-\-\-Gtk2::Container
\&                      +\-\-\-\-Gtk2::List
.Ve
.SH INTERFACES
.IX Header "INTERFACES"
.Vb 2
\&  Glib::Object::_Unregistered::AtkImplementorIface
\&  Gtk2::Buildable
.Ve
.SH METHODS
.IX Header "METHODS"
.SS "widget = Gtk2::List\->\fBnew\fP"
.IX Subsection "widget = Gtk2::List->new"
.ie n .SS "$list\->\fBappend_items\fP (...)"
.el .SS "\f(CW$list\fP\->\fBappend_items\fP (...)"
.IX Subsection "$list->append_items (...)"
.IP \(bu 4
\&... (list) of Gtk2::ListItem's to be appended
.ie n .SS "integer = $list\->\fBchild_position\fP ($child)"
.el .SS "integer = \f(CW$list\fP\->\fBchild_position\fP ($child)"
.IX Subsection "integer = $list->child_position ($child)"
.IP \(bu 4
\&\f(CW$child\fR (Gtk2::Widget)
.ie n .SS "$list\->\fBclear_items\fP ($start, $end)"
.el .SS "\f(CW$list\fP\->\fBclear_items\fP ($start, \f(CW$end\fP)"
.IX Subsection "$list->clear_items ($start, $end)"
.IP \(bu 4
\&\f(CW$start\fR (integer)
.IP \(bu 4
\&\f(CW$end\fR (integer)
.ie n .SS $list\->\fBend_drag_selection\fP
.el .SS \f(CW$list\fP\->\fBend_drag_selection\fP
.IX Subsection "$list->end_drag_selection"
.ie n .SS $list\->\fBend_selection\fP
.el .SS \f(CW$list\fP\->\fBend_selection\fP
.IX Subsection "$list->end_selection"
.ie n .SS "$list\->\fBextend_selection\fP ($scroll_type, $position, $auto_start_selection)"
.el .SS "\f(CW$list\fP\->\fBextend_selection\fP ($scroll_type, \f(CW$position\fP, \f(CW$auto_start_selection\fP)"
.IX Subsection "$list->extend_selection ($scroll_type, $position, $auto_start_selection)"
.IP \(bu 4
\&\f(CW$scroll_type\fR (Gtk2::ScrollType)
.IP \(bu 4
\&\f(CW$position\fR (double)
.IP \(bu 4
\&\f(CW$auto_start_selection\fR (boolean)
.ie n .SS "$list\->\fBinsert_items\fP ($position, ...)"
.el .SS "\f(CW$list\fP\->\fBinsert_items\fP ($position, ...)"
.IX Subsection "$list->insert_items ($position, ...)"
.IP \(bu 4
\&\f(CW$position\fR (integer)
.IP \(bu 4
\&... (list) of Gtk2::ListItem's to be inserted
.ie n .SS "$list\->\fBprepend_items\fP (..., $list_item)"
.el .SS "\f(CW$list\fP\->\fBprepend_items\fP (..., \f(CW$list_item\fP)"
.IX Subsection "$list->prepend_items (..., $list_item)"
.IP \(bu 4
\&... (list) of Gtk2::ListItem's to be prepended
.IP \(bu 4
\&\f(CW$list_item\fR (Gtk2::ListItem)
.ie n .SS "$list\->\fBremove_items\fP (..., $list_item)"
.el .SS "\f(CW$list\fP\->\fBremove_items\fP (..., \f(CW$list_item\fP)"
.IX Subsection "$list->remove_items (..., $list_item)"
.IP \(bu 4
\&... (list) of Gtk2::ListItem's to be removed
.IP \(bu 4
\&\f(CW$list_item\fR (Gtk2::ListItem)
.ie n .SS "$list\->\fBscroll_horizontal\fP ($scroll_type, $position)"
.el .SS "\f(CW$list\fP\->\fBscroll_horizontal\fP ($scroll_type, \f(CW$position\fP)"
.IX Subsection "$list->scroll_horizontal ($scroll_type, $position)"
.IP \(bu 4
\&\f(CW$scroll_type\fR (Gtk2::ScrollType)
.IP \(bu 4
\&\f(CW$position\fR (double)
.ie n .SS "$list\->\fBscroll_vertical\fP ($scroll_type, $position)"
.el .SS "\f(CW$list\fP\->\fBscroll_vertical\fP ($scroll_type, \f(CW$position\fP)"
.IX Subsection "$list->scroll_vertical ($scroll_type, $position)"
.IP \(bu 4
\&\f(CW$scroll_type\fR (Gtk2::ScrollType)
.IP \(bu 4
\&\f(CW$position\fR (double)
.ie n .SS $list\->\fBselect_all\fP
.el .SS \f(CW$list\fP\->\fBselect_all\fP
.IX Subsection "$list->select_all"
.ie n .SS "$list\->\fBselect_child\fP ($child)"
.el .SS "\f(CW$list\fP\->\fBselect_child\fP ($child)"
.IX Subsection "$list->select_child ($child)"
.IP \(bu 4
\&\f(CW$child\fR (Gtk2::Widget)
.ie n .SS "$list\->\fBselect_item\fP ($item)"
.el .SS "\f(CW$list\fP\->\fBselect_item\fP ($item)"
.IX Subsection "$list->select_item ($item)"
.IP \(bu 4
\&\f(CW$item\fR (integer)
.ie n .SS "$list\->\fBset_selection_mode\fP ($mode)"
.el .SS "\f(CW$list\fP\->\fBset_selection_mode\fP ($mode)"
.IX Subsection "$list->set_selection_mode ($mode)"
.IP \(bu 4
\&\f(CW$mode\fR (Gtk2::SelectionMode)
.ie n .SS $list\->\fBstart_selection\fP
.el .SS \f(CW$list\fP\->\fBstart_selection\fP
.IX Subsection "$list->start_selection"
.ie n .SS $list\->\fBtoggle_add_mode\fP
.el .SS \f(CW$list\fP\->\fBtoggle_add_mode\fP
.IX Subsection "$list->toggle_add_mode"
.ie n .SS $list\->\fBtoggle_focus_row\fP
.el .SS \f(CW$list\fP\->\fBtoggle_focus_row\fP
.IX Subsection "$list->toggle_focus_row"
.ie n .SS "$list\->\fBtoggle_row\fP ($item)"
.el .SS "\f(CW$list\fP\->\fBtoggle_row\fP ($item)"
.IX Subsection "$list->toggle_row ($item)"
.IP \(bu 4
\&\f(CW$item\fR (Gtk2::Widget)
.ie n .SS $list\->\fBundo_selection\fP
.el .SS \f(CW$list\fP\->\fBundo_selection\fP
.IX Subsection "$list->undo_selection"
.ie n .SS $list\->\fBunselect_all\fP
.el .SS \f(CW$list\fP\->\fBunselect_all\fP
.IX Subsection "$list->unselect_all"
.ie n .SS "$list\->\fBunselect_child\fP ($child)"
.el .SS "\f(CW$list\fP\->\fBunselect_child\fP ($child)"
.IX Subsection "$list->unselect_child ($child)"
.IP \(bu 4
\&\f(CW$child\fR (Gtk2::Widget)
.ie n .SS "$list\->\fBunselect_item\fP ($item)"
.el .SS "\f(CW$list\fP\->\fBunselect_item\fP ($item)"
.IX Subsection "$list->unselect_item ($item)"
.IP \(bu 4
\&\f(CW$item\fR (integer)
.SH PROPERTIES
.IX Header "PROPERTIES"
.IP "'selection\-mode' (Gtk2::SelectionMode : default ""none"" : readable / writable / private)" 4
.IX Item "'selection-mode' (Gtk2::SelectionMode : default ""none"" : readable / writable / private)"
.SH SIGNALS
.IX Header "SIGNALS"
.PD 0
.IP "\fBselect-child\fR (Gtk2::List, Gtk2::Widget)" 4
.IX Item "select-child (Gtk2::List, Gtk2::Widget)"
.IP "\fBselection-changed\fR (Gtk2::List)" 4
.IX Item "selection-changed (Gtk2::List)"
.IP "\fBunselect-child\fR (Gtk2::List, Gtk2::Widget)" 4
.IX Item "unselect-child (Gtk2::List, Gtk2::Widget)"
.PD
.SH "ENUMS AND FLAGS"
.IX Header "ENUMS AND FLAGS"
.SS "enum Gtk2::ScrollType"
.IX Subsection "enum Gtk2::ScrollType"
.IP \(bu 4
\&'none' / 'GTK_SCROLL_NONE'
.IP \(bu 4
\&'jump' / 'GTK_SCROLL_JUMP'
.IP \(bu 4
\&'step\-backward' / 'GTK_SCROLL_STEP_BACKWARD'
.IP \(bu 4
\&'step\-forward' / 'GTK_SCROLL_STEP_FORWARD'
.IP \(bu 4
\&'page\-backward' / 'GTK_SCROLL_PAGE_BACKWARD'
.IP \(bu 4
\&'page\-forward' / 'GTK_SCROLL_PAGE_FORWARD'
.IP \(bu 4
\&'step\-up' / 'GTK_SCROLL_STEP_UP'
.IP \(bu 4
\&'step\-down' / 'GTK_SCROLL_STEP_DOWN'
.IP \(bu 4
\&'page\-up' / 'GTK_SCROLL_PAGE_UP'
.IP \(bu 4
\&'page\-down' / 'GTK_SCROLL_PAGE_DOWN'
.IP \(bu 4
\&'step\-left' / 'GTK_SCROLL_STEP_LEFT'
.IP \(bu 4
\&'step\-right' / 'GTK_SCROLL_STEP_RIGHT'
.IP \(bu 4
\&'page\-left' / 'GTK_SCROLL_PAGE_LEFT'
.IP \(bu 4
\&'page\-right' / 'GTK_SCROLL_PAGE_RIGHT'
.IP \(bu 4
\&'start' / 'GTK_SCROLL_START'
.IP \(bu 4
\&'end' / 'GTK_SCROLL_END'
.SS "enum Gtk2::SelectionMode"
.IX Subsection "enum Gtk2::SelectionMode"
.IP \(bu 4
\&'none' / 'GTK_SELECTION_NONE'
.IP \(bu 4
\&'single' / 'GTK_SELECTION_SINGLE'
.IP \(bu 4
\&'browse' / 'GTK_SELECTION_BROWSE'
.IP \(bu 4
\&'multiple' / 'GTK_SELECTION_MULTIPLE'
.IP \(bu 4
\&'extended' / 'GTK_SELECTION_EXTENDED'
.SH "SEE ALSO"
.IX Header "SEE ALSO"
Gtk2, Glib::Object, Glib::InitiallyUnowned, Gtk2::Object, Gtk2::Widget, Gtk2::Container
.SH COPYRIGHT
.IX Header "COPYRIGHT"
Copyright (C) 2003\-2011 by the gtk2\-perl team.
.PP
This software is licensed under the LGPL.  See Gtk2 for a full notice.