gnc-main-window.h

Go to the documentation of this file.

/*
 * gnc-main-window.h -- GtkWindow which represents the
 *  GnuCash main window.
 *
 * Copyright (C) 2003 Jan Arne Petersen <jpetersen@uni-bonn.de>
 * Copyright (C) 2003,2005 David Hampton <hampton@employees.org>
 *
 * 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@gnu.org
 */

#ifndef __GNC_MAIN_WINDOW_H
#define __GNC_MAIN_WINDOW_H

#include <gtk/gtk.h>
#include "gnc-plugin-page.h"

/* type macros */
#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 & structures */

typedef struct GncMainWindow
{
    GtkWindow gtk_window;   
    GtkUIManager *ui_merge; 
    gboolean window_quitting; 
    gboolean just_plugin_prefs; 
} GncMainWindow;

typedef struct
{
    GtkWindowClass gtk_window;  
    /* callbacks */
    void (*page_added)   (GncMainWindow *window,
                          GncPluginPage *page);
    void (*page_changed) (GncMainWindow *window,
                          GncPluginPage *page);
} GncMainWindowClass;

typedef struct
{
    GncMainWindow *window;
    gpointer data;
} GncMainWindowActionData;

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

/* function prototypes */

GType gnc_main_window_get_type (void);


GncMainWindow *gnc_main_window_new (void);


void gnc_main_window_display_page (GncPluginPage *page);


void gnc_main_window_open_page (GncMainWindow *window,
                                GncPluginPage *page);


void gnc_main_window_close_page (GncPluginPage *page);


/*  Iterator function to walk all pages in all windows, calling the
 *  specified function for each page.
 *
 *  @param entry A pointer to the function to be called.
 *
 *  @param user_data A data pointer passed to each call of the function.
 */
void gnc_main_window_foreach_page (GncMainWindowPageFunc fn,
                                   gpointer user_data);


GncPluginPage *gnc_main_window_get_current_page (GncMainWindow *window);


GtkUIManager *gnc_main_window_get_uimanager (GncMainWindow *window);


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


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

void
main_window_update_page_set_read_only_icon (GncPluginPage *page,
                                            gboolean read_only);

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


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


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


void gnc_main_window_actions_updated (GncMainWindow *window);


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


void gnc_main_window_set_progressbar_window( GncMainWindow *window );


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


gboolean gnc_main_window_popup_menu_cb (GtkWidget *widget,
        GncPluginPage *page);


void gnc_main_window_restore_all_windows(const GKeyFile *keyfile);

gboolean gnc_main_window_is_restoring_pages (GncMainWindow *window);

void gnc_main_window_save_all_windows(GKeyFile *keyfile);

void gnc_main_window_restore_default_state(GncMainWindow *window);


gboolean gnc_main_window_finish_pending (GncMainWindow *window);


gboolean gnc_main_window_all_finish_pending (void);

void gnc_main_window_all_action_set_sensitive (const gchar *action_name, gboolean sensitive);

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

void gnc_main_window_show_all_windows(void);

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

gboolean gnc_book_options_dialog_apply_helper(GNCOptionDB * options);

#endif /* __GNC_MAIN_WINDOW_H */