ETree

ETree

Functions

gboolean e_tree_construct ()
GtkWidget * e_tree_new ()
ETableState * e_tree_get_state_object ()
ETableSpecification * e_tree_get_spec ()
void e_tree_set_state_object ()
void e_tree_show_cursor_after_reflow ()
void e_tree_set_cursor ()
ETreePath e_tree_get_cursor ()
void e_tree_path_foreach ()
void e_tree_get_cell_at ()
void e_tree_get_cell_geometry ()
ETreeModel * e_tree_get_model ()
ESelectionModel * e_tree_get_selection_model ()
ETreeTableAdapter * e_tree_get_table_adapter ()
void e_tree_drag_source_set ()
void e_tree_drag_source_unset ()
GdkDragContext * e_tree_drag_begin ()
gboolean e_tree_is_dragging ()
ETableItem * e_tree_get_item ()
GnomeCanvasItem * e_tree_get_header_item ()
void e_tree_set_info_message ()
void e_tree_freeze_state_change ()
void e_tree_thaw_state_change ()
gboolean e_tree_is_editing ()
gboolean e_tree_get_grouped_view ()
void e_tree_set_grouped_view ()
gboolean e_tree_get_sort_children_ascending ()
void e_tree_set_sort_children_ascending ()

Description

Functions

e_tree_construct ()

gboolean
e_tree_construct (ETree *tree,
                  ETreeModel *etm,
                  ETableExtras *ete,
                  ETableSpecification *specification);

This is the internal implementation of e_tree_new() for use by subclasses or language bindings. See e_tree_new() for details.

Parameters

tree

The newly created ETree object.

 

etm

The model for this table.

 

ete

An optional ETableExtras. (NULL is valid.)

 

specification

an ETableSpecification

 

Returns

TRUE on success, FALSE if an error occurred


e_tree_new ()

GtkWidget *
e_tree_new (ETreeModel *etm,
            ETableExtras *ete,
            ETableSpecification *specification);

This function creates an ETree from the given parameters. The ETreeModel is a tree model to be represented. The ETableExtras is an optional set of pixbufs, cells, and sorting functions to be used when interpreting the spec. If you pass in NULL it uses the default ETableExtras. (See e_table_extras_new()).

specification is the specification of the set of viewable columns and the default sorting state and such. state is an optional string specifying the current sorting state and such.

Parameters

etm

The model for this tree

 

ete

An optional ETableExtras (NULL is valid.)

 

specification

an ETableSpecification

 

Returns

The newly created ETree or NULL if there's an error.


e_tree_get_state_object ()

ETableState *
e_tree_get_state_object (ETree *tree);

Builds an ETableState corresponding to the current state of the ETree.

Parameters

tree

ETree object to act on

 

Returns

The ETableState object generated.


e_tree_get_spec ()

ETableSpecification *
e_tree_get_spec (ETree *tree);

Returns the specification object.

Parameters

tree

The ETree to query

 

e_tree_set_state_object ()

void
e_tree_set_state_object (ETree *tree,
                         ETableState *state);

e_tree_show_cursor_after_reflow ()

void
e_tree_show_cursor_after_reflow (ETree *tree);

e_tree_set_cursor ()

void
e_tree_set_cursor (ETree *tree,
                   ETreePath path);

e_tree_get_cursor ()

ETreePath
e_tree_get_cursor (ETree *tree);

e_tree_path_foreach ()

void
e_tree_path_foreach (ETree *tree,
                     ETreeForeachFunc callback,
                     gpointer closure);

e_tree_get_cell_at ()

void
e_tree_get_cell_at (ETree *tree,
                    gint x,
                    gint y,
                    gint *row_return,
                    gint *col_return);

Return the row and column for the cell in which the pixel at (x , y ) is contained.

Parameters

tree

An ETree widget

 

x

X coordinate for the pixel

 

y

Y coordinate for the pixel

 

row_return

Pointer to return the row value

 

col_return

Pointer to return the column value

 

e_tree_get_cell_geometry ()

void
e_tree_get_cell_geometry (ETree *tree,
                          gint row,
                          gint col,
                          gint *x_return,
                          gint *y_return,
                          gint *width_return,
                          gint *height_return);

Computes the data about this cell.

Parameters

tree

The tree.

 

row

The row to get the geometry of.

 

col

The col to get the geometry of.

 

x_return

Returns the x coordinate of the upper right hand corner of the cell with respect to the widget.

 

y_return

Returns the y coordinate of the upper right hand corner of the cell with respect to the widget.

 

width_return

Returns the width of the cell.

 

height_return

Returns the height of the cell.

 

e_tree_get_model ()

ETreeModel *
e_tree_get_model (ETree *tree);

Returns the model upon which this ETree is based.

Parameters

tree

the ETree

 

Returns

the model


e_tree_get_selection_model ()

ESelectionModel *
e_tree_get_selection_model (ETree *tree);

Returns the selection model of this ETree.

Parameters

tree

the ETree

 

Returns

the selection model


e_tree_get_table_adapter ()

ETreeTableAdapter *
e_tree_get_table_adapter (ETree *tree);

Returns the table adapter this ETree uses.

Parameters

tree

the ETree

 

Returns

the model


e_tree_drag_source_set ()

void
e_tree_drag_source_set (ETree *tree,
                        GdkModifierType start_button_mask,
                        const GtkTargetEntry *targets,
                        gint n_targets,
                        GdkDragAction actions);

e_tree_drag_source_unset ()

void
e_tree_drag_source_unset (ETree *tree);

e_tree_drag_begin ()

GdkDragContext *
e_tree_drag_begin (ETree *tree,
                   gint row,
                   gint col,
                   GtkTargetList *targets,
                   GdkDragAction actions,
                   gint button,
                   GdkEvent *event);

e_tree_is_dragging ()

gboolean
e_tree_is_dragging (ETree *tree);

Returns whether is tree in a drag&drop operation.

Parameters

tree

An ETree widget

 

e_tree_get_item ()

ETableItem *
e_tree_get_item (ETree *tree);

e_tree_get_header_item ()

GnomeCanvasItem *
e_tree_get_header_item (ETree *tree);

e_tree_set_info_message ()

void
e_tree_set_info_message (ETree *tree,
                         const gchar *info_message);

Creates an info message in table area, or removes old.

Parameters

tree

ETree instance

 

info_message

Message to set. Can be NULL.

 

e_tree_freeze_state_change ()

void
e_tree_freeze_state_change (ETree *tree);

e_tree_thaw_state_change ()

void
e_tree_thaw_state_change (ETree *tree);

e_tree_is_editing ()

gboolean
e_tree_is_editing (ETree *tree);

e_tree_get_grouped_view ()

gboolean
e_tree_get_grouped_view (ETree *tree);

e_tree_set_grouped_view ()

void
e_tree_set_grouped_view (ETree *tree,
                         gboolean grouped_view);

e_tree_get_sort_children_ascending ()

gboolean
e_tree_get_sort_children_ascending (ETree *tree);

e_tree_set_sort_children_ascending ()

void
e_tree_set_sort_children_ascending (ETree *tree,
                                    gboolean sort_children_ascending);

Types and Values