GtkIMContext

gtk_im_context_get_preedit_string ()

void
gtk_im_context_get_preedit_string (GtkIMContext *context,
                                   char **str,
                                   PangoAttrList **attrs,
                                   int *cursor_pos);

Получить текущую строку предварительного редактирования для контекста ввода и список атрибутов для применения к строке. Эта строка должна быть отображена вставленной в точку вставки.

gtk_im_context_filter_keypress ()

gboolean
gtk_im_context_filter_keypress (GtkIMContext *context,
                                GdkEvent *event);

Разрешить методу ввода внутренне обрабатывать события нажатия и отпускания клавиш. Если эта функция возвращает TRUE, дальнейшая обработка этого события нажатия клавиши не должна производиться.

gtk_im_context_filter_key ()

gboolean
gtk_im_context_filter_key (GtkIMContext *context,
                           gboolean press,
                           GdkSurface *surface,
                           GdkDevice *device,
                           guint32 time,
                           guint keycode,
                           GdkModifierType state,
                           int group);

Разрешить методу ввода пересылать события нажатия и отпускания клавиш другому методу ввода, не обязательно имея доступ к GdkEvent.

gtk_im_context_focus_in ()

void
gtk_im_context_focus_in (GtkIMContext *context);

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

gtk_im_context_focus_out ()

void
gtk_im_context_focus_out (GtkIMContext *context);

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

gtk_im_context_reset ()

void
gtk_im_context_reset (GtkIMContext *context);

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

gtk_im_context_set_client_widget ()

void
gtk_im_context_set_client_widget (GtkIMContext *context,
                                  GtkWidget *widget);

Установить клиентское окно для контекста ввода; это GtkWidget, удерживающий фокус ввода. Этот виджет используется для правильного позиционирования окон состояния и может также использоваться для целей, внутренних для метода ввода.

gtk_im_context_set_cursor_location ()

void
gtk_im_context_set_cursor_location (GtkIMContext *context,
                                    const GdkRectangle *area);

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

gtk_im_context_set_use_preedit ()

void
gtk_im_context_set_use_preedit (GtkIMContext *context,
                                gboolean use_preedit);

Устанавливает, должен ли контекст метода ввода использовать строку предварительного редактирования для отображения обратной связи. Если use_preedit имеет значение FALSE (по умолчанию TRUE), контекст метода ввода может использовать другой способ отображения обратной связи, например, отображая её в дочернем элементе корневого окна.

gtk_im_context_set_surrounding ()

void
gtk_im_context_set_surrounding (GtkIMContext *context,
                                const char *text,
                                int len,
                                int cursor_index);

Устанавливает контекст, окружающий точку вставки и строку предварительного редактирования. Ожидается, что эта функция будет вызвана в ответ на сигнал GtkIMContext::retrieve_surrounding, и, вероятно, не будет иметь эффекта, если вызвана в другое время.

gtk_im_context_get_surrounding ()

gboolean
gtk_im_context_get_surrounding (GtkIMContext *context,
                                char **text,
                                int *cursor_index);

Получает контекст вокруг точки вставки. Методы ввода обычно нуждаются в контексте, чтобы ограничить ввод текста на основе уже существующего текста; это важно для языков, таких как тайский, где допускаются только некоторые последовательности символов.

Эта функция реализуется путём отправки сигнала GtkIMContext::retrieve_surrounding методу ввода; в ответ на этот сигнал виджет должен предоставить как можно больше контекста, до целого абзаца, вызвав gtk_im_context_set_surrounding(). Обратите внимание, что виджет не обязан реагировать на сигнал ::retrieve_surrounding, поэтому методы ввода должны быть готовы функционировать без контекста.

gtk_im_context_delete_surrounding ()

gboolean
gtk_im_context_delete_surrounding (GtkIMContext *context,
                                   int offset,
                                   int n_chars);

Запрашивает у виджета, к которому прикреплён контекст ввода, удалить символы вокруг позиции курсора, отправив сигнал GtkIMContext::delete_surrounding. Обратите внимание, что offset и n_chars указаны в символах, а не байтах, что отличается от использования в других местах в GtkIMContext.

Для использования этой функции сначала необходимо вызвать gtk_im_context_get_surrounding() для получения текущего контекста и сразу после этого вызвать эту функцию, чтобы убедиться, что известно, что удаляется. Также необходимо учитывать, что даже если сигнал был обработан, контекст ввода может не удалить все запрошенные символы.

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