gnc-hooks.h

/*
 * gnc-hooks.h -- helpers for using Glib hook functions
 * Copyright (C) 2005 David Hampton <hampton@employees.org>
 *                    Derek Atkins <derek@ihtfp.com>
 *
 * 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_HOOKS_H
#define GNC_HOOKS_H

#ifdef __cplusplus
extern "C" {
#endif

gchar * gnc_hook_create(const gchar *name, gint num_args, const gchar *desc);

void gnc_hook_add_dangler(const gchar *name, GFunc callback,
                          GDestroyNotify destroy, gpointer cb_data);
void gnc_hook_remove_dangler(const gchar *name, GFunc callback);

int gnc_hook_num_args (const gchar *name);

void gnc_hook_run(const gchar *name, gpointer data);

void gnc_hooks_init(void);

/* Common hook names */
#define HOOK_STARTUP        "hook_startup"
#define HOOK_SHUTDOWN       "hook_shutdown"
#define HOOK_UI_STARTUP     "hook_ui_startup"
#define HOOK_UI_POST_STARTUP    "hook_ui_post_startup"
#define HOOK_UI_SHUTDOWN    "hook_ui_shutdown"
#define HOOK_NEW_BOOK       "hook_new_book"
#define HOOK_REPORT     "hook_report"
#define HOOK_CURRENCY_CHANGED   "hook_currency_changed"
#define HOOK_SAVE_OPTIONS   "hook_save_options"
#define HOOK_ADD_EXTENSION  "hook_add_extension"

/* Common session hook names */
#define HOOK_BOOK_OPENED    "hook_book_opened"
#define HOOK_BOOK_CLOSED    "hook_book_closed"
#define HOOK_BOOK_SAVED     "hook_book_saved"

#ifdef __cplusplus
}
#endif

#endif /* GNC_HOOKS_H */