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.
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 516 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 485 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 343 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 747 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);
    }
}