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 | таблица GtkTextTagTable | |
tag | тег GtkTextTag |
Возвращает
TRUE при успехе.
gtk_text_tag_table_remove ()
void gtk_text_tag_table_remove (GtkTextTagTable *table,GtkTextTag *tag);
Удаляет тег из таблицы. Если GtkTextBuffer использует table в качестве таблицы тегов, тег удаляется из буфера. Ссылка на тег в таблице удаляется, поэтому тег будет уничтожен, если у вас нет ссылки на него.
Параметры
table | таблица GtkTextTagTable | |
tag | тег GtkTextTag |
gtk_text_tag_table_lookup ()
GtkTextTag * gtk_text_tag_table_lookup (GtkTextTagTable *table,const gchar *name);
Поиск тега по имени.
Параметры
table | таблица GtkTextTagTable | |
name | имя тега |
gtk_text_tag_table_foreach ()
void gtk_text_tag_table_foreach (GtkTextTagTable *table,GtkTextTagTableForeach func,gpointer data);
Вызывает func для каждого тега в table с пользовательскими данными data. Обратите внимание, что таблицу нельзя изменять во время итерации по ней (нельзя добавлять/удалять теги).
Параметры
table | таблица GtkTextTagTable | |
func | функция, которую нужно вызвать для каждого тега. | [scope call] |
data | пользовательские данные |
gtk_text_tag_table_get_size ()
gint
gtk_text_tag_table_get_size (GtkTextTagTable *table); Возвращает размер таблицы (количество тегов)
Параметры
table | таблица GtkTextTagTable |
Возвращает
количество тегов в 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.22/GtkTextTagTable.html
