GtkEntryCompletion

GtkEntryCompletionMatchFunc ()

gboolean
(*GtkEntryCompletionMatchFunc) (GtkEntryCompletion *completion,
                                const gchar *key,
                                GtkTreeIter *iter,
                                gpointer user_data);

Функция, определяющая, соответствует ли строка, указанная в iter, заданному key и должна ли она отображаться в качестве возможного дополнения для key. Обратите внимание, что key нормализована и приведена к нижнему регистру (см. g_utf8_normalize() и g_utf8_casefold()). Если это не подходит, функции сопоставления имеют доступ к исходному ключу через gtk_entry_get_text (GTK_ENTRY (gtk_entry_completion_get_entry())).

gtk_entry_completion_new ()

GtkEntryCompletion *
gtk_entry_completion_new (void);

Создаёт новый объект GtkEntryCompletion.

С: 2.4

gtk_entry_completion_new_with_area ()

GtkEntryCompletion *
gtk_entry_completion_new_with_area (GtkCellArea *area);

Создаёт новый объект GtkEntryCompletion, используя указанный area для выравнивания ячеек во внутреннем GtkTreeViewColumn раскрывающегося меню.

С: 3.0

gtk_entry_completion_get_entry ()

GtkWidget *
gtk_entry_completion_get_entry (GtkEntryCompletion *completion);

Возвращает поле, к которому прикреплён completion.

С: 2.4

gtk_entry_completion_set_model ()

void
gtk_entry_completion_set_model (GtkEntryCompletion *completion,
                                GtkTreeModel *model);

Устанавливает модель для GtkEntryCompletion. Если у completion уже есть модель, она будет удалена перед установкой новой. Если model имеет значение NULL, то модель будет удалена.

С: 2.4

gtk_entry_completion_get_model ()

GtkTreeModel *
gtk_entry_completion_get_model (GtkEntryCompletion *completion);

Возвращает модель, используемую объектом GtkEntryCompletion в качестве источника данных. Возвращает NULL, если модель не задана.

С: 2.4

gtk_entry_completion_set_match_func ()

void
gtk_entry_completion_set_match_func (GtkEntryCompletion *completion,
                                     GtkEntryCompletionMatchFunc func,
                                     gpointer func_data,
                                     GDestroyNotify func_notify);

Устанавливает функцию сопоставления для completion в func. Функция сопоставления используется для определения, должна ли строка быть включена в список дополнений.

С: 2.4

gtk_entry_completion_set_minimum_key_length ()

void
gtk_entry_completion_set_minimum_key_length
                               (GtkEntryCompletion *completion,
                                gint length);

Требует, чтобы длина ключа поиска для completion была не меньше length. Это полезно для длинных списков, где завершение по короткому ключу занимает много времени и в любом случае приведёт к бессмысленным результатам (т.е., слишком большая база данных).

С: 2.4

gtk_entry_completion_get_minimum_key_length ()

gint
gtk_entry_completion_get_minimum_key_length
                               (GtkEntryCompletion *completion);

Возвращает минимальную длину ключа, установленную для completion.

С: 2.4

gtk_entry_completion_compute_prefix ()

gchar *
gtk_entry_completion_compute_prefix (GtkEntryCompletion *completion,
                                     const char *key);

Вычисляет общее префиксное совпадение, которое разделяют все строки в completion, начинающиеся с key. Если ни одна строка не соответствует key, возвращается NULL. Обратите внимание, что для работы этой функции должна быть установлена колонка текста; см. gtk_entry_completion_set_text_column() для получения подробностей.

С момента: 3.4

gtk_entry_completion_complete ()

void
gtk_entry_completion_complete (GtkEntryCompletion *completion);

Запрашивает операцию завершения, или, другими словами, повторное фильтрование текущего списка с помощью текущего ключа. Список завершений будет обновлен соответствующим образом.

С момента: 2.4

gtk_entry_completion_get_completion_prefix ()

const gchar *
gtk_entry_completion_get_completion_prefix
                               (GtkEntryCompletion *completion);

Получить исходный текст, введённый пользователем, который инициировал завершение, или NULL, если процесс завершения не происходит.

С момента: 2.12

gtk_entry_completion_insert_prefix ()

void
gtk_entry_completion_insert_prefix (GtkEntryCompletion *completion);

Запрашивает вставку префикса.

С момента: 2.6

gtk_entry_completion_insert_action_text ()

void
gtk_entry_completion_insert_action_text
                               (GtkEntryCompletion *completion,
                                gint index_,
                                const gchar *text);

Вставляет действие в список элементов действий completion в позиции index_ с текстом text. Если вы хотите, чтобы элемент действия имел разметку, используйте gtk_entry_completion_insert_action_markup().

Обратите внимание, что index_ — это относительная позиция в списке действий, и позиция действия может измениться при удалении другого действия.

С момента: 2.4

gtk_entry_completion_insert_action_markup ()

void
gtk_entry_completion_insert_action_markup
                               (GtkEntryCompletion *completion,
                                gint index_,
                                const gchar *markup);

Вставляет действие в список элементов действий completion в позиции index_ с разметкой markup.

С момента: 2.4

gtk_entry_completion_delete_action ()

void
gtk_entry_completion_delete_action (GtkEntryCompletion *completion,
                                    gint index_);

Удаляет действие в позиции index_ из списка действий completion.

Обратите внимание, что index_ — это относительная позиция, а позиция действия может измениться с момента её вставки.

С момента: 2.4

gtk_entry_completion_set_text_column ()

void
gtk_entry_completion_set_text_column (GtkEntryCompletion *completion,
                                      gint column);

Функция-помощник для настройки наиболее часто используемого случая: списка завершений только с текстовыми строками. Эта функция настроит completion для отображения списка (и только) всех строк в списке завершений и получения этих строк из column в модели completion.

Эта функция создаёт и добавляет GtkCellRendererText для выбранной колонки. Если вам нужно установить колонку текста, но вы не хотите использовать компонент отображения ячейки, используйте g_object_set() для прямого задания свойства “text-column”.

С момента: 2.4

gtk_entry_completion_get_text_column ()

gint
gtk_entry_completion_get_text_column (GtkEntryCompletion *completion);

Возвращает колонку в модели completion для получения строк.

С момента: 2.6

gtk_entry_completion_set_inline_completion ()

void
gtk_entry_completion_set_inline_completion
                               (GtkEntryCompletion *completion,
                                gboolean inline_completion);

Устанавливает, нужно ли автоматически вставлять общее префиксное совпадение возможных завершений в поле ввода.

С момента: 2.6

gtk_entry_completion_get_inline_completion ()

gboolean
gtk_entry_completion_get_inline_completion
                               (GtkEntryCompletion *completion);

Возвращает, следует ли автоматически вставлять общее префиксное совпадение возможных дополнений в поле ввода.

С: 2.6

gtk_entry_completion_set_inline_selection ()

void
gtk_entry_completion_set_inline_selection
                               (GtkEntryCompletion *completion,
                                gboolean inline_selection);

Устанавливает возможность циклического перебора возможных дополнений внутри поля ввода.

С: 2.12

gtk_entry_completion_get_inline_selection ()

gboolean
gtk_entry_completion_get_inline_selection
                               (GtkEntryCompletion *completion);

Возвращает TRUE, если режим вставки дополнений включён.

С: 2.12

gtk_entry_completion_set_popup_completion ()

void
gtk_entry_completion_set_popup_completion
                               (GtkEntryCompletion *completion,
                                gboolean popup_completion);

Устанавливает, будут ли дополнения отображаться в всплывающем окне.

С: 2.6

gtk_entry_completion_get_popup_completion ()

gboolean
gtk_entry_completion_get_popup_completion
                               (GtkEntryCompletion *completion);

Возвращает, будут ли дополнения отображаться в всплывающем окне.

С: 2.6

gtk_entry_completion_set_popup_set_width ()

void
gtk_entry_completion_set_popup_set_width
                               (GtkEntryCompletion *completion,
                                gboolean popup_set_width);

Устанавливает, будет ли ширина всплывающего окна для дополнений соответствовать ширине поля ввода.

С: 2.8

gtk_entry_completion_get_popup_set_width ()

gboolean
gtk_entry_completion_get_popup_set_width
                               (GtkEntryCompletion *completion);

Возвращает, будет ли ширина всплывающего окна для дополнений соответствовать ширине поля ввода.

С: 2.8

gtk_entry_completion_set_popup_single_match ()

void
gtk_entry_completion_set_popup_single_match
                               (GtkEntryCompletion *completion,
                                gboolean popup_single_match);

Устанавливает, будет ли всплывающее окно для дополнений отображаться, даже если существует только одно совпадение. Возможно, стоит установить это значение в FALSE, если вы используете встроенное дополнение.

С: 2.8

gtk_entry_completion_get_popup_single_match ()

gboolean
gtk_entry_completion_get_popup_single_match
                               (GtkEntryCompletion *completion);

Возвращает, будет ли всплывающее окно для дополнений отображаться, даже если существует только одно совпадение.

С: 2.8