GtkTextTagTable
GtkTextTagTable — Коллекция тегов, которые могут использоваться вместе
Функции
| void | (*GtkTextTagTableForeach) () |
| GtkTextTagTable * | gtk_text_tag_table_new () |
| gboolean | gtk_text_tag_table_add () |
| void | gtk_text_tag_table_remove () |
| GtkTextTag * | gtk_text_tag_table_lookup () |
| void | gtk_text_tag_table_foreach () |
| gint | gtk_text_tag_table_get_size () |
Сигналы
| void | tag-added | Run Last |
| void | tag-changed | Run Last |
| void | tag-removed | Run Last |
Типы и значения
Иерархия объектов
GObject
╰── GtkTextTagTable
Реализованные интерфейсы
GtkTextTagTable реализует GtkBuildable.
Включаемые файлы
#include <gtk/gtk.h>
Описание
Вы можете начать с прочтения общего обзора виджета текста, в котором содержится обзор всех объектов и типов данных, связанных с виджетом текста, и того, как они взаимодействуют.
GtkTextTagTables в качестве GtkBuildable
Реализация GtkTextTagTable интерфейса GtkBuildable поддерживает добавление тегов путем указания «tag» в качестве атрибута «type» элемента <child>.
Пример фрагмента определения пользовательского интерфейса, определяющего теги:
<object class="GtkTextTagTable"> <child type="tag"> <object class="GtkTextTag"/> </child> </object>
Функции
GtkTextTagTableForeach ()
void (*GtkTextTagTableForeach) (GtkTextTag *tag,gpointer data);
Параметры
tag | тег GtkTextTag | |
data | данные, переданные в | [closure] |
gtk_text_tag_table_new ()
GtkTextTagTable *
gtk_text_tag_table_new (void); Создаёт новую GtkTextTagTable. Таблица по умолчанию не содержит тегов.
Возвращает
новую GtkTextTagTable
gtk_text_tag_table_add ()
gboolean gtk_text_tag_table_add (GtkTextTagTable *table,GtkTextTag *tag);
Добавляет тег в таблицу. Тегу назначается наивысший приоритет в таблице.
tag не должен уже находиться в таблице тегов и не может иметь такое же имя, как уже добавленный тег.
Параметры
table | ||
tag |
Возвращает
TRUE при успешном выполнении.
gtk_text_tag_table_remove ()
void gtk_text_tag_table_remove (GtkTextTagTable *table,GtkTextTag *tag);
Удаляет тег из таблицы. Если у GtkTextBuffer её таблицей тегов является table, тег удаляется из буфера. Ссылка таблицы на тег удаляется, поэтому тег будет уничтожен, если у вас нет на него ссылки.
Параметры
table | ||
tag |
gtk_text_tag_table_lookup ()
GtkTextTag * gtk_text_tag_table_lookup (GtkTextTagTable *table,const gchar *name);
Ищет тег по имени.
Параметры
table | ||
name | имя тега |
Возвращает
Тег или NULL , если тег с таким именем отсутствует в таблице.
[nullable][transfer none]
gtk_text_tag_table_foreach ()
void gtk_text_tag_table_foreach (GtkTextTagTable *table,GtkTextTagTableForeach func,gpointer data);
Вызывает func для каждого тега в table с пользовательскими данными data. Обратите внимание, что таблица не может быть изменена во время итерации по ней (вы не можете добавлять или удалять теги).
Параметры
table | ||
func | функция, которую нужно вызвать для каждого тега. | [scope call] |
data | пользовательские данные |
gtk_text_tag_table_get_size ()
gint
gtk_text_tag_table_get_size (GtkTextTagTable *table); Возвращает размер таблицы (количество тегов)
Параметры
table |
Возвращает
количество тегов в table
Типы и значения
GtkTextTagTable
typedef struct _GtkTextTagTable GtkTextTagTable;
Подробности сигналов
Сигнал “tag-added”
void user_function (GtkTextTagTable *texttagtable, GtkTextTag *tag, gpointer user_data)
Параметры
texttagtable | объект, получивший сигнал. | |
tag | добавляемый тег. | |
user_data | данные пользователя, заданные при подключении обработчика сигнала. |
Флаги: Run Last
Сигнал “tag-changed”
void user_function (GtkTextTagTable *texttagtable, GtkTextTag *tag, gboolean size_changed, gpointer user_data)
Параметры
texttagtable | объект, получивший сигнал. | |
tag | изменённый тег. | |
size_changed | указывает, влияет ли изменение на макет GtkTextView. | |
user_data | данные пользователя, заданные при подключении обработчика сигнала. |
Флаги: Run Last
Сигнал “tag-removed”
void user_function (GtkTextTagTable *texttagtable, GtkTextTag *tag, gpointer user_data)
Параметры
texttagtable | объект, получивший сигнал. | |
tag | удаляемый тег. | |
user_data | данные пользователя, заданные при подключении обработчика сигнала. |
Флаги: Run Last
© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer.gnome.org/gtk3/3.24/GtkTextTagTable.html
