Gnome User Interface Library Reference Manual
PrevNext

GnomeEntry

Name

GnomeEntry — one line description goes here.

Synopsis


#include <gnome.h>


struct      GnomeEntry
GtkWidget*  gnome_entry_new                 (const gchar *history_id);
GtkWidget*  gnome_entry_gtk_entry           (GnomeEntry *gentry);
void        gnome_entry_set_history_id      (GnomeEntry *gentry,
                                             const gchar *history_id);
void        gnome_entry_prepend_history     (GnomeEntry *gentry,
                                             gint save,
                                             const gchar *text);
void        gnome_entry_append_history      (GnomeEntry *gentry,
                                             gint save,
                                             const gchar *text);
void        gnome_entry_load_history        (GnomeEntry *gentry);
void        gnome_entry_save_history        (GnomeEntry *gentry);

Object Hierarchy


  GtkObject
   +----GtkWidget
         +----GtkContainer
               +----GtkBox
                     +----GtkHBox
                           +----GtkCombo
                                 +----GnomeEntry

Description

Details

GnomeEntry

struct GnomeEntry;

gnome_entry_new()

GtkWidget*  gnome_entry_new                 (const gchar *history_id);

Creates a new gnome-entry widget. If history_id is not NULL, then the history list will be saved and restored between uses under the given id.

history_id : If not NULL, the text id under which history data is storedReturns :Newly-created gnome-entry widget.

gnome_entry_gtk_entry()

GtkWidget*  gnome_entry_gtk_entry           (GnomeEntry *gentry);

Obtain pointer to GNOME entry's internal text entry widget.

gentry : Pointer to GNOME entry object.Returns :Pointer to gtk-entry widget.

gnome_entry_set_history_id()

void        gnome_entry_set_history_id      (GnomeEntry *gentry,
                                             const gchar *history_id);

Set or clear the history id of the GNOME entry widget. If history_id is NULL, the widget's history id is cleared. Otherwise, the given id replaces the previous widget history id.

gentry : Pointer to GNOME entry object.history_id : If not NULL, the text id under which history data is stored

gnome_entry_prepend_history()

void        gnome_entry_prepend_history     (GnomeEntry *gentry,
                                             gint save,
                                             const gchar *text);

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).

gentry : Pointer to GNOME entry object.save : If TRUE, history entry will be saved to config filetext : 

gnome_entry_append_history()

void        gnome_entry_append_history      (GnomeEntry *gentry,
                                             gint save,
                                             const gchar *text);

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).

gentry : Pointer to GNOME entry object.save : If TRUE, history entry will be saved to config filetext : 

gnome_entry_load_history()

void        gnome_entry_load_history        (GnomeEntry *gentry);

Loads a stored history list from the GNOME config file, if one is available. If the history id of gentry is NULL, nothing occurs.

gentry : Pointer to GNOME entry object.

gnome_entry_save_history()

void        gnome_entry_save_history        (GnomeEntry *gentry);

gentry : 

PrevHomeNext
GnomeDockUpGnomeFileEntry