GtkEntry

gtk_entry_new ()

GtkWidget *
gtk_entry_new (void);

Создаёт новое поле ввода.

gtk_entry_new_with_buffer ()

GtkWidget *
gtk_entry_new_with_buffer (GtkEntryBuffer *buffer);

Создаёт новое поле ввода с указанным буфером текста.

С версии: 2.18

gtk_entry_get_buffer ()

GtkEntryBuffer *
gtk_entry_get_buffer (GtkEntry *entry);

Получает объект GtkEntryBuffer, который содержит текст для данного виджета.

С версии: 2.18

gtk_entry_set_buffer ()

void
gtk_entry_set_buffer (GtkEntry *entry,
                      GtkEntryBuffer *buffer);

Устанавливает объект GtkEntryBuffer, который будет содержать текст для данного виджета.

С версии: 2.18

gtk_entry_set_text ()

void
gtk_entry_set_text (GtkEntry *entry,
                    const gchar *text);

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

См. gtk_entry_buffer_set_text().

gtk_entry_get_text ()

const gchar *
gtk_entry_get_text (GtkEntry *entry);

Извлекает содержимое виджета поля ввода. См. также gtk_editable_get_chars().

Эквивалентно получению entry 's GtkEntryBuffer и вызову gtk_entry_buffer_get_text() для него.

gtk_entry_get_text_length ()

guint16
gtk_entry_get_text_length (GtkEntry *entry);

Возвращает текущую длину текста в entry .

Эквивалентно получению entry 's GtkEntryBuffer и вызову gtk_entry_buffer_get_length() для него.

С версии: 2.14

gtk_entry_get_text_area ()

void
gtk_entry_get_text_area (GtkEntry *entry,
                         GdkRectangle *text_area);

Получает область, где отображается текст поля ввода. Эта функция полезна, когда нужно что-то нарисовать в поле ввода в обработчике рисования.

Если поле ввода не реализовано, text_area заполняется нулями.

См. также gtk_entry_get_icon_area().

С версии: 3.0

gtk_entry_set_visibility ()

void
gtk_entry_set_visibility (GtkEntry *entry,
                          gboolean visible);

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

По умолчанию GTK+ выбирает лучший невидимый символ, доступный в текущем шрифте, но он может быть изменён с помощью gtk_entry_set_invisible_char().

Обратите внимание, что, скорее всего, необходимо установить “input-purpose” на GTK_INPUT_PURPOSE_PASSWORD или GTK_INPUT_PURPOSE_PIN, чтобы проинформировать методы ввода о назначении этого поля ввода, помимо установки видимости в FALSE.

gtk_entry_set_invisible_char ()

void
gtk_entry_set_invisible_char (GtkEntry *entry,
                              gunichar ch);

Устанавливает символ, используемый вместо фактического текста, когда gtk_entry_set_visibility() был вызван для установки видимости текста в FALSE. То есть, это символ, используемый в режиме «пароль», чтобы показать пользователю, сколько символов было введено. По умолчанию GTK+ выбирает лучший невидимый символ, доступный в текущем шрифте. Если вы установите невидимый символ в 0, то пользователю вообще не будет дано обратной связи; никакого текста на экране не будет отображаться во время ввода.

gtk_entry_unset_invisible_char ()

void
gtk_entry_unset_invisible_char (GtkEntry *entry);

Сбрасывает невидимый символ, установленный ранее с помощью gtk_entry_set_invisible_char(). Таким образом, будет снова использован символ невидимости по умолчанию.

С версии: 2.16

gtk_entry_set_max_length ()

void
gtk_entry_set_max_length (GtkEntry *entry,
                          gint max);

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

Это эквивалентно получению entry 's GtkEntryBuffer и вызову gtk_entry_buffer_set_max_length() на нём. ]|

gtk_entry_get_activates_default ()

gboolean
gtk_entry_get_activates_default (GtkEntry *entry);

Возвращает значение, установленное функцией gtk_entry_set_activates_default().

gtk_entry_get_has_frame ()

gboolean
gtk_entry_get_has_frame (GtkEntry *entry);

Возвращает значение, установленное функцией gtk_entry_set_has_frame().

gtk_entry_get_inner_border ()

const GtkBorder *
gtk_entry_get_inner_border (GtkEntry *entry);

Эта функция возвращает свойство “inner-border” поля ввода. Подробнее см. gtk_entry_set_inner_border().

Since: 2.10

gtk_entry_get_width_chars ()

gint
gtk_entry_get_width_chars (GtkEntry *entry);

Возвращает значение, установленное функцией gtk_entry_set_width_chars().

gtk_entry_get_max_width_chars ()

gint
gtk_entry_get_max_width_chars (GtkEntry *entry);

Возвращает желаемую максимальную ширину entry в символах. См. gtk_entry_set_max_width_chars().

Since: 3.12

gtk_entry_set_activates-default ()

void
gtk_entry_set_activates_default (GtkEntry *entry,
                                 gboolean setting);

Если setting равно TRUE, нажатие клавиши Enter в entry активирует виджет по умолчанию для окна, содержащего поле ввода. Обычно это означает закрытие диалогового окна, содержащего поле ввода, так как виджет по умолчанию обычно является одной из кнопок диалогового окна.

(Для специалистов: если setting равно TRUE, поле ввода вызывает gtk_window_activate_default() для содержащего его окна в обработчике по умолчанию сигнала “activate”.)

gtk_entry_set_has-frame ()

void
gtk_entry_set_has_frame (GtkEntry *entry,
                         gboolean setting);

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

gtk_entry_set_inner-border ()

void
gtk_entry_set_inner_border (GtkEntry *entry,
                            const GtkBorder *border);

Устанавливает свойство внутреннего обрамления “inner-border” поля ввода на border или очищает его, если передано NULL. Внутреннее обрамление — это область вокруг текста поля ввода, но внутри его рамки.

Если установлено, это свойство переопределяет свойство внутреннего обрамления стиля. Переопределение стилизованного обрамления полезно, когда требуется выполнение редактирования текста внутри виджета Canvas или List, где точное позиционирование поля ввода имеет значение.

Since: 2.10

gtk_entry_set-width-chars ()

void
gtk_entry_set_width_chars (GtkEntry *entry,
                           gint n_chars);

Изменяет запрос размера поля ввода, чтобы он соответствовал приблизительному размеру для n_chars символов. Обратите внимание, что изменяется запрос размера, но размер всё ещё может зависеть от того, как вы размещаете виджет в контейнерах. Если n_chars равно -1, размер возвращается к размеру по умолчанию для поля ввода.

gtk_entry_set_max_width_chars ()

void
gtk_entry_set_max_width_chars (GtkEntry *entry,
                               gint n_chars);

Устанавливает желаемую максимальную ширину в символах для entry.

С версии: 3.12

gtk_entry_get_invisible_char ()

gunichar
gtk_entry_get_invisible_char (GtkEntry *entry);

Возвращает символ, отображаемый вместо реальных символов для полей ввода с видимостью, установленной в false. См. gtk_entry_set_invisible_char().

gtk_entry_set_alignment ()

void
gtk_entry_set_alignment (GtkEntry *entry,
                         gfloat xalign);

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

С версии: 2.4

gtk_entry_get_alignment ()

gfloat
gtk_entry_get_alignment (GtkEntry *entry);

Получает значение, установленное с помощью gtk_entry_set_alignment().

С версии: 2.4

gtk_entry_set_placeholder_text ()

void
gtk_entry_set_placeholder_text (GtkEntry *entry,
                                const gchar *text);

Устанавливает текст, который будет отображаться в entry, когда оно пустое и не имеет фокуса. Это может использоваться для визуального указания ожидаемого содержимого GtkEntry.

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

С версии: 3.2

gtk_entry_get_placeholder_text ()

const gchar *
gtk_entry_get_placeholder_text (GtkEntry *entry);

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

С версии: 3.2

gtk_entry_set_overwrite_mode ()

void
gtk_entry_set_overwrite_mode (GtkEntry *entry,
                              gboolean overwrite);

Устанавливает, будет ли текст перезаписываться при вводе в GtkEntry.

С версии: 2.14

gtk_entry_get_overwrite_mode ()

gboolean
gtk_entry_get_overwrite_mode (GtkEntry *entry);

Получает значение, установленное с помощью gtk_entry_set_overwrite_mode().

С версии: 2.14

gtk_entry_get_layout ()

PangoLayout *
gtk_entry_get_layout (GtkEntry *entry);

Возвращает PangoLayout, используемый для отображения поля ввода. Разметка полезна, например, для преобразования позиций текста в пиксельные позиции в сочетании с gtk_entry_get_layout_offsets(). Возвращаемая разметка принадлежит полю ввода и не должна быть изменена или освобождена вызывающей стороной.

Помните, что текст разметки может содержать строку предварительного редактирования, поэтому gtk_entry_layout_index_to_text_index() и gtk_entry_text_index_to_layout_index() необходимы для преобразования индексов байтов в разметке в индексы байтов в содержимом поля ввода.

gtk_entry_get_layout_offsets ()

void
gtk_entry_get_layout_offsets (GtkEntry *entry,
                              gint *x,
                              gint *y);

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

Также полезно для преобразования событий мыши в координаты внутри PangoLayout, например, для выполнения действия, если была нажата какая-то часть текста в поле.

Обратите внимание, что при прокрутке пользователем поля ввода смещения изменятся; вам нужно подключиться к сигналу «notify::scroll-offset», чтобы отслеживать это. Помните, что при использовании функций PangoLayout необходимо преобразовывать в пиксели и из пикселей с помощью PANGO_PIXELS() или PANGO_SCALE.

Учитывайте, что текст макета может содержать строку предварительного редактирования, поэтому gtk_entry_layout_index_to_text_index() и gtk_entry_text_index_to_layout_index() необходимы для преобразования индексов байтов в макете в индексы байтов в содержимом поля.

gtk_entry_layout_index_to_text_index ()

gint
gtk_entry_layout_index_to_text_index (GtkEntry *entry,
                                      gint layout_index);

Преобразует позицию в PangoLayout поля ввода (возвращается gtk_entry_get_layout()) в позицию в содержимом поля ввода (возвращается gtk_entry_get_text()).

gtk_entry_text_index-to-layout-index ()

gint
gtk_entry_text_index_to_layout_index (GtkEntry *entry,
                                      gint text_index);

Преобразует позицию в содержимом поля ввода (возвращается gtk_entry_get_text()) в позицию в PangoLayout поля ввода (возвращается gtk_entry_get_layout(), с текстом, полученным с помощью pango_layout_get_text()).

gtk_entry_set_attributes ()

void
gtk_entry_set_attributes (GtkEntry *entry,
                          PangoAttrList *attrs);

Устанавливает PangoAttrList; атрибуты в списке применяются к тексту поля ввода.

С: 3.6

gtk_entry_get_attributes ()

PangoAttrList *
gtk_entry_get_attributes (GtkEntry *entry);

Получает список атрибутов, установленных для поля ввода с помощью gtk_entry_set_attributes(), если таковой был.

С: 3.6

gtk_entry_get_max_length ()

gint
gtk_entry_get_max_length (GtkEntry *entry);

Получает максимальную разрешённую длину текста в entry . См. gtk_entry_set_max_length().

Это эквивалентно получению entry 's GtkEntryBuffer и вызову gtk_entry_buffer_get_max_length() на нём.

gtk_entry_get_visibility ()

gboolean
gtk_entry_get_visibility (GtkEntry *entry);

Получает, отображается ли текст в entry. См. gtk_entry_set_visibility().

gtk_entry_set_completion ()

void
gtk_entry_set_completion (GtkEntry *entry,
                          GtkEntryCompletion *completion);

Устанавливает completion в качестве вспомогательного объекта автодополнения для использования с entry. Вся дальнейшая конфигурация механизма автодополнения выполняется для completion с использованием API GtkEntryCompletion. Автодополнение отключается, если completion установлено в NULL.

Since: 2.4

gtk_entry_get_completion ()

GtkEntryCompletion *
gtk_entry_get_completion (GtkEntry *entry);

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

Since: 2.4

gtk_entry_set_cursor_hadjustment ()

void
gtk_entry_set_cursor_hadjustment (GtkEntry *entry,
                                  GtkAdjustment *adjustment);

Подключает настройку к позиции курсора в поле ввода, так что при перемещении курсора настройка прокручивается, чтобы показать эту позицию. См. gtk_scrolled_window_get_hadjustment() для типичного способа получения настройки.

Настройка должна быть в пиксельных единицах и в той же системе координат, что и поле ввода.

Since: 2.12

gtk_entry_get_cursor_hadjustment ()

GtkAdjustment *
gtk_entry_get_cursor_hadjustment (GtkEntry *entry);

Извлекает горизонтальную настройку курсора для поля ввода. См. gtk_entry_set_cursor_hadjustment().

Since: 2.12

gtk_entry_set_progress_fraction ()

void
gtk_entry_set_progress_fraction (GtkEntry *entry,
                                 gdouble fraction);

Заставляет индикатор выполнения поля ввода «заполнить» заданную долю полосы. Доля должна находиться в диапазоне от 0,0 до 1,0 включительно.

Since: 2.16

gtk_entry_get_progress_fraction ()

gdouble
gtk_entry_get_progress_fraction (GtkEntry *entry);

Возвращает текущую долю выполненной задачи. См. gtk_entry_set_progress_fraction().

Since: 2.16

gtk_entry_set_progress_pulse_step ()

void
gtk_entry_set_progress_pulse_step (GtkEntry *entry,
                                   gdouble fraction);

Устанавливает долю от общей ширины поля ввода для перемещения прыгающего блока выполнения для каждого вызова gtk_entry_progress_pulse().

Since: 2.16

gtk_entry_get_progress_pulse_step ()

gdouble
gtk_entry_get_progress_pulse_step (GtkEntry *entry);

Извлекает шаг импульса, установленный с помощью gtk_entry_set_progress_pulse_step().

Since: 2.16

gtk_entry_progress_pulse ()

void
gtk_entry_progress_pulse (GtkEntry *entry);

Указывает на то, что достигнут некоторый прогресс, но неизвестно, насколько. Заставляет индикатор выполнения поля ввода перейти в «режим активности», где блок перемещается туда и обратно. Каждый вызов gtk_entry_progress_pulse() приводит к перемещению блока на небольшое расстояние (величина перемещения за импульс определяется с помощью gtk_entry_set_progress_pulse_step()).

Since: 2.16

gtk_entry_im_context_filter_keypress ()

gboolean
gtk_entry_im_context_filter_keypress (GtkEntry *entry,
                                      GdkEventKey *event);

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

Обратите внимание, что вы должны вызывать эту функцию из своего обработчика при переопределении обработки событий клавиш. Это необходимо в случае, когда вам нужно вставить свою собственную обработку клавиш между методом ввода и обработкой событий клавиш по умолчанию для GtkEntry. См. gtk_text_view_reset_im_context() для примера использования.

Since: 2.22

gtk_entry_reset_im_context ()

void
gtk_entry_reset_im_context (GtkEntry *entry);

Сбросить контекст ввода метода, если необходимо.

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

С момента: 2.22

gtk_entry_get_tabs ()

PangoTabArray *
gtk_entry_get_tabs (GtkEntry *entry);

Получает отступы табуляции, установленные для поля ввода с помощью gtk_entry_set_tabs(), если таковые есть.

С момента: 3.10

gtk_entry_set_tabs ()

void
gtk_entry_set_tabs (GtkEntry *entry,
                    PangoTabArray *tabs);

Устанавливает PangoTabArray; отступы табуляции в массиве применяются к тексту поля ввода.

С момента: 3.10

gtk_entry_set_icon_from_pixbuf ()

void
gtk_entry_set_icon_from_pixbuf (GtkEntry *entry,
                                GtkEntryIconPosition icon_pos,
                                GdkPixbuf *pixbuf);

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

Если pixbuf равно NULL, значок не будет отображаться в указанной позиции.

С момента: 2.16

gtk_entry_set_icon_from_stock ()

void
gtk_entry_set_icon_from_stock (GtkEntry *entry,
                               GtkEntryIconPosition icon_pos,
                               const gchar *stock_id);

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

Если stock_id равно NULL, значок не будет отображаться в указанной позиции.

С момента: 2.16

gtk_entry_set_icon_from_icon_name ()

void
gtk_entry_set_icon_from_icon_name (GtkEntry *entry,
                                   GtkEntryIconPosition icon_pos,
                                   const gchar *icon_name);

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

Если имя значка неизвестно, вместо него будет показан значок «разбитого изображения».

Если icon_name равно NULL, значок не будет отображаться в указанной позиции.

С момента: 2.16

gtk_entry_set_icon_from_gicon ()

void
gtk_entry_set_icon_from_gicon (GtkEntry *entry,
                               GtkEntryIconPosition icon_pos,
                               GIcon *icon);

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

Если icon равно NULL, значок не будет отображаться в указанной позиции.

С момента: 2.16

gtk_entry_get_icon_storage_type ()

GtkImageType
gtk_entry_get_icon_storage_type (GtkEntry *entry,
                                 GtkEntryIconPosition icon_pos);

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

С момента: 2.16

gtk_entry_get_icon_pixbuf ()

GdkPixbuf *
gtk_entry_get_icon_pixbuf (GtkEntry *entry,
                           GtkEntryIconPosition icon_pos);

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

В отличие от других методов установки и получения данных значка, этот метод будет работать независимо от того, был ли значок установлен с помощью GdkPixbuf, GIcon, стандартного элемента или имени значка.

С момента: 2.16

gtk_entry_get_icon_stock ()

const gchar *
gtk_entry_get_icon_stock (GtkEntry *entry,
                          GtkEntryIconPosition icon_pos);

Возвращает идентификатор используемого значка или NULL, если значок отсутствует или был задан другим способом (например, с помощью pixbuf, имени значка или gicon).

С: 2.16

gtk_entry_get_icon_name ()

const gchar *
gtk_entry_get_icon_name (GtkEntry *entry,
                         GtkEntryIconPosition icon_pos);

Возвращает имя используемого значка или NULL, если значок отсутствует или был задан другим способом (например, с помощью pixbuf, значка stock или gicon).

С: 2.16

gtk_entry_get_icon_gicon ()

GIcon *
gtk_entry_get_icon_gicon (GtkEntry *entry,
                          GtkEntryIconPosition icon_pos);

Возвращает GIcon, используемый для значка, или NULL, если значок отсутствует или был задан другим способом (например, с помощью stock, pixbuf или имени значка).

С: 2.16

gtk_entry_set_icon_activatable ()

void
gtk_entry_set_icon_activatable (GtkEntry *entry,
                                GtkEntryIconPosition icon_pos,
                                gboolean activatable);

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

С: 2.16

gtk_entry_get_icon_activatable ()

gboolean
gtk_entry_get_icon_activatable (GtkEntry *entry,
                                GtkEntryIconPosition icon_pos);

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

С: 2.16

gtk_entry_set_icon_sensitive ()

void
gtk_entry_set_icon_sensitive (GtkEntry *entry,
                              GtkEntryIconPosition icon_pos,
                              gboolean sensitive);

Устанавливает чувствительность указанного значка.

С: 2.16

gtk_entry_get_icon_sensitive ()

gboolean
gtk_entry_get_icon_sensitive (GtkEntry *entry,
                              GtkEntryIconPosition icon_pos);

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

С: 2.16

gtk_entry_get_icon_at_pos ()

gint
gtk_entry_get_icon_at_pos (GtkEntry *entry,
                           gint x,
                           gint y);

Находит значок в заданной позиции и возвращает его индекс. Координаты позиции относительны к верхнему левому углу entry . Если x , y не лежит внутри значка, возвращается -1. Эта функция предназначена для использования в обработчике сигнала “query-tooltip”.

С: 2.16

gtk_entry_set_icon_tooltip_text ()

void
gtk_entry_set_icon_tooltip_text (GtkEntry *entry,
                                 GtkEntryIconPosition icon_pos,
                                 const gchar *tooltip);

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

Используйте NULL для tooltip , чтобы удалить существующую всплывающую подсказку.

См. также gtk_widget_set_tooltip_text() и gtk_entry_set_icon_tooltip_markup().

Если вы сбросите всплывающую подсказку виджета с помощью gtk_widget_set_tooltip_text() или gtk_widget_set_tooltip_markup(), это устанавливает GtkWidget:has-tooltip в FALSE, что подавляет всплывающие подсказки для значков тоже. Вы можете решить эту проблему, вызвав gtk_widget_set_has_tooltip() для установки GtkWidget:has-tooltip обратно в TRUE, или установка хотя бы одной непустой всплывающей подсказки на любой значок достигает того же результата.

С: 2.16

gtk_entry_get_icon_tooltip_text ()

gchar *
gtk_entry_get_icon_tooltip_text (GtkEntry *entry,
                                 GtkEntryIconPosition icon_pos);

Получает содержимое всплывающей подсказки для значка в указанной позиции в entry.

С: 2.16

gtk_entry_set_icon_tooltip_markup ()

void
gtk_entry_set_icon_tooltip_markup (GtkEntry *entry,
                                   GtkEntryIconPosition icon_pos,
                                   const gchar *tooltip);

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

Используйте NULL для tooltip, чтобы удалить существующую всплывающую подсказку.

См. также gtk_widget_set_tooltip_markup() и gtk_entry_set_icon_tooltip_text().

С: 2.16

gtk_entry_get_icon_tooltip_markup ()

gchar *
gtk_entry_get_icon_tooltip_markup (GtkEntry *entry,
                                   GtkEntryIconPosition icon_pos);

Получает содержимое всплывающей подсказки для значка в указанной позиции в entry.

С: 2.16

gtk_entry_set_icon_drag_source ()

void
gtk_entry_set_icon_drag_source (GtkEntry *entry,
                                GtkEntryIconPosition icon_pos,
                                GtkTargetList *target_list,
                                GdkDragAction actions);

Настраивает значок в заданной позиции таким образом, что GTK+ начнёт операцию перетаскивания, когда пользователь нажмёт и перетащит значок.

Для обработки операции перетаскивания необходимо подключиться к обычному сигналу “drag-data-get” (или, возможно, “drag-data-delete”) и использовать gtk_entry_get_current_icon_drag_source() в обработчике сигнала, чтобы определить, началось ли перетаскивание со значка.

По умолчанию GTK+ использует значок в качестве значка перетаскивания. Вы можете использовать сигнал “drag-begin” для установки другого значка. Обратите внимание, что вам необходимо использовать g_signal_connect_after() для обеспечения выполнения обработчика сигнала после обработки по умолчанию.

С: 2.16

gtk_entry_get_current_icon_drag_source ()

gint
gtk_entry_get_current_icon_drag_source
                               (GtkEntry *entry);

Возвращает индекс значка, который является источником текущей операции перетаскивания, или -1.

Эта функция предназначена для использования в обработчике “drag-data-get”.

С: 2.16

gtk_entry_get_icon_area ()

void
gtk_entry_get_icon_area (GtkEntry *entry,
                         GtkEntryIconPosition icon_pos,
                         GdkRectangle *icon_area);

Получает область, в которой нарисован значок ввода в icon_pos. Эта функция полезна при рисовании чего-либо в вводе в обработчике рисования.

Если ввод не реализован или не имеет значка в данной позиции, icon_area заполняется нулями. В противном случае icon_area будет заполнен размещением значка, относительно размещения entry.

См. также gtk_entry_get_text_area()

С: 3.0

gtk_entry_set_input_purpose ()

void
gtk_entry_set_input_purpose (GtkEntry *entry,
                             GtkInputPurpose purpose);

Устанавливает свойство “input-purpose”, которое может использоваться экранными клавиатурами и другими методами ввода для корректировки их поведения.

С: 3.6

gtk_entry_get_input_purpose ()

GtkInputPurpose
gtk_entry_get_input_purpose (GtkEntry *entry);

Получает значение свойства “input-purpose”.

С: 3.6

gtk_entry_set_input_hints ()

void
gtk_entry_set_input_hints (GtkEntry *entry,
                           GtkInputHints hints);

Устанавливает свойство “input-hints”, которое позволяет методам ввода уточнять своё поведение.

С момента: 3.6

gtk_entry_get_input_hints ()

GtkInputHints
gtk_entry_get_input_hints (GtkEntry *entry);

Получает значение свойства “input-hints”.

С момента: 3.6

gtk_entry_grab_focus_without_selecting ()

void
gtk_entry_grab_focus_without_selecting
                               (GtkEntry *entry);

Приводит entry к получению фокуса клавиатуры.

Он работает так же, как gtk_widget_grab_focus(), за исключением того, что он не выделяет содержимое поля ввода. Вы хотите вызвать это только для некоторых особых полей ввода, в которых пользователь обычно не хочет заменять весь текст, таких как поля поиска по мере ввода.

С момента: 3.16

struct GtkEntry

struct GtkEntry;

struct GtkEntryClass

struct GtkEntryClass {
  GtkWidgetClass parent_class;

  /* Hook to customize right-click popup */
  void (* populate_popup)   (GtkEntry       *entry,
                             GtkWidget      *popup);

  /* Action signals
   */
  void (* activate)           (GtkEntry             *entry);
  void (* move_cursor)        (GtkEntry             *entry,
			       GtkMovementStep       step,
			       gint                  count,
			       gboolean              extend_selection);
  void (* insert_at_cursor)   (GtkEntry             *entry,
			       const gchar          *str);
  void (* delete_from_cursor) (GtkEntry             *entry,
			       GtkDeleteType         type,
			       gint                  count);
  void (* backspace)          (GtkEntry             *entry);
  void (* cut_clipboard)      (GtkEntry             *entry);
  void (* copy_clipboard)     (GtkEntry             *entry);
  void (* paste_clipboard)    (GtkEntry             *entry);
  void (* toggle_overwrite)   (GtkEntry             *entry);

  /* hooks to add other objects beside the entry (like in GtkSpinButton) */
  void (* get_text_area_size) (GtkEntry       *entry,
			       gint           *x,
			       gint           *y,
			       gint           *width,
			       gint           *height);
  void (* get_frame_size)     (GtkEntry       *entry,
                               gint           *x,
                               gint           *y,
			       gint           *width,
			       gint           *height);
  void (* insert_emoji)       (GtkEntry             *entry);
};

Структура класса для GtkEntry. Все виртуальные функции имеют реализацию по умолчанию. Производные классы могут установить указатели на виртуальные функции для обработчиков сигналов на NULL, но должны сохранить get_text_area_size и get_frame_size не-NULL; либо использовать реализацию по умолчанию, либо предоставить пользовательскую.

Перечисление GtkEntryIconPosition

Определяет сторону поля ввода, на которой размещён значок.

С момента: 2.16

Перечисление GtkInputPurpose

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

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

Разница между GTK_INPUT_PURPOSE_DIGITS и GTK_INPUT_PURPOSE_NUMBER заключается в том, что первый принимает только цифры, а второй также некоторые знаки препинания (например, запятые или точки, плюс, минус) и «e» или «E», как в 3.14E+000.

Это перечисление может быть расширено в будущем; методы ввода должны интерпретировать неизвестные значения как «свободная форма».

С: 3.6

Перечисление GtkInputHints

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

При использовании этих флагов требуется здравый смысл – смешивание GTK_INPUT_HINT_LOWERCASE с любыми подсказками в верхнем регистре не имеет смысла.

Это перечисление может быть расширено в будущем; методы ввода должны игнорировать неизвестные значения.

С: 3.6

Свойство “activates-default”

  “activates-default”        gboolean

Устанавливает, активируется ли виджет по умолчанию (например, кнопка по умолчанию в диалоговом окне), когда нажимается Enter.

Владелец: GtkEntry

Флаги: Чтение / Запись

Значение по умолчанию: FALSE

Свойство “attributes”

  “attributes”               PangoAttrList *

Список атрибутов Pango, применяемых к тексту в поле.

Это полезно, в основном, для изменения размера или начертания текста.

Атрибуты PangoAttribute start_index и end_index должны ссылаться на текст GtkEntryBuffer, то есть без предварительного ввода.

Владелец: GtkEntry

Флаги: Чтение / Запись

С версии: 3.6

Свойство “buffer”

  “buffer”                   GtkEntryBuffer *

Объект буфера текста, который фактически хранит текст в поле ввода.

Владелец: GtkEntry

Флаги: Чтение / Запись / Создание

Свойство “caps-lock-warning”

  “caps-lock-warning”        gboolean

Устанавливает, будет ли отображаться предупреждение о включенном Caps Lock в полях для ввода паролей.

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

Владелец: GtkEntry

Флаги: Чтение / Запись

Значение по умолчанию: TRUE

С версии: 2.16

Свойство “completion”

  “completion”               GtkEntryCompletion *

Дополнительный объект автодополнения, используемый с полем ввода.

Владелец: GtkEntry

Флаги: Чтение / Запись

С версии: 3.2

Свойство “cursor-position”

  “cursor-position”          int

Текущее положение курсора ввода в символах.

Владелец: GtkEntry

Флаги: Чтение

Допустимые значения: [0,65535]

Значение по умолчанию: 0

Свойство “editable”

  “editable”                 gboolean

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

Владелец: GtkEntry

Флаги: Чтение / Запись

Значение по умолчанию: TRUE

Свойство “enable-emoji-completion”

  “enable-emoji-completion”  gboolean

Указывает, предлагать ли замены эмодзи.

Владелец: GtkEntry

Флаги: Чтение / Запись

Значение по умолчанию: FALSE

Свойство “has-frame”

  “has-frame”                gboolean

FALSE удаляет внешние уступы поля.

Владелец: GtkEntry

Флаги: Чтение / Запись

Значение по умолчанию: TRUE

Свойство “im-module”

  “im-module”                char *

Модуль IM (метода ввода), который следует использовать для данного поля. См. GtkIMContext.

Установка значения, отличного от NULL, переопределяет системное значение модуля IM. См. свойство GtkSettings “gtk-im-module”.

Владелец: GtkEntry

Флаги: Чтение / Запись

Значение по умолчанию: NULL

С версии: 2.16

Свойство “inner-border”

  “inner-border”             GtkBorder *

Устанавливает отступ между областью текста и рамкой.

Владелец: GtkEntry

Флаги: Чтение / Запись

С версии: 2.10

Свойство “input-hints”

  “input-hints”              GtkInputHints

Дополнительные подсказки (помимо “input-purpose”), позволяющие методам ввода уточнять свое поведение.

Владелец: GtkEntry

Флаги: Чтение / Запись

С версии: 3.6

Свойство “input-purpose”

  “input-purpose”            GtkInputPurpose

Назначение этого поля ввода текста.

Это свойство может использоваться экранными клавиатурами и другими методами ввода для настройки их поведения.

Обратите внимание, что установка назначения на GTK_INPUT_PURPOSE_PASSWORD или GTK_INPUT_PURPOSE_PIN независимо от установки “visibility”.

Владелец: GtkEntry

Флаги: Чтение / Запись

Значение по умолчанию: GTK_INPUT_PURPOSE_FREE_FORM

С версии: 3.6

Свойство “invisible-char”

  “invisible-char”           guint

Невидимый символ используется при маскировании содержимого поля (в режиме «пароль»). Если не задано явно с помощью свойства “invisible-char”, GTK+ определяет символ из списка возможных кандидатов, в зависимости от наличия в текущем шрифте.

Это свойство позволяет теме добавлять символ в список кандидатов.

Владелец: GtkEntry

Флаги: Чтение / Запись

Значение по умолчанию: '*'

С версии: 2.18

Свойство “invisible-char-set”

  “invisible-char-set”       gboolean

Указывает, был ли задан невидимый символ для GtkEntry.

Владелец: GtkEntry

Флаги: Чтение / Запись

Значение по умолчанию: FALSE

С версии: 2.16

Свойство “max-length”

  “max-length”               int

Максимальное количество символов для данного поля. Ноль, если максимальное количество не ограничено.

Владелец: GtkEntry

Флаги: Чтение / Запись

Допустимые значения: [0,65535]

Значение по умолчанию: 0

Свойство “max-width-chars”

  “max-width-chars”          int

Желаемая максимальная ширина поля в символах. Если свойство установлено в -1, ширина будет рассчитана автоматически.

Владелец: GtkEntry

Флаги: Чтение / Запись

Допустимые значения: >= -1

Значение по умолчанию: -1

С версии: 3.12

Свойство “overwrite-mode”

  “overwrite-mode”           gboolean

Устанавливает, будет ли текст перезаписываться при вводе в GtkEntry.

Владелец: GtkEntry

Флаги: Чтение / Запись

Значение по умолчанию: FALSE

С версии: 2.14

Свойство “placeholder-text”

  “placeholder-text”         char *

Текст, который будет отображаться в GtkEntry, когда он пустой и не фокусирован.

Владелец: GtkEntry

Флаги: Чтение / Запись

Значение по умолчанию: NULL

С версии: 3.2

Свойство “populate-all”

  “populate-all”             gboolean

Если :populate-all TRUE, сигнал “populate-popup” также генерируется для всплывающих окон при касании.

Владелец: GtkEntry

Флаги: Чтение / Запись

Значение по умолчанию: FALSE

С версии: 3.8

Свойство “primary-icon-activatable”

  “primary-icon-activatable” gboolean

Указывает, может ли быть активирован основной значок.

GTK+ генерирует сигналы “icon-press” и “icon-release” только для активных значков.

Неактивные значки можно использовать только для информационных целей.

Владелец: GtkEntry

Флаги: Чтение / Запись

Значение по умолчанию: TRUE

С версии: 2.16

Свойство “primary-icon-gicon”

  “primary-icon-gicon”       GIcon *

Значение GIcon для использования в качестве основного значка поля.

Владелец: GtkEntry

Флаги: Чтение / Запись

С версии: 2.16

Свойство “primary-icon-name”

  “primary-icon-name”        char *

Имя значка для использования в качестве основного значка поля.

Владелец: GtkEntry

Флаги: Чтение / Запись

Значение по умолчанию: NULL

С версии: 2.16

Свойство “primary-icon-pixbuf”

  “primary-icon-pixbuf”      GdkPixbuf *

Значение pixbuf для использования в качестве основного значка поля.

Владелец: GtkEntry

Флаги: Чтение / Запись

С версии: 2.16

Свойство “primary-icon-sensitive”

  “primary-icon-sensitive”   gboolean

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

Нечувствительный значок отображается серым. GTK+ не генерирует сигналы “icon-press” и “icon-release” и не допускает перетаскивание из нечувствительных значков.

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

Владелец: GtkEntry

Флаги: Чтение / Запись

Значение по умолчанию: TRUE

С версии: 2.16

Свойство “primary-icon-stock”

  “primary-icon-stock”       char *

Идентификатор stock, используемый для основного значка элемента ввода.

Владелец: GtkEntry

Флаги: Чтение / Запись

Значение по умолчанию: NULL

С версии: 2.16

Свойство “primary-icon-storage-type”

  “primary-icon-storage-type” GtkImageType

Представление, используемое для основного значка элемента ввода.

Владелец: GtkEntry

Флаги: Чтение

Значение по умолчанию: GTK_IMAGE_EMPTY

С версии: 2.16

Свойство “primary-icon-tooltip-markup”

  “primary-icon-tooltip-markup” char *

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

См. также gtk_entry_set_icon_tooltip_markup().

Владелец: GtkEntry

Флаги: Чтение / Запись

Значение по умолчанию: NULL

С версии: 2.16

Свойство “primary-icon-tooltip-text”

  “primary-icon-tooltip-text” char *

Содержание подсказки для основного значка.

См. также gtk_entry_set_icon_tooltip_text().

Владелец: GtkEntry

Флаги: Чтение / Запись

Значение по умолчанию: NULL

С версии: 2.16

Свойство “progress-fraction”

  “progress-fraction”        double

Текущая доля выполненной задачи.

Владелец: GtkEntry

Флаги: Чтение / Запись

Допустимые значения: [0,1]

Значение по умолчанию: 0

С версии: 2.16

Свойство “progress-pulse-step”

  “progress-pulse-step”      double

Доля общей ширины элемента ввода для перемещения блока прыгающего прогресса для каждого вызова gtk_entry_progress_pulse().

Владелец: GtkEntry

Флаги: Чтение / Запись

Допустимые значения: [0,1]

Значение по умолчанию: 0.1

С версии: 2.16

Свойство “scroll-offset”

  “scroll-offset”            int

Количество пикселей элемента ввода, прокрученных за экран влево.

Владелец: GtkEntry

Флаги: Чтение

Допустимые значения: >= 0

Значение по умолчанию: 0

Свойство “secondary-icon-activatable”

  “secondary-icon-activatable” gboolean

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

GTK+ генерирует сигналы “icon-press” и “icon-release” только для чувствительных, активируемых значков.

Чувствительные, но не активируемые значки могут использоваться в чисто информационных целях.

Владелец: GtkEntry

Флаги: Чтение / Запись

Значение по умолчанию: TRUE

С версии: 2.16

Свойство “secondary-icon-gicon”

  “secondary-icon-gicon”     GIcon *

Объект GIcon, используемый для вторичного значка элемента ввода.

Владелец: GtkEntry

Флаги: Чтение / Запись

С версии: 2.16

Свойство “secondary-icon-name”

  “secondary-icon-name”      char *

Имя значка, используемое для вторичного значка элемента ввода.

Владелец: GtkEntry

Флаги: Чтение / Запись

Значение по умолчанию: NULL

С версии: 2.16

Свойство “secondary-icon-pixbuf”

  “secondary-icon-pixbuf”    GdkPixbuf *

Pixbuf, используемый в качестве вторичного значка элемента ввода.

Владелец: GtkEntry

Флаги: Чтение / Запись

С версии: 2.16

Свойство “secondary-icon-sensitive”

  “secondary-icon-sensitive” gboolean

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

Нечувствительный значок отображается серым. GTK+ не генерирует сигналы “icon-press” и “icon-release” и не допускает перетаскивание из нечувствительных значков.

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

Владелец: GtkEntry

Флаги: Чтение / Запись

Значение по умолчанию: TRUE

С версии: 2.16

Свойство “secondary-icon-stock”

  “secondary-icon-stock”     char *

Идентификатор stock, используемый для вторичного значка элемента ввода.

Владелец: GtkEntry

Флаги: Чтение / Запись

Значение по умолчанию: NULL

С версии: 2.16

Свойство “secondary-icon-storage-type”

  “secondary-icon-storage-type” GtkImageType

Представление, используемое для вторичного значка элемента ввода.

Владелец: GtkEntry

Флаги: Чтение

Значение по умолчанию: GTK_IMAGE_EMPTY

С версии: 2.16

Свойство “secondary-icon-tooltip-markup”

  “secondary-icon-tooltip-markup” char *

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

См. также gtk_entry_set_icon_tooltip_markup().

Владелец: GtkEntry

Флаги: Чтение / Запись

Значение по умолчанию: NULL

С версии: 2.16

Свойство “secondary-icon-tooltip-text”

  “secondary-icon-tooltip-text” char *

Содержание подсказки для вторичного значка.

См. также gtk_entry_set_icon_tooltip_text().

Владелец: GtkEntry

Флаги: Чтение / Запись

Значение по умолчанию: NULL

С версии: 2.16

Свойство “selection-bound”

  “selection-bound”          int

Позиция противоположного конца выделения от курсора в символах.

Владелец: GtkEntry

Флаги: Чтение

Допустимые значения: [0,65535]

Значение по умолчанию: 0

Свойство “shadow-type”

  “shadow-type”              GtkShadowType

Какой тип тени рисовать вокруг элемента ввода, когда “has-frame” установлено в TRUE.

Владелец: GtkEntry

Флаги: Чтение / Запись

Значение по умолчанию: GTK_SHADOW_IN

С версии: 2.12

Свойство “show-emoji-icon”

  “show-emoji-icon”          gboolean

Отображать ли значок для Emoji.

Владелец: GtkEntry

Флаги: Чтение / Запись

Значение по умолчанию: FALSE

Свойство “tabs”

  “tabs”                     PangoTabArray *

Список расположений табуляции для применения к тексту элемента ввода.

Владелец: GtkEntry

Флаги: Чтение / Запись

Свойство “text”

  “text”                     char *

Содержимое элемента ввода.

Владелец: GtkEntry

Флаги: Чтение / Запись

Значение по умолчанию: ""

Свойство “text-length”

  “text-length”              guint

Длина текста в GtkEntry.

Владелец: GtkEntry

Флаги: Чтение

Допустимые значения: <= 65535

Значение по умолчанию: 0

С версии: 2.14

Свойство “truncate-multiline”

  “truncate-multiline”       gboolean

Когда TRUE, вставленный многострочный текст усекается до первой строки.

Владелец: GtkEntry

Флаги: Чтение / Запись

Значение по умолчанию: FALSE

С версии: 2.10

Свойство “visibility”

  “visibility”               gboolean

FALSE отображает "невидимый символ" вместо фактического текста (режим пароля).

Владелец: GtkEntry

Флаги: Чтение / Запись

Значение по умолчанию: TRUE

Свойство “width-chars”

  “width-chars”              int

Количество символов, для которых нужно оставить место в элементе ввода.

Владелец: GtkEntry

Флаги: Чтение / Запись

Допустимые значения: >= -1

Значение по умолчанию: -1

Свойство “xalign”

  “xalign”                   float

Горизонтальное выравнивание, от 0 (слева) до 1 (справа). Обратное для макетов RTL.

Владелец: GtkEntry

Флаги: Чтение / Запись

Допустимые значения: [0,1]

Значение по умолчанию: 0

С версии: 2.4

Сигнал “activate”

void
user_function (GtkEntry *entry,
               gpointer  user_data)

Сигнал ::activate генерируется, когда пользователь нажимает клавишу Enter.

Хотя этот сигнал используется как сигнал для привязки клавиш, его также часто используют приложения для перехвата активации полей ввода.

По умолчанию этот сигнал привязан ко всем вариантам нажатия клавиши Enter.

Флаги: Действие

Сигнал “backspace”

void
user_function (GtkEntry *entry,
               gpointer  user_data)

Сигнал ::backspace — это сигнал для привязки клавиш, который генерируется, когда пользователь запрашивает удаление символа.

По умолчанию этот сигнал привязан к Backspace и Shift-Backspace.

Флаги: Действие

Сигнал “copy-clipboard”

void
user_function (GtkEntry *entry,
               gpointer  user_data)

Сигнал ::copy-clipboard — это сигнал для привязки клавиш, который генерируется для копирования выделенного текста в буфер обмена.

По умолчанию этот сигнал привязан к Ctrl-c и Ctrl-Insert.

Флаги: Действие

Сигнал “cut-clipboard”

void
user_function (GtkEntry *entry,
               gpointer  user_data)

Сигнал ::cut-clipboard — это сигнал для привязки клавиш, который генерируется для вырезания выделенного текста в буфер обмена.

По умолчанию этот сигнал привязан к Ctrl-x и Shift-Delete.

Флаги: Действие

Сигнал “delete-from-cursor”

void
user_function (GtkEntry     *entry,
               GtkDeleteType type,
               int           count,
               gpointer      user_data)

Сигнал ::delete-from-cursor — это сигнал для привязки клавиш, который генерируется при начальной попытке пользователя удалить текст.

Если type равен GTK_DELETE_CHARS, GTK+ удаляет выделение, если оно есть, иначе удаляет указанное количество символов.

По умолчанию этот сигнал привязан к Delete для удаления одного символа и Ctrl-Delete для удаления слова.

Флаги: Действие

Сигнал “icon-press”

void
user_function (GtkEntry            *entry,
               GtkEntryIconPosition icon_pos,
               GdkEvent            *event,
               gpointer             user_data)

Сигнал ::icon-press генерируется при нажатии на активируемую иконку.

Флаги: Выполнить последним

С версии: 2.16

Сигнал “icon-release”

void
user_function (GtkEntry            *entry,
               GtkEntryIconPosition icon_pos,
               GdkEvent            *event,
               gpointer             user_data)

Сигнал ::icon-release генерируется при отпускании кнопки мыши после щелчка по активируемой иконке.

Флаги: Выполнить последним

С версии: 2.16

Сигнал “insert-at-cursor”

void
user_function (GtkEntry *entry,
               char     *string,
               gpointer  user_data)

Сигнал ::insert-at-cursor — это сигнал для привязки клавиш, который генерируется при вставке фиксированной строки в курсор.

У этого сигнала нет стандартных привязок.

Флаги: Действие

Сигнал “insert-emoji”

void
user_function (GtkEntry *entry,
               gpointer  user_data)

Сигнал ::insert-emoji — это сигнал для привязки клавиш, который генерируется для отображения диалога выбора смайликов для entry.

По умолчанию этот сигнал привязан к Ctrl-. и Ctrl-;

Флаги: Действие

С версии: 3.22.27

Сигнал “move-cursor”

void
user_function (GtkEntry       *entry,
               GtkMovementStep step,
               int             count,
               gboolean        extend_selection,
               gpointer        user_data)

Сигнал ::move-cursor — это сигнал привязки клавиш, который генерируется при перемещении курсора пользователем. Если курсор не виден в entry, этот сигнал вызывает перемещение области просмотра вместо этого.

Приложения не должны подключаться к нему, но могут генерировать его с помощью g_signal_emit_by_name(), если им нужно управлять курсором программно.

Стандартные привязки к этому сигналу представлены в двух вариантах: вариант со Shift-модификатором расширяет выделение, а вариант без Shift-модификатора — нет. Здесь слишком много комбинаций клавиш, чтобы перечислить их все.

Флаги: Действие

Сигнал “paste-clipboard”

void
user_function (GtkEntry *entry,
               gpointer  user_data)

Сигнал ::paste-clipboard — это сигнал привязки клавиш, который генерируется для вставки содержимого буфера обмена в текстовое представление.

Стандартные привязки к этому сигналу — Ctrl-v и Shift-Insert.

Флаги: Действие

Сигнал “populate-popup”

void
user_function (GtkEntry  *entry,
               GtkWidget *widget,
               gpointer   user_data)

Сигнал ::populate-popup генерируется перед отображением контекстного меню поля ввода.

Если вам нужно добавить элементы в контекстное меню, подключитесь к этому сигналу и добавьте ваши элементы в widget, который в данном случае будет GtkMenu.

Если свойство “populate-all” TRUE, этот сигнал также будет сгенерирован для заполнения всплывающих меню сенсорных элементов. В этом случае widget будет другим контейнером, например GtkToolbar. Обработчик сигнала не должен делать предположений о типе widget.

Флаги: Выполнение в последнюю очередь

Сигнал “preedit-changed”

void
user_function (GtkEntry *entry,
               char     *preedit,
               gpointer  user_data)

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

Флаги: Действие

С версии: 2.20

Сигнал “toggle-overwrite”

void
user_function (GtkEntry *entry,
               gpointer  user_data)

Сигнал ::toggle-overwrite — это сигнал привязки клавиш, который генерируется для переключения режима вставки.

Стандартная привязка к этому сигналу — Insert.

Флаги: Действие