gtktexttagtable

			gtk+ reference manual
top \| description \| object hierarchy \| signals

gtktexttagtable — коллекция тегов которые могут использоваться совместно

краткое описание

#include <gtk/gtk.h>


            gtktexttagtable;
void        (*gtktexttagtableforeach)       (gtktexttag *tag,
                                             gpointer data);

gtktexttagtable* gtk_text_tag_table_new     (void);
void        gtk_text_tag_table_add          (gtktexttagtable *table,
                                             gtktexttag *tag);
void        gtk_text_tag_table_remove       (gtktexttagtable *table,
                                             gtktexttag *tag);

gtktexttag* gtk_text_tag_table_lookup       (gtktexttagtable *table,
                                             const gchar *name);
void        gtk_text_tag_table_foreach      (gtktexttagtable *table,
                                             gtktexttagtableforeach func,
                                             gpointer data);

gint        gtk_text_tag_table_get_size     (gtktexttagtable *table);

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

  gobject

   +----gtktexttagtable

сигналы

"tag-added" void        user_function      (gtktexttagtable *texttagtable,
                                            gtktexttag      *arg1,
                                            gpointer         user_data)         : run last
"tag-changed"
            void        user_function      (gtktexttagtable *texttagtable,
                                            gtktexttag      *arg1,
                                            gboolean         arg2,
                                            gpointer         user_data)         : run last
"tag-removed"
            void        user_function      (gtktexttagtable *texttagtable,
                                            gtktexttag      *arg1,
                                            gpointer         user_data)         : run last

описание

для начала вы можете прочесть text widget conceptual overview который даёт краткое описание всех объектов и типов данных связанных с текстовыми виджетами и как они взаимодействуют.

детали

gtktexttagtable

typedef struct _gtktexttagtable gtktexttagtable;

gtktexttagtableforeach ()

void        (*gtktexttagtableforeach)       (gtktexttag *tag,
                                             gpointer data);

`tag` :
`data` :

gtk_text_tag_table_new ()

gtktexttagtable* gtk_text_tag_table_new     (void);

создаёт новый gtktexttagtable. по умолчанию таблица не содержит теги.

возвращает :

новый gtktexttagtable

gtk_text_tag_table_add ()

void        gtk_text_tag_table_add          (gtktexttagtable *table,
                                             gtktexttag *tag);

добавляет тег в таблицу. тег получает наивысший приоритет в таблице.

tag не должен быть уже в таблице, и не может иметь имя которое уже существует.

`table` :	gtktexttagtable
`tag` :	gtktexttag

gtk_text_tag_table_remove ()

void        gtk_text_tag_table_remove       (gtktexttagtable *table,
                                             gtktexttag *tag);

удаляет тег из таблицы. это удалит ссылку на тег в таблице, так что будьте внимательны – тег будет уничтожен если на него нет ссылки.

`table` :	gtktexttagtable
`tag` :	gtktexttag

gtk_text_tag_table_lookup ()

gtktexttag* gtk_text_tag_table_lookup       (gtktexttagtable *table,
                                             const gchar *name);

находит именованный тег.

`table` :	gtktexttagtable
`name` :	имя тега
возвращает :	тег, или `null` если такого имени в таблице нет.

gtk_text_tag_table_foreach ()

void        gtk_text_tag_table_foreach      (gtktexttagtable *table,
                                             gtktexttagtableforeach func,
                                             gpointer data);

вызывает func на каждом теге в table, с пользовательскими данными data. помните, таблица не может изменяться в течении выполнения повторений (вы не можете добавлять/удалять теги).

`table` :	gtktexttagtable
`func` :	функция вызываемая для каждого тега
`data` :	пользовательские данные

gtk_text_tag_table_get_size ()

gint        gtk_text_tag_table_get_size     (gtktexttagtable *table);

возвращает размер таблицы (количество тегов)

`table` :	gtktexttagtable
возвращает :	количество тегов в `table`

детали сигналов

сигнал "tag-added"

void        user_function                  (gtktexttagtable *texttagtable,
                                            gtktexttag      *arg1,
                                            gpointer         user_data)         : run last

`texttagtable` :	объект получающий сигнал.
`arg1` :
`user_data` :	данные пользователя устанавливаемые при подключении обработчика сигнала.

сигнал "tag-changed"

void        user_function                  (gtktexttagtable *texttagtable,
                                            gtktexttag      *arg1,
                                            gboolean         arg2,
                                            gpointer         user_data)         : run last

`texttagtable` :	объект получающий сигнал.
`arg1` :
`arg2` :
`user_data` :	данные пользователя устанавливаемые при подключении обработчика сигнала.

сигнал "tag-removed"

void        user_function                  (gtktexttagtable *texttagtable,
                                            gtktexttag      *arg1,
                                            gpointer         user_data)         : run last

`texttagtable` :	объект получающий сигнал.
`arg1` :
`user_data` :	данные пользователя устанавливаемые при подключении обработчика сигнала.