Main Window functions.

Files
file	gnc-main-window.c
	Functions for adding content to a window.
file	gnc-main-window.h
	Functions for adding content to a window.

Data Structures
struct	GncMainWindowPrivate
	The instance private data structure for an embedded window object. More...
struct	GncMainWindowSaveData
struct	menu_update
	This data structure is used to describe the requested state of a GtkRadioAction, and us used to pass data among several functions. More...
struct	TabWidth
	This data structure allows the passing of the tab width and whether the tab layout is on the left or right. More...
struct	GncMainWindow
	The instance data structure for a main window object. More...
struct	GncMainWindowClass
	The class data structure for a main window object. More...
struct	GncMainWindowActionData

Macros
#define	PLUGIN_PAGE_LABEL   "plugin-page"
	This label is used to provide a mapping from a visible page widget back to the corresponding GncPluginPage object. More...
#define	PLUGIN_PAGE_CLOSE_BUTTON   "close-button"
#define	PLUGIN_PAGE_TAB_LABEL   "label"
#define	GNC_PREF_SHOW_CLOSE_BUTTON   "tab-close-buttons"
#define	GNC_PREF_TAB_NEXT_RECENT   "tab-next-recent"
#define	GNC_PREF_TAB_POSITION_TOP   "tab-position-top"
#define	GNC_PREF_TAB_POSITION_BOTTOM   "tab-position-bottom"
#define	GNC_PREF_TAB_POSITION_LEFT   "tab-position-left"
#define	GNC_PREF_TAB_POSITION_RIGHT   "tab-position-right"
#define	GNC_PREF_TAB_WIDTH   "tab-width"
#define	GNC_PREF_TAB_COLOR   "show-account-color-tabs"
#define	GNC_PREF_SAVE_CLOSE_EXPIRES   "save-on-close-expires"
#define	GNC_PREF_SAVE_CLOSE_WAIT_TIME   "save-on-close-wait-time"
#define	GNC_PREF_TAB_OPEN_ADJACENT   "tab-open-adjacent"
#define	GNC_MAIN_WINDOW_NAME   "GncMainWindow"
#define	DIALOG_BOOK_OPTIONS_CM_CLASS   "dialog-book-options"
#define	MSG_AUTO_SAVE   _("Changes will be saved automatically in %u seconds")
#define	WINDOW_COUNT   "WindowCount"
#define	WINDOW_STRING   "Window %d"
#define	WINDOW_GEOMETRY   "WindowGeometry"
#define	WINDOW_POSITION   "WindowPosition"
#define	WINDOW_MAXIMIZED   "WindowMaximized"
#define	TOOLBAR_VISIBLE   "ToolbarVisible"
#define	STATUSBAR_VISIBLE   "StatusbarVisible"
#define	SUMMARYBAR_VISIBLE   "SummarybarVisible"
#define	WINDOW_FIRSTPAGE   "FirstPage"
#define	WINDOW_PAGECOUNT   "PageCount"
#define	WINDOW_PAGEORDER   "PageOrder"
#define	PAGE_TYPE   "PageType"
#define	PAGE_NAME   "PageName"
#define	PAGE_STRING   "Page %d"
#define	GNC_TYPE_MAIN_WINDOW   (gnc_main_window_get_type ())
#define	GNC_MAIN_WINDOW(obj)   (G_TYPE_CHECK_INSTANCE_CAST ((obj), GNC_TYPE_MAIN_WINDOW, GncMainWindow))
#define	GNC_MAIN_WINDOW_CLASS(klass)   (G_TYPE_CHECK_CLASS_CAST ((klass), GNC_TYPE_MAIN_WINDOW, GncMainWindowClass))
#define	GNC_IS_MAIN_WINDOW(obj)   (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GNC_TYPE_MAIN_WINDOW))
#define	GNC_IS_MAIN_WINDOW_CLASS(klass)   (G_TYPE_CHECK_CLASS_TYPE ((klass), GNC_TYPE_MAIN_WINDOW))
#define	GNC_MAIN_WINDOW_GET_CLASS(obj)   (G_TYPE_INSTANCE_GET_CLASS ((obj), GNC_TYPE_MAIN_WINDOW, GncMainWindowClass))
#define	PLUGIN_PAGE_IMMUTABLE   "page-immutable"

Typedefs
typedef void(*	GncMainWindowFunc) (GncMainWindow *window, GncPluginPage *page)
typedef void(*	GncMainWindowPageFunc) (GncPluginPage *page, gpointer user_data)

Enumerations
enum	{ PAGE_ADDED, PAGE_CHANGED, LAST_SIGNAL }
	Names of signals generated by the main window. More...

Functions
	GNC_DEFINE_TYPE_WITH_CODE (GncMainWindow, gnc_main_window, GTK_TYPE_WINDOW, G_IMPLEMENT_INTERFACE(GNC_TYPE_WINDOW, gnc_window_main_window_init))
	This data structure maintains information about one action groups that has been installed in this window. More...
gboolean	gnc_main_window_is_restoring_pages (GncMainWindow *window)
	Check if the main window is restoring the plugin pages. More...
void	gnc_main_window_foreach_page (GncMainWindowPageFunc fn, gpointer user_data)
void	gnc_main_window_restore_all_windows (const GKeyFile *keyfile)
	Restore the persistent state of all windows. More...
void	gnc_main_window_restore_default_state (GncMainWindow *window)
	Restore the persistent state of one window to a sane default.
void	gnc_main_window_save_all_windows (GKeyFile *keyfile)
	Save the persistent state of all windows. More...
gboolean	gnc_main_window_finish_pending (GncMainWindow *window)
	Tell a window to finish any outstanding activities. More...
gboolean	gnc_main_window_all_finish_pending (void)
	Tell all pages in all windows to finish any outstanding activities. More...
void	main_window_update_page_name (GncPluginPage *page, const gchar *name_in)
	Update the name of the page in the main window. More...
void	main_window_update_page_color (GncPluginPage *page, const gchar *color_in)
	Update the color on the page tabs in the main window. More...
void	main_window_update_page_set_read_only_icon (GncPluginPage *page, gboolean read_only)
	Update the icon on the page tabs in the main window. More...
GncMainWindow *	gnc_main_window_new (void)
	Create a new gnc main window plugin. More...
void	gnc_main_window_display_page (GncPluginPage *page)
	Bring the window containing the specified page to the top of the window stack, then switch the notebook to show the specified page. More...
void	gnc_main_window_open_page (GncMainWindow *window, GncPluginPage *page)
	Display a data plugin page in a window. More...
void	gnc_main_window_close_page (GncPluginPage *page)
	Remove a data plugin page from a window and display the previous page. More...
GncPluginPage *	gnc_main_window_get_current_page (GncMainWindow *window)
	Retrieve a pointer to the page that is currently at the front of the specified window. More...
void	gnc_main_window_manual_merge_actions (GncMainWindow *window, const gchar *group_name, GtkActionGroup *group, guint merge_id)
	Manually add a set of actions to the specified window. More...
void	gnc_main_window_merge_actions (GncMainWindow *window, const gchar *group_name, GtkActionEntry *entries, guint n_entries, GtkToggleActionEntry *toggle_entries, guint n_toggle_entries, const gchar *filename, gpointer user_data)
	Add a set of actions to the specified window. More...
void	gnc_main_window_unmerge_actions (GncMainWindow *window, const gchar *group_name)
	Remove a set of actions from the specified window. More...
void	gnc_main_window_actions_updated (GncMainWindow *window)
	Force a full update of the user interface for the specified window. More...
GtkAction *	gnc_main_window_find_action (GncMainWindow *window, const gchar *name)
	Find action in main window. More...
GtkActionGroup *	gnc_main_window_get_action_group (GncMainWindow *window, const gchar *group_name)
	Retrieve a specific set of user interface actions from a window. More...
gboolean	gnc_book_options_dialog_apply_helper (GNCOptionDB *options)
	Processes selected options in the Book Options dialog: checks book_currency and use_split_action_for_num to see if features kvp should be set. More...
void	gnc_book_option_num_field_source_change_cb (gboolean num_action)
	Calls gnc_book_option_num_field_source_change to initiate registered callbacks when num_field_source book option changes so that registers/reports can update themselves; sets feature flag.
void	gnc_book_option_book_currency_selected_cb (gboolean use_book_currency)
	Calls gnc_book_option_book_currency_selected to initiate registered callbacks when currency accounting book option changes to book-currency so that registers/reports can update themselves; sets feature flag.
GtkWidget *	gnc_book_options_dialog_cb (gboolean modal, gchar *title, GtkWindow *parent)
	Opens the Book Options dialog. More...
void	gnc_main_window_show_all_windows (void)
	Shows all main windows.
GtkWindow *	gnc_ui_get_gtk_window (GtkWidget *widget)
	Get a pointer to the widget's immediate top level GtkWindow. More...
GtkWindow *	gnc_ui_get_main_window (GtkWidget *widget)
	Get a pointer to the final GncMainWindow widget is rooted in. More...
void	gnc_main_window_set_progressbar_window (GncMainWindow *window)
	Set the window where all progressbar updates should occur. More...
gboolean	gnc_main_window_popup_menu_cb (GtkWidget *widget, GncPluginPage *page)
	Callback function invoked when the user requests that Gnucash popup the contextual menu via the keyboard context-menu request key combination (Shift-F10 by default). More...
gboolean	gnc_main_window_button_press_cb (GtkWidget *whatever, GdkEventButton *event, GncPluginPage *page)
	Callback function invoked when the user clicks in the content of any Gnucash window. More...
void	gnc_main_window_all_action_set_sensitive (const gchar *action_name, gboolean sensitive)
	Change the sensitivity of a command in all windows. More...
GtkUIManager *	gnc_main_window_get_uimanager (GncMainWindow *window)
	Returns the pointer to the GtkUIManager which is used for the menu item merging. More...
GType	gnc_main_window_get_type (void)
	Get the type of a gnc main window. More...

Variables
	MergedActionEntry

Detailed Description

Macro Definition Documentation

PLUGIN_PAGE_LABEL

#define PLUGIN_PAGE_LABEL   "plugin-page"

This label is used to provide a mapping from a visible page widget back to the corresponding GncPluginPage object.

Definition at line 100 of file gnc-main-window.c.

Enumeration Type Documentation

anonymous enum

anonymous enum

Names of signals generated by the main window.

Definition at line 91 of file gnc-main-window.c.

{
    PAGE_ADDED,
    PAGE_CHANGED,
    LAST_SIGNAL
};

Function Documentation

gnc_book_options_dialog_apply_helper()

gboolean gnc_book_options_dialog_apply_helper

(

GNCOptionDB *

options

)

Processes selected options in the Book Options dialog: checks book_currency and use_split_action_for_num to see if features kvp should be set.

To be used where ever a new book situation requires book option selection (e.g., not just in Book Options dialog opened from main window but also in new-file assistant).

Parameters

GNCOptionDB

* options.

Returns

TRUE if gnc_gui_refresh_all should be called; otherwise FALSE.

Definition at line 4285 of file gnc-main-window.c.

{
    QofBook *book = gnc_get_current_book ();
    gboolean use_split_action_for_num_before =
        qof_book_use_split_action_for_num_field (book);
    gboolean use_book_currency_before =
        gnc_book_use_book_currency (book);
    gint use_read_only_threshold_before =
        qof_book_get_num_days_autoreadonly (book);
    gboolean use_split_action_for_num_after;
    gboolean use_book_currency_after;
    gint use_read_only_threshold_after;
    gboolean return_val = FALSE;
    GList *results = NULL, *iter;

    if (!options) return return_val;

    results = gnc_option_db_commit (options);
    for (iter = results; iter; iter = iter->next)
    {
        GtkWidget *dialog = gtk_message_dialog_new(gnc_ui_get_main_window (NULL),
                                                   0,
                                                   GTK_MESSAGE_ERROR,
                                                   GTK_BUTTONS_OK,
                                                   "%s",
                                                   (char*)iter->data);
        gtk_dialog_run(GTK_DIALOG(dialog));
        gtk_widget_destroy(dialog);
        g_free (iter->data);
    }
    g_list_free (results);
    qof_book_begin_edit (book);
    qof_book_save_options (book, gnc_option_db_save, options, TRUE);
    use_split_action_for_num_after =
        qof_book_use_split_action_for_num_field (book);
    use_book_currency_after = gnc_book_use_book_currency (book);

    // mark cached value as invalid so we get new value
    book->cached_num_days_autoreadonly_isvalid = FALSE;
    use_read_only_threshold_after = qof_book_get_num_days_autoreadonly (book);

    if (use_split_action_for_num_before != use_split_action_for_num_after)
    {
        gnc_book_option_num_field_source_change_cb (
                                                use_split_action_for_num_after);
        return_val = TRUE;
    }
    if (use_book_currency_before != use_book_currency_after)
    {
        gnc_book_option_book_currency_selected_cb (use_book_currency_after);
        return_val = TRUE;
    }
    if (use_read_only_threshold_before != use_read_only_threshold_after)
        return_val = TRUE;

    qof_book_commit_edit (book);
    return return_val;
}

gnc_book_options_dialog_cb()

GtkWidget * gnc_book_options_dialog_cb	(	gboolean	modal,
		gchar *	title,
		GtkWindow *	parent
	)

Opens the Book Options dialog.

Parameters

modal	True to open in modal mode, false otherwise.
title	Title of the dialog; "Book Options" if NULL.
parent	The toplevel GdkWindow with which the dialog will be transient for.

Returns

A pointer to the GtkWidget for the dialog that can be used when started in modal mode.

Definition at line 4421 of file gnc-main-window.c.

{
    QofBook *book = gnc_get_current_book ();
    GNCOptionDB *options;
    GNCOptionWin *optionwin;

    options = gnc_option_db_new_for_type (QOF_ID_BOOK);
    qof_book_load_options (book, gnc_option_db_load, options);
    gnc_option_db_clean (options);

    /* Only allow one Book Options dialog if called from file->properties
       menu */
    if (gnc_forall_gui_components(DIALOG_BOOK_OPTIONS_CM_CLASS,
                                  show_handler, NULL))
    {
        return NULL;
    }
    optionwin = gnc_options_dialog_new_modal (
        modal,
        (title ? title : _( "Book Options")),
        DIALOG_BOOK_OPTIONS_CM_CLASS, parent);
    gnc_options_dialog_build_contents (optionwin, options);

    gnc_options_dialog_set_book_options_help_cb (optionwin);

    gnc_options_dialog_set_apply_cb (optionwin,
                                     gnc_book_options_dialog_apply_cb,
                                     (gpointer)options);
    gnc_options_dialog_set_close_cb (optionwin,
                                     gnc_book_options_dialog_close_cb,
                                     (gpointer)options);
    if (modal)
        gnc_options_dialog_set_new_book_option_values (options);
    return gnc_options_dialog_widget (optionwin);
}

GNC_DEFINE_TYPE_WITH_CODE()

GNC_DEFINE_TYPE_WITH_CODE	(	GncMainWindow	,
		gnc_main_window	,
		GTK_TYPE_WINDOW	,
		G_IMPLEMENT_INTERFACE(GNC_TYPE_WINDOW, gnc_window_main_window_init)
	)

This data structure maintains information about one action groups that has been installed in this window.

The merge identifier for this action group. This number is provided by the UI manager.
The action group itself. This contains all actions added by a single menu or content plugin.

Definition at line 244 of file gnc-main-window.c.

{
    guint merge_id;
    GtkActionGroup *action_group;
} MergedActionEntry;

gnc_main_window_actions_updated()

void gnc_main_window_actions_updated

(

GncMainWindow *

window

)

Force a full update of the user interface for the specified window.

This can be an expensive function, but is needed because the gtk ui manager doesn't always seem to update properly when actions are changed.

Parameters

window

A pointer to the window whose user interface should be updated.

Attention

Is this function still needed?

Definition at line 3585 of file gnc-main-window.c.

{
    GtkActionGroup *force;

    g_return_if_fail (GNC_IS_MAIN_WINDOW (window));

    /* Unfortunately gtk_ui_manager_ensure_update doesn't work
     * here.  Force a full update by adding and removing an empty
     * action group.
     */
    force = gtk_action_group_new("force_update");
    gtk_ui_manager_insert_action_group (window->ui_merge, force, 0);
    gtk_ui_manager_ensure_update (window->ui_merge);
    gtk_ui_manager_remove_action_group (window->ui_merge, force);
    g_object_unref(force);
}

gnc_main_window_all_action_set_sensitive()

void gnc_main_window_all_action_set_sensitive	(	const gchar *	action_name,
		gboolean	sensitive
	)

Change the sensitivity of a command in all windows.

This can be used to serialize access to a command so that in cannot be reinvoked until the current invocation is finished.

Parameters

action_name	The name of the command to modity.
sensitive	Whether or not the user should be able to invoke this action.

Definition at line 5244 of file gnc-main-window.c.

{
    GList *tmp;
    GtkAction *action;

    for (tmp = active_windows; tmp; tmp = g_list_next(tmp))
    {
        action = gnc_main_window_find_action (tmp->data, action_name);
        gtk_action_set_sensitive (action, sensitive);
    }
}

gnc_main_window_all_finish_pending()

gboolean gnc_main_window_all_finish_pending

(

void

)

Tell all pages in all windows to finish any outstanding activities.

This function will call gnc_plugin_page_finish_pending for each installed page. If any page returns a failure indication, then the function stops walking pages and immediately returns a failure.

Returns

FALSE if any page could not or would not comply, which should cancel the pending operation. TRUE otherwise

Definition at line 1184 of file gnc-main-window.c.

{
    const GList *windows, *item;

    windows = gnc_gobject_tracking_get_list(GNC_MAIN_WINDOW_NAME);
    for (item = windows; item; item = g_list_next(item))
    {
        if (!gnc_main_window_finish_pending(item->data))
        {
            return FALSE;
        }
    }
    if (gnc_gui_refresh_suspended ())
    {
        gnc_warning_dialog (NULL, "%s", "An operation is still running, wait for it to complete before quitting.");
        return FALSE;
    }
    return TRUE;
}

gnc_main_window_button_press_cb()

gboolean gnc_main_window_button_press_cb	(	GtkWidget *	whatever,
		GdkEventButton *	event,
		GncPluginPage *	page
	)

Callback function invoked when the user clicks in the content of any Gnucash window.

If this was a "right-click" then Gnucash will popup the contextual menu.

Parameters

whatever	Whatever widget had focus when the user issued the keyboard context-menu request.
event	The event parameter describing where on the screen the mouse was pointing when clicked, type of click, modifiers, etc.
page	This is the GncPluginPage corresponding to the visible page.

Returns

Returns TRUE if this was a right-click, meaning Gnucash handled the click.

Definition at line 5224 of file gnc-main-window.c.

{
    g_return_val_if_fail(GNC_IS_PLUGIN_PAGE(page), FALSE);

    ENTER("widget %p, event %p, page %p", whatever, event, page);
    /* Ignore double-clicks and triple-clicks */
    if (event->button == 3 && event->type == GDK_BUTTON_PRESS)
    {
        do_popup_menu(page, event);
        LEAVE("menu shown");
        return TRUE;
    }

    LEAVE("other click");
    return FALSE;
}

gnc_main_window_close_page()

void gnc_main_window_close_page

(

GncPluginPage *

page

)

Remove a data plugin page from a window and display the previous page.

If the page removed was the last page in the window, and there is more than one window open, then the entire window will be destroyed.

Parameters

page	The page of data to be removed.

Definition at line 3388 of file gnc-main-window.c.

{
    GncMainWindow *window;
    GncMainWindowPrivate *priv;

    if (!page || !page->notebook_page)
        return;

    if (!gnc_plugin_page_finish_pending(page))
        return;

    if (!GNC_IS_MAIN_WINDOW (page->window))
        return;

    window = GNC_MAIN_WINDOW (page->window);
    if (!window)
    {
        g_warning("Page is not in a window.");
        return;
    }

    gnc_main_window_disconnect(window, page);
    gnc_plugin_page_destroy_widget (page);
    g_object_unref(page);

    /* If this isn't the last window, go ahead and destroy the window. */
    priv = GNC_MAIN_WINDOW_GET_PRIVATE(window);
    if (priv->installed_pages == NULL)
    {
        if (window->window_quitting)
        {
            GncPluginManager *manager = gnc_plugin_manager_get ();
            GList *plugins = gnc_plugin_manager_get_plugins (manager);

            /* remove only the preference callbacks from the window plugins */
            window->just_plugin_prefs = TRUE;
            g_list_foreach (plugins, gnc_main_window_remove_plugin, window);
            window->just_plugin_prefs = FALSE;
            g_list_free (plugins);

            /* remove the preference callbacks from the main window */
            gnc_main_window_remove_prefs (window);
        }
        if (window && (gnc_list_length_cmp (active_windows, 1) > 0))
            gtk_widget_destroy (GTK_WIDGET(window));
    }
}

gnc_main_window_display_page()

void gnc_main_window_display_page

(

GncPluginPage *

page

)

Bring the window containing the specified page to the top of the window stack, then switch the notebook to show the specified page.

Parameters

page	The existing page to be displayed.

Definition at line 3211 of file gnc-main-window.c.

{
    GncMainWindow *window;
    GncMainWindowPrivate *priv;
    GtkNotebook *notebook;
    gint page_num;

    window = GNC_MAIN_WINDOW (page->window);
    priv = GNC_MAIN_WINDOW_GET_PRIVATE(window);
    notebook = GTK_NOTEBOOK (priv->notebook);
    page_num = gtk_notebook_page_num(notebook, page->notebook_page);
    gtk_notebook_set_current_page (notebook, page_num);
    gtk_window_present(GTK_WINDOW(window));
}

gnc_main_window_find_action()

GtkAction * gnc_main_window_find_action	(	GncMainWindow *	window,
		const gchar *	name
	)

Find action in main window.

Parameters

window	The window which should be checked for the action.
name	The name of the command to be retrieved.

Returns

A pointer to a GtkAction that was added with the specified name. If the name cannot be found, then NULL will be returned.

Definition at line 3604 of file gnc-main-window.c.

{
    GtkAction *action = NULL;
    const GList *groups, *tmp;

    groups = gtk_ui_manager_get_action_groups(window->ui_merge);
    for (tmp = groups; tmp; tmp = g_list_next(tmp))
    {
        action = gtk_action_group_get_action(GTK_ACTION_GROUP(tmp->data), name);
        if (action)
            break;
    }
    return action;
}

gnc_main_window_finish_pending()

gboolean gnc_main_window_finish_pending

(

GncMainWindow *

window

)

Tell a window to finish any outstanding activities.

This function will call gnc_plugin_page_finish_pending for each installed page. If any page returns a failure indication, then the function stops walking pages and immediately returns a failure.

Parameters

window

The window whose pages should be checked.

Returns

FALSE if any page could not or would not comply, which should cancel the pending operation. TRUE otherwise

Definition at line 1164 of file gnc-main-window.c.

{
    GncMainWindowPrivate *priv;
    GList *item;

    g_return_val_if_fail(GNC_IS_MAIN_WINDOW(window), TRUE);

    priv = GNC_MAIN_WINDOW_GET_PRIVATE(window);
    for (item = priv->installed_pages; item; item = g_list_next(item))
    {
        if (!gnc_plugin_page_finish_pending(item->data))
        {
            return FALSE;
        }
    }
    return TRUE;
}

gnc_main_window_get_action_group()

GtkActionGroup * gnc_main_window_get_action_group	(	GncMainWindow *	window,
		const gchar *	group_name
	)

Retrieve a specific set of user interface actions from a window.

This function can be used to get an group of action to be manipulated when the front page of a window has changed.

Parameters

window	The window to check when looking for the action group.
group_name	The name of a set of actions. This must be a name provided when the actions were installed.

Returns

A pointer to a GtkActionGroup that was added with the specified name. If the name cannot be found, then NULL will be returned.

Definition at line 3625 of file gnc-main-window.c.

{
    GncMainWindowPrivate *priv;
    MergedActionEntry *entry;

    g_return_val_if_fail (GNC_IS_MAIN_WINDOW (window), NULL);
    g_return_val_if_fail (group_name != NULL, NULL);

    priv = GNC_MAIN_WINDOW_GET_PRIVATE(window);
    if (priv->merged_actions_table == NULL)
        return NULL;
    entry = g_hash_table_lookup (priv->merged_actions_table, group_name);

    if (entry == NULL)
        return NULL;

    return entry->action_group;
}

gnc_main_window_get_current_page()

GncPluginPage * gnc_main_window_get_current_page

(

GncMainWindow *

window

)

Retrieve a pointer to the page that is currently at the front of the specified window.

Any plugin that needs to manipulate its menus based upon the currently selected menu page should connect to the "page_changed" signal on a window. The callback function from that signal can then call this function to obtain a pointer to the current page.

Parameters

window

A pointer to the window whose front page should be returned.

Returns

A pointer to the GncPluginPage currently at the front of the specified window. If the window pointer is invalid or the window is empty, this function will return NULL.

Definition at line 3445 of file gnc-main-window.c.

{
    GncMainWindowPrivate *priv;

    priv = GNC_MAIN_WINDOW_GET_PRIVATE(window);
    return priv->current_page;
}

gnc_main_window_get_type()

GType gnc_main_window_get_type

(

void

)

Get the type of a gnc main window.

Returns

A GType.

gnc_main_window_get_uimanager()

GtkUIManager * gnc_main_window_get_uimanager

(

GncMainWindow *

window

)

Returns the pointer to the GtkUIManager which is used for the menu item merging.

Definition at line 5257 of file gnc-main-window.c.

{
    g_assert(window);
    return window->ui_merge;
}

gnc_main_window_is_restoring_pages()

gboolean gnc_main_window_is_restoring_pages

(

GncMainWindow *

window

)

Check if the main window is restoring the plugin pages.

This is used on report pages to delay the creation of the report till the page is focused.

Parameters

window

The window whose pages should be checked.

Returns

TRUE if pages are being restored

Definition at line 568 of file gnc-main-window.c.

{
    GncMainWindowPrivate *priv = GNC_MAIN_WINDOW_GET_PRIVATE(window);
    return priv->restoring_pages;
}

gnc_main_window_manual_merge_actions()

void gnc_main_window_manual_merge_actions	(	GncMainWindow *	window,
		const gchar *	group_name,
		GtkActionGroup *	group,
		guint	merge_id
	)

Manually add a set of actions to the specified window.

Plugins whose user interface is not hard coded (e.g. the menu-additions * plugin) must create their actions at run time, then use this * function to install them into the window.

Parameters

window	A pointer to the window whose user interface should be updated.
group_name	The name for this set of actions. This name should be unique among all groups added to the window, and will be needed to remove the actions from this window.
group	A pointer to an array of GtkActions. These are the actions that will be added to the user interface.
merge_id	A merge identifier retrieved from a call to gtk_ui_manager_new_merge_id().

Definition at line 3460 of file gnc-main-window.c.

{
    GncMainWindowPrivate *priv;
    MergedActionEntry *entry;

    g_return_if_fail (GNC_IS_MAIN_WINDOW (window));
    g_return_if_fail (group_name != NULL);
    g_return_if_fail (GTK_IS_ACTION_GROUP(group));
    g_return_if_fail (merge_id > 0);

    priv = GNC_MAIN_WINDOW_GET_PRIVATE(window);
    entry = g_new0 (MergedActionEntry, 1);
    entry->action_group = group;
    entry->merge_id = merge_id;
    gtk_ui_manager_ensure_update (window->ui_merge);
    g_hash_table_insert (priv->merged_actions_table, g_strdup (group_name), entry);
}

gnc_main_window_merge_actions()

void gnc_main_window_merge_actions	(	GncMainWindow *	window,
		const gchar *	group_name,
		GtkActionEntry *	entries,
		guint	n_entries,
		GtkToggleActionEntry *	toggle_entries,
		guint	n_toggle_entries,
		const gchar *	filename,
		gpointer	user_data
	)

Add a set of actions to the specified window.

This function should not need to be called directly by plugin implementors. Correctly assigning values to the GncPluginClass fields during plugin initialization will cause this routine to be automatically called.

Parameters

window	A pointer to the window whose user interface should be updated.
group_name	The name for this set of actions. This name should be unique among all groups added to the window, and will be needed to remove the actions from this window.
entries	A pointer to an array of GtkActionEntry. These are the actions that will be added to the user interface.
n_entries	The number of actions in the array.
toggle_entries	A pointer to an array of GtkToggleActionEntry. These are the toggle actions that will be added to the user interface.
n_toggle_entries	The number of toggle actions in the array.
filename	The filename containing the user interface definition that goes with this set of actions.
user_data	The data to be provided to all callback functions.

Definition at line 3489 of file gnc-main-window.c.

{
    GncMainWindowPrivate *priv;
    GncMainWindowActionData *data;
    MergedActionEntry *entry;
    GError *error = NULL;
    gchar *pathname;

    g_return_if_fail (GNC_IS_MAIN_WINDOW (window));
    g_return_if_fail (group_name != NULL);
    g_return_if_fail (actions != NULL);
    g_return_if_fail (n_actions > 0);
    g_return_if_fail (filename != NULL);

    pathname = gnc_filepath_locate_ui_file (filename);
    if (pathname == NULL)
        return;

    data = g_new0 (GncMainWindowActionData, 1);
    data->window = window;
    data->data = user_data;

    priv = GNC_MAIN_WINDOW_GET_PRIVATE(window);
    entry = g_new0 (MergedActionEntry, 1);
    entry->action_group = gtk_action_group_new (group_name);
    gtk_action_group_set_translation_domain (entry->action_group, PROJECT_NAME);
    gtk_action_group_add_actions (entry->action_group, actions, n_actions, data);
    if (toggle_actions != NULL && n_toggle_actions > 0)
    {
        gtk_action_group_add_toggle_actions (entry->action_group,
                                             toggle_actions, n_toggle_actions,
                                             data);
    }
    gtk_ui_manager_insert_action_group (window->ui_merge, entry->action_group, 0);
    entry->merge_id = gtk_ui_manager_add_ui_from_file (window->ui_merge, pathname, &error);
    g_assert(entry->merge_id || error);
    if (entry->merge_id)
    {
        gtk_ui_manager_ensure_update (window->ui_merge);
        g_hash_table_insert (priv->merged_actions_table, g_strdup (group_name), entry);
    }
    else
    {
        g_critical("Failed to load ui file.\n  Filename %s\n  Error %s",
                   filename, error->message);
        g_error_free(error);
        g_free(entry);
    }
    g_free(pathname);
}

gnc_main_window_new()

GncMainWindow * gnc_main_window_new

(

void

)

Create a new gnc main window plugin.

Returns

A pointer to the new object.

Definition at line 3006 of file gnc-main-window.c.

{
    GncMainWindow *window;
    GtkWindow *old_window;

    window = g_object_new (GNC_TYPE_MAIN_WINDOW, NULL);
    gtk_window_set_default_size(GTK_WINDOW(window), 800, 600);

    old_window = gnc_ui_get_main_window (NULL);
    if (old_window)
    {
        gint width, height;
        gtk_window_get_size (old_window, &width, &height);
        gtk_window_resize (GTK_WINDOW (window), width, height);
        if ((gdk_window_get_state((gtk_widget_get_window (GTK_WIDGET(old_window))))
                & GDK_WINDOW_STATE_MAXIMIZED) != 0)
        {
            gtk_window_maximize (GTK_WINDOW (window));
        }
    }
    active_windows = g_list_append (active_windows, window);
    gnc_main_window_update_title(window);
    window->window_quitting = FALSE;
    window->just_plugin_prefs = FALSE;
#ifdef MAC_INTEGRATION
    gnc_quartz_set_menu(window);
#else
    gnc_main_window_update_all_menu_items();
#endif
    gnc_engine_add_commit_error_callback( gnc_main_window_engine_commit_error_callback, window );

    // set up a callback for notebook navigation
    g_signal_connect (G_OBJECT(window), "key-press-event",
                      G_CALLBACK(gnc_main_window_key_press_event),
                      NULL);

    return window;
}

gnc_main_window_open_page()

void gnc_main_window_open_page	(	GncMainWindow *	window,
		GncPluginPage *	page
	)

Display a data plugin page in a window.

If the page already exists in any window, then that window will be brought to the front and the notebook switch to display the specified page. If the page is new then it will be added to the specified window (unless the page itself requests otherwise.). If the window is NULL, the new page will be added to the first window.

Parameters

window	The window to display a new page in.
page	The new page of data to be displayed, or the existing page of data the should be brought to the top and displayed.

Definition at line 3235 of file gnc-main-window.c.

{
    GncMainWindowPrivate *priv;
    GtkWidget *tab_hbox;
    GtkWidget *label, *entry;
    const gchar *icon, *text, *color_string, *lab_text;
    GtkWidget *image;
    GList *tmp;
    TabWidth *tw;

    ENTER("window %p, page %p", window, page);
    if (window)
        g_return_if_fail (GNC_IS_MAIN_WINDOW (window));
    g_return_if_fail (GNC_IS_PLUGIN_PAGE (page));
    g_return_if_fail (gnc_plugin_page_has_books(page));

    if (gnc_main_window_page_exists(page))
    {
        gnc_main_window_display_page(page);
        return;
    }

    /* Does the page want to be in a new window? */
    if (gnc_plugin_page_get_use_new_window(page))
    {
        /* See if there's a blank window. If so, use that. */
        for (tmp = active_windows; tmp; tmp = g_list_next(tmp))
        {
            window = GNC_MAIN_WINDOW(tmp->data);
            priv = GNC_MAIN_WINDOW_GET_PRIVATE(window);
            if (priv->installed_pages == NULL)
            {
                break;
            }
        }
        if (tmp == NULL)
            window = gnc_main_window_new ();
        gtk_widget_show(GTK_WIDGET(window));
    }
    else if ((window == NULL) && active_windows)
    {
        window = active_windows->data;
    }

    page->window = GTK_WIDGET(window);
    page->notebook_page = gnc_plugin_page_create_widget (page);
    g_object_set_data (G_OBJECT (page->notebook_page),
                       PLUGIN_PAGE_LABEL, page);

    /*
     * The page tab.
     */
    icon = GNC_PLUGIN_PAGE_GET_CLASS(page)->tab_icon;
    lab_text = gnc_plugin_page_get_page_name(page);
    label = gtk_label_new (lab_text);
    g_object_set_data (G_OBJECT (page), PLUGIN_PAGE_TAB_LABEL, label);

    tw = populate_tab_width_struct ();
    gnc_main_window_update_tab_width_one_page (page, tw);
    g_free (tw);

    gtk_widget_show (label);

    tab_hbox = gtk_box_new (GTK_ORIENTATION_HORIZONTAL, 6);

    if (g_strcmp0 (gnc_plugin_page_get_plugin_name (page), "GncPluginPageAccountTree") == 0)
        gtk_widget_set_name (GTK_WIDGET(tab_hbox), "gnc-id-account-page-tab-box");

    gtk_box_set_homogeneous (GTK_BOX (tab_hbox), FALSE);
    gtk_widget_show (tab_hbox);

    if (icon != NULL)
    {
        image = gtk_image_new_from_icon_name (icon, GTK_ICON_SIZE_MENU);
        gtk_widget_show (image);
        gtk_box_pack_start (GTK_BOX (tab_hbox), image, FALSE, FALSE, 0);
        gtk_widget_set_margin_start (GTK_WIDGET(image), 5);
        gtk_box_pack_start (GTK_BOX (tab_hbox), label, TRUE, TRUE, 0);
    }
    else
        gtk_box_pack_start (GTK_BOX (tab_hbox), label, TRUE, TRUE, 0);

    text = gnc_plugin_page_get_page_long_name(page);
    if (text)
    {
        gtk_widget_set_tooltip_text(tab_hbox, text);
    }

    entry = gtk_entry_new();
    gtk_widget_hide (entry);
    gtk_box_pack_start (GTK_BOX (tab_hbox), entry, TRUE, TRUE, 0);
    g_signal_connect(G_OBJECT(entry), "activate",
                     G_CALLBACK(gnc_main_window_tab_entry_activate), page);
    g_signal_connect(G_OBJECT(entry), "focus-out-event",
                     G_CALLBACK(gnc_main_window_tab_entry_focus_out_event),
                     page);
    g_signal_connect(G_OBJECT(entry), "key-press-event",
                     G_CALLBACK(gnc_main_window_tab_entry_key_press_event),
                     page);
    g_signal_connect(G_OBJECT(entry), "editing-done",
                     G_CALLBACK(gnc_main_window_tab_entry_editing_done),
                     page);

    /* Add close button - Not for immutable pages */
    if (!g_object_get_data (G_OBJECT (page), PLUGIN_PAGE_IMMUTABLE))
    {
        GtkWidget *close_image, *close_button;
        GtkRequisition requisition;

        close_button = gtk_button_new();
        gtk_button_set_relief(GTK_BUTTON(close_button), GTK_RELIEF_NONE);
        close_image = gtk_image_new_from_icon_name ("window-close", GTK_ICON_SIZE_MENU);
        gtk_widget_show(close_image);
        gtk_widget_get_preferred_size (close_image, &requisition, NULL);
        gtk_widget_set_size_request(close_button, requisition.width + 4,
                                    requisition.height + 2);
        gtk_container_add(GTK_CONTAINER(close_button), close_image);
        if (gnc_prefs_get_bool(GNC_PREFS_GROUP_GENERAL, GNC_PREF_SHOW_CLOSE_BUTTON))
            gtk_widget_show (close_button);
        else
            gtk_widget_hide (close_button);

        g_signal_connect_swapped (G_OBJECT (close_button), "clicked",
                                  G_CALLBACK(gnc_main_window_close_page), page);

        gtk_box_pack_start (GTK_BOX (tab_hbox), close_button, FALSE, FALSE, 0);
        gtk_widget_set_margin_end (GTK_WIDGET(close_button), 5);
        g_object_set_data (G_OBJECT (page), PLUGIN_PAGE_CLOSE_BUTTON, close_button);
    }

    /*
     * The popup menu
     */
    label = gtk_label_new (gnc_plugin_page_get_page_name(page));

    /*
     * Now install it all in the window.
     */
    gnc_main_window_connect(window, page, tab_hbox, label);

    color_string = gnc_plugin_page_get_page_color(page);
    main_window_update_page_color (page, color_string);
    LEAVE("");
}

gnc_main_window_popup_menu_cb()

gboolean gnc_main_window_popup_menu_cb	(	GtkWidget *	widget,
		GncPluginPage *	page
	)

Callback function invoked when the user requests that Gnucash popup the contextual menu via the keyboard context-menu request key combination (Shift-F10 by default).

Parameters

page	This is the GncPluginPage corresponding to the visible page.
widget	Whatever widget had focus when the user issued the keyboard context-menu request.

Returns

Always returns TRUE to indicate that the menu request was handled.

Definition at line 5209 of file gnc-main-window.c.

{
    ENTER("widget %p, page %p", widget, page);
    do_popup_menu(page, NULL);
    LEAVE(" ");
    return TRUE;
}

gnc_main_window_restore_all_windows()

void gnc_main_window_restore_all_windows

(

const GKeyFile *

keyfile

)

Restore the persistent state of all windows.

Parameters

keyfile

The GKeyFile containing persistent window state.

Definition at line 964 of file gnc-main-window.c.

{
    gint i, window_count;
    GError *error = NULL;
    GncMainWindowSaveData data;
    GncMainWindow *window;

    /* We use the same struct for reading and for writing, so we cast
       away the const. */
    data.key_file = (GKeyFile *) keyfile;
    window_count = g_key_file_get_integer(data.key_file, STATE_FILE_TOP,
                                          WINDOW_COUNT, &error);
    if (error)
    {
        g_warning("error reading group %s key %s: %s",
                  STATE_FILE_TOP, WINDOW_COUNT, error->message);
        g_error_free(error);
        LEAVE("can't read count");
        return;
    }

    /* Restore all state information on the open windows.  Window
       numbers in state file are 1-based. GList indices are 0-based. */
    gnc_set_busy_cursor (NULL, TRUE);
    for (i = 0; i < window_count; i++)
    {
        data.window_num = i;
        window = g_list_nth_data(active_windows, i);
        gnc_main_window_restore_window(window, &data);
    }
    gnc_unset_busy_cursor (NULL);

    statusbar_notification_lastmodified();
}

gnc_main_window_save_all_windows()

void gnc_main_window_save_all_windows

(

GKeyFile *

keyfile

)

Save the persistent state of all windows.

Parameters

keyfile

The GKeyFile to contain persistent window state.

Definition at line 1146 of file gnc-main-window.c.

{
    GncMainWindowSaveData data;

    /* Set up the iterator data structures */
    data.key_file = keyfile;
    data.window_num = 1;
    data.page_num = 1;

    g_key_file_set_integer(data.key_file,
                           STATE_FILE_TOP, WINDOW_COUNT,
                           g_list_length(active_windows));
    /* Dump all state information on the open windows */
    g_list_foreach(active_windows, (GFunc)gnc_main_window_save_window, &data);
}

gnc_main_window_set_progressbar_window()

void gnc_main_window_set_progressbar_window

(

GncMainWindow *

window

)

Set the window where all progressbar updates should occur.

This is a wrapper around the gnc_window_set_progressbar_window() function.

Parameters

window

The window to use for all progressbar updates.

Definition at line 5147 of file gnc-main-window.c.

{
    GncWindow *gncwin;
    gncwin = GNC_WINDOW(window);
    gnc_window_set_progressbar_window(gncwin);
}

gnc_main_window_unmerge_actions()

void gnc_main_window_unmerge_actions	(	GncMainWindow *	window,
		const gchar *	group_name
	)

Remove a set of actions from the specified window.

This function should not need to be called directly by plugin implementors. It will automatically be called when a plugin is removed from a window.

Parameters

window	A pointer to the window whose user interface should be updated.
group_name	The name for this set of actions. This must be the same name provided when the actions were installed.

Definition at line 3554 of file gnc-main-window.c.

{
    GncMainWindowPrivate *priv;
    MergedActionEntry *entry;

    g_return_if_fail (GNC_IS_MAIN_WINDOW (window));
    g_return_if_fail (group_name != NULL);

    priv = GNC_MAIN_WINDOW_GET_PRIVATE(window);
    if (priv->merged_actions_table == NULL)
        return;
    entry = g_hash_table_lookup (priv->merged_actions_table, group_name);

    if (entry == NULL)
        return;

    gtk_ui_manager_remove_action_group (window->ui_merge, entry->action_group);
    gtk_ui_manager_remove_ui (window->ui_merge, entry->merge_id);
    gtk_ui_manager_ensure_update (window->ui_merge);

    g_hash_table_remove (priv->merged_actions_table, group_name);
}

gnc_ui_get_gtk_window()

GtkWindow* gnc_ui_get_gtk_window

(

GtkWidget *

widget

)

Get a pointer to the widget's immediate top level GtkWindow.

This can be a dialog window or a GncMainWindow. If the widget is not a child of a GtkWindow (yet), NULL is returned.

Parameters

widget

the widget to find a GtkWindow for.

Returns

A pointer to a GtkWindow object or NULL if no toplevel was found.

Definition at line 5009 of file gnc-main-window.c.

{
    GtkWidget *toplevel;

    if (!widget)
        return NULL;

    toplevel = gtk_widget_get_toplevel (widget);
    if (toplevel && GTK_IS_WINDOW (toplevel))
        return GTK_WINDOW (toplevel);
    else
        return NULL;
}

gnc_ui_get_main_window()

GtkWindow* gnc_ui_get_main_window

(

GtkWidget *

widget

)

Get a pointer to the final GncMainWindow widget is rooted in.

If widget is a child of a GncMainWindow return that window. If it's a child of a dialog window recursively query the dialog's transient parent until the first parent that's a GncMainWindow and return that. If widget is NULL or not part of any GtkWindow, get a pointer to the first active top level window. If there is none, return the first mapped window. If there's no mapped window return NULL.

An example of why searching for a GncMainWindow makes sense: suppose a user has opened a search dialog for vendors and in that dialog has clicked "View vendor invoices". This opens another search window in which the user can click "View/Edit bill". Clicking that button should open a new tab in the GncMainWindow from which the first search dialog was opened.

Parameters

widget

the widget to find a GncMainWindow for.

Returns

A pointer to a GtkWindow object.

Definition at line 5024 of file gnc-main-window.c.

{
    GList *window;

    GtkWindow *toplevel = gnc_ui_get_gtk_window (widget);
    while (toplevel && !GNC_IS_MAIN_WINDOW (toplevel))
        toplevel = gtk_window_get_transient_for(toplevel);

    if (toplevel)
        return toplevel;

    for (window = active_windows; window; window = window->next)
        if (gtk_window_is_active (GTK_WINDOW (window->data)))
            return window->data;

    for (window = active_windows; window; window = window->next)
        if (gtk_widget_get_mapped (GTK_WIDGET(window->data)))
            return window->data;

    return NULL;
}

main_window_update_page_color()

void main_window_update_page_color	(	GncPluginPage *	page,
		const gchar *	color_in
	)

Update the color on the page tabs in the main window.

Parameters

page	The page to be updated.
color_in	The new color string for the page tab.

Definition at line 2468 of file gnc-main-window.c.

{
    GncMainWindow *window;
    GncMainWindowPrivate *priv;
    GtkWidget *tab_widget;
    GdkRGBA tab_color;
    gchar *color_string = NULL;
    gboolean want_color = FALSE;

    ENTER(" ");
    if (color_in)
        color_string = g_strstrip(g_strdup(color_in));

    if (color_string && *color_string != '\0')
        want_color = TRUE;

    /* Update the plugin */
    window = GNC_MAIN_WINDOW(page->window);
    if (want_color)
        gnc_plugin_page_set_page_color(page, color_string);
    else
        gnc_plugin_page_set_page_color(page, NULL);

    /* Update the notebook tab */
    main_window_find_tab_widget (window, page, &tab_widget);
    priv = GNC_MAIN_WINDOW_GET_PRIVATE(window);

    if (want_color && gdk_rgba_parse(&tab_color, color_string) && priv->show_color_tabs)
    {
        GtkCssProvider *provider = gtk_css_provider_new();
        GtkStyleContext *stylectxt;
        gchar *col_str, *widget_css;

        if (!GTK_IS_EVENT_BOX (tab_widget))
        {
            GtkWidget *event_box = gtk_event_box_new ();
            g_object_ref (tab_widget);
            gtk_notebook_set_tab_label (GTK_NOTEBOOK(priv->notebook),
                                        page->notebook_page, event_box);
            gtk_container_add (GTK_CONTAINER(event_box), tab_widget);
            g_object_unref (tab_widget);
            tab_widget = event_box;
        }

        stylectxt = gtk_widget_get_style_context (GTK_WIDGET (tab_widget));
        col_str = gdk_rgba_to_string (&tab_color);
        widget_css = g_strconcat ("*{\n  background-color:", col_str, ";\n}\n", NULL);

        gtk_css_provider_load_from_data (provider, widget_css, -1, NULL);
        gtk_style_context_add_provider (stylectxt, GTK_STYLE_PROVIDER (provider),
                                        GTK_STYLE_PROVIDER_PRIORITY_APPLICATION);
        g_object_unref (provider);
        g_free (col_str);
        g_free (widget_css);
    }
    else
    {
        if (GTK_IS_EVENT_BOX (tab_widget))
        {
            GtkWidget *tab_hbox = gtk_bin_get_child(GTK_BIN(tab_widget));
            g_object_ref (tab_hbox);
            gtk_container_remove (GTK_CONTAINER(tab_widget), tab_hbox);
            gtk_notebook_set_tab_label (GTK_NOTEBOOK(priv->notebook),
                                        page->notebook_page, tab_hbox);
            g_object_unref (tab_hbox);
        }
    }
    g_free(color_string);
    LEAVE("done");
}

main_window_update_page_name()

void main_window_update_page_name	(	GncPluginPage *	page,
		const gchar *	name_in
	)

Update the name of the page in the main window.

Parameters

page	The page to be updated.
name_in	The new name for the page.

Definition at line 2379 of file gnc-main-window.c.

{
    GncMainWindow *window;
    GncMainWindowPrivate *priv;
    GtkWidget *label, *entry;
    gchar *name, *old_page_name, *old_page_long_name;
    TabWidth *tw;

    ENTER(" ");

    if ((name_in == NULL) || (*name_in == '\0'))
    {
        LEAVE("no string");
        return;
    }
    name = g_strstrip(g_strdup(name_in));

    /* Optimization, if the name hasn't changed, don't update X. */
    if (*name == '\0' || 0 == strcmp(name, gnc_plugin_page_get_page_name(page)))
    {
        g_free(name);
        LEAVE("empty string or name unchanged");
        return;
    }

    old_page_name = g_strdup( gnc_plugin_page_get_page_name(page));
    old_page_long_name = g_strdup( gnc_plugin_page_get_page_long_name(page));

    /* Update the plugin */
    gnc_plugin_page_set_page_name(page, name);

    /* Update the notebook tab */
    window = GNC_MAIN_WINDOW(page->window);
    if (!window)
    {
        g_free(old_page_name);
        g_free(old_page_long_name);
        g_free(name);
        LEAVE("no window widget available");
        return;
    }

    if (main_window_find_tab_items(window, page, &label, &entry))
        gtk_label_set_text(GTK_LABEL(label), name);

    /* Adjust the label width for new text */
    tw = populate_tab_width_struct ();
    gnc_main_window_update_tab_width_one_page (page, tw);
    g_free (tw);

    /* Update Tooltip on notebook Tab */
    if (old_page_long_name && old_page_name
            && g_strrstr(old_page_long_name, old_page_name) != NULL)
    {
        gchar *new_page_long_name;
        gint string_position;
        GtkWidget *tab_widget;

        string_position = strlen(old_page_long_name) - strlen(old_page_name);
        new_page_long_name = g_strconcat(g_strndup(old_page_long_name, string_position), name, NULL);

        gnc_plugin_page_set_page_long_name(page, new_page_long_name);

        if (main_window_find_tab_widget(window, page, &tab_widget))
            gtk_widget_set_tooltip_text(tab_widget, new_page_long_name);

        g_free(new_page_long_name);
    }

    /* Update the notebook menu */
    if (page->notebook_page)
    {
        priv = GNC_MAIN_WINDOW_GET_PRIVATE(window);
        label = gtk_notebook_get_menu_label (GTK_NOTEBOOK(priv->notebook),
                                             page->notebook_page);
        gtk_label_set_text(GTK_LABEL(label), name);
    }

    /* Force an update of the window title */
    gnc_main_window_update_title(window);
    g_free(old_page_long_name);
    g_free(old_page_name);
    g_free(name);
    LEAVE("done");
}

main_window_update_page_set_read_only_icon()

void main_window_update_page_set_read_only_icon	(	GncPluginPage *	page,
		gboolean	read_only
	)

Update the icon on the page tabs in the main window.

Parameters

page	The page to be updated.
read_only	If set a padlock icon will be displayed for the page tab icon if it had one.

Definition at line 2542 of file gnc-main-window.c.

{
    GncMainWindow *window;
    GncMainWindowPrivate *priv;
    GtkWidget *tab_widget;
    GtkWidget *image = NULL;
    GList *children;
    gchar *image_name = NULL;
    const gchar *icon_name;

    ENTER(" ");

    g_return_if_fail (page && page->window);

    if (!GNC_IS_MAIN_WINDOW (page->window))
        return;

    window = GNC_MAIN_WINDOW(page->window);

    /* Get the notebook tab widget */
    main_window_find_tab_widget (window, page, &tab_widget);
    priv = GNC_MAIN_WINDOW_GET_PRIVATE(window);

    if (!tab_widget)
    {
        LEAVE("no tab widget");
        return;
    }

    if (GTK_IS_EVENT_BOX(tab_widget))
        tab_widget = gtk_bin_get_child (GTK_BIN(tab_widget));

    children = gtk_container_get_children (GTK_CONTAINER(tab_widget));
    /* For each, walk the list of container children to get image widget */
    for (GList *child = children; child; child = g_list_next (child))
    {
        GtkWidget *widget = child->data;
        if (GTK_IS_IMAGE(widget))
            image = widget;
    }
    g_list_free (children);

    if (!image)
    {
        LEAVE("no image to replace");
        return;
    }

    g_object_get (image, "icon-name", &image_name, NULL);

    if (read_only)
        icon_name = "changes-prevent-symbolic";
    else
        icon_name = GNC_PLUGIN_PAGE_GET_CLASS(page)->tab_icon;

    if (g_strcmp0 (icon_name, image_name) == 0)
    {
        LEAVE("page icon the same, no need to replace");
        g_free (image_name);
        return;
    }
    gtk_container_remove (GTK_CONTAINER(tab_widget), image);
    image = gtk_image_new_from_icon_name (icon_name, GTK_ICON_SIZE_MENU);
    gtk_widget_show (image);

    gtk_container_add (GTK_CONTAINER(tab_widget), image);
    gtk_widget_set_margin_start (GTK_WIDGET(image), 5);
    gtk_box_reorder_child (GTK_BOX(tab_widget), image, 0);

    g_free (image_name);
    LEAVE("done");
}