gnc-tree-view.h File Reference

common utilities for manipulating a GtkTreeView within gnucash More...

#include <gtk/gtk.h>

Go to the source code of this file.

Data Structures
struct	_GncTreeViewClass

Macros
#define	GNC_TYPE_TREE_VIEW   (gnc_tree_view_get_type ())
#define	GNC_TREE_VIEW_NAME   "GncTreeView"
#define	MODEL_COLUMN   "model_column"
#define	REAL_TITLE   "real_title"
#define	PREF_NAME   "pref-name"
#define	ALWAYS_VISIBLE   "always-visible"
#define	DEFAULT_VISIBLE   "default-visible"
#define	GNC_TREE_VIEW_COLUMN_DATA_NONE   -1
#define	GNC_TREE_VIEW_COLUMN_COLOR_NONE   -1
#define	GNC_TREE_VIEW_COLUMN_VISIBLE_ALWAYS   -1

Typedefs
typedef void(*	renderer_toggled) (GtkCellRendererToggle *cell_renderer_toggle, const gchar *path, gpointer user_data)

Functions
Tree View Creation
GtkTreeViewColumn *	gnc_tree_view_add_toggle_column (GncTreeView *view, const gchar *column_title, const gchar *column_short_title, const gchar *pref_name, gint model_data_column, gint model_visibility_column, GtkTreeIterCompareFunc column_sort_fn, renderer_toggled toggle_edited_cb)
	This function adds a new toggle column to a GncTreeView base view. More...
GtkTreeViewColumn *	gnc_tree_view_add_text_column (GncTreeView *view, const gchar *column_title, const gchar *pref_name, const gchar *icon_name, const gchar *sizing_text, gint model_data_column, gint model_visibility_column, GtkTreeIterCompareFunc column_sort_fn)
	This function adds a new text column to a GncTreeView base view. More...
GtkTreeViewColumn *	gnc_tree_view_add_text_view_column (GncTreeView *view, const gchar *column_title, const gchar *pref_name, const gchar *icon_name, const gchar *sizing_text, gint model_data_column, gint model_visibility_column, GtkTreeIterCompareFunc column_sort_fn)
	This function adds a new text view column to a GncTreeView base view. More...
GtkTreeViewColumn *	gnc_tree_view_add_pix_column (GncTreeView *view, const gchar *column_title, const gchar *pref_name, const gchar *sizing_text, gint model_data_column, gint model_visibility_column, GtkTreeIterCompareFunc column_sort_fn)
	This function adds a pixbuf view column to a GncTreeView base view. More...
GtkTreeViewColumn *	gnc_tree_view_add_numeric_column (GncTreeView *view, const gchar *column_title, const gchar *pref_name, const gchar *sizing_text, gint model_data_column, gint model_color_column, gint model_visibility_column, GtkTreeIterCompareFunc column_sort_fn)
	This function adds a new numeric column to a GncTreeView base view. More...
gint	gnc_tree_view_append_column (GncTreeView *view, GtkTreeViewColumn *column)
	Add a column to a view based upon a GncTreeView. More...
Tree View Properties
void	gnc_tree_view_configure_columns (GncTreeView *view)
	Make all the correct columns visible, respecting their default visibility setting, their "always" visibility setting, and the last saved state if available. More...
GtkTreeViewColumn *	gnc_tree_view_find_column_by_name (GncTreeView *view, const gchar *wanted)
	Find a tree column given the "pref name". More...
void	gnc_tree_view_set_state_section (GncTreeView *view, const gchar *section)
	This function is called to set up or remove an association between a saved state section and the display of a view. More...
const gchar *	gnc_tree_view_get_state_section (GncTreeView *view)
	This function is called to get the current association between a saved state section and the display of a view. More...
void	gnc_tree_view_remove_state_information (GncTreeView *view)
	This function is called to completely wipe the treeview's state information (column visibility, width, sorting order,..). More...
void	gnc_tree_view_save_state (GncTreeView *view)
	This function is called to write the treeview's state information (column visibility, width, sorting order,..) to the state file. More...
void	gnc_tree_view_expand_columns (GncTreeView *view, gchar *first_column_name,...)
	This function set the columns that will be allocated the free space in the view. More...
void	gnc_tree_view_set_control_column_background (GncTreeView *view, gint column, GtkTreeCellDataFunc func)
	This function links the cell backgrounds of the two control columns to a column in the model that has color strings or a cell data function that sets the "cell-background" property. More...
void	gnc_tree_view_set_sort_user_data (GncTreeView *view, GtkTreeModel *s_model)
	This allows the columns to be setup without the model connected. More...
void	gnc_tree_view_set_show_column_menu (GncTreeView *view, gboolean visible)
	This function is called to set the "show-column-menu" property on this view. More...
gboolean	gnc_tree_view_get_show_column_menu (GncTreeView *view)
	This function is called to get the current value of the "show-column-menu" property. More...
GtkCellRenderer *	gnc_tree_view_column_get_renderer (GtkTreeViewColumn *column)
	Return the "main" cell renderer from a GtkTreeViewColumn added to a GncTreeView my one of the convenience routines. More...
void	gnc_tree_view_keynav (GncTreeView *view, GtkTreeViewColumn **col, GtkTreePath *path, GdkEventKey *event)
gboolean	gnc_tree_view_path_is_valid (GncTreeView *view, GtkTreePath *path)
void	gnc_tree_view_set_editing_started_cb (GncTreeView *view, GFunc editing_started_cb, gpointer editing_cb_data)
	Setup a callback for when the user starts editing so appropriate actions can be taken like disable the actions delete menu option.
void	gnc_tree_view_set_editing_finished_cb (GncTreeView *view, GFunc editing_finished_cb, gpointer editing_cb_data)
	Setup a callback for when the user finishes editing so appropriate actions can be taken like enable the actions delete menu option.

Detailed Description

common utilities for manipulating a GtkTreeView within gnucash

Author

David Hampton hampt.nosp@m.on@e.nosp@m.mploy.nosp@m.ees..nosp@m.org

Definition in file gnc-tree-view.h.