Webhosting and cheap domain registration service
  

 Home

GTK Classes
Prev GtkList Next

GtkList

Widget displaying a list of selectable items.

Object Hierarchy

GtkObject
`-- GtkWidget
       `-- GtkContainer
              `-- GtkList

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.

Constructor

GtkList (void);

-- Creates a container for a simple list.

Methods

append_items()
  Appends an array of list items to a list.
clear_items()
  Clears designated list items from list.
select_item()
  Causes the "select-child" signal to be emitted.
unselect_item()
  Causes the "unselect-child" signal to be emitted.
select_child()
  Causes the "select-child" signal to be emitted.
unselect_child()
  Causes the "unselect-child" signal to be emitted.
child_position()
  Returns item specified by list position.
set_selection_mode()
  Sets the selection mode.
extend_selection()
  Extends selected area to position given.
start_selection()
  Selects range from anchor to currently selected item.
end_selection()
  Curtails selection set with start_selection() .
select_all()
  Selects all list items.
unselect_all()
  Deselects all list items.
scroll_horizontal()
  Sets associated horizontal scrollbar to a predetermined position.
scroll_vertical()
  Sets associated vertical scrollbar to a predetermined position.
toggle_add_mode()
  Toggles whether further selections may be added in extended mode.
toggle_focus_row()
  Toggles selection status of row with focus.
toggle_row()
  Toggles selection status of specified row.
undo_selection()
  In extended mode, returns selection to its previous state.
end_drag_selection()
  Ends drag selection.

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.


Prev Home Next
GtkLayout::thaw Up GtkList Constructor

 

  

Network sites:

Cheap domain registrar's cheap domain registration service

$8.95 domain registration : Buy domain name or register domain name 

 
 
Quotes:
Experience is never limited, and it is never complete; it is an immense sensibility, a kind of huge spider-web of the finest silken threads suspended in the chamber of consciousness, and catching every air-borne particle in its tissue.  
 
 

Disclaimer: This documentation is provided only for the benefits of our webhosting customers.
For authoritative source of the documentation, please refer to http://gtk.php.net/docs.php