gnc-plugin-page-report.h – A GncPlugin page for a report. More...

Modules
	Window/Plugin Structure

	Dialogs

	Druids

	Utility functions for the GnuCash GUI

	Auto-complete typed user input.
	QuickFill is meant to be used by the GUI to auto-complete (e.g.

	Reports

	Creating and editing accounts in the GUI

	Commodity windows

	GncCurrencyEdit

	Gnome-specific GUI handling.

	GUIUtility

	GnuCash Tree Model

	GncTreeView

	Registers, Ledgers and Journals

Files
file	gnc-accounting-period.c
	General utilities for dealing with accounting periods.

file	gnc-accounting-period.h
	General utilities for dealing with accounting periods.

file	dialog-book-close.h
	This file contains the functions to present a GUI to select a book closing date and accounts into which to close the Income and Expense accounts.

file	dialog-file-access.h
	This file contains the functions to present a GUI to select a file or a database connection.

file	dialog-object-references.h
	This file contains the functions to present a dialog box with a list of object references and an explanation that these objects must be modified to not refer to another specific object so that that object may be deleted.

file	gnc-period-select.c
	A custom widget for selecting accounting periods.

file	gnc-period-select.h
	A custom widget for selecting accounting periods.

file	gnc-tree-view-sx-list.h
	GncTreeView implementation for Scheduled Transaction List.

file	gnc-tree-view.h
	common utilities for manipulating a GtkTreeView within gnucash

Data Structures
struct	GncPeriodSelectPrivate
	Private Data Structure. More...

struct	GncPeriodSelect

struct	GncPeriodSelectClass

struct	GncTreeViewSxList

struct	GncTreeViewSxListClass

struct	GncTreeView

struct	GncTreeViewClass

Macros
#define	GNC_PERIOD_SELECT_GET_PRIVATE(o) ((GncPeriodSelectPrivate)gnc_period_select_get_instance_private((GncPeriodSelect)o))

#define	GNC_TYPE_PERIOD_SELECT (gnc_period_select_get_type())

#define	GNC_PERIOD_SELECT(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), GNC_TYPE_PERIOD_SELECT, GncPeriodSelect))

#define	GNC_PERIOD_SELECT_CLASS(k) (G_TYPE_CHECK_CLASS_CAST ((k), GNC_TYPE_PERIOD_SELECT, GncPeriodSelectClass))

#define	GNC_IS_PERIOD_SELECT(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), GNC_TYPE_PERIOD_SELECT))

#define	GNC_TYPE_TREE_VIEW_SX_LIST (gnc_tree_view_sx_list_get_type ())

#define	GNC_TREE_VIEW_SX_LIST(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), GNC_TYPE_TREE_VIEW_SX_LIST, GncTreeViewSxList))

#define	GNC_TREE_VIEW_SX_LIST_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), GNC_TYPE_TREE_VIEW_SX_LIST, GncTreeViewSxListClass))

#define	GNC_IS_TREE_VIEW_SX_LIST(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GNC_TYPE_TREE_VIEW_SX_LIST))

#define	GNC_IS_TREE_VIEW_SX_LIST_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GNC_TYPE_TREE_VIEW_SX_LIST))

#define	GNC_TREE_VIEW_SX_LIST_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), GNC_TYPE_TREE_VIEW_SX_LIST, GncTreeViewSxListClass))

#define	GNC_TYPE_TREE_VIEW (gnc_tree_view_get_type ())

#define	GNC_TREE_VIEW(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), GNC_TYPE_TREE_VIEW, GncTreeView))

#define	GNC_TREE_VIEW_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), GNC_TYPE_TREE_VIEW, GncTreeViewClass))

#define	GNC_IS_TREE_VIEW(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GNC_TYPE_TREE_VIEW))

#define	GNC_IS_TREE_VIEW_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GNC_TYPE_TREE_VIEW))

#define	GNC_TREE_VIEW_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), GNC_TYPE_TREE_VIEW, GncTreeViewClass))

#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)

Enumerations
enum	GncAccountingPeriod { GNC_ACCOUNTING_PERIOD_INVALID = -1, GNC_ACCOUNTING_PERIOD_TODAY, GNC_ACCOUNTING_PERIOD_MONTH, GNC_ACCOUNTING_PERIOD_MONTH_PREV, GNC_ACCOUNTING_PERIOD_QUARTER, GNC_ACCOUNTING_PERIOD_QUARTER_PREV, GNC_ACCOUNTING_PERIOD_CYEAR, GNC_ACCOUNTING_PERIOD_CYEAR_PREV, GNC_ACCOUNTING_PERIOD_CYEAR_LAST, GNC_ACCOUNTING_PERIOD_FYEAR = GNC_ACCOUNTING_PERIOD_CYEAR_LAST, GNC_ACCOUNTING_PERIOD_FYEAR_PREV, GNC_ACCOUNTING_PERIOD_FYEAR_LAST, GNC_ACCOUNTING_PERIOD_LAST = GNC_ACCOUNTING_PERIOD_FYEAR_LAST }
	This specifies a time interval.

enum	{ PROP_0, PROP_FY_END, PROP_SHOW_DATE, PROP_DATE_BASE, PROP_PS_ACTIVE }

enum	{ CHANGED, LAST_SIGNAL }

Functions
void	gnc_ui_close_book (QofBook book, GtkWindow parent)
	Create and run the dialog to close the book. More...

void	gnc_ui_file_access_for_open (GtkWindow *parent)

void	gnc_ui_file_access_for_save_as (GtkWindow *parent)

void	gnc_ui_file_access_for_export (GtkWindow *parent)

void	gnc_ui_object_references_show (const gchar explanation, GList objlist)

void	gnc_period_select_set_active (GncPeriodSelect *period, GncAccountingPeriod which)
	Set which item in the GncPeriodSelect is initially selected. More...

GncAccountingPeriod	gnc_period_select_get_active (GncPeriodSelect *period)
	Get the currently selected accounting period from a GncPeriodSelect widget. More...

GDate *	gnc_period_select_get_date (GncPeriodSelect *period)
	Get the currently selected accounting period choice from a GncPeriodSelect widget. More...

GType	gnc_tree_view_sx_list_get_type (void)

GtkTreeView *	gnc_tree_view_sx_list_new (GncSxInstanceModel *sx_instances)

SchedXaction *	gnc_tree_view_sx_list_get_sx_from_path (GncTreeViewSxList view, GtkTreePath path)

GType	gnc_tree_view_get_type (void)

Variables
const gchar *	start_strings [GNC_ACCOUNTING_PERIOD_LAST]

const gchar *	end_strings [GNC_ACCOUNTING_PERIOD_LAST]

Accounting Periods
time64	gnc_accounting_period_fiscal_start (void)

time64	gnc_accounting_period_fiscal_end (void)

GDate *	gnc_accounting_period_start_gdate (GncAccountingPeriod which, const GDate fy_end, const GDate contains)
	This function returns the starting date for an accounting period. More...

GDate *	gnc_accounting_period_end_gdate (GncAccountingPeriod which, const GDate fy_end, const GDate contains)
	This function returns the ending date for an accounting period. More...

GncPeriodSelect Properties
GDate *	gnc_period_select_get_fy_end (GncPeriodSelect *period)
	Get the current value of the fiscal year end setting from a GncPeriodSelect widget. More...

void	gnc_period_select_set_fy_end (GncPeriodSelect period, const GDate fy_end)
	Set the fiscal year end on a GncPeriodSelect widget. More...

gboolean	gnc_period_select_get_show_date (GncPeriodSelect *period)
	Get the current value of the "show sample" setting from a GncPeriodSelect widget.

void	gnc_period_select_set_show_date (GncPeriodSelect *period, const gboolean show_date)
	Set the "show sample" setting on a GncPeriodSelect widget. More...

GDate *	gnc_period_select_get_date_base (GncPeriodSelect *period)

void	gnc_period_select_set_date_base (GncPeriodSelect period, const GDate date_base)

GncPeriodSelect Core Implementation
GtkWidget *	gnc_period_select_new (gboolean starting_labels)
	Create a new GncPeriodSelect widget which is used to select a accounting period like "previous month" or "this year". More...

GtkWidget *	gnc_period_select_new_glade (gchar widget_name, gchar string1, gchar *string2, gint int1, gint int2)
	Create a new GncPeriodSelect widget from a glade file. More...

GncPeriodSelect Widget Implementation
GType	gnc_period_select_get_type (void)
	Returns the GType of a GncPeriodSelect widget.

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_combo_column (GncTreeView view, const gchar column_title, const gchar pref_name, const gchar sizing_text, gint model_data_column, gint model_visibility_column, GtkTreeModel *combo_tree_model, gint combo_model_text_column, GtkTreeIterCompareFunc column_sort_fn)
	This function adds a new combobox column to a GncTreeView base view. More...

GtkTreeViewColumn *	gnc_tree_view_add_date_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 date 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

gnc-plugin-page-report.h – A GncPlugin page for a report.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, contact:

Free Software Foundation Voice: +1-617-542-5942 51 Franklin Street, Fifth Floor Fax: +1-617-542-2652 Boston, MA 02110-1301, USA gnu@g.nosp@m.nu.o.nosp@m.rg

Function Documentation

◆ gnc_accounting_period_end_gdate()

GDate * gnc_accounting_period_end_gdate	(	GncAccountingPeriod	which,
		const GDate *	fy_end,
		const GDate *	contains
	)

This function returns the ending date for an accounting period.

The date will be computed based upon the type of accounting interval requested, an optional fiscal year end value, and an optional time value.

Parameters

which	An enum specifying the type of accounting period.
fy_end	This argument specifies the month and day of the fiscal year end. If the accounting period specified in the 'which' parameter is not a fiscal accounting period, this variable is ignored and may be NULL. Note: the year field of this argument is always ignored.
contains	This argument specifies the origin time value used by the calculations in this function. If this value is NULL, the origin will be the current time.

Returns: The final day of the specified time interval, as a GDate.

Definition at line 229 of file gnc-accounting-period.c.

 {
     GDate *date;
 
     if (contains)
     {
         date = g_date_new_dmy (g_date_get_day (contains),
                                g_date_get_month (contains),
                                g_date_get_year (contains));
     }
     else
     {
         date = g_date_new ();
         gnc_gdate_set_today (date);
     }
 
     switch (which)
     {
     default:
         PINFO ("Undefined relative time constant %d", which);
         g_date_free (date);
         return 0;
 
     case GNC_ACCOUNTING_PERIOD_TODAY:
         /* Already have today's date */
         break;
 
     case GNC_ACCOUNTING_PERIOD_MONTH:
         gnc_gdate_set_month_end (date);
         break;
 
     case GNC_ACCOUNTING_PERIOD_MONTH_PREV:
         gnc_gdate_set_prev_month_end (date);
         break;
 
     case GNC_ACCOUNTING_PERIOD_QUARTER:
         gnc_gdate_set_quarter_end (date);
         break;
 
     case GNC_ACCOUNTING_PERIOD_QUARTER_PREV:
         gnc_gdate_set_prev_quarter_end (date);
         break;
 
     case GNC_ACCOUNTING_PERIOD_CYEAR:
         gnc_gdate_set_year_end (date);
         break;
 
     case GNC_ACCOUNTING_PERIOD_CYEAR_PREV:
         gnc_gdate_set_prev_year_end (date);
         break;
 
     case GNC_ACCOUNTING_PERIOD_FYEAR:
         if (fy_end == NULL)
         {
             PINFO ("Request for fisal year value but no fiscal year end value provided.");
             g_date_free (date);
             return 0;
         }
         gnc_gdate_set_fiscal_year_end (date, fy_end);
         break;
 
     case GNC_ACCOUNTING_PERIOD_FYEAR_PREV:
         if (fy_end == NULL)
         {
             PINFO ("Request for fisal year value but no fiscal year end value provided.");
             g_date_free (date);
             return 0;
         }
         gnc_gdate_set_prev_fiscal_year_end (date, fy_end);
         break;
     }
 
     return date;
 }

◆ gnc_accounting_period_start_gdate()

GDate * gnc_accounting_period_start_gdate	(	GncAccountingPeriod	which,
		const GDate *	fy_end,
		const GDate *	contains
	)

This function returns the starting date for an accounting period.

The date will be computed based upon the type of accounting interval requested, an optional fiscal year end value, and an optional time value.

Parameters

which	An enum specifying the type of accounting period.
fy_end	This argument specifies the month and day of the fiscal year end. If the accounting period specified in the 'which' parameter is not a fiscal accounting period, this variable is ignored and may be NULL. Note: the year field of this argument is always ignored.
contains	This argument specifies the origin time value used by the calculations in this function. If this value is NULL, the origin will be the current time.

Returns: The starting day of the specified time interval, as a GDate.

Definition at line 135 of file gnc-accounting-period.c.

 {
     GDate *date;
 
     if (contains)
     {
         date = g_date_new_dmy (g_date_get_day (contains),
                                g_date_get_month (contains),
                                g_date_get_year (contains));
     }
     else
     {
         date = g_date_new ();
         gnc_gdate_set_today (date);
     }
 
     switch (which)
     {
     default:
         PINFO ("Undefined relative time constant %d", which);
         g_date_free (date);
         return NULL;
 
     case GNC_ACCOUNTING_PERIOD_TODAY:
         /* Already have today's date */
         break;
 
     case GNC_ACCOUNTING_PERIOD_MONTH:
         gnc_gdate_set_month_start (date);
         break;
 
     case GNC_ACCOUNTING_PERIOD_MONTH_PREV:
         gnc_gdate_set_prev_month_start (date);
         break;
 
     case GNC_ACCOUNTING_PERIOD_QUARTER:
         gnc_gdate_set_quarter_start (date);
         break;
 
     case GNC_ACCOUNTING_PERIOD_QUARTER_PREV:
         gnc_gdate_set_prev_quarter_start (date);
         break;
 
     case GNC_ACCOUNTING_PERIOD_CYEAR:
         gnc_gdate_set_year_start (date);
         break;
 
     case GNC_ACCOUNTING_PERIOD_CYEAR_PREV:
         gnc_gdate_set_prev_year_start (date);
         break;
 
     case GNC_ACCOUNTING_PERIOD_FYEAR:
         if (fy_end == NULL)
         {
             PINFO ("Request for fisal year value but no fiscal year end value provided.");
             g_date_free (date);
             return NULL;
         }
         gnc_gdate_set_fiscal_year_start (date, fy_end);
         break;
 
     case GNC_ACCOUNTING_PERIOD_FYEAR_PREV:
         if (fy_end == NULL)
         {
             PINFO ("Request for fisal year value but no fiscal year end value provided.");
             g_date_free (date);
             return NULL;
         }
         gnc_gdate_set_prev_fiscal_year_start (date, fy_end);
         break;
     }
     return date;
 }

◆ gnc_period_select_get_active()

GncAccountingPeriod gnc_period_select_get_active ( GncPeriodSelect * period )

Get the currently selected accounting period from a GncPeriodSelect widget.

This is used to retrieve the user's selection in the form of an enum.

Parameters

period The selection widget to query.

Returns: An enum indicating the user's choice of accounting period.

Definition at line 723 of file gnc-period-select.c.

 {
     GncPeriodSelectPrivate *priv;
 
     g_return_val_if_fail(period != NULL, -1);
     g_return_val_if_fail(GNC_IS_PERIOD_SELECT(period), -1);
 
     priv = GNC_PERIOD_SELECT_GET_PRIVATE(period);
     return gtk_combo_box_get_active(GTK_COMBO_BOX(priv->selector));
 }

◆ gnc_period_select_get_date()

GDate * gnc_period_select_get_date ( GncPeriodSelect * period )

Get the currently selected accounting period choice from a GncPeriodSelect widget.

This is used to retrieve the user's selection in the form of a GDate.

Parameters

period The selection widget to query.

Returns: The starting/ending time.

Definition at line 740 of file gnc-period-select.c.

 {
     GncPeriodSelectPrivate *priv;
     GncAccountingPeriod which;
 
     g_return_val_if_fail(period != NULL, 0);
     g_return_val_if_fail(GNC_IS_PERIOD_SELECT(period), 0);
 
     priv = GNC_PERIOD_SELECT_GET_PRIVATE(period);
     which = gtk_combo_box_get_active(GTK_COMBO_BOX(priv->selector));
     if (which == -1)
         return NULL;
 
     if (priv->start)
         return gnc_accounting_period_start_gdate(which, priv->fy_end,
                 priv->date_base);
     return gnc_accounting_period_end_gdate(which, priv->fy_end,
                                            priv->date_base);
 }

◆ gnc_period_select_get_fy_end()

GDate * gnc_period_select_get_fy_end ( GncPeriodSelect * period )

Get the current value of the fiscal year end setting from a GncPeriodSelect widget.

If the result is NULL then fiscal years are not currently supported.

Parameters

period The GncPeriodSelect widget to query.

Returns: A pointer to a GDate containing the fiscal year end value, or NULL if no fiscal year end is set. Note that only the month and day fields are valid in the returned GDate.

Definition at line 255 of file gnc-period-select.c.

 {
     GncPeriodSelectPrivate *priv;
 
     g_return_val_if_fail(period != NULL, NULL);
     g_return_val_if_fail(GNC_IS_PERIOD_SELECT(period), NULL);
 
     priv = GNC_PERIOD_SELECT_GET_PRIVATE(period);
     if (!priv->fy_end)
         return NULL;
     return g_date_new_dmy(g_date_get_day(priv->fy_end),
                           g_date_get_month(priv->fy_end),
                           G_DATE_BAD_YEAR);
 }

◆ gnc_period_select_new()

GtkWidget * gnc_period_select_new ( gboolean starting_labels )

Create a new GncPeriodSelect widget which is used to select a accounting period like "previous month" or "this year".

Parameters

starting_labels If set to TRUE then all the labels will refer to the "Start of...". If FALSE, labels will refer to "End of...".

Returns: A newly created GncPeriodSelect widget.

Definition at line 639 of file gnc-period-select.c.

 {
     GncPeriodSelectPrivate *priv;
     GncPeriodSelect *period;
     const gchar *label;
     gint i;
 
     period = g_object_new(GNC_TYPE_PERIOD_SELECT, NULL);
 
     /* Set up private data structures */
     priv = GNC_PERIOD_SELECT_GET_PRIVATE(period);
     priv->selector   = gtk_combo_box_text_new();
     priv->start      = starting_labels;
 
     /* Add the internal widgets to the hbox */
     gtk_box_pack_start(GTK_BOX(period), priv->selector, TRUE, TRUE, 0);
     gtk_widget_show(priv->selector);
 
     /* Find out when the combo box changes */
     g_signal_connect(G_OBJECT(priv->selector), "changed",
                      G_CALLBACK(gnc_period_sample_combobox_changed), period);
 
     /* Build all the labels except the fiscal year labels */
     for (i = 0; i < GNC_ACCOUNTING_PERIOD_CYEAR_LAST; i++)
     {
         label = starting_labels ? _(start_strings[i]) : _(end_strings[i]);
         gtk_combo_box_text_append_text(GTK_COMBO_BOX_TEXT(priv->selector), label);
     }
 
     /* Track changes to date formatting */
     gnc_prefs_register_cb (GNC_PREFS_GROUP_GENERAL, GNC_PREF_DATE_FORMAT,
                            gnc_period_sample_new_date_format, period);
 
     return GTK_WIDGET (period);
 }

◆ gnc_period_select_new_glade()

GtkWidget * gnc_period_select_new_glade	(	gchar *	widget_name,
		gchar *	string1,
		gchar *	string2,
		gint	int1,
		gint	int2
	)

Create a new GncPeriodSelect widget from a glade file.

The int1 argument passed from glade is used to determine whether the widget uses labels for start times or end times. A non-zero int2 argument indicates that an example date should be shown.

Returns: A newly created GncPeriodSelect widget.

Definition at line 682 of file gnc-period-select.c.

 {
     GtkWidget *widget;
     widget = gnc_period_select_new(int1 != 0);
     if (int2)
         gnc_period_select_set_show_date(GNC_PERIOD_SELECT(widget), TRUE);
     gtk_widget_show(widget);
     return widget;
 }

◆ gnc_period_select_set_active()

void gnc_period_select_set_active	(	GncPeriodSelect *	period,
		GncAccountingPeriod	which
	)

Set which item in the GncPeriodSelect is initially selected.

This is used to set the initial selection before the widget is shown to the user.

Parameters

period	The selection widget to update.
which	The accounting period that should be selected.

Definition at line 706 of file gnc-period-select.c.

 {
     g_return_if_fail(period != NULL);
     g_return_if_fail(GNC_IS_PERIOD_SELECT(period));
     g_return_if_fail(which >= 0);
     g_return_if_fail(which <  GNC_ACCOUNTING_PERIOD_LAST);
 
     g_object_set (G_OBJECT (period), "active", which, NULL);
 }

◆ gnc_period_select_set_fy_end()

void gnc_period_select_set_fy_end	(	GncPeriodSelect *	period,
		const GDate *	fy_end
	)

Set the fiscal year end on a GncPeriodSelect widget.

If set to a value other than NULL then widget will include fiscal accounting period like "this fiscal year".

Parameters

period	The GncPeriodSelect widget to update.
fy_end	The new fiscal year end value, or NULL if no fiscal year is set. Note that only the month and day fields need be valid in the provided GDate.

Definition at line 276 of file gnc-period-select.c.

 {
     GncPeriodSelectPrivate *priv;
     const gchar *label;
     gint i;
 
     g_return_if_fail(period != NULL);
     g_return_if_fail(GNC_IS_PERIOD_SELECT(period));
 
     priv = GNC_PERIOD_SELECT_GET_PRIVATE(period);
     if (priv->fy_end)
         g_date_free(priv->fy_end);
 
     if (fy_end)
     {
         priv->fy_end = g_date_new_dmy(g_date_get_day(fy_end),
                                       g_date_get_month(fy_end),
                                       G_DATE_BAD_YEAR);
     }
     else
     {
         priv->fy_end = NULL;
     }
 
     if (fy_end)
     {
         for (i = GNC_ACCOUNTING_PERIOD_CYEAR_LAST; i < GNC_ACCOUNTING_PERIOD_FYEAR_LAST; i++)
         {
             label = priv->start ? _(start_strings[i]) : _(end_strings[i]);
             gtk_combo_box_text_append_text(GTK_COMBO_BOX_TEXT(priv->selector), label);
         }
     }
     else
     {
         for (i = GNC_ACCOUNTING_PERIOD_FYEAR_LAST - 1; i >= GNC_ACCOUNTING_PERIOD_FYEAR_LAST; i--)
         {
             gtk_combo_box_text_remove(GTK_COMBO_BOX_TEXT(priv->selector), i);
         }
     }
 }

◆ gnc_period_select_set_show_date()

void gnc_period_select_set_show_date	(	GncPeriodSelect *	period,
		const gboolean	show_date
	)

Set the "show sample" setting on a GncPeriodSelect widget.

If set to TRUE then a GtkLabel will be used to show the date corresponding to the selected time period.

Definition at line 372 of file gnc-period-select.c.

 {
     GDate date;
 
     g_return_if_fail(period != NULL);
     g_return_if_fail(GNC_IS_PERIOD_SELECT(period));
 
     if (show_date)
     {
         g_date_clear(&date, 1);
         gnc_gdate_set_time64(&date, gnc_time (NULL));
         gnc_period_select_set_date_common(period, &date);
     }
     else
     {
         gnc_period_select_set_date_common(period, NULL);
     }
 }

◆ gnc_tree_view_add_combo_column()

GtkTreeViewColumn* gnc_tree_view_add_combo_column	(	GncTreeView *	view,
		const gchar *	column_title,
		const gchar *	pref_name,
		const gchar *	sizing_text,
		gint	model_data_column,
		gint	model_visibility_column,
		GtkTreeModel *	combo_tree_model,
		gint	combo_model_text_column,
		GtkTreeIterCompareFunc	column_sort_fn
	)

This function adds a new combobox column to a GncTreeView base view.

The parameters it takes in common with gnc_tree_view_add_text_column() behave the same as there. In addition, it will use combo_tree_model as the GtkTreeModel for the combobox, and combo_model_text_column will be the column in the model used for displaying the text in the combobox.

Definition at line 2028 of file gnc-tree-view.c.

 {
     GtkTreeViewColumn *column;
     GtkCellRenderer *renderer;
     PangoLayout* layout;
     int default_width, title_width;
 
     g_return_val_if_fail (GNC_IS_TREE_VIEW(view), NULL);
 
     column = gtk_tree_view_column_new ();
     gtk_tree_view_column_set_title (column, gettext(column_title));
 
     /* Set up a renderer and attributes */
     renderer = gtk_cell_renderer_combo_new ();
     gtk_tree_view_column_pack_start (column, renderer, TRUE);
 
     /* Set renderer attributes controlled by the model */
     if (model_data_column != GNC_TREE_VIEW_COLUMN_DATA_NONE)
         gtk_tree_view_column_add_attribute (column, renderer,
                                             "text", model_data_column);
     if (model_visibility_column != GNC_TREE_VIEW_COLUMN_VISIBLE_ALWAYS)
         gtk_tree_view_column_add_attribute (column, renderer,
                                             "visible", model_visibility_column);
 
     /* Default size is the larger of the column title and the sizing text */
     layout = gtk_widget_create_pango_layout (GTK_WIDGET(view), column_title);
     pango_layout_get_pixel_size (layout, &title_width, NULL);
     g_object_unref (layout);
     layout = gtk_widget_create_pango_layout (GTK_WIDGET(view), sizing_text);
     pango_layout_get_pixel_size (layout, &default_width, NULL);
     g_object_unref (layout);
     default_width = MAX(default_width, title_width);
     if (default_width)
         default_width += 10; /* padding on either side */
 
     gnc_tree_view_column_properties (view, column, pref_name, model_data_column,
                                      default_width, TRUE, column_sort_fn);
 
     /* Stuff specific to combo */
     if (combo_tree_model)
     {
         g_object_set (G_OBJECT(renderer), "model", combo_tree_model,
                       "text-column", combo_model_text_column, NULL);
     }
     /* TODO: has-entry? */
 
     gnc_tree_view_append_column (view, column);
     return column;
 }

◆ gnc_tree_view_add_date_column()

GtkTreeViewColumn* gnc_tree_view_add_date_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 date column to a GncTreeView base view.

The parameters it takes in common with gnc_tree_view_add_text_column() behave the same as there.

It takes all the parameters necessary to hook a GtkTreeModel column to a GtkTreeViewColumn. If the tree has a state section associated with it, this function also wires up the column so that its visibility and width are remembered.

Parameters are defined in gnc-tree-view.h

Definition at line 1970 of file gnc-tree-view.c.

 {
     GtkTreeViewColumn *column;
     GtkCellRenderer *renderer;
     PangoLayout* layout;
     int default_width, title_width;
 
     g_return_val_if_fail (GNC_IS_TREE_VIEW(view), NULL);
 
     column = gtk_tree_view_column_new ();
     gtk_tree_view_column_set_title (column, column_title);
 
     /* Set up an icon renderer if requested */
     if (icon_name)
     {
         renderer = gtk_cell_renderer_pixbuf_new ();
         g_object_set (renderer, "icon-name", icon_name, NULL);
         gtk_tree_view_column_pack_start (column, renderer, FALSE);
     }
 
     /* Set up a text renderer and attributes */
     renderer = gnc_cell_renderer_date_new (TRUE);
     gtk_tree_view_column_pack_start (column, renderer, TRUE);
 
     /* Set renderer attributes controlled by the model */
     if (model_data_column != GNC_TREE_VIEW_COLUMN_DATA_NONE)
         gtk_tree_view_column_add_attribute (column, renderer,
                                             "text", model_data_column);
     if (model_visibility_column != GNC_TREE_VIEW_COLUMN_VISIBLE_ALWAYS)
         gtk_tree_view_column_add_attribute (column, renderer,
                                             "visible", model_visibility_column);
 
     /* Default size is the larger of the column title and the sizing text */
     layout = gtk_widget_create_pango_layout (GTK_WIDGET(view), column_title);
     pango_layout_get_pixel_size (layout, &title_width, NULL);
     g_object_unref (layout);
     layout = gtk_widget_create_pango_layout (GTK_WIDGET(view), sizing_text);
     pango_layout_get_pixel_size (layout, &default_width, NULL);
     g_object_unref (layout);
     default_width = MAX(default_width, title_width);
     if (default_width)
         default_width += 10; /* padding on either side */
     gnc_tree_view_column_properties (view, column, pref_name, model_data_column,
                                      default_width, TRUE, column_sort_fn);
 
     gnc_tree_view_append_column (view, column);
     return column;
 }

◆ gnc_tree_view_add_numeric_column()

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.

It takes all the parameters necessary to hook a GtkTreeModel column to a GtkTreeViewColumn. A numeric column is nothing more then a text column with a few extra attributes.

Parameters

view	A pointer to a generic GncTreeView.
column_title	The title for this column.
pref_name	The internal name of this column. This name is used in several functions to look up the column, and it is also used when saving/restoring the view's state.
sizing_text	A string used to compute the default width of the column. This text is never displayed.
model_data_column	The index of the GtkTreeModel data column used to determine the data that will be displayed in this column for each row in the view. Use GNC_TREE_VIEW_COLUMN_DATA_NONE if you plan on using an non-model data source for this column.
model_color_column	The index of the GtkTreeModel data column used to determine the foreground color of any text in this column. It should be used to display negative numbers in red. Use GNC_TREE_VIEW_COLUMN_COLOR_NONE if the text in this column should always be displayed in the default theme color for text.
model_visibility_column	The index of the GtkTreeModel data column used to determine whether or not a checkbox for each row will be displayed at all. Use GNC_TREE_VIEW_COLUMN_VISIBLE_ALWAYS if the checkbox should be displayed in all rows.
column_sort_fn	The function that GtkTreeModelSort will call to compare two rows to determine their displayed order.

Returns: The newly created GtkTreeViewColumn.

It takes all the parameters necessary to hook a GtkTreeModel column to a GtkTreeViewColumn. If the tree has a state section associated with it, this function also wires up the column so that its visibility and width are remembered. A numeric column is nothing more then a text column with a few extra attributes.

Parameters are defined in gnc-tree-view.h

Definition at line 2114 of file gnc-tree-view.c.

 {
     GtkTreeViewColumn *column;
     GtkCellRenderer *renderer;
     gfloat alignment = 1.0;
 
     column = gnc_tree_view_add_text_column (view, column_title, pref_name,
                                             NULL, sizing_text, model_data_column,
                                             model_visibility_column,
                                             column_sort_fn);
 
     renderer = gnc_tree_view_column_get_renderer (column);
 
     /* Right align the column title and data for both ltr and rtl */
     if (gtk_widget_get_direction (GTK_WIDGET(view)) == GTK_TEXT_DIR_RTL)
         alignment = 0.0;
 
     g_object_set (G_OBJECT(column), "alignment", alignment, NULL);
     g_object_set (G_OBJECT(renderer), "xalign", alignment, NULL);
 
     /* Change the text color */
     if (model_color_column != GNC_TREE_VIEW_COLUMN_COLOR_NONE)
         gtk_tree_view_column_add_attribute (column, renderer,
                                             "foreground", model_color_column);
 
     return column;
 }

◆ gnc_tree_view_add_text_column()

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.

It takes all the parameters necessary to hook a GtkTreeModel column to a GtkTreeViewColumn.

Parameters

view	A pointer to a generic GncTreeView.
column_title	The title for this column.
pref_name	The internal name of this column. This name is used in several functions to look up the column, and it is also used when saving/restoring the view's state.
icon_name	The name of the icon to display to the left of the text in this column. Used for adding icons like the "account" icon to a view. This must be a registered icon, not a filename.
sizing_text	A string used to compute the default width of the column. This text is never displayed.
model_data_column	The index of the GtkTreeModel data column used to determine the data that will be displayed in this column for each row in the view. Use GNC_TREE_VIEW_COLUMN_DATA_NONE if you plan on using a non-model data source for this column. This index is connected to the "text" attribute of the cell renderer.
model_visibility_column	The index of the GtkTreeModel data column used to determine whether or not a checkbox for each row will be displayed at all. Use GNC_TREE_VIEW_COLUMN_VISIBLE_ALWAYS if the checkbox should be displayed in all rows.
column_sort_fn	The function that GtkTreeModelSort will call to compare two rows to determine their displayed order.

Returns: The newly created GtkTreeViewColumn.

It takes all the parameters necessary to hook a GtkTreeModel column to a GtkTreeViewColumn. If the tree has a state section associated with it, this function also wires up the column so that its visibility and width are remembered.

Parameters are defined in gnc-tree-view.h

Definition at line 1905 of file gnc-tree-view.c.

 {
     GtkCellRenderer *renderer;
 
     g_return_val_if_fail (GNC_IS_TREE_VIEW(view), NULL);
 
     renderer = gtk_cell_renderer_text_new ();
 
     return add_text_column_variant (view, renderer,
                                     column_title, pref_name,
                                     icon_name, sizing_text,
                                     model_data_column,
                                     model_visibility_column,
                                     column_sort_fn);
 }

◆ gnc_tree_view_add_text_view_column()

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.

It takes all the parameters necessary to hook a GtkTreeModel column to a GtkTreeViewColumn.

Parameters

view	A pointer to a generic GncTreeView.
column_title	The title for this column.
pref_name	The internal name of this column. This name is used in several functions to look up the column, and it is also used when saving/restoring the view's state.
icon_name	The name of the icon to display to the left of the text in this column. Used for adding icons like the "account" icon to a view. This must be a registered icon, not a filename.
sizing_text	A string used to compute the default width of the column. This text is never displayed.
model_data_column	The index of the GtkTreeModel data column used to determine the data that will be displayed in this column for each row in the view. Use GNC_TREE_VIEW_COLUMN_DATA_NONE if you plan on using a non-model data source for this column. This index is connected to the "text" attribute of the cell renderer.
model_visibility_column	The index of the GtkTreeModel data column used to determine whether or not a checkbox for each row will be displayed at all. Use GNC_TREE_VIEW_COLUMN_VISIBLE_ALWAYS if the checkbox should be displayed in all rows.
column_sort_fn	The function that GtkTreeModelSort will call to compare two rows to determine their displayed order.

Returns: The newly created GtkTreeViewColumn.

It takes all the parameters necessary to hook a GtkTreeModel column to a GtkTreeViewColumn. If the tree has a state section associated with it, this function also wires up the column so that its visibility and width are remembered.

Parameters are defined in gnc-tree-view.h

Definition at line 1937 of file gnc-tree-view.c.

 {
     GtkCellRenderer *renderer;
 
     g_return_val_if_fail (GNC_IS_TREE_VIEW(view), NULL);
 
     renderer = gnc_cell_renderer_text_view_new ();
 
     return add_text_column_variant (view, renderer,
                                     column_title, pref_name,
                                     icon_name, sizing_text,
                                     model_data_column,
                                     model_visibility_column,
                                     column_sort_fn);
 }

◆ gnc_tree_view_add_toggle_column()

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.

It takes all the parameters necessary to hook a GtkTreeModel column to a GtkTreeViewColumn. It handles creating a tooltip to show the full title name, and setting the sort and edit callback functions.

Parameters

view	A pointer to a generic GncTreeView.
column_title	The full title for this column. This will be added as a tooltip what will be displayed when the mouse is hovered over the column title button.
column_short_title	This is what will actually be displayed as the title of the column. This should be a single character, as anything more will unnecessarily expand the width of the column.
pref_name	The internal name of this column. This name is used in several functions to look up the column, and it is also used when saving/restoring the view's state.
model_data_column	The index of the GtkTreeModel data column used to determine whether the displayed checkbox for each row will be show as checked or empty. Use GNC_TREE_VIEW_COLUMN_DATA_NONE if you plan on using an non-model data source for this column.
model_visibility_column	The index of the GtkTreeModel data column used to determine whether or not a checkbox for each row will be displayed at all. Use GNC_TREE_VIEW_COLUMN_VISIBLE_ALWAYS if the checkbox should be displayed in all rows.
column_sort_fn	The function that GtkTreeModelSort will call to compare two rows to determine their displayed order.
toggle_edited_cb	The function to call when the user toggles the state of a checkbox.

Returns: The newly created GtkTreeViewColumn.

It takes all the parameters necessary to hook a GtkTreeModel column to a GtkTreeViewColumn. It handles creating a tooltip to show the full title name, and setting the sort and edit callback functions. If the tree has a state section associated with it, this function also wires up the column so that its visibility and width are remembered.

Parameters are defined in gnc-tree-view.h

Definition at line 1752 of file gnc-tree-view.c.

 {
     GtkTreeViewColumn *column;
     GtkCellRenderer *renderer;
 
     g_return_val_if_fail (GNC_IS_TREE_VIEW(view), NULL);
 
     renderer = gtk_cell_renderer_toggle_new ();
     if (!toggle_edited_cb)
     {
         gtk_cell_renderer_toggle_set_activatable (GTK_CELL_RENDERER_TOGGLE(renderer), FALSE);
     }
     column =
         gtk_tree_view_column_new_with_attributes (column_short_title,
                 renderer,
                 "active", model_data_column,
                 NULL);
 
     /* Add the full title to the object for menu creation */
     g_object_set_data_full (G_OBJECT(column), REAL_TITLE,
                             g_strdup(column_title), g_free);
     if (toggle_edited_cb)
         g_signal_connect (G_OBJECT(renderer), "toggled",
                           G_CALLBACK(toggle_edited_cb), view);
 
     if (model_visibility_column != GNC_TREE_VIEW_COLUMN_VISIBLE_ALWAYS)
         gtk_tree_view_column_add_attribute (column, renderer,
                                             "visible", model_visibility_column);
 
 
     gnc_tree_view_column_properties (view, column, pref_name, model_data_column,
                                      0, FALSE, column_sort_fn);
 
     gnc_tree_view_append_column (view, column);
 
     /* Also add the full title to the object as a tooltip */
     gtk_widget_set_tooltip_text (gtk_tree_view_column_get_button (column), column_title);
 
     return column;
 }

◆ gnc_tree_view_append_column()

gint gnc_tree_view_append_column	(	GncTreeView *	view,
		GtkTreeViewColumn *	column
	)

Add a column to a view based upon a GncTreeView.

This function knows about the two special columns on the right side of this type of view, and adds the new column before these two columns. You could say that it appends to the data columns and ignores the infrastructure columns.

Parameters

view	A pointer to a generic GncTreeView.
column	The column to append.

Returns: The index of the newly added column.

This function knows about the two special columns on the right side of this type of view, and adds the new column before these two columns. You could say that it appends to the data columns and ignores the infrastructure columns.

Parameters are defined in gnc-tree-view.h

Definition at line 2158 of file gnc-tree-view.c.

 {
     int n = gtk_tree_view_get_n_columns (GTK_TREE_VIEW(view));
 
     /* Ignore the initial column, the selection menu */
     if (n >= 1)
         n -= 1;
     return gtk_tree_view_insert_column (GTK_TREE_VIEW(view), column, n);
 }

◆ gnc_tree_view_column_get_renderer()

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.

Parameters

column The tree view column that was added to the GncTreeView

Returns: The cell renderer in use in the column.

Definition at line 2087 of file gnc-tree-view.c.

 {
     GList *renderers;
     GtkCellRenderer *cr = NULL;
 
     g_return_val_if_fail (GTK_TREE_VIEW_COLUMN(column), NULL);
 
     /* Get the list of one renderer */
     renderers = gtk_cell_layout_get_cells (GTK_CELL_LAYOUT(column));
     if (g_list_length (renderers) > 0)
         cr = GTK_CELL_RENDERER(renderers->data);
     g_list_free (renderers);
 
     return cr;
 }

◆ gnc_tree_view_configure_columns()

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.

Parameters

view	A pointer to an gnc tree view.

Definition at line 1582 of file gnc-tree-view.c.

 {
     GncTreeViewPrivate *priv;
     GtkTreeViewColumn *column;
     GList *columns;
     gboolean hide_menu_column;
 
     g_return_if_fail (GNC_IS_TREE_VIEW(view));
 
     ENTER(" ");
 
     /* Update the view and saved state */
     columns = gtk_tree_view_get_columns (GTK_TREE_VIEW(view));
     g_list_foreach (columns, (GFunc)gnc_tree_view_update_visibility, view);
     g_list_free (columns);
 
     priv = GNC_TREE_VIEW_GET_PRIVATE(view);
     if (priv->state_section)
         priv->seen_state_visibility = TRUE;
 
     /* If only the first column is visible, hide the spacer and make that
      * column expand. */
     hide_menu_column = (gnc_tree_view_count_visible_columns (view) == 1);
     column = gtk_tree_view_get_column (GTK_TREE_VIEW(view), 0);
     gtk_tree_view_column_set_expand (column, hide_menu_column);
     gtk_tree_view_column_set_visible (priv->column_menu_column, !hide_menu_column);
 
     LEAVE(" ");
 }

◆ gnc_tree_view_expand_columns()

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.

Parameters

view	The tree view.
list	of column names.

Definition at line 1412 of file gnc-tree-view.c.

 {
     GncTreeViewPrivate *priv;
     GtkTreeViewColumn *column;
     gboolean hide_spacer;
     GList *columns, *tmp;
     gchar *name, *pref_name;
     va_list args;
 
     g_return_if_fail (GNC_IS_TREE_VIEW(view));
     ENTER(" ");
     va_start (args, first_column_name);
     priv = GNC_TREE_VIEW_GET_PRIVATE(view);
     name = first_column_name;
     hide_spacer = FALSE;
 
     /* First disable the expand property on all (non-infrastructure) columns. */
     columns = gtk_tree_view_get_columns (GTK_TREE_VIEW(view));
     for (tmp = columns; tmp; tmp = g_list_next (tmp))
     {
         column = tmp->data;
         pref_name = g_object_get_data (G_OBJECT(column), PREF_NAME);
         if (pref_name != NULL)
             gtk_tree_view_column_set_expand (column, FALSE);
     }
     g_list_free(columns);
 
     /* Now enable it on the requested columns. */
     while (name != NULL)
     {
         column = gnc_tree_view_find_column_by_name (view, name);
         if (column != NULL)
         {
             gtk_tree_view_column_set_expand (column, TRUE);
             hide_spacer = TRUE;
         }
         name = va_arg (args, gchar*);
     }
     va_end (args);
 
     LEAVE(" ");
 }

◆ gnc_tree_view_find_column_by_name()

GtkTreeViewColumn* gnc_tree_view_find_column_by_name	(	GncTreeView *	view,
		const gchar *	wanted
	)

Find a tree column given the "pref name".

This function simply runs the list of all (visible and invisible) columns looking for a match. Column names were attached to each column at the time the column was created.

Parameters

view	The visible tree widget.
wanted	The "pref name" to find.

Find a tree column given the "pref name".

This function simply runs the list of all (visible and invisible) columns looking for a match. Column names were attached to each column at the time the column was created.

Parameters

view	The visible tree widget.
wanted	The "pref name" to find.

Definition at line 534 of file gnc-tree-view.c.

 {
     GtkTreeViewColumn *column, *found = NULL;
     GList *column_list, *tmp;
     const gchar *name;
 
     // ENTER("view %p, wanted %s", view, wanted);
     column_list = gtk_tree_view_get_columns(GTK_TREE_VIEW(view));
     for (tmp = column_list; tmp; tmp = g_list_next (tmp))
     {
         column = tmp->data;
         name = g_object_get_data (G_OBJECT(column), PREF_NAME);
         if (!name || (strcmp(name, wanted) != 0))
             continue;
         found = column;
         break;
     }
     g_list_free (column_list);
 
     // LEAVE("column %p", found);
     return found;
 }

◆ gnc_tree_view_get_show_column_menu()

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.

It returns the same value passed to gnc_tree_view_set_show_menu_column().

Parameters

view	The tree view.

Returns: Whether or not the column selection menu should be shown.

It returns the same value passed to gnc_tree_view_set_show_menu_column().

Parameters are defined in gnc-tree-view.h

Definition at line 1546 of file gnc-tree-view.c.

 {
     GncTreeViewPrivate *priv;
 
     g_return_val_if_fail (GNC_IS_TREE_VIEW(view), FALSE);
 
     priv = GNC_TREE_VIEW_GET_PRIVATE(view);
     return (priv->show_column_menu);
 }

◆ gnc_tree_view_get_state_section()

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.

It returns the same value passed to gnc_tree_view_set_state_section().

Parameters

view	The tree view.

Returns: The current state section.

This function is called to get the current association between a saved state section and the display of a view.

It returns the same value passed to gnc_tree_view_set_state_section(); i.e. a string like "dialogs/edit_prices".

Parameters are defined in gnc-tree-view.h

Definition at line 1120 of file gnc-tree-view.c.

 {
     GncTreeViewPrivate *priv;
 
     g_return_val_if_fail (GNC_IS_TREE_VIEW(view), NULL);
 
     priv = GNC_TREE_VIEW_GET_PRIVATE (view);
     return priv->state_section;
 }

◆ gnc_tree_view_remove_state_information()

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,..).

This function may be called at any time; either when the user wants to disconnect or when the view object is being destroyed.

Parameters

view	The tree view.

This function is called to completely wipe the treeview's state information (column visibility, width, sorting order,..).

This function may be called at any time; either when the user wants to disconnect or when the view object is being destroyed.

Parameters

view	The tree view.

Definition at line 978 of file gnc-tree-view.c.

 {
     GncTreeViewPrivate *priv;
     GKeyFile *state_file = gnc_state_get_current ();
 
     ENTER(" ");
     priv = GNC_TREE_VIEW_GET_PRIVATE(view);
     if (!priv->state_section)
     {
         LEAVE("no state section");
         return;
     }
 
     g_key_file_remove_group (state_file, priv->state_section, NULL);
     g_free (priv->state_section);
     priv->state_section = NULL;
     LEAVE(" ");
 }

◆ gnc_tree_view_save_state()

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.

Parameters

view	The tree view.

Definition at line 1130 of file gnc-tree-view.c.

 {
     GncTreeViewPrivate *priv;
 
     ENTER("view %p", view);
     g_return_if_fail (view != NULL);
     g_return_if_fail (GNC_IS_TREE_VIEW(view));
 
     priv = GNC_TREE_VIEW_GET_PRIVATE(view);
 
     if (priv->state_section)
     {
         /* Save state. Only store non-default values when possible. */
         GList *column_list, *tmp;
         GKeyFile *state_file = gnc_state_get_current();
         gsize num_cols = 0;
         gchar *sort_column = gnc_tree_view_get_sort_column (view);
         gchar *sort_order = gnc_tree_view_get_sort_order (view);
         gchar **col_order = gnc_tree_view_get_column_order (view, &num_cols);
 
         /* Default sort column is the name column */
         if (sort_column && (g_strcmp0 (sort_column, "name") != 0))
             g_key_file_set_string (state_file, priv->state_section, STATE_KEY_SORT_COLUMN, sort_column);
         else if (g_key_file_has_key (state_file, priv->state_section, STATE_KEY_SORT_COLUMN, NULL))
             g_key_file_remove_key (state_file, priv->state_section, STATE_KEY_SORT_COLUMN, NULL);
         g_free (sort_column);
 
 
         /* Default sort order is "ascending" */
         if (g_strcmp0 (sort_order, "descending") == 0)
             g_key_file_set_string (state_file, priv->state_section, STATE_KEY_SORT_ORDER, sort_order);
         else if (g_key_file_has_key (state_file, priv->state_section, STATE_KEY_SORT_ORDER, NULL))
             g_key_file_remove_key (state_file, priv->state_section, STATE_KEY_SORT_ORDER, NULL);
         g_free (sort_order);
 
         if (col_order && (num_cols > 0))
             g_key_file_set_string_list (state_file, priv->state_section, STATE_KEY_COLUMN_ORDER,
                                         (const gchar**) col_order, num_cols);
         else if (g_key_file_has_key (state_file, priv->state_section, STATE_KEY_COLUMN_ORDER, NULL))
             g_key_file_remove_key (state_file, priv->state_section, STATE_KEY_COLUMN_ORDER, NULL);
 
         g_strfreev (col_order);
 
 
         // ENTER("view %p, wanted %s", view, wanted);
         column_list = gtk_tree_view_get_columns (GTK_TREE_VIEW(view));
         for (tmp = column_list; tmp; tmp = g_list_next (tmp))
         {
             GtkTreeViewColumn *column = tmp->data;
             gchar *key=NULL;
             const gchar *name = g_object_get_data (G_OBJECT(column), PREF_NAME);
             if (!name)
                 continue;
 
             if (!g_object_get_data (G_OBJECT(column), ALWAYS_VISIBLE))
             {
                 key = g_strjoin ("_", name, STATE_KEY_SUFF_VISIBLE, NULL);
                 g_key_file_set_boolean (state_file, priv->state_section, key,
                                         gtk_tree_view_column_get_visible (column));
                 g_free (key);
             }
 
             key = g_strjoin ("_", name, STATE_KEY_SUFF_WIDTH, NULL);
             if (g_object_get_data (G_OBJECT(column), "default-width") &&
                 (GPOINTER_TO_INT((g_object_get_data (G_OBJECT(column), "default-width")))
                     != gtk_tree_view_column_get_width (column)))
             {
                 g_key_file_set_integer (state_file, priv->state_section, key,
                                         gtk_tree_view_column_get_width (column));
             }
             else if (g_key_file_has_key (state_file, priv->state_section, key, NULL))
                 g_key_file_remove_key (state_file, priv->state_section, key, NULL);
             g_free (key);
         }
         g_list_free (column_list);
     }
 
     LEAVE(" ");
 }

◆ gnc_tree_view_set_control_column_background()

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.

Parameters

view	The tree view.
column	The column in the model containing color strings.
func	This is a cell data function that sets the "cell-background".

Definition at line 1486 of file gnc-tree-view.c.

 {
     GncTreeViewPrivate *priv;
 
     g_return_if_fail (GNC_IS_TREE_VIEW(view));
 
     ENTER("view %p, column %d, func %p", view, column, func);
     priv = GNC_TREE_VIEW_GET_PRIVATE(view);
 
     update_control_cell_renderers_background (view, priv->column_menu_column, column, func);
 
     LEAVE(" ");
 }

◆ gnc_tree_view_set_show_column_menu()

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.

This function has no visible effect if the "state-section" property has not been set.

Parameters

view	The tree view.
visible	Create the column selection menu if TRUE.

This function has no visible effect if the "state-section" property has not been set.

Parameters are defined in gnc-tree-view.h

Definition at line 1525 of file gnc-tree-view.c.

 {
     GncTreeViewPrivate *priv;
 
     g_return_if_fail (GNC_IS_TREE_VIEW(view));
 
     ENTER("view %p, show menu %d", view, visible);
     priv = GNC_TREE_VIEW_GET_PRIVATE(view);
     priv->show_column_menu = visible;
     gnc_tree_view_build_column_menu (view);
     LEAVE(" ");
 }

◆ gnc_tree_view_set_sort_user_data()

void gnc_tree_view_set_sort_user_data	(	GncTreeView *	view,
		GtkTreeModel *	s_model
	)

This allows the columns to be setup without the model connected.

Parameters

view	The tree view.
sort	model.

Definition at line 1504 of file gnc-tree-view.c.

 {
     GncTreeViewPrivate *priv;
 
     g_return_if_fail (GNC_IS_TREE_VIEW(view));
 
     ENTER("view %p, sort_model %p", view, s_model);
     priv = GNC_TREE_VIEW_GET_PRIVATE(view);
 
     priv->sort_model = s_model;
     LEAVE(" ");
 }

◆ gnc_tree_view_set_state_section()

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.

It will first remove any existing association, and then install the new one.

Note: This function currently marks the first column as autosized and all other columns as fixed size. This may change in the future. It must change if we want to take advantage of the "fixed row height" performance enhancements added to GtkTreeView in gtk-2.4

Parameters

view	The tree view.
section	Link the view to this saved state section. Use NULL to disconnect saved state association.

This function is called to set up or remove an association between a saved state section and the display of a view.

It will first remove any existing association, and then install the new one. If the new section has state information, update the view with this information.

Parameters are defined in gnc-tree-view.h

Definition at line 1005 of file gnc-tree-view.c.

 {
     GncTreeViewPrivate *priv;
     GKeyFile *state_file;
 
     g_return_if_fail (GNC_IS_TREE_VIEW(view));
 
     ENTER("view %p, section %s", view, section);
 
     priv = GNC_TREE_VIEW_GET_PRIVATE(view);
 
     /* Drop any previous state section */
     if (priv->state_section)
         gnc_tree_view_remove_state_information (view);
 
     if (!section)
     {
         LEAVE("cleared state section");
         return;
     }
 
     /* Catch changes in state. Propagate to view. */
     priv->state_section = g_strdup (section);
 
     state_file = gnc_state_get_current ();
     if (g_key_file_has_group (state_file, priv->state_section))
     {
         gsize num_keys, idx;
         gchar **keys = g_key_file_get_keys (state_file, priv->state_section, &num_keys, NULL);
         for (idx = 0; idx < num_keys; idx++)
         {
             gchar *key = keys[idx];
             if (g_strcmp0 (key, STATE_KEY_SORT_COLUMN) == 0)
             {
                 gchar *name = g_key_file_get_string (state_file, priv->state_section,
                                                      key, NULL);
                 gnc_tree_view_set_sort_column (view, name);
                 g_free (name);
             }
             else if (g_strcmp0 (key, STATE_KEY_SORT_ORDER) == 0)
             {
                 gchar *name = g_key_file_get_string (state_file, priv->state_section,
                                                      key, NULL);
                 gnc_tree_view_set_sort_order (view, name);
                 g_free (name);
             }
             else if (g_strcmp0 (key, STATE_KEY_COLUMN_ORDER) == 0)
             {
                 gsize length;
                 gchar **columns = g_key_file_get_string_list (state_file, priv->state_section,
                                                               key, &length, NULL);
                 gnc_tree_view_set_column_order (view, columns, length);
                 g_strfreev (columns);
             }
             else
             {
                 /* Make a copy of the local part of the key so it can be split
                  * into column name and key type */
                 gboolean known = FALSE;
                 gchar *column_name = g_strdup (key);
                 gchar *type_name = g_strrstr (column_name, "_");
 
                 if (type_name != NULL) //guard against not finding '_'
                 {
                     *type_name++ = '\0';
 
                     if (g_strcmp0 (type_name, STATE_KEY_SUFF_VISIBLE) == 0)
                     {
                         GtkTreeViewColumn *column = gnc_tree_view_find_column_by_name (view, column_name);
                         if (column)
                         {
                             known = TRUE;
                             if (!g_object_get_data (G_OBJECT (column), ALWAYS_VISIBLE))
                             {
                                 gtk_tree_view_column_set_visible (column,
                                                                   g_key_file_get_boolean (state_file, priv->state_section, key, NULL));
                             }
                         }
                     }
                     else if (g_strcmp0 (type_name, STATE_KEY_SUFF_WIDTH) == 0)
                     {
                         gint width = g_key_file_get_integer (state_file, priv->state_section, key, NULL);
                         GtkTreeViewColumn *column = gnc_tree_view_find_column_by_name (view, column_name);
                         if (column)
                         {
                             known = TRUE;
                             if (width && (width != gtk_tree_view_column_get_width (column)))
                             {
                                 gtk_tree_view_column_set_fixed_width (column, width);
                             }
                         }
                     }
                     if (!known)
                         DEBUG ("Ignored key %s", key);
 
                     g_free (column_name);
                 }
             }
         }
         g_strfreev (keys);
     }
 
     /* Rebuild the column visibility menu */
     gnc_tree_view_build_column_menu (view);
     LEAVE ("set state section");
 }

◆ gnc_ui_close_book()

void gnc_ui_close_book	(	QofBook *	book,
		GtkWindow *	parent
	)

Create and run the dialog to close the book.

Parameters

book	This parameter specifies the book whose data will be closed.
parent	This parameter specifies the parent window

Definition at line 318 of file dialog-book-close.c.

 {
     struct CloseBookWindow *cbw;
     GtkBuilder* builder;
     GtkWidget* box;
     GList* equity_list = NULL;
 
     g_return_if_fail(book);
 
     cbw = g_new0(struct CloseBookWindow, 1);
     g_return_if_fail(cbw);
     cbw->book = book;
 
     /* Open the dialog */
     builder = gtk_builder_new();
     gnc_builder_add_from_file (builder, "dialog-book-close.glade", "close_book_dialog");
     cbw->dialog = GTK_WIDGET(gtk_builder_get_object (builder,  "close_book_dialog"));
 
     // Set the name for this dialog so it can be easily manipulated with css
     gtk_widget_set_name (GTK_WIDGET(cbw->dialog), "gnc-id-book-close");
 
     /* parent */
     if (parent != NULL)
         gtk_window_set_transient_for (GTK_WINDOW(cbw->dialog), GTK_WINDOW(parent));
 
     PINFO("Closed Book Window is %p, Dialog is %p", cbw, cbw->dialog);
 
     /* close date */
     box = GTK_WIDGET(gtk_builder_get_object (builder,  "date_box"));
     cbw->close_date_widget = gnc_date_edit_new(gnc_time (NULL), FALSE, FALSE);
     gtk_box_pack_start(GTK_BOX(box), cbw->close_date_widget, TRUE, TRUE, 0);
 
     /* income acct */
     equity_list = g_list_prepend(equity_list, GINT_TO_POINTER(ACCT_TYPE_EQUITY));
     box = GTK_WIDGET(gtk_builder_get_object (builder, "income_acct_box"));
     cbw->income_acct_widget = gnc_account_sel_new();
     gnc_account_sel_set_hexpand (GNC_ACCOUNT_SEL(cbw->income_acct_widget), TRUE);
     gnc_account_sel_set_acct_filters(GNC_ACCOUNT_SEL(cbw->income_acct_widget),
                                      equity_list, NULL);
     gnc_account_sel_set_new_account_ability(GNC_ACCOUNT_SEL(cbw->income_acct_widget), TRUE);
     gtk_box_pack_start(GTK_BOX(box), cbw->income_acct_widget, TRUE, TRUE, 0);
 
     /* expense acct */
     box = GTK_WIDGET(gtk_builder_get_object (builder, "expense_acct_box"));
     cbw->expense_acct_widget = gnc_account_sel_new();
     gnc_account_sel_set_hexpand (GNC_ACCOUNT_SEL(cbw->expense_acct_widget), TRUE);
     gnc_account_sel_set_acct_filters(GNC_ACCOUNT_SEL(cbw->expense_acct_widget),
                                      equity_list, NULL);
     gnc_account_sel_set_new_account_ability(GNC_ACCOUNT_SEL(cbw->expense_acct_widget), TRUE);
     gtk_box_pack_start(GTK_BOX(box), cbw->expense_acct_widget, TRUE, TRUE, 0);
 
     /* desc */
     cbw->desc_widget = GTK_WIDGET(gtk_builder_get_object (builder, "desc_entry"));
 
     /* Autoconnect signals */
     gtk_builder_connect_signals_full (builder, gnc_builder_connect_full_func, cbw->dialog);
 
     /* Register dialog with component manager */
     cbw->component_manager_id =
         gnc_register_gui_component(DIALOG_BOOK_CLOSE_CM_CLASS, NULL, close_handler,
                                    cbw->dialog);
     gnc_gui_component_set_session(cbw->component_manager_id,
                                   gnc_get_current_session());
     g_signal_connect(cbw->dialog, "destroy", G_CALLBACK(destroy_cb), NULL);
 
     /* Clean up the data structure when the dialog is destroyed */
     g_object_set_data_full(G_OBJECT(cbw->dialog), "CloseBookWindow", cbw, g_free);
 
     g_object_unref(G_OBJECT(builder));
 
     /* Run the dialog */
     gtk_widget_show_all(cbw->dialog);
 
     g_list_free(equity_list);
 }

Variable Documentation

◆ end_strings

const gchar* end_strings[GNC_ACCOUNTING_PERIOD_LAST]

Initial value:

=
{
    
    N_("Today"),
    N_("End of this month"),
    N_("End of previous month"),
    N_("End of this quarter"),
    N_("End of previous quarter"),
    N_("End of this year"),
    N_("End of previous year"),
    
    N_("End of this accounting period"),
    N_("End of previous accounting period"),
}

Definition at line 83 of file gnc-period-select.c.

◆ start_strings

const gchar* start_strings[GNC_ACCOUNTING_PERIOD_LAST]

Initial value:

=
{
    
    N_("Today"),
    N_("Start of this month"),
    N_("Start of previous month"),
    N_("Start of this quarter"),
    N_("Start of previous quarter"),
    N_("Start of this year"),
    N_("Start of previous year"),
    
    N_("Start of this accounting period"),
    N_("Start of previous accounting period"),
}

Definition at line 67 of file gnc-period-select.c.

Modules

Files

Data Structures

Macros

Typedefs

Enumerations

Functions

Variables

Accounting Periods

GncPeriodSelect Properties

GncPeriodSelect Core Implementation

GncPeriodSelect Widget Implementation

Tree View Creation

Tree View Properties

Detailed Description

Function Documentation

◆ gnc_accounting_period_end_gdate()

◆ gnc_accounting_period_start_gdate()

◆ gnc_period_select_get_active()

◆ gnc_period_select_get_date()

◆ gnc_period_select_get_fy_end()

◆ gnc_period_select_new()

◆ gnc_period_select_new_glade()

◆ gnc_period_select_set_active()

◆ gnc_period_select_set_fy_end()

◆ gnc_period_select_set_show_date()

◆ gnc_tree_view_add_combo_column()

◆ gnc_tree_view_add_date_column()

◆ gnc_tree_view_add_numeric_column()

◆ gnc_tree_view_add_text_column()

◆ gnc_tree_view_add_text_view_column()

◆ gnc_tree_view_add_toggle_column()

◆ gnc_tree_view_append_column()

◆ gnc_tree_view_column_get_renderer()

◆ gnc_tree_view_configure_columns()

◆ gnc_tree_view_expand_columns()

◆ gnc_tree_view_find_column_by_name()

◆ gnc_tree_view_get_show_column_menu()

◆ gnc_tree_view_get_state_section()

◆ gnc_tree_view_remove_state_information()

◆ gnc_tree_view_save_state()

◆ gnc_tree_view_set_control_column_background()

◆ gnc_tree_view_set_show_column_menu()

◆ gnc_tree_view_set_sort_user_data()

◆ gnc_tree_view_set_state_section()

◆ gnc_ui_close_book()

Variable Documentation

◆ end_strings

◆ start_strings