GtkEntryCompletion

GtkEntryCompletionMatchFunc ()

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

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

gtk_entry_completion_new ()

GtkEntryCompletion *
gtk_entry_completion_new (void);

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

gtk_entry_completion_new_with_area ()

GtkEntryCompletion *
gtk_entry_completion_new_with_area (GtkCellArea *area);

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

gtk_entry_completion_get_entry ()

GtkWidget *
gtk_entry_completion_get_entry (GtkEntryCompletion *completion);

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

gtk_entry_completion_set_model ()

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

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

gtk_entry_completion_get_model ()

GtkTreeModel *
gtk_entry_completion_get_model (GtkEntryCompletion *completion);

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

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. Функция сопоставления используется для определения, должна ли строка быть в списке дополнений.

gtk_entry_completion_set_minimum_key_length ()

void
gtk_entry_completion_set_minimum_key_length
                               (GtkEntryCompletion *completion,
                                int length);

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

gtk_entry_completion_get_minimum_key_length ()

int
gtk_entry_completion_get_minimum_key_length
                               (GtkEntryCompletion *completion);

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

gtk_entry_completion_compute_prefix ()

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

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

gtk_entry_completion_complete ()

void
gtk_entry_completion_complete (GtkEntryCompletion *completion);

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

gtk_entry_completion_get_completion_prefix ()

const char *
gtk_entry_completion_get_completion_prefix
                               (GtkEntryCompletion *completion);

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

gtk_entry_completion_insert_prefix ()

void
gtk_entry_completion_insert_prefix (GtkEntryCompletion *completion);

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

gtk_entry_completion_set_text_column ()

void
gtk_entry_completion_set_text_column (GtkEntryCompletion *completion,
                                      int column);

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

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

gtk_entry_completion_get_text_column ()

int
gtk_entry_completion_get_text_column (GtkEntryCompletion *completion);

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

gtk_entry_completion_set_inline_completion ()

void
gtk_entry_completion_set_inline_completion
                               (GtkEntryCompletion *completion,
                                gboolean inline_completion);

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

gtk_entry_completion_get_inline_completion ()

gboolean
gtk_entry_completion_get_inline_completion
                               (GtkEntryCompletion *completion);

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

gtk_entry_completion_set_inline_selection ()

void
gtk_entry_completion_set_inline_selection
                               (GtkEntryCompletion *completion,
                                gboolean inline_selection);

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

gtk_entry_completion_get_inline_selection ()

gboolean
gtk_entry_completion_get_inline_selection
                               (GtkEntryCompletion *completion);

Возвращает TRUE если режим встроенного выбора включен.

gtk_entry_completion_set_popup_completion ()

void
gtk_entry_completion_set_popup_completion
                               (GtkEntryCompletion *completion,
                                gboolean popup_completion);

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

gtk_entry_completion_get_popup_completion ()

gboolean
gtk_entry_completion_get_popup_completion
                               (GtkEntryCompletion *completion);

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

gtk_entry_completion_set_popup_set_width ()

void
gtk_entry_completion_set_popup_set_width
                               (GtkEntryCompletion *completion,
                                gboolean popup_set_width);

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

gtk_entry_completion_get_popup_set_width ()

gboolean
gtk_entry_completion_get_popup_set_width
                               (GtkEntryCompletion *completion);

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

gtk_entry_completion_set_popup_single_match ()

void
gtk_entry_completion_set_popup_single_match
                               (GtkEntryCompletion *completion,
                                gboolean popup_single_match);

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

gtk_entry_completion_get_popup_single_match ()

gboolean
gtk_entry_completion_get_popup_single_match
                               (GtkEntryCompletion *completion);

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