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