Description
These functions provide access to store and retrieve a list of
recently used documents. Applications need to call
gnome_history_recently_used() routine with the proper arguments to
register a file as having been recently used. The creator field
should be an action in the format supported by the "open" mime-type
action (for example "program f", or "program") to re-open the
document.
In the following example, the file
sales.gnumericill be added to the historic list
of visited documents, the mime-type of the file is
"application/x-gnumeric" and the program that will open this file is
"gnumeric". Finally note that the descriptive information is
surrounded by the _() macro to have this item translated to the user's
language at runtime.
The following example would keep track of recent talks with a
user:
To retrieve items from the history, you use the
gnome_history_get_recently_used() function which returns a GList that
contains GnomeHistoryEntry structures. To
release this list, call the
gnome_history_free_recently_used_list().