GNOME.org

ETreeModel

ETreeModel

Functions

ETreePath e_tree_model_get_root ()
ETreePath e_tree_model_node_get_parent ()
ETreePath e_tree_model_node_get_first_child ()
ETreePath e_tree_model_node_get_next ()
gboolean e_tree_model_node_is_root ()
gboolean e_tree_model_node_is_expandable ()
guint e_tree_model_node_get_n_nodes ()
guint e_tree_model_node_get_n_children ()
guint e_tree_model_node_depth ()
gboolean e_tree_model_get_expanded_default ()
gint e_tree_model_column_count ()
gchar * e_tree_model_get_save_id ()
ETreePath e_tree_model_get_node_by_id ()
gpointer e_tree_model_sort_value_at ()
gpointer e_tree_model_value_at ()
gpointer e_tree_model_duplicate_value ()
void e_tree_model_free_value ()
gpointer e_tree_model_initialize_value ()
gboolean e_tree_model_value_is_empty ()
gchar * e_tree_model_value_to_string ()
gboolean (*ETreePathFunc) ()
void e_tree_model_node_traverse ()
ETreePath e_tree_model_node_find ()
void e_tree_model_pre_change ()
void e_tree_model_rebuilt ()
void e_tree_model_node_changed ()
void e_tree_model_node_data_changed ()
void e_tree_model_node_inserted ()
void e_tree_model_node_removed ()
void e_tree_model_node_deleted ()

Signals

void node-changed Run Last
void node-data-changed Run Last
void node-deleted Run Last
void node-inserted Run Last
void node-removed Run Last
void pre-change Run Last
void rebuilt Run Last

Types and Values

  ETreeModel
typedef ETreePath

Object Hierarchy

    GInterface
    ╰── ETreeModel

Prerequisites

ETreeModel requires GObject.

Description

Functions

e_tree_model_get_root ()

ETreePath
e_tree_model_get_root (ETreeModel *tree_model);

Accessor for the root node of tree_model .

return values: the ETreePath corresponding to the root node.

Parameters

tree_model

the ETreeModel of which we want the root node.

  

e_tree_model_node_get_parent ()

ETreePath
e_tree_model_node_get_parent (ETreeModel *tree_model,
                              ETreePath path);

Returns

e_tree_model_node_get_first_child ()

ETreePath
e_tree_model_node_get_first_child (ETreeModel *tree_model,
                                   ETreePath path);

Returns

e_tree_model_node_get_next ()

ETreePath
e_tree_model_node_get_next (ETreeModel *tree_model,
                            ETreePath path);

Returns

e_tree_model_node_is_root ()

gboolean
e_tree_model_node_is_root (ETreeModel *tree_model,
                           ETreePath path);

Returns

e_tree_model_node_is_expandable ()

gboolean
e_tree_model_node_is_expandable (ETreeModel *tree_model,
                                 ETreePath path);

Returns

e_tree_model_node_get_n_nodes ()

guint
e_tree_model_node_get_n_nodes (ETreeModel *tree_model);

e_tree_model_node_get_n_children ()

guint
e_tree_model_node_get_n_children (ETreeModel *tree_model,
                                  ETreePath path);

e_tree_model_node_depth ()

guint
e_tree_model_node_depth (ETreeModel *tree_model,
                         ETreePath path);

Returns

e_tree_model_get_expanded_default ()

gboolean
e_tree_model_get_expanded_default (ETreeModel *tree_model);

XXX docs here.

return values: Whether nodes should be expanded by default.

Parameters

tree_model

The ETreeModel.

  

e_tree_model_column_count ()

gint
e_tree_model_column_count (ETreeModel *tree_model);

XXX docs here.

return values: The number of columns

Parameters

tree_model

The ETreeModel.

  

e_tree_model_get_save_id ()

gchar *
e_tree_model_get_save_id (ETreeModel *tree_model,
                          ETreePath path);

XXX docs here.

return values: The save id for this path.

Parameters

tree_model

The ETreeModel.

  

path

The ETreePath.

  

e_tree_model_get_node_by_id ()

ETreePath
e_tree_model_get_node_by_id (ETreeModel *tree_model,
                             const gchar *save_id);

get_node_by_id(get_save_id(node)) should be the original node. Likewise if get_node_by_id is not NULL, then get_save_id(get_node_by_id(string)) should be a copy of the original string.

return values: The path for this save id.

Parameters

tree_model

The ETreeModel.

  

e_tree_model_sort_value_at ()

gpointer
e_tree_model_sort_value_at (ETreeModel *tree_model,
                            ETreePath path,
                            gint col);

Parameters

tree_model

The ETreeModel.

  

path

The ETreePath to the node we're getting the data from.

  

col

the column to retrieve data from

  

Returns

This function returns the value that is stored by the tree_model in column col and node path . The data returned can be a pointer or any data value that can be stored inside a pointer.

The data returned is typically used by an sort renderer if it wants to proxy the data of cell value_at at a better sorting order.

The data returned must be valid until the model sends a signal that affect that piece of data. node_changed and node_deleted affect all data in tha t node and all nodes under that node. node_data_changed affects the data in that node. node_col_changed affects the data in that node for that column. node_inserted, node_removed, and no_change don't affect any data in this way.

e_tree_model_value_at ()

gpointer
e_tree_model_value_at (ETreeModel *tree_model,
                       ETreePath path,
                       gint col);

Parameters

tree_model

The ETreeModel.

  

path

The ETreePath to the node we're getting the data from.

  

col

the column to retrieve data from

  

Returns

This function returns the value that is stored by the tree_model in column col and node path . The data returned can be a pointer or any data value that can be stored inside a pointer.

The data returned is typically used by an ECell renderer.

The data returned must be valid until the model sends a signal that affect that piece of data. node_changed and node_deleted affect all data in tha t node and all nodes under that node. node_data_changed affects the data in that node. node_col_changed affects the data in that node for that column. node_inserted, node_removed, and no_change don't affect any data in this way.

e_tree_model_duplicate_value ()

gpointer
e_tree_model_duplicate_value (ETreeModel *tree_model,
                              gint col,
                              gconstpointer value);

Returns

e_tree_model_free_value ()

void
e_tree_model_free_value (ETreeModel *tree_model,
                         gint col,
                         gpointer value);

Returns

e_tree_model_initialize_value ()

gpointer
e_tree_model_initialize_value (ETreeModel *tree_model,
                               gint col);

Returns

e_tree_model_value_is_empty ()

gboolean
e_tree_model_value_is_empty (ETreeModel *tree_model,
                             gint col,
                             gconstpointer value);

Returns

e_tree_model_value_to_string ()

gchar *
e_tree_model_value_to_string (ETreeModel *tree_model,
                              gint col,
                              gconstpointer value);

Returns

ETreePathFunc ()

gboolean
(*ETreePathFunc) (ETreeModel *tree_model,
                  ETreePath path,
                  gpointer data);

e_tree_model_node_traverse ()

void
e_tree_model_node_traverse (ETreeModel *tree_model,
                            ETreePath path,
                            ETreePathFunc func,
                            gpointer data);

e_tree_model_node_find ()

ETreePath
e_tree_model_node_find (ETreeModel *tree_model,
                        ETreePath path,
                        ETreePath end_path,
                        ETreePathFunc func,
                        gpointer data);

e_tree_model_pre_change ()

void
e_tree_model_pre_change (ETreeModel *tree_model);

Returns

e_tree_model_rebuilt ()

void
e_tree_model_rebuilt (ETreeModel *tree_model);

Returns

e_tree_model_node_changed ()

void
e_tree_model_node_changed (ETreeModel *tree_model,
                           ETreePath path);

Returns

e_tree_model_node_data_changed ()

void
e_tree_model_node_data_changed (ETreeModel *tree_model,
                                ETreePath path);

Returns

e_tree_model_node_inserted ()

void
e_tree_model_node_inserted (ETreeModel *tree_model,
                            ETreePath parent_path,
                            ETreePath inserted_path);

e_tree_model_node_removed ()

void
e_tree_model_node_removed (ETreeModel *tree_model,
                           ETreePath parent_path,
                           ETreePath removed_path,
                           gint old_position);

e_tree_model_node_deleted ()

void
e_tree_model_node_deleted (ETreeModel *tree_model,
                           ETreePath deleted_path);

Types and Values

ETreeModel

typedef struct _ETreeModel ETreeModel;

ETreePath

typedef gpointer ETreePath;

Signal Details

The “node-changed” signal

void
user_function (ETreeModel *etreemodel,
               gpointer    arg1,
               gpointer    user_data)

Flags: Run Last

The “node-data-changed” signal

void
user_function (ETreeModel *etreemodel,
               gpointer    arg1,
               gpointer    user_data)

Flags: Run Last

The “node-deleted” signal

void
user_function (ETreeModel *etreemodel,
               gpointer    arg1,
               gpointer    user_data)

Flags: Run Last

The “node-inserted” signal

void
user_function (ETreeModel *etreemodel,
               gpointer    arg1,
               gpointer    arg2,
               gpointer    user_data)

Flags: Run Last

The “node-removed” signal

void
user_function (ETreeModel *etreemodel,
               gpointer    arg1,
               gpointer    arg2,
               gint        arg3,
               gpointer    user_data)

Flags: Run Last

The “pre-change” signal

void
user_function (ETreeModel *etreemodel,
               gpointer    user_data)

Flags: Run Last

The “rebuilt” signal

void
user_function (ETreeModel *etreemodel,
               gpointer    user_data)

Flags: Run Last

Generated by GTK-Doc V1.21