GNU Info

(gtk.info)GtkEntry

---

Next: GtkEventBox Prev: GtkDrawingArea Up: Widgets

---

Enter node , (file) or (file)node

The entry widget
================

Description
-----------

   Enter text into this widget.  Derived from GtkEditable.  Can be set
so it isn't editable.

Options
-------

 - User Option: max
     With this option it is possible to set the TEXT_MAX_LENGTH to the
     value specified in the MAX option. This value is a guint16 value.

 - User Option: text
     With this option it is possible to 'preload' the text that will be
     displayed in the `entry' widget to the string pointed to by TEXT.

Signals
-------

 - Signal: void GtkEntry::insert_text (GtkEntry *ENTRY, gchar *TEXT,
          gint LENGTH, gint *POSITION)

 - Signal: void GtkEntry::delete_text (GtkEntry *ENTRY, gint START_POS,
          gint END_POS)

 - Signal: void GtkEntry::changed (GtkEntry *ENTRY)

 - Signal: void GtkEntry::set_text (GtkEntry *ENTRY)

 - Signal: void GtkEntry::activate (GtkEntry *ENTRY)

Functions
---------

 - Function: guint gtk_entry_get_type (void)
     Returns the `GtkEntry' type identifier.

 - Function: GtkWidget* gtk_entry_new (void)
     Create a new `GtkEntry' object. The new widget is returned as a
     pointer to a `GtkWidget' object. `NULL' is returned on failure.

 - Function: GtkWidget* gtk_entry_new_with_max_length (guint16 MAX)
     Create a new `GtkEntry' object initializing it with the value MAX.
     The new widget is returned as a pointer to a `GtkWidget' object.
     `NULL' is returned on failure.

 - Function: void gtk_entry_set_text (GtkEntry *ENTRY, gchar *TEXT)
     Will set the text in the previously created `GtkEntry' object to
     TEXT. It is important to not set the fields of the `GtkEntry'
     structure directly (or, for that matter, any type derived from
     `GtkObject').

 - Function: void gtk_entry_append_text (GtkEntry *ENTRY, gchar *TEXT)
     Append the text that is in the TEXT argument to the widgets text.
     It is important to not set the fields of the `GtkEntry' structure
     directly.

 - Function: void gtk_entry_prepend_text (GtkEntry *ENTRY, gchar *TEXT)
     Add the text in the TEXT argument to the text in the `GtkEntry'
     widget. It is important to not set the fields of the `GtkEntry'
     structure directly.

 - Function: void gtk_entry_set_position (GtkEntry *ENTRY, gint
          POSITION)

 - Function: void gtk_entry_set_visibility (GtkEntry *ENTRY, gint
          VISIBLE)
     Will make the keystrokes entered into the `GtkEntry' object
     invisible when VISIBLE is `TRUE'. Defaults to `FALSE'.

 - Function: gchar* gtk_entry_get_text (GtkEntry *ENTRY)
     Returns the text that is contained in the `GtkEntry' as a pointer
     to a `gchar' variable.

 - Function: GtkEntry* GTK_ENTRY (gpointer OBJ)
     Cast a generic pointer to `GtkEntry*'. Note: Standard Macros, for
     more info.

 - Function: GtkEntryClass* GTK_ENTRY_CLASS (gpointer CLASS)
     Cast a generic pointer to `GtkEntryClass*'. Note: Standard
     Macros, for more info.

 - Function: gint GTK_IS_ENTRY (gpointer OBJ)
     Determine if a generic pointer refers to a `GtkEntry' object.
     Note: Standard Macros, for more info.