![]() |
![]() |
![]() |
GNOME Data Access 5 manual | ![]() |
---|---|---|---|---|
Top | Description |
GdauiTreeStoreGdauiTreeStore — Bridge between a GdaTree and a GtkTreeModel |
struct GdauiTreeStore; GtkTreeModel * gdaui_tree_store_new (GdaTree *tree
,guint n_columns
,...
); GtkTreeModel * gdaui_tree_store_newv (GdaTree *tree
,guint n_columns
,GType *types
,const gchar **attribute_names
); GdaTreeNode * gdaui_tree_store_get_node (GdauiTreeStore *store
,GtkTreeIter *iter
); gboolean gdaui_tree_store_get_iter (GdauiTreeStore *store
,GtkTreeIter *iter
,GdaTreeNode *node
);
The GdauiTreeStore implements the GtkTreeModel interface required to display data from a GdaTree in a GtkTreeView widget.
To allow a tree to be populated only on request (ie. when the user expands a row), each
GdaTreeNode can give the attribute named GDA_ATTRIBUTE_TREE_NODE_UNKNOWN_CHILDREN
a boolean TRUE
GValue to tell the GdauiTreeStore data model to artificially add
a dummy child for the row corresponding to the GdaTreeNode. Then the programmer
can connect to the GtkTreeView::test-expand-row
signal and update the requested children.
GtkTreeModel * gdaui_tree_store_new (GdaTree *tree
,guint n_columns
,...
);
Creates a GtkTreeModel interface with a GdaTree, mapping columns to attributes' values.
As an example, gdaui_tree_store_new (tree, 2, G_TYPE_STRING, "name", G_TYPE_STRING, "schema");
creates
a GtkTreeStore with two columns (of type G_TYPE_STRING), one with the values of the "name" attribute, and one with
the values of the "schema" attribute.
Note that the GType has to correspond to the type of value associated with the attribute name (no type conversion is done), and a warning will be displayed in case of type mismatch.
|
a GdaTree object |
|
number of columns in the tree store |
|
couples of (GType, attribute name) for each column, from first to last |
Returns : |
the new object, or NULL if an attribute's name was NULL or an empty string |
Since 4.2
GtkTreeModel * gdaui_tree_store_newv (GdaTree *tree
,guint n_columns
,GType *types
,const gchar **attribute_names
);
Creates a GtkTreeModel interface with a GdaTree, mapping columns to attributes' values.
For more information and limitations, see gdaui_tree_store_new()
.
|
a GdaTree object |
|
number of columns in the tree store |
|
an array of n_columns GType to specify the type of each column |
|
an array of n_columns strings to specify the attribute name
to map each column on |
Returns : |
the new object, or NULL if an inconsistency exists in the parameters |
Since 4.2
GdaTreeNode * gdaui_tree_store_get_node (GdauiTreeStore *store
,GtkTreeIter *iter
);
Get the GdaTreeNode represented by iter
.
|
a GdauiTreeStore object |
|
a valid GtkTreeIter |
Returns : |
the GdaTreeNode represented by iter , or NULL if an error occurred. [transfer none]
|
Since 4.2.8
gboolean gdaui_tree_store_get_iter (GdauiTreeStore *store
,GtkTreeIter *iter
,GdaTreeNode *node
);
Sets iter
to represent node
in the tree.
|
a GdauiTreeStore object |
|
a pointer to a GtkTreeIter |
|
a GdaTreeNode in store
|
Returns : |
TRUE if no error occurred and iter is valid |
Since 4.2.8