Function

Gtk.EntryCompletionMatchFunc

Declaration

gboolean
EntryCompletionMatchFunc (
  GtkEntryCompletion* completion,
  const char* key,
  GtkTreeIter* iter,
  gpointer user_data
)

Description [src]

A function which decides whether the row indicated by iter matches a given key, and should be displayed as a possible completion for key.

Note that key is normalized and case-folded (see g_utf8_normalize() and g_utf8_casefold()). If this is not appropriate, match functions have access to the unmodified key via gtk_editable_get_text (GTK_EDITABLE (gtk_entry_completion_get_entry ())).

Parameters

completion GtkEntryCompletion
 

the GtkEntryCompletion

 Ownership is not transferred to the callee
key const char*
 

the string to match, normalized and case-folded

 Ownership is not transferred to the callee
 The string is a NUL terminated UTF-8 string
iter GtkTreeIter
 

a GtkTreeIter indicating the row to match

 Ownership is not transferred to the callee
user_data gpointer
 

user data given to gtk_entry_completion_set_match_func()

Return value

Returns: gboolean

TRUE if iter should be displayed as a possible completion for key