Copyright (C) 2000-2012 |
Whole document tree
GnomeEntrySynopsis
Object Hierarchy
DescriptionThis widget is a wrapper around the GtkEntry widget, but it provides a history mechanism for all the input entered into the widget. The way this works is that a special identifier is provided when creating the GnomeEntry widget, and this identifier is used to load and save the history of the text. Here is an example of how to use the widget Example 1. Sample usage of the GnomeEntry widget
Detailsgnome_entry_new ()
Creates a new GnomeEntry widget. If history_id is not NULL, then the history list will be saved and restored between uses under the given id. gnome_entry_gtk_entry ()
Obtain pointer to GnomeEntry's internal text entry gnome_entry_set_history_id ()
Set or clear the history id of the GnomeEntry widget. If history_id is NULL, the widget's history id is cleared. Otherwise, the given id replaces the previous widget history id. gnome_entry_prepend_history ()
Adds a history item of the given text to the head of the history list inside gentry. If save is TRUE, the history item will be saved in the config file (assuming that gentry's history id is not NULL). gnome_entry_append_history ()
Adds a history item of the given text to the tail of the history list inside gentry. If save is TRUE, the history item will be saved in the config file (assuming that gentry's history id is not NULL). gnome_entry_load_history ()
Loads a stored history list from the GNOME config file, if one is available. If the history id of gentry is NULL, nothing occurs. gnome_entry_save_history ()
Force the history items of the widget to be stored in a configuration file. If the history id of gentry is NULL, nothing occurs. |