<!-- ##### SECTION Title ##### --> GnomeEntry <!-- ##### SECTION Short_Description ##### --> Entry widget with history tracking. <!-- ##### SECTION Long_Description ##### --> <para> This 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 <type>GnomeEntry</type> widget, and this identifier is used to load and save the history of the text. </para> <para> Here is an example of how to use the widget <example> <title>Sample usage of the GnomeEntry widget</title> <programlisting> GtkWidget *gnomeentry, *gtkentry; char *text; ... /* create a gnome entry */ gnomeentry = gnome_entry_new("some_history_id"); /* get the GtkEntry widget */ gtkentry = gnome_entry_gtk_entry (GNOME_ENTRY (gnomeentry)); /* set the text to "BLAH" */ gtk_entry_set_text(GTK_ENTRY(gtkentry), "BLAH"); ... /*somewhere else we wish to retrieve the contents*/ text = gtk_entry_get_text(GTK_ENTRY(gtkentry)); </programlisting> </example> </para> <!-- ##### SECTION See_Also ##### --> <para> #GnomeFileEntry, #GnomeIconEntry, #GnomePixmapEntry, #GnomeNumberEntry </para> <!-- ##### STRUCT GnomeEntry ##### --> <para> </para> <!-- ##### FUNCTION gnome_entry_new ##### --> <para> </para> @history_id: @Returns: <!-- ##### FUNCTION gnome_entry_gtk_entry ##### --> <para> </para> @gentry: @Returns: <!-- ##### FUNCTION gnome_entry_set_history_id ##### --> <para> </para> @gentry: @history_id: <!-- ##### FUNCTION gnome_entry_prepend_history ##### --> <para> </para> @gentry: @save: @text: <!-- ##### FUNCTION gnome_entry_append_history ##### --> <para> </para> @gentry: @save: @text: <!-- ##### FUNCTION gnome_entry_load_history ##### --> <para> </para> @gentry: <!-- ##### FUNCTION gnome_entry_save_history ##### --> <para> </para> @gentry: