gtkEntryCompletionNew()
gtkEntryCompletionGetEntry(object)
gtkEntryCompletionSetModel(object, model = NULL)
gtkEntryCompletionGetModel(object)
gtkEntryCompletionSetMatchFunc(object, func, func.data = NULL)
gtkEntryCompletionSetMinimumKeyLength(object, length)
gtkEntryCompletionGetMinimumKeyLength(object)
gtkEntryCompletionComplete(object)
gtkEntryCompletionGetCompletionPrefix(object)
gtkEntryCompletionInsertPrefix(object)
gtkEntryCompletionInsertActionText(object, index, text)
gtkEntryCompletionInsertActionMarkup(object, index, markup)
gtkEntryCompletionDeleteAction(object, index)
gtkEntryCompletionSetTextColumn(object, column)
gtkEntryCompletionGetTextColumn(object)
gtkEntryCompletionSetInlineCompletion(object, inline.completion)
gtkEntryCompletionGetInlineCompletion(object)
gtkEntryCompletionSetInlineSelection(object, inline.selection)
gtkEntryCompletionGetInlineSelection(object)
gtkEntryCompletionSetPopupCompletion(object, popup.completion)
gtkEntryCompletionGetPopupCompletion(object)
gtkEntryCompletionSetPopupSetWidth(object, popup.set.width)
gtkEntryCompletionGetPopupSetWidth(object)
gtkEntryCompletionSetPopupSingleMatch(object, popup.single.match)
gtkEntryCompletionGetPopupSingleMatch(object)
gtkEntryCompletion()
GObject +----GtkEntryCompletion
GtkCellLayout
and GtkBuildable
.GtkEntryCompletion
is an auxiliary object to be used in conjunction with
GtkEntry
to provide the completion functionality. It implements the
GtkCellLayout
interface, to allow the user to add extra cells to the
GtkTreeView
with completion matches. "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
gtkEntryCompletionSetTextColumn
), but this can be overridden with
a custom match function (see gtkEntryCompletionSetMatchFunc
). 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 gtkEntrySetCompletion
. 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.gtkEntryCompletion
is the equivalent of gtkEntryCompletionNew
.action-activated(widget, index, user.data)
widget
index
user.data
cursor-on-match(widget, model, iter, user.data)
iter
.
Since 2.12 widget
model
GtkTreeModel
containing the matchesiter
GtkTreeIter
positioned at the selected matchuser.data
TRUE
if the signal has been handled insert-prefix(widget, prefix, user.data)
prefix
into the entry - e.g. the entry used in
the GtkFileChooser
inserts only the part of the prefix up to the
next '/'.
Since 2.6 widget
prefix
user.data
TRUE
if the signal has been handled match-selected(widget, model, iter, user.data)
iter
.
Since 2.4 widget
model
GtkTreeModel
containing the matchesiter
GtkTreeIter
positioned at the selected matchuser.data
TRUE
if the signal has been handled inline-completion
[logical : Read / Write]inline-selection
[logical : Read / Write]minimum-key-length
[integer : Read / Write]model
[GtkTreeModel
: * : Read / Write]popup-completion
[logical : Read / Write]popup-set-width
[logical : Read / Write]popup-single-match
[logical : Read / Write]FALSE
if you are using
inline
completion.
Default value: TRUE Since 2.8 text-column
[integer : Read / Write]