Spec-Zone.ru › GTK 4.0

GtkText

GtkText — Простое однострочное поле ввода текста

Функции

GtkWidget * gtk_text_new ()
GtkWidget * gtk_text_new_with_buffer ()
void gtk_text_set_buffer ()
GtkEntryBuffer * gtk_text_get_buffer ()
void gtk_text_set_visibility ()
gboolean gtk_text_get_visibility ()
void gtk_text_set_invisible_char ()
gunichar gtk_text_get_invisible_char ()
void gtk_text_unset_invisible_char ()
void gtk_text_set_overwrite_mode ()
gboolean gtk_text_get_overwrite_mode ()
void gtk_text_set_max_length ()
int gtk_text_get_max_length ()
guint16 gtk_text_get_text_length ()
void gtk_text_set_activates_default ()
gboolean gtk_text_get_activates_default ()
void gtk_text_set_placeholder_text ()
const char * gtk_text_get_placeholder_text ()
void gtk_text_set_input_purpose ()
GtkInputPurpose gtk_text_get_input_purpose ()
void gtk_text_set_input_hints ()
GtkInputHints gtk_text_get_input_hints ()
void gtk_text_set_attributes ()
PangoAttrList * gtk_text_get_attributes ()
void gtk_text_set_tabs ()
PangoTabArray * gtk_text_get_tabs ()
gboolean gtk_text_grab_focus_without_selecting ()
void gtk_text_set_extra_menu ()
GMenuModel * gtk_text_get_extra_menu ()
void gtk_text_set_enable_emoji_completion ()
gboolean gtk_text_get_enable_emoji_completion ()
void gtk_text_set_propagate_text_width ()
gboolean gtk_text_get_propagate_text_width ()
void gtk_text_set_truncate_multiline ()
gboolean gtk_text_get_truncate_multiline ()

Свойства

gboolean activates-default Чтение / Запись
PangoAttrList * attributes Чтение / Запись
GtkEntryBuffer * buffer Чтение / Запись / Создание
gboolean enable-emoji-completion Чтение / Запись
GMenuModel * extra-menu Чтение / Запись
char * im-module Чтение / Запись
GtkInputHints input-hints Чтение / Запись
GtkInputPurpose input-purpose Чтение / Запись
guint invisible-char Чтение / Запись
gboolean invisible-char-set Чтение / Запись
int max-length Чтение / Запись
gboolean overwrite-mode Чтение / Запись
char * placeholder-text Чтение / Запись
gboolean propagate-text-width Чтение / Запись
int scroll-offset Чтение
PangoTabArray * tabs Чтение / Запись
gboolean truncate-multiline Чтение / Запись
gboolean visibility Чтение / Запись

Сигналы

void activate Действие
void backspace Действие
void copy-clipboard Действие
void cut-clipboard Действие
void delete-from-cursor Действие
void insert-at-cursor Действие
void insert-emoji Действие
void move-cursor Действие
void paste-clipboard Действие
void preedit-changed Действие
void toggle-overwrite Действие

Действия

menu.popup
text.redo
text.undo
misc.toggle-visibility
misc.insert-emoji
selection.select-all
selection.delete
clipboard.paste
clipboard.copy
clipboard.cut

Типы и значения

struct GtkText

Иерархия объектов

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkWidget
            ╰── GtkText

Реализованные интерфейсы

GtkText реализует GtkAccessible, GtkBuildable, GtkConstraintTarget и GtkEditable.

Включения

#include <gtk/gtk.h>

Описание

Виджет GtkText — это виджет однострочного текстового поля.

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

При использовании поля для паролей и другой конфиденциальной информации, можно переключиться в «режим пароля», используя gtk_text_set_visibility(). В этом режиме введённый текст отображается с использованием «невидимого» символа. По умолчанию GTK выбирает наиболее подходящий невидимый символ, доступный в текущем шрифте, но его можно изменить с помощью gtk_text_set_invisible_char().

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

Если вам необходимо многострочное редактируемое текстовое поле, обратитесь к GtkTextView.

CSS-узлы

text[.read-only]
├── placeholder
├── undershoot.left
├── undershoot.right
├── [selection]
├── [block-cursor]
╰── [window.popup]

GtkText имеет основной узел с именем text. В зависимости от свойств виджета, может появиться класс стиля .read-only.

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

Когда поле находится в режиме вставки, добавляется дочерний узел с именем block-cursor, который определяет, как отображается курсор блока.

CSS-узел для контекстного меню также добавляется как дочерний узел под text.

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

При использовании сенсорного управления и отображении сенсорных маркеров выделения, используются CSS-узлы с именем cursor-handle. Они получают классы стиля .top или .bottom в зависимости от того, где они отображаются относительно выделения. Если есть только один маркер для текстового курсора, он получает класс стиля .insertion-cursor.

Доступность

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

Функции

gtk_text_new ()

GtkWidget *
gtk_text_new (void);

Создаёт новый объект.

Возвращаемое значение

новый GtkText.

gtk_text_new_with_buffer ()

GtkWidget *
gtk_text_new_with_buffer (GtkEntryBuffer *buffer);

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

Параметры

buffer

Буфер, который будет использоваться для нового GtkText.

Возвращаемое значение

новый GtkText.

gtk_text_set_buffer ()

void
gtk_text_set_buffer (GtkText *self,
                     GtkEntryBuffer *buffer);

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

Параметры

self

объект GtkText

buffer

объект GtkEntryBuffer

gtk_text_get_buffer ()

GtkEntryBuffer *
gtk_text_get_buffer (GtkText *self);

Возвращает объект GtkEntryBuffer, который хранит текст для этого объекта.

Параметры

self

объект GtkText

Возвращаемое значение

Объект GtkEntryBuffer.

[transfer none]

gtk_text_set_visibility ()

void
gtk_text_set_visibility (GtkText *self,
                         gboolean visible);

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

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

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

Параметры

self

объект GtkText

visible

TRUE если содержимое объекта отображается как обычный текст

gtk_text_get_visibility ()

gboolean
gtk_text_get_visibility (GtkText *self);

Возвращает значение видимости текста в self. Смотрите gtk_text_set_visibility().

Параметры

self

объект GtkText

Возвращаемое значение

TRUE если текст сейчас виден

gtk_text_set_invisible_char ()

void
gtk_text_set_invisible_char (GtkText *self,
                             gunichar ch);

Устанавливает символ, который будет использоваться вместо реального текста, когда gtk_text_set_visibility() был вызван для установки видимости текста на FALSE. То есть это символ, используемый в "режиме пароля", чтобы показать пользователю, сколько символов было введено.

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

Параметры

self

объект GtkText

ch

символ Юникод

gtk_text_get_invisible_char ()

gunichar
gtk_text_get_invisible_char (GtkText *self);

Возвращает символ, отображаемый вместо реальных символов для полей с видимость установленной в false. Обратите внимание, что GTK не вычисляет это значение, пока ему это не нужно, поэтому возвращаемое значение этой функции не очень полезно, если оно не было явно установлено с помощью gtk_text_set_invisible_char()

Параметры

self

объект GtkText

Возвращаемое значение

текущий невидимый символ или 0, если text вообще не отображает невидимый текст.

gtk_text-unset-invisible-char ()

void
gtk_text_unset_invisible_char (GtkText *self);

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

Параметры

self

объект GtkText

gtk_text_set_overwrite_mode ()

void
gtk_text_set_overwrite_mode (GtkText *self,
                             gboolean overwrite);

Устанавливает режим перезаписи текста при вводе в GtkText.

Параметры

self

объект GtkText

overwrite

новое значение

gtk_text_get_overwrite_mode ()

gboolean
gtk_text_get_overwrite_mode (GtkText *self);

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

Параметры

self

объект GtkText

Возвращаемое значение

режим перезаписи текста при вводе.

gtk_text_set_max_length ()

void
gtk_text_set_max_length (GtkText *self,
                         int length);

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

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

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

Параметры

self

объект GtkText

length

максимальная длина объекта или 0 для отсутствия максимальной длины (кроме максимальной длины ввода). Переданное значение будет ограничено диапазоном 0-65536.

gtk_text_get_max_length ()

int
gtk_text_get_max_length (GtkText *self);

Возвращает максимальную длину текста в self. Смотрите gtk_text_set_max_length().

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

Параметры

self

объект GtkText

Возвращаемое значение

максимальное количество символов в GtkText, или 0, если нет максимума.

gtk_text_get_text_length ()

guint16
gtk_text_get_text_length (GtkText *self);

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

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

Параметры

self

a GtkText

Возвращает

текущее количество символов в GtkText, или 0, если их нет.

gtk_text_set_activates_default ()

void
gtk_text_set_activates_default (GtkText *self,
                                gboolean activates);

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

Параметры

self

a GtkText

activates

TRUE для активации виджета по умолчанию окна при нажатии Enter

gtk_text_get_activates_default ()

gboolean
gtk_text_get_activates_default (GtkText *self);

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

Параметры

self

a GtkText

Возвращает

TRUE если self будет активировать виджет по умолчанию

gtk_text_set_placeholder_text ()

void
gtk_text_set_placeholder_text (GtkText *self,
                               const char *text);

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

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

Параметры

self

a GtkText

text

строка, отображаемая, когда self пуста и не фокусируется, или NULL.

[nullable]

gtk_text_get_placeholder_text ()

const char *
gtk_text_get_placeholder_text (GtkText *self);

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

Параметры

self

a GtkText

Возвращает

указатель на текст подставки в виде строки. Эта строка указывает на внутренне выделенную память в виджете и не должна освобождаться, изменяться или сохраняться. Если текст подставки не был установлен, будет возвращено NULL.

[nullable][transfer none]

gtk_text_set_input_purpose ()

void
gtk_text_set_input_purpose (GtkText *self,
                            GtkInputPurpose purpose);

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

Параметры

self

a GtkText

purpose

назначение

gtk_text_get_input_purpose ()

GtkInputPurpose
gtk_text_get_input_purpose (GtkText *self);

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

Параметры

self

a GtkText

gtk_text_set_input-hints ()

void
gtk_text_set_input_hints (GtkText *self,
                          GtkInputHints hints);

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

Параметры

self

a GtkText

hints

подсказки

gtk_text-get-input-hints ()

GtkInputHints
gtk_text_get_input_hints (GtkText *self);

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

Параметры

self

a GtkText

gtk_text_set_attributes ()

void
gtk_text_set_attributes (GtkText *self,
                         PangoAttrList *attrs);

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

Параметры

self

a GtkText

attrs

a PangoAttrList или NULL для сброса.

[nullable]

gtk_text_get_attributes ()

PangoAttrList *
gtk_text_get_attributes (GtkText *self);

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

Параметры

self

a GtkText

Возвращает

список атрибутов, или NULL если не было установлено ни одного.

[transfer none][nullable]

gtk_text_set_tabs ()

void
gtk_text_set_tabs (GtkText *self,
                   PangoTabArray *tabs);

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

Параметры

self

a GtkText

tabs

a PangoTabArray.

[nullable]

gtk_text_get_tabs ()

PangoTabArray *
gtk_text_get_tabs (GtkText *self);

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

Параметры

self

объект GtkText

Возвращаемое значение

отступы или NULL , если они не были установлены.

[nullable][transfer none]

gtk_text_grab_focus_without_selecting ()

gboolean
gtk_text_grab_focus_without_selecting (GtkText *self);

Присваивает фокус клавиатуры self.

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

Параметры

self

объект GtkText

Возвращаемое значение

TRUE если фокус теперь внутри self

gtk_text_set_extra_menu ()

void
gtk_text_set_extra_menu (GtkText *self,
                         GMenuModel *model);

Устанавливает модель меню для добавления при построении контекстного меню для self .

Параметры

self

объект GtkText

model

модель GMenuModel.

[allow-none]

gtk_text-get-extra-menu ()

GMenuModel *
gtk_text_get_extra_menu (GtkText *self);

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

Параметры

self

объект GtkText

Возвращаемое значение

модель меню.

[transfer none][nullable]

gtk_text_set_enable_emoji_completion ()

void
gtk_text_set_enable_emoji_completion (GtkText *self,
                                      gboolean enable_emoji_completion);

Устанавливает, включено ли завершение эмодзи. Если включено, ввод символа «:», за которым следует распознанное ключевое слово, отобразит окно с предложенными эмодзи, соответствующими этому ключевому слову.

Параметры

self

объект GtkText

enable_emoji_completion

TRUE для включения завершения эмодзи

gtk_text_get_enable_emoji_completion ()

gboolean
gtk_text_get_enable_emoji_completion (GtkText *self);

Возвращает, включено ли завершение эмодзи для этого виджета GtkText.

Параметры

self

объект GtkText

Возвращаемое значение

TRUE если завершение эмодзи включено

gtk_text_set_propagate_text-width ()

void
gtk_text_set_propagate_text_width (GtkText *self,
                                   gboolean propagate_text_width);

Устанавливает, должен ли GtkText изменять размер вместе с содержимым.

Параметры

self

объект GtkText

propagate_text_width

TRUE для распространения ширины текста

gtk_text_get_propagate_text_width ()

gboolean
gtk_text_get_propagate_text_width (GtkText *self);

Возвращает, будет ли GtkText изменять размер вместе с содержимым.

Параметры

self

объект GtkText

Возвращаемое значение

TRUE если self будет изменять ширину текста

gtk_text_set_truncate-multiline ()

void
gtk_text_set_truncate_multiline (GtkText *self,
                                 gboolean truncate_multiline);

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

Параметры

self

объект GtkText

truncate_multiline

TRUE для обрезки многострочного текста

gtk_text_get_truncate-multiline ()

gboolean
gtk_text_get_truncate_multiline (GtkText *self);

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

Параметры

self

объект GtkText

Возвращаемое значение

TRUE если self будет обрезать многострочный текст

Типы и значения

struct GtkText

struct GtkText;

Подробное описание свойств

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

  “activates-default”        gboolean

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

Владелец: GtkText

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

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

Свойство “attributes”

  “attributes”               PangoAttrList *

Список атрибутов Pango для применения к тексту self.

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

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

Владелец: GtkText

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

Свойство “buffer”

  “buffer”                   GtkEntryBuffer *

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

Владелец: GtkText

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

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

  “enable-emoji-completion”  gboolean

Включить ли предложение замены смайликами.

Владелец: GtkText

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

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

Свойство “extra-menu”

  “extra-menu”               GMenuModel *

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

Владелец: GtkText

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

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

  “im-module”                char *

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

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

Владелец: GtkText

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

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

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

  “input-hints”              GtkInputHints

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

Владелец: GtkText

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

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

  “input-purpose”            GtkInputPurpose

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

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

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

Владелец: GtkText

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

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

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

  “invisible-char”           guint

Символ, используемый для маскирования содержимого self (в режиме «пароль»).

Владелец: GtkText

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

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

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

  “invisible-char-set”       gboolean

Установлен ли символ маскирования для GtkText.

Владелец: GtkText

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

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

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

  “max-length”               int

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

Владелец: GtkText

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

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

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

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

  “overwrite-mode”           gboolean

Заменяется ли текст при вводе в GtkText.

Владелец: GtkText

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

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

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

  “placeholder-text”         char *

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

Владелец: GtkText

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

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

Свойство “propagate-text-width”

  “propagate-text-width”     gboolean

Должен ли ввод расти и уменьшаться вместе с содержимым.

Владелец: GtkText

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

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

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

  “scroll-offset”            int

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

Владелец: GtkText

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

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

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

Свойство “tabs”

  “tabs”                     PangoTabArray *

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

Владелец: GtkText

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

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

  “truncate-multiline”       gboolean

Если TRUE, вставленный текст с несколькими строками обрезается до первой строки.

Владелец: GtkText

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

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

Свойство “visibility”

  “visibility”               gboolean

FALSE отображает «символ маскировки» вместо фактического текста (режим «пароль»).

Владелец: GtkText

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

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

Подробные сведения о сигналах

Сигнал “activate”

void
user_function (GtkText *self,
               gpointer user_data)

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

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

Параметры

self

Виджет, на котором генерируется сигнал

user_data

Данные пользователя, заданные при подключении обработчика сигнала.

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

Сигнал “backspace”

void
user_function (GtkText *self,
               gpointer user_data)

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

По умолчанию для этого сигнала назначены сочетания Backspace и Shift-Backspace.

Параметры

self

Объект, получивший сигнал

user_data

Данные пользователя, заданные при подключении обработчика сигнала.

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

Сигнал “copy-clipboard”

void
user_function (GtkText *self,
               gpointer user_data)

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

По умолчанию для этого сигнала назначены сочетания Ctrl-c и Ctrl-Insert.

Параметры

self

Объект, получивший сигнал

user_data

Данные пользователя, заданные при подключении обработчика сигнала.

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

Сигнал “cut-clipboard”

void
user_function (GtkText *self,
               gpointer user_data)

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

По умолчанию для этого сигнала назначены сочетания Ctrl-x и Shift-Delete.

Параметры

self

Объект, получивший сигнал

user_data

Данные пользователя, заданные при подключении обработчика сигнала.

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

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

void
user_function (GtkText      *self,
               GtkDeleteType type,
               int           count,
               gpointer      user_data)

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

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

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

Параметры

self

Объект, получивший сигнал

type

Степень детализации удаления, как GtkDeleteType

count

Количество type единиц для удаления

user_data

Данные пользователя, заданные при подключении обработчика сигнала.

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

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

void
user_function (GtkText *self,
               char    *string,
               gpointer user_data)

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

По умолчанию для этого сигнала нет назначенных сочетаний.

Параметры

self

Объект, получивший сигнал

string

Строка для вставки

user_data

Данные пользователя, заданные при подключении обработчика сигнала.

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

Сигнал “insert-emoji”

void
user_function (GtkText *self,
               gpointer user_data)

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

По умолчанию для этого сигнала назначены сочетания Ctrl-. и Ctrl-;

Параметры

self

Объект, получивший сигнал

user_data

Данные пользователя, заданные при подключении обработчика сигнала.

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

Сигнал “move-cursor”

void
user_function (GtkText        *self,
               GtkMovementStep step,
               int             count,
               gboolean        extend,
               gpointer        user_data)

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

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

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

  • Клавиши со стрелками перемещают курсор на отдельные символы/строки

  • Сочетания Ctrl-стрелка перемещают на слова/абзацы

  • Клавиши Home/End перемещают курсор в начало/конец буфера

Параметры

self

Объект, получивший сигнал

step

Степень детализации перемещения, как GtkMovementStep

count

Количество step единиц для перемещения

extend

TRUE если перемещение должно расширить выделение

user_data

Данные пользователя, заданные при подключении обработчика сигнала.

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

Сигнал “paste-clipboard”

void
user_function (GtkText *self,
               gpointer user_data)

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

По умолчанию для этого сигнала назначены сочетания Ctrl-v и Shift-Insert.

Параметры

self

Объект, получивший сигнал

user_data

Данные пользователя, заданные при подключении обработчика сигнала.

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

Сигнал “preedit-changed”

void
user_function (GtkText *self,
               char    *preedit,
               gpointer user_data)

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

Параметры

self

Объект, получивший сигнал

preedit

Текущая строка предварительного редактирования

user_data

Данные пользователя, заданные при подключении обработчика сигнала.

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

Сигнал “toggle-overwrite”

void
user_function (GtkText *self,
               gpointer user_data)

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

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

Параметры

self

объект, получивший сигнал

user_data

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

Флаги: Action

Подробное описание действий

Действие “menu.popup”

Открывает контекстное меню.

Действие “text.redo”

Повторяет последнее изменение содержимого.

Действие “text.undo”

Отменяет последнее изменение содержимого.

Действие “misc.insert-emoji”

Переключает свойство “видимость”.

Действие “misc.toggle-visibility”

Открывает выборщик смайликов.

Действие “selection.select-all”

Выделяет все содержимое виджета.

Действие “selection.delete”

Удаляет текущий выделенный фрагмент.

Действие “clipboard.paste”

Вставляет содержимое буфера обмена в виджет.

Действие “clipboard.copy”

Копирует содержимое в буфер обмена.

Действие “clipboard.cut”

Копирует содержимое в буфер обмена и удаляет его из виджета.

См. также

GtkEntry, GtkTextView

© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer-old.gnome.org/gtk4/4.0/GtkText.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API