GtkIMContext

gtk_im_context_set_client_window ()

void
gtk_im_context_set_client_window (GtkIMContext *context,
                                  GdkWindow *window);

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

gtk_im_context_get_preedit_string ()

void
gtk_im_context_get_preedit_string (GtkIMContext *context,
                                   gchar **str,
                                   PangoAttrList **attrs,
                                   gint *cursor_pos);

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

gtk_im_context_filter_keypress ()

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

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

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_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 ложно (по умолчанию истинно), то контекст метода ввода может использовать другой метод отображения обратной связи, например, отображая его в дочернем окне корневого окна.

gtk_im_context_set_surrounding ()

void
gtk_im_context_set_surrounding (GtkIMContext *context,
                                const gchar *text,
                                gint len,
                                gint cursor_index);

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

gtk_im_context_get_surrounding ()

gboolean
gtk_im_context_get_surrounding (GtkIMContext *context,
                                gchar **text,
                                gint *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,
                                   gint offset,
                                   gint n_chars);

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

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

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

Структура GtkIMContext

struct GtkIMContext;

Структура GtkIMContextClass

struct GtkIMContextClass {
  /* Signals */
  void     (*preedit_start)        (GtkIMContext *context);
  void     (*preedit_end)          (GtkIMContext *context);
  void     (*preedit_changed)      (GtkIMContext *context);
  void     (*commit)               (GtkIMContext *context, const gchar *str);
  gboolean (*retrieve_surrounding) (GtkIMContext *context);
  gboolean (*delete_surrounding)   (GtkIMContext *context,
				    gint          offset,
				    gint          n_chars);

  /* Virtual functions */
  void     (*set_client_window)   (GtkIMContext   *context,
				   GdkWindow      *window);
  void     (*get_preedit_string)  (GtkIMContext   *context,
				   gchar         **str,
				   PangoAttrList **attrs,
				   gint           *cursor_pos);
  gboolean (*filter_keypress)     (GtkIMContext   *context,
			           GdkEventKey    *event);
  void     (*focus_in)            (GtkIMContext   *context);
  void     (*focus_out)           (GtkIMContext   *context);
  void     (*reset)               (GtkIMContext   *context);
  void     (*set_cursor_location) (GtkIMContext   *context,
				   GdkRectangle   *area);
  void     (*set_use_preedit)     (GtkIMContext   *context,
				   gboolean        use_preedit);
  void     (*set_surrounding)     (GtkIMContext   *context,
				   const gchar    *text,
				   gint            len,
				   gint            cursor_index);
  gboolean (*get_surrounding)     (GtkIMContext   *context,
				   gchar         **text,
				   gint           *cursor_index);
};

struct GtkIMContextInfo

struct GtkIMContextInfo {
  const gchar *context_id;
  const gchar *context_name;
  const gchar *domain;
  const gchar *domain_dirname;
  const gchar *default_locales;
};

Справочная информация о загружаемом методе ввода.