GtkList
Widget displaying a list of selectable items.
Object Hierarchy
Direct subclasses
None.
Description
A GtkList is a container widget that is designed
to hold a simple list, the full range of which is displayed. The items
held in the list are selectable, with the default selection mode set as
GTK_SELECTION_SINGLE. Each item in the list must be
a GtkListItem widget. Glade users will find that
they need to code these manually in order to populate a list or combo box.
The signal part of the function/signal pair for most of the methods given
here is private in GtkList, but is also
implemented in GtkListItem. As this secondary
implementation is also private, these signals are not covered in this
manual. Although those signals that have GTK keybindings will cause the
appropriate signal to be publicly fired when their key combinations are
used, there is no other way to emit this range of signals. The
keybindings are listed under GtkListItem; the
signal prototypes share the relevant GtkList
method's parameters, should you need to connect to them.
If you need a list with multiple columns and/or titles with sorting
support, GtkCList is the right class for you.
See also: GtkCList,
GtkCombo,
GtkListItem.
GtkList has been deprecated since GTK+ 2.0 and should
not be used in newly written code.
Constructor
--
Creates a container for a simple list.
Signals
"selection-changed"
Emitted when the selection property is changed.
"select-child"
Emitted when a list item is selected.
"unselect-child"
Emitted when a list item is deselected.
Properties
selection:
Array containing current selection information.
