Description
This widget provides completion functionality for Gtk.Gentry.Gtk_Entry.
"Completion functionality" means that when the user modifies the text in
the entry, GtkEntryCompletion checks which rows in the model match the
current content of the entry, and displays a list of matches. By default,
the matching is done by comparing the entry text case-insensitively against
the text column of the model (see Set_Text_Column), but this can be
overridden with a custom match function (see Set_Match_Func).
When the user selects a completion, the content of the entry is updated. By
default, the content of the entry is replaced by the text column of the
model, but this can be overridden by connecting to the ::match-selected
signal and updating the entry in the signal handler. Note that you should
return TRUE from the signal handler to suppress the default behaviour.
To add completion functionality to an entry, use Gtk.Entry.Set_Completion.
In addition to regular completion matches, which will be inserted into the
entry when they are selected, GtkEntryCompletion also allows to display
"actions" in the popup window. Their appearance is similar to menuitems, to
differentiate them clearly from completion strings. When an action is
selected, the ::action-activated signal is emitted.
Subprograms
-
procedure Gtk_New (Completion : out Gtk_Entry_Completion);
procedure Initialize
(Completion : access Gtk_Entry_Completion_Record'Class);
-
-
procedure Complete
(Completion : access Gtk_Entry_Completion_Record);
-
procedure Delete_Action
(Completion : access Gtk_Entry_Completion_Record;
Index : Gint);
-
-
procedure Set_Inline_Completion
(Completion : access Gtk_Entry_Completion_Record;
Inline_Completion : Boolean);
function Get_Inline_Completion
(Completion : access Gtk_Entry_Completion_Record)
return Boolean;
-
procedure Set_Minimum_Key_Length
(Completion : access Gtk_Entry_Completion_Record;
Length : Gint);
function Get_Minimum_Key_Length
(Completion : access Gtk_Entry_Completion_Record) return Gint;
-
-
procedure Set_Popup_Completion
(Completion : access Gtk_Entry_Completion_Record;
Popup_Completion : Boolean);
function Get_Popup_Completion
(Completion : access Gtk_Entry_Completion_Record)
return Boolean;
-
procedure Set_Popup_Set_Width
(Completion : access Gtk_Entry_Completion_Record;
Popup_Set_Width : Boolean);
function Get_Popup_Set_Width
(Completion : access Gtk_Entry_Completion_Record)
return Boolean;
-
procedure Set_Popup_Single_Match
(Completion : access Gtk_Entry_Completion_Record;
Popup_Single_Match : Boolean);
function Get_Popup_Single_Match
(Completion : access Gtk_Entry_Completion_Record)
return Boolean;
-
procedure Set_Text_Column
(Completion : access Gtk_Entry_Completion_Record;
Column : Gint);
function Get_Text_Column
(Completion : access Gtk_Entry_Completion_Record) return Gint;
-
procedure Insert_Action_Markup
(Completion : access Gtk_Entry_Completion_Record;
Index : Gint;
Markup : String);
-
procedure Insert_Action_Text
(Completion : access Gtk_Entry_Completion_Record;
Index : Gint;
Text : String);
-
procedure Insert_Prefix (Completion : access Gtk_Entry_Completion_Record);
-
procedure Set_Match_Func
(Completion : access Gtk_Entry_Completion_Record;
Func : Gtk_Entry_Completion_Match_Func;
Func_Data : Data_Type;
Func_Notify : Destroy_Notify);