Synopsis#include <gtk/gtk.h> GtkList; GtkWidget* gtk_list_new (void); void gtk_list_insert_items (GtkList *list, GList *items, gint position); void gtk_list_append_items (GtkList *list, GList *items); void gtk_list_prepend_items (GtkList *list, GList *items); void gtk_list_remove_items (GtkList *list, GList *items); void gtk_list_remove_items_no_unref (GtkList *list, GList *items); void gtk_list_clear_items (GtkList *list, gint start, gint end); void gtk_list_select_item (GtkList *list, gint item); void gtk_list_unselect_item (GtkList *list, gint item); void gtk_list_select_child (GtkList *list, GtkWidget *child); void gtk_list_unselect_child (GtkList *list, GtkWidget *child); gint gtk_list_child_position (GtkList *list, GtkWidget *child); void gtk_list_set_selection_mode (GtkList *list, GtkSelectionMode mode); void gtk_list_extend_selection (GtkList *list, GtkScrollType scroll_type, gfloat position, gboolean auto_start_selection); void gtk_list_start_selection (GtkList *list); void gtk_list_end_selection (GtkList *list); void gtk_list_select_all (GtkList *list); void gtk_list_unselect_all (GtkList *list); void gtk_list_scroll_horizontal (GtkList *list, GtkScrollType scroll_type, gfloat position); void gtk_list_scroll_vertical (GtkList *list, GtkScrollType scroll_type, gfloat position); void gtk_list_toggle_add_mode (GtkList *list); void gtk_list_toggle_focus_row (GtkList *list); void gtk_list_toggle_row (GtkList *list, GtkWidget *item); void gtk_list_undo_selection (GtkList *list); void gtk_list_end_drag_selection (GtkList *list); Object HierarchyGObject +----GInitiallyUnowned +----GtkObject +----GtkWidget +----GtkContainer +----GtkList DescriptionThe GtkList widget is a container whose children are displayed vertically in order, and can be selected. The list has many selection modes, which are programmer selective and depend on how many elements are able to be selected at the same time. GtkList has been deprecated since GTK+ 2.0 and should not be used in newly written code. Use GtkTreeView instead. DetailsGtkListtypedef struct _GtkList GtkList; Warning
gtk_list_new ()GtkWidget* gtk_list_new (void); Warning
Creates a new GtkList.
gtk_list_insert_items ()void gtk_list_insert_items (GtkList *list, GList *items, gint position); Warning
Inserts
gtk_list_append_items ()void gtk_list_append_items (GtkList *list, GList *items); Warning
Adds
gtk_list_prepend_items ()void gtk_list_prepend_items (GtkList *list, GList *items); Warning
Inserts
gtk_list_remove_items ()void gtk_list_remove_items (GtkList *list, GList *items); Warning
Removes the
gtk_list_remove_items_no_unref ()void gtk_list_remove_items_no_unref (GtkList *list, GList *items); Warning
Removes the
gtk_list_clear_items ()void gtk_list_clear_items (GtkList *list, gint start, gint end); Warning
Removes the items between index
gtk_list_select_item ()void gtk_list_select_item (GtkList *list, gint item); Warning
Selects the child number
gtk_list_unselect_item ()void gtk_list_unselect_item (GtkList *list, gint item); Warning
Unselects the child number
gtk_list_select_child ()void gtk_list_select_child (GtkList *list, GtkWidget *child); Warning
Selects the given
gtk_list_unselect_child ()void gtk_list_unselect_child (GtkList *list, GtkWidget *child); Warning
Unselects the given
gtk_list_child_position ()gint gtk_list_child_position (GtkList *list, GtkWidget *child); Warning
Searches the children of
gtk_list_set_selection_mode ()void gtk_list_set_selection_mode (GtkList *list, GtkSelectionMode mode); Warning
Set the list selection mode. The selection mode can be any value in ""
gtk_list_extend_selection ()void gtk_list_extend_selection (GtkList *list, GtkScrollType scroll_type, gfloat position, gboolean auto_start_selection); Warning
Extends the selection by moving the anchor according to
gtk_list_start_selection ()void gtk_list_start_selection (GtkList *list); Warning
Starts a selection (or part of selection) at the focused child. Only in GTK_SELECTION_EXTENDED mode.
gtk_list_end_selection ()void gtk_list_end_selection (GtkList *list); Warning
Ends the selection. Used with
gtk_list_select_all ()void gtk_list_select_all (GtkList *list); Warning
Selects all children of
gtk_list_unselect_all ()void gtk_list_unselect_all (GtkList *list); Warning
Unselects all children of
gtk_list_scroll_horizontal ()void gtk_list_scroll_horizontal (GtkList *list, GtkScrollType scroll_type, gfloat position); Warning
Scrolls
gtk_list_scroll_vertical ()void gtk_list_scroll_vertical (GtkList *list, GtkScrollType scroll_type, gfloat position); Warning
Scrolls
gtk_list_toggle_add_mode ()void gtk_list_toggle_add_mode (GtkList *list); Warning
Toggles between adding to the selection and beginning a new selection. Only
in GTK_SELECTION_EXTENDED. Useful with
gtk_list_toggle_focus_row ()void gtk_list_toggle_focus_row (GtkList *list); Warning
Toggles the focus row. If the focus row is selected, it's
unselected. If the focus row is unselected, it's selected. If the
selection mode of
gtk_list_toggle_row ()void gtk_list_toggle_row (GtkList *list, GtkWidget *item); Warning
Toggles the child
gtk_list_undo_selection ()void gtk_list_undo_selection (GtkList *list); Warning
Restores the selection in the last state, only if selection mode is GTK_SELECTION_EXTENDED. If this function is called twice, the selection is cleared. This function sometimes gives stranges "last states".
gtk_list_end_drag_selection ()void gtk_list_end_drag_selection (GtkList *list); Warning
Stops the drag selection mode and ungrabs the pointer. This has no effect if a drag selection is not active.
Property DetailsThe
|
|
the object which received the signal. |
|
the newly selected child. |
|
user data set when the signal handler was connected. |
"selection-changed"
signalvoid user_function (GtkList *list, gpointer user_data) : Run First
The selection of the widget has just changed.
|
the object which received the signal. |
|
user data set when the signal handler was connected. |
"unselect-child"
signalvoid user_function (GtkList *list, GtkWidget *widget, gpointer user_data) : Run First
The child widget
has just been unselected.
|
the object which received the signal. |
|
the newly unselected child. |
|
user data set when the signal handler was connected. |
For functions that apply to every GtkContainer (like GtkList). |
|
GtkListitem |
Children of a GtkList widget must be of this type. |