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().

Это эквивалентно:

gtk_entry_get_text_length ()

guint16
gtk_entry_get_text_length (GtkEntry *entry);

Получает текущую длину текста в entry.

Это эквивалентно:

С: 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);

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

Эквивалентно:

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() для получения дополнительной информации.

С: 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().

С: 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 поля ввода entry в значение border, или очищает его, если передано NULL. Внутренняя граница - это область вокруг текста поля ввода, но внутри его рамки.

Если установлено, это свойство переопределяет свойство inner-border стиля. Переопределение границы, заданной стилем, полезно, когда вы хотите выполнить редактирование текста внутри холста или виджета списка, где точное позиционирование поля ввода в пикселях имеет значение.

С: 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);

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

gtk_entry_text-index-to-layout-index ()

gint
gtk_entry_text_index_to_layout_index (GtkEntry *entry,
                                      gint text_index);

Преобразует позицию в PangoLayout поля (возвращается gtk_entry_get_layout()) в позицию в содержимом поля (возвращается gtk_entry_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
├── image.left
├── image.right
├── undershoot.left
├── undershoot.right
├── [selection]
├── [progress[.pulse]]
╰── [window.popup]

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.

С версии: 2.4

gtk_entry_get_completion ()

GtkEntryCompletion *
gtk_entry_get_completion (GtkEntry *entry);

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

С версии: 2.4

gtk_entry_set_cursor_hadjustment ()

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

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

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

С версии: 2.12

gtk_entry_get_cursor_hadjustment ()

GtkAdjustment *
gtk_entry_get_cursor_hadjustment (GtkEntry *entry);

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

С версии: 2.12

gtk_entry_set_progress_fraction ()

void
gtk_entry_set_progress_fraction (GtkEntry *entry,
                                 gdouble fraction);

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

С версии: 2.16

gtk_entry_get_progress_fraction ()

gdouble
gtk_entry_get_progress_fraction (GtkEntry *entry);

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

С версии: 2.16

gtk_entry_set_progress_pulse_step ()

void
gtk_entry_set_progress_pulse_step (GtkEntry *entry,
                                   gdouble fraction);

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

С версии: 2.16

gtk_entry_get_progress_pulse_step ()

gdouble
gtk_entry_get_progress_pulse_step (GtkEntry *entry);

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

С версии: 2.16

gtk_entry_progress_pulse ()

void
gtk_entry_progress_pulse (GtkEntry *entry);

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

С версии: 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() для примера использования.

С: 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, стандартного элемента или gicon).

С версии: 2.16

gtk_entry_get_icon_gicon ()

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

Извлекает GIcon, используемый для иконки, или NULL, если иконка не установлена или если она установлена другим способом (например, с помощью стандартного элемента, 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().

С версии: 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 заполняется нулями.

См. также 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);
};

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

enum GtkEntryIconPosition

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

Since: 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.

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

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

Свойство “attributes”

  “attributes”               PangoAttrList *

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

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

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

С версии: 3.6

Свойство “buffer”

  “buffer”                   GtkEntryBuffer *

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

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

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

  “caps-lock-warning”        gboolean

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

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

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

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

С версии: 2.16

Свойство “completion”

  “completion”               GtkEntryCompletion *

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

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

С версии: 3.2

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

  “cursor-position”          gint

Текущая позиция курсора ввода в символах.

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

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

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

Свойство “editable”

  “editable”                 gboolean

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

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

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

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

  “has-frame”                gboolean

FALSE удаляет внешнюю фаску из поля.

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

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

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

  “im-module”                gchar *

Какой модуль IM (метода ввода) следует использовать для этого поля. См. GtkIMContext.

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

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

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

С версии: 2.16

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

  “inner-border”             GtkBorder *

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

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

С версии: 2.10

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

  “input-hints”              GtkInputHints

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

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

С версии: 3.6

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

  “input-purpose”            GtkInputPurpose

Цель этого поля ввода.

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

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

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

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

С версии: 3.6

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

  “invisible-char”           guint

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

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

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

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

С версии: 2.18

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

  “invisible-char-set”       gboolean

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

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

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

С версии: 2.16

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

  “max-length”               gint

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

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

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

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

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

  “max-width-chars”          gint

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

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

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

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

С версии: 3.12

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

  “overwrite-mode”           gboolean

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

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

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

С версии: 2.14

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

  “placeholder-text”         gchar *

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

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

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

С версии: 3.2

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

  “populate-all”             gboolean

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

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

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

С версии: 3.8

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

  “primary-icon-activatable” gboolean

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

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

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

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

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

С версии: 2.16

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

  “primary-icon-gicon”       GIcon *

Используемый значок GIcon для основного значка поля.

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

С версии: 2.16

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

  “primary-icon-name”        gchar *

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

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

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

С версии: 2.16

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

  “primary-icon-pixbuf”      GdkPixbuf *

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

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

С версии: 2.16

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

  “primary-icon-sensitive”   gboolean

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

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

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

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

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

С версии: 2.16

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

  “primary-icon-stock”       gchar *

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

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

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

С версии: 2.16

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

  “primary-icon-storage-type” GtkImageType

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

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

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

С версии: 2.16

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

  “primary-icon-tooltip-markup” gchar *

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

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

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

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

С версии: 2.16

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

  “primary-icon-tooltip-text” gchar *

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

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

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

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

С версии: 2.16

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

  “progress-fraction”        gdouble

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

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

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

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

С версии: 2.16

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

  “progress-pulse-step”      gdouble

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

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

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

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

С версии: 2.16

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

  “scroll-offset”            gint

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

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

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

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

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

  “secondary-icon-activatable” gboolean

Можно ли активировать вторичный значок.

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

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

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

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

С версии: 2.16

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

  “secondary-icon-gicon”     GIcon *

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

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

С версии: 2.16

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

  “secondary-icon-name”      gchar *

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

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

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

С версии: 2.16

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

  “secondary-icon-pixbuf”    GdkPixbuf *

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

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

С версии: 2.16

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

  “secondary-icon-sensitive” gboolean

Чувствителен ли вторичный значок.

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

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

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

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

С версии: 2.16

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

  “secondary-icon-stock”     gchar *

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

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

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

С версии: 2.16

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

  “secondary-icon-storage-type” GtkImageType

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

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

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

С версии: 2.16

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

  “secondary-icon-tooltip-markup” gchar *

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

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

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

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

С версии: 2.16

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

  “secondary-icon-tooltip-text” gchar *

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

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

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

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

С версии: 2.16

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

  “selection-bound”          gint

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

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

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

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

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

  “shadow-type”              GtkShadowType

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

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

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

С версии: 2.12

Свойство “tabs”

  “tabs”                     PangoTabArray *

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

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

Свойство “text”

  “text”                     gchar *

Содержимое поля ввода.

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

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

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

  “text-length”              guint

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

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

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

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

С версии: 2.14

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

  “truncate-multiline”       gboolean

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

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

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

С версии: 2.10

Свойство “visibility”

  “visibility”               gboolean

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

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

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

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

  “width-chars”              gint

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

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

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

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

Свойство “xalign”

  “xalign”                   gfloat

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

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

Допустимые значения: [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,
               gint          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,
               gchar    *string,
               gpointer  user_data)

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

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

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

Сигнал “move-cursor”

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

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

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

Стандартные привязки к этому сигналу имеют два варианта: с модификатором 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 *popup,
               gpointer   user_data)

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

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

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

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

Сигнал “preedit-changed”

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

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

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

С: 2.20

Сигнал “toggle-overwrite”

void
user_function (GtkEntry *entry,
               gpointer  user_data)

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

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

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