[Contents] [Back] [Prev] [Up] [Next] [Forward]

# Package Gtk.GEntry

A Gtk_Entry is a single line text editing widget. The text is automatically scrolled if it is longer than can be displayed on the screen, so that the cursor position is visible at all times.

See also Gtk_Text for a multiple-line text editing widget.

Note that this widget does not currently support wide-character, or character sets that require multiple-byte encoding.

- Gtk.GEntry Widget Hierarchy
- Gtk.GEntry Subprograms

## Widget Hierarchy

    Gtk_Object                    (see section Package Gtk.Object)
       \___ Gtk_Widget            (see section Package Gtk.Widget)
          \___ Gtk_Editable       (see section Package Gtk.Editable)
             \___ Gtk_Entry       (see section Package Gtk.GEntry)

## Subprograms

    procedure Gtk_New
      (Widget             : out    Gtk_Entry;
       Max                : in     Guint16);

| Create a new entry with a maximum length for the text. The text can never be longer than Max characters.

    procedure Gtk_New
      (Widget             : out    Gtk_Entry);

| Create a new entry with no maximum length for the text

    function Get_Type              return Gtk.Gtk_Type;

| Return the internal value associated with a Gtk_Entry.

    procedure Set_Text
      (The_Entry          : access Gtk_Entry_Record;
       Text               : in     String);

| Modify the text in the entry. The text is cut at the maximum length that was set when the entry was created. The text replaces the current contents.

    procedure Append_Text
      (The_Entry          : access Gtk_Entry_Record;
       Text               : in     String);

| Append a new string at the end of the existing one.

    procedure Prepend_Text
      (The_Entry          : access Gtk_Entry_Record;
       Text               : in     String);

| Insert some text at the beginning of the entry.

    procedure Set_Visibility
      (The_Entry          : access Gtk_Entry_Record;
       Visible            : in     Boolean);

| Set the visibility of the characters in the entry. If Visible is set to False, the characters will be replaced with starts ('*') in the display, and when the text is copied elsewhere.

    procedure Set_Max_Length
      (The_Entry          : access Gtk_Entry_Record;
       Max                : in     Guint16);

| Set the maximum length for the text. The current text is truncated if needed.

[Contents] [Back] [Prev] [Up] [Next] [Forward]