File History Menu Items
[Menu Only Plugins]

Files
file	gnc-plugin-file-history.h
	Utility functions for writing import modules.
Data Structures
struct	GncPluginFileHistoryPrivate
struct	GncPluginFileHistory
struct	GncPluginFileHistoryClass
Defines
#define	FILENAME_STRING   "filename"
#define	PLUGIN_ACTIONS_NAME   "gnc-plugin-file-history-actions"
#define	PLUGIN_UI_FILENAME   "gnc-plugin-file-history-ui.xml"
#define	GNC_TYPE_PLUGIN_FILE_HISTORY   (gnc_plugin_file_history_get_type ())
#define	GNC_PLUGIN_FILE_HISTORY(obj)   (G_TYPE_CHECK_INSTANCE_CAST ((obj), GNC_TYPE_PLUGIN_FILE_HISTORY, GncPluginFileHistory))
#define	GNC_PLUGIN_FILE_HISTORY_CLASS(klass)   (G_TYPE_CHECK_CLASS_CAST ((klass), GNC_TYPE_PLUGIN_FILE_HISTORY, GncPluginFileHistoryClass))
#define	GNC_IS_PLUGIN_FILE_HISTORY(obj)   (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GNC_TYPE_PLUGIN_FILE_HISTORY))
#define	GNC_IS_PLUGIN_FILE_HISTORY_CLASS(klass)   (G_TYPE_CHECK_CLASS_TYPE ((klass), GNC_TYPE_PLUGIN_FILE_HISTORY))
#define	GNC_PLUGIN_FILE_HISTORY_GET_CLASS(obj)   (G_TYPE_INSTANCE_GET_CLASS ((obj), GNC_TYPE_PLUGIN_FILE_HISTORY, GncPluginFileHistoryClass))
#define	GNC_PLUGIN_FILE_HISTORY_NAME   "gnc-plugin-file-history"
#define	MAX_HISTORY_FILES   10
#define	HISTORY_STRING_SECTION   "history"
#define	HISTORY_STRING_MAXFILES   "maxfiles"
#define	HISTORY_STRING_FILE_N   "file%d"
Typedefs
typedef GncPluginFileHistoryPrivate	GncPluginFileHistoryPrivate
Functions
void	gnc_history_add_file (const char *newfile)
char *	gnc_history_get_last (void)
GType	gnc_plugin_file_history_get_type (void)
GncPlugin *	gnc_plugin_file_history_new (void)

---

Function Documentation

void gnc_history_add_file (  const char *  filename  )

Add a file name to the front of the file "history list". If the name already exist on the list, then it is moved from its current location to the front of the list. The "list" is actually a sequence of up to ten gconf keys. Parameters: filename  The name of the file to add to the list. Definition at line 98 of file gnc-plugin-file-history.c. { gchar *filename, *from, *to; gint i, last; if (newfile == NULL) return; if (!g_utf8_validate(newfile, -1, NULL)) return; /* * Look for the filename in gconf. */ last = MAX_HISTORY_FILES - 1; for (i = 0; i < MAX_HISTORY_FILES; i++) { from = g_strdup_printf(HISTORY_STRING_FILE_N, i); filename = gnc_gconf_get_string(HISTORY_STRING_SECTION, from, NULL); g_free(from); if (!filename) { last = i; break; } if (g_utf8_collate(newfile, filename) == 0) { g_free(filename); last = i; break; } g_free(filename); } /* * Shuffle filenames upward through gconf. */ to = g_strdup_printf(HISTORY_STRING_FILE_N, last); for (i = last - 1; i >= 0; i--) { from = g_strdup_printf(HISTORY_STRING_FILE_N, i); filename = gnc_gconf_get_string(HISTORY_STRING_SECTION, from, NULL); if (filename) { gnc_gconf_set_string(HISTORY_STRING_SECTION, to, filename, NULL); g_free(filename); } else { gnc_gconf_unset(HISTORY_STRING_SECTION, to, NULL); } g_free(to); to = from; } /* * Store the new zero entry. */ gnc_gconf_set_string(HISTORY_STRING_SECTION, to, newfile, NULL); }

char * gnc_history_get_last (  void   )

Retrieve the name of the file most recently accessed. This is the name at the front of the list. Since the "list" is actually a sequence of up to ten gconf keys, this is the value of key zero. Returns: This function returns an allocated string containing the name of the most recently accessed file. The caller is responsible for freeing this string. Definition at line 158 of file gnc-plugin-file-history.c. { static char *filename = NULL; char *key; /* The static string supports the current signature of this * function. At some point this should be changed to pass the * allocated string up to the caller and make them responsible for * freeing irt, but that change percolates up into the scheme code * and requires changing that as well. */ if (filename) { g_free(filename); filename = NULL; } key = g_strdup_printf(HISTORY_STRING_FILE_N, 0); filename = gnc_gconf_get_string(HISTORY_STRING_SECTION, key, NULL); g_free(key); return filename; }

GType gnc_plugin_file_history_get_type (  void   )

Get the type of a file history plugin. Returns: A GType. Definition at line 377 of file gnc-plugin-file-history.c. { static GType gnc_plugin_file_history_type = 0; if (gnc_plugin_file_history_type == 0) { static const GTypeInfo our_info = { sizeof (GncPluginFileHistoryClass), NULL, /* base_init */ NULL, /* base_finalize */ (GClassInitFunc) gnc_plugin_file_history_class_init, NULL, /* class_finalize */ NULL, /* class_data */ sizeof (GncPluginFileHistory), 0, (GInstanceInitFunc) gnc_plugin_file_history_init }; gnc_plugin_file_history_type = g_type_register_static (GNC_TYPE_PLUGIN, "GncPluginFileHistory", &our_info, 0); } return gnc_plugin_file_history_type; }

GncPlugin * gnc_plugin_file_history_new (  void   )

Create a new file history plugin. This plugin attaches the file history menu to any window that is opened. Returns: A pointer to the new object. Definition at line 459 of file gnc-plugin-file-history.c. { GncPlugin *plugin_page = NULL; ENTER(""); plugin_page = GNC_PLUGIN (g_object_new (GNC_TYPE_PLUGIN_FILE_HISTORY, NULL)); LEAVE("plugin %p", plugin_page); return plugin_page; }

---