Synopsis#include <gtk/gtk.h> GtkTree; #define GTK_IS_ROOT_TREE (obj) #define GTK_TREE_ROOT_TREE (obj) #define GTK_TREE_SELECTION_OLD (obj) enum GtkTreeViewMode; GtkWidget* gtk_tree_new (void); void gtk_tree_append (GtkTree *tree, GtkWidget *tree_item); void gtk_tree_prepend (GtkTree *tree, GtkWidget *tree_item); void gtk_tree_insert (GtkTree *tree, GtkWidget *tree_item, gint position); void gtk_tree_remove_items (GtkTree *tree, GList *items); void gtk_tree_clear_items (GtkTree *tree, gint start, gint end); void gtk_tree_select_item (GtkTree *tree, gint item); void gtk_tree_unselect_item (GtkTree *tree, gint item); void gtk_tree_select_child (GtkTree *tree, GtkWidget *tree_item); void gtk_tree_unselect_child (GtkTree *tree, GtkWidget *tree_item); gint gtk_tree_child_position (GtkTree *tree, GtkWidget *child); void gtk_tree_set_selection_mode (GtkTree *tree, GtkSelectionMode mode); void gtk_tree_set_view_mode (GtkTree *tree, GtkTreeViewMode mode); void gtk_tree_set_view_lines (GtkTree *tree, gboolean flag); void gtk_tree_remove_item (GtkTree *tree, GtkWidget *child); Object HierarchyGObject +----GInitiallyUnowned +----GtkObject +----GtkWidget +----GtkContainer +----GtkTree Description
Warning
GtkTree is deprecated and unsupported. It is known to be
buggy. To use it, you must define the symbol The GtkTree widget is a container that shows users a list of items, in a tree format complete with branches and leafnodes. Branches can be expanded to show their child items, or collapsed to hide them. DetailsGtkTreetypedef struct _GtkTree GtkTree; Warning
struct _GtkTree { GtkContainer container; GList *children; GtkTree* root_tree; /* owner of selection list */ GtkWidget* tree_owner; GList *selection; guint level; guint indent_value; guint current_indent; guint selection_mode : 2; guint view_mode : 1; guint view_line : 1; };
GTK_IS_ROOT_TREE()#define GTK_IS_ROOT_TREE(obj) ((GtkObject*) GTK_TREE(obj)->root_tree == (GtkObject*)obj) Warning
A macro that returns a boolean value which indicates if GTK_TREE_ROOT_TREE()#define GTK_TREE_ROOT_TREE(obj) (GTK_TREE(obj)->root_tree ? GTK_TREE(obj)->root_tree : GTK_TREE(obj)) Warning
A macro that returns the root tree of
If GTK_TREE_SELECTION_OLD()#define GTK_TREE_SELECTION_OLD(obj) (GTK_TREE_ROOT_TREE(obj)->selection) Warning
enum GtkTreeViewModetypedef enum { GTK_TREE_VIEW_LINE, /* default view mode */ GTK_TREE_VIEW_ITEM } GtkTreeViewMode; Warning
gtk_tree_new ()GtkWidget* gtk_tree_new (void); Warning
Creates a new GtkTree.
gtk_tree_append ()void gtk_tree_append (GtkTree *tree, GtkWidget *tree_item); Warning
Adds the GtkTreeItem in gtk_tree_prepend ()void gtk_tree_prepend (GtkTree *tree, GtkWidget *tree_item); Warning
Adds the GtkTreeItem in gtk_tree_insert ()void gtk_tree_insert (GtkTree *tree, GtkWidget *tree_item, gint position); Warning
Adds the GtkTreeItem in gtk_tree_remove_items ()void gtk_tree_remove_items (GtkTree *tree, GList *items); Warning
Removes a list of items from the GtkTree in
If only one item is to be removed from the GtkTree,
Removing an item from a GtkTree dereferences the item, and thus usually destroys the item and any subtrees it may contain. If the item is not to be destroyed, use
gtk_tree_clear_items ()void gtk_tree_clear_items (GtkTree *tree, gint start, gint end); Warning
Removes the items at positions between
Removing an item from a GtkTree dereferences the item, and thus usually destroys the item and any subtrees it may contain. If the item is not to be destroyed, use
gtk_tree_select_item ()void gtk_tree_select_item (GtkTree *tree, gint item); Warning
Emits the select_item signal for the child at position
gtk_tree_unselect_item ()void gtk_tree_unselect_item (GtkTree *tree, gint item); Warning
Emits the unselect_item for the child at position
gtk_tree_select_child ()void gtk_tree_select_child (GtkTree *tree, GtkWidget *tree_item); Warning
Emits the select_item signal for the child gtk_tree_unselect_child ()void gtk_tree_unselect_child (GtkTree *tree, GtkWidget *tree_item); Warning
Emits the unselect_item signal for the child gtk_tree_child_position ()gint gtk_tree_child_position (GtkTree *tree, GtkWidget *child); Warning
Returns the position of
If gtk_tree_set_selection_mode ()void gtk_tree_set_selection_mode (GtkTree *tree, GtkSelectionMode mode); Warning
Sets the selection mode for the GtkTree
The selection mode is only defined for a root tree, as the root tree "owns" the selection.
The default mode is
gtk_tree_set_view_mode ()void gtk_tree_set_view_mode (GtkTree *tree, GtkTreeViewMode mode); Warning
Sets the 'viewmode' for the GtkTree in
The default mode is
gtk_tree_set_view_lines ()void gtk_tree_set_view_lines (GtkTree *tree, gboolean flag); Warning
Sets whether or not the connecting lines between branches and children are drawn.
Signal DetailsThe
|
|
the object which received the signal. |
|
The child that is about to be selected. |
|
user data set when the signal handler was connected. |
"selection-changed"
signalvoid user_function (GtkTree *tree, gpointer user_data) : Run First
This signal is emitted by the root tree whenever the selection changes.
|
the object which received the signal. |
|
user data set when the signal handler was connected. |
"unselect-child"
signalvoid user_function (GtkTree *tree, GtkWidget *widget, gpointer user_data) : Run First
This signal is emitted by tree
whenever widget
is about to be unselected.
|
the object which received the signal. |
|
The child that is about to be unselected. |
|
user data set when the signal handler was connected. |
GtkTreeList for the items to put into a GtkTree.
GtkScrolledWindow for details on how to scroll around a GtkTree.