Gnome-specific GUI handling.

Files
file	gnc-gnome-utils.h
	Gnome specific utility functions.

Functions
void	gnc_gnome_utils_init (void)
	Initialize the gnome-utils library Should be run once before using any gnome-utils features.
void	gnc_add_css_file (void)
	Load a gtk resource configuration file to customize gtk appearance and behaviour.
void	gnc_gnome_help (GtkWindow *parent, const char *file_name, const char *anchor)
	Launch the systems default help browser, gnome's yelp for linux, and open to a given link within a given file. More...
void	gnc_launch_doclink (GtkWindow *parent, const char *uri)
	Launch the default browser and open the provided URI.
void	gnc_options_dialog_set_book_options_help_cb (GNCOptionWin *win)
	Set the help callback to 'gnc_book_options_help_cb' to open a help browser and point it to the Book Options link in the Help file.
void	gnc_options_dialog_set_new_book_option_values (GNCOptionDB *odb)
	Set the initial values of new book options to values specified in user preferences.
void	gnc_options_dialog_set_style_sheet_options_help_cb (GNCOptionWin *win)
	Set the help callback to 'gnc_style_sheet_options_help_cb' to open a help browser and point it to the Style Sheet link in the Help file.
GtkWidget *	gnc_gnome_get_pixmap (const char *name)
	Given a file name, find and load the requested pixmap. More...
GdkPixbuf *	gnc_gnome_get_gdkpixbuf (const char *name)
	Given a file name, find and load the requested pixbuf. More...
void	gnc_shutdown (int exit_status)
	Shutdown gnucash. More...
GncMainWindow *	gnc_gui_init (void)
	Initialize the gnucash gui.
int	gnc_ui_start_event_loop (void)
gboolean	gnucash_ui_is_running (void)

Detailed Description

Function Documentation

gnc_gnome_get_gdkpixbuf()

GdkPixbuf* gnc_gnome_get_gdkpixbuf

(

const char *

name

)

Given a file name, find and load the requested pixbuf.

This routine will display an error message if it can't find the file or load the pixbuf.

Parameters

name	The name of the pixbuf file to load.

Returns

A pointer to the pixbuf, or NULL of the file couldn't be found or loaded..

Definition at line 577 of file gnc-gnome-utils.c.

{
    GdkPixbuf *pixbuf;
    GError *error = NULL;
    char *fullname;

    g_return_val_if_fail (name != NULL, NULL);

    fullname = gnc_filepath_locate_pixmap (name);
    if (fullname == NULL)
        return NULL;

    DEBUG ("Loading pixbuf file %s", fullname);
    pixbuf = gdk_pixbuf_new_from_file (fullname, &error);
    if (error != NULL)
    {
        g_assert (pixbuf == NULL);
        PERR ("Could not load pixbuf: %s", error->message);
        g_error_free (error);
    }
    g_free (fullname);

    return pixbuf;
}

gnc_gnome_get_pixmap()

GtkWidget* gnc_gnome_get_pixmap

(

const char *

name

)

Given a file name, find and load the requested pixmap.

This routine will display an error message if it can't find the file or load the pixmap.

Parameters

name	The name of the pixmap file to load.

Returns

A pointer to the pixmap, or NULL of the file couldn't be found or loaded..

Definition at line 546 of file gnc-gnome-utils.c.

{
    GtkWidget *pixmap;
    char *fullname;

    g_return_val_if_fail (name != NULL, NULL);

    fullname = gnc_filepath_locate_pixmap (name);
    if (fullname == NULL)
        return NULL;

    DEBUG ("Loading pixmap file %s", fullname);

    pixmap = gtk_image_new_from_file (fullname);
    if (pixmap == NULL)
    {
        PERR ("Could not load pixmap");
    }
    g_free (fullname);

    return pixmap;
}

gnc_gnome_help()

void gnc_gnome_help	(	GtkWindow *	parent,
		const char *	file_name,
		const char *	anchor
	)

Launch the systems default help browser, gnome's yelp for linux, and open to a given link within a given file.

This routine will display an error message if it can't find the help file or can't open the help browser.

Parameters

parent	The parent window for any dialogs.
file_name	The name of the help file.
anchor	The anchor the help browser should scroll to.

Definition at line 404 of file gnc-gnome-utils.c.

{
    GError *error = NULL;
    gchar *uri = NULL;
    gboolean success = TRUE;

    if (anchor)
        uri = g_strconcat ("help:", file_name, "/", anchor, NULL);
    else
        uri = g_strconcat ("help:", file_name, NULL);

    DEBUG ("Attempting to opening help uri %s", uri);

    if (uri)
        success = gtk_show_uri_on_window (NULL, uri, gtk_get_current_event_time (), &error);

    g_free (uri);
    if (success)
        return;

    g_assert(error != NULL);
    {
        gnc_error_dialog (parent, "%s\n%s", _(msg_no_help_found), _(msg_no_help_reason));
    }
    PERR ("%s", error->message);
    g_error_free(error);
}

gnc_shutdown()

void gnc_shutdown

(

int

exit_status

)

Shutdown gnucash.

This function will initiate an orderly shutdown, and when that has finished it will exit the program.

Parameters

exit_status

The exit status for the program.

Definition at line 801 of file gnc-gnome-utils.c.

{
    if (gnucash_ui_is_running())
    {
        if (!gnome_is_terminating)
        {
            if (gnc_file_query_save (gnc_ui_get_main_window (NULL), FALSE))
            {
                gnc_hook_run(HOOK_UI_SHUTDOWN, NULL);
                gnc_gui_shutdown();
            }
        }
    }
    else
    {
        gnc_gui_destroy();
        gnc_hook_run(HOOK_SHUTDOWN, NULL);
        gnc_engine_shutdown();
        exit(exit_status);
    }
}