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