GtkTreeStore

gtk_tree_store_new ()

GtkTreeStore *
gtk_tree_store_new (gint n_columns,
                    ...);

Создаёт новую структуру данных типа дерево со столбцами, заданными переданными типами. Обратите внимание, что поддерживаются только типы, производные от стандартных фундаментальных типов GObject.

Например, gtk_tree_store_new (3, G_TYPE_INT, G_TYPE_STRING, GDK_TYPE_PIXBUF); создаст новую GtkTreeStore с тремя столбцами типа gint, gchararray и GdkPixbuf соответственно.

gtk_tree_store_newv ()

GtkTreeStore *
gtk_tree_store_newv (gint n_columns,
                     GType *types);

Функция создания без использования переменного числа аргументов. Используется в основном для языковых библиотек.

[rename-to gtk_tree_store_new]

gtk_tree_store_set_column_types ()

void
gtk_tree_store_set_column_types (GtkTreeStore *tree_store,
                                 gint n_columns,
                                 GType *types);

Эта функция предназначена в первую очередь для GObjects, унаследованных от GtkTreeStore, и должна использоваться только при создании новой GtkTreeStore. Она не будет работать после добавления строки или вызова метода интерфейса GtkTreeModel.

gtk_tree_store_set_value ()

void
gtk_tree_store_set_value (GtkTreeStore *tree_store,
                          GtkTreeIter *iter,
                          gint column,
                          GValue *value);

Устанавливает данные в ячейке, указанной iter и column. Тип value должен быть преобразуем в тип столбца.

gtk_tree_store_set ()

void
gtk_tree_store_set (GtkTreeStore *tree_store,
                    GtkTreeIter *iter,
                    ...);

Устанавливает значение одной или нескольких ячеек в строке, на которую ссылается iter. Список аргументов должен содержать целочисленные номера столбцов, каждый номер столбца, за которым следует значение, которое нужно установить. Список завершается значением -1. Например, чтобы установить столбец 0 с типом G_TYPE_STRING на «Foo», вы бы написали gtk_tree_store_set (store, iter, 0, "Foo", -1).

Значение будет ссылаться на хранилище, если это G_TYPE_OBJECT, и будет скопировано, если это G_TYPE_STRING или G_TYPE_BOXED.

gtk_tree_store_set_valist ()

void
gtk_tree_store_set_valist (GtkTreeStore *tree_store,
                           GtkTreeIter *iter,
                           va_list var_args);

См. gtk_tree_store_set(); этот вариант принимает va_list для использования языковыми библиотеками.

gtk_tree_store_set_valuesv ()

void
gtk_tree_store_set_valuesv (GtkTreeStore *tree_store,
                            GtkTreeIter *iter,
                            gint *columns,
                            GValue *values,
                            gint n_values);

Вариант gtk_tree_store_set_valist(), который принимает столбцы и значения в виде двух массивов вместо varargs. Эта функция в основном предназначена для языковых библиотек или в случае, если количество изменяемых столбцов неизвестно до выполнения.

[rename-to gtk_tree_store_set]

С момента: 2.12

gtk_tree_store_remove ()

gboolean
gtk_tree_store_remove (GtkTreeStore *tree_store,
                       GtkTreeIter *iter);

Удаляет iter из tree_store. После удаления iter устанавливается на следующую корректную строку на том же уровне или становится некорректной, если она ранее указывала на последнюю строку.

gtk_tree_store_insert ()

void
gtk_tree_store_insert (GtkTreeStore *tree_store,
                       GtkTreeIter *iter,
                       GtkTreeIter *parent,
                       gint position);

Создаёт новую строку в position. Если родитель не NULL, то строка станет дочерней для parent. В противном случае строка будет создана на верхнем уровне. Если position равно -1 или больше, чем количество строк на этом уровне, новая строка будет вставлена в конец списка. iter будет изменено на указание на эту новую строку. Строка будет пустой после вызова этой функции. Для заполнения значений необходимо вызвать gtk_tree_store_set() или gtk_tree_store_set_value().

gtk_tree_store_insert_before ()

void
gtk_tree_store_insert_before (GtkTreeStore *tree_store,
                              GtkTreeIter *iter,
                              GtkTreeIter *parent,
                              GtkTreeIter *sibling);

Вставляет новую строку перед sibling. Если sibling равен NULL, то строка будет добавленна к дочерним элементам parent. Если parent и sibling равны NULL, то строка будет добавлена на верхний уровень. Если оба sibling и parent заданы, parent должен быть родителем sibling. Когда sibling установлен, parent необязательно.

iter будет изменено на указание на эту новую строку. Строка будет пустой после вызова этой функции. Для заполнения значений необходимо вызвать gtk_tree_store_set() или gtk_tree_store_set_value().

gtk_tree_store_insert_after ()

void
gtk_tree_store_insert_after (GtkTreeStore *tree_store,
                             GtkTreeIter *iter,
                             GtkTreeIter *parent,
                             GtkTreeIter *sibling);

Вставляет новую строку после sibling. Если sibling равен NULL, то строка будет добавлена к началу дочерних элементов parent. Если parent и sibling равны NULL, то строка будет добавлена к началу верхнего уровня. Если оба sibling и parent заданы, parent должен быть родителем sibling. Когда sibling установлен, parent необязательно.

iter будет изменено на указание на эту новую строку. Строка будет пустой после вызова этой функции. Для заполнения значений необходимо вызвать gtk_tree_store_set() или gtk_tree_store_set_value().

gtk_tree_store_insert_with_values ()

void
gtk_tree_store_insert_with_values (GtkTreeStore *tree_store,
                                   GtkTreeIter *iter,
                                   GtkTreeIter *parent,
                                   gint position,
                                   ...);

Создаёт новую строку по адресу position. iter будет изменено для указания на эту новую строку. Если position равно -1 или больше количества строк в списке, то новая строка будет добавлена в конец списка. Строка будет заполнена значениями, переданными в эту функцию.

Вызов gtk_tree_store_insert_with_values (tree_store, iter, position, ...) имеет тот же эффект, что и вызов

<object class="GtkTreeStore">
  <columns>
    <column type="gchararray"/>
    <column type="gchararray"/>
    <column type="gint"/>
  </columns>
</object>

за исключением того, что первый вызов будет излучать только сигнал row_inserted, в то время как второй вызов — row_inserted, row_changed и, если дерево упорядочено, rows_reordered. Поскольку многократное излучение сигнала rows_reordered может повлиять на производительность программы, gtk_tree_store_insert_with_values() обычно следует предпочесть при добавлении строк в упорядоченное дерево.

С: 2.10

gtk_tree_store_insert_with_valuesv ()

void
gtk_tree_store_insert_with_valuesv (GtkTreeStore *tree_store,
                                    GtkTreeIter *iter,
                                    GtkTreeIter *parent,
                                    gint position,
                                    gint *columns,
                                    GValue *values,
                                    gint n_values);

Вариант gtk_tree_store_insert_with_values(), принимающий массивы столбцов и значений вместо аргументов по умолчанию. Эта функция в основном предназначена для языковых библиотек.

[rename-to gtk_tree_store_insert_with_values]

С: 2.10

gtk_tree_store_prepend ()

void
gtk_tree_store_prepend (GtkTreeStore *tree_store,
                        GtkTreeIter *iter,
                        GtkTreeIter *parent);

Вставляет новую строку в начало tree_store. Если parent не NULL, то новая строка будет вставлена перед первым дочерним элементом parent, в противном случае — в корень. iter будет изменено для указания на эту новую строку. Строка будет пустой после вызова функции. Для заполнения значений необходимо вызвать gtk_tree_store_set() или gtk_tree_store_set_value().

gtk_tree_store_append ()

void
gtk_tree_store_append (GtkTreeStore *tree_store,
                       GtkTreeIter *iter,
                       GtkTreeIter *parent);

Добавляет новую строку в конец tree_store. Если parent не NULL, то новая строка будет добавлена после последнего дочернего элемента parent, в противном случае — в корень. iter будет изменено для указания на эту новую строку. Строка будет пустой после вызова функции. Для заполнения значений необходимо вызвать gtk_tree_store_set() или gtk_tree_store_set_value().

gtk_tree_store_is_ancestor ()

gboolean
gtk_tree_store_is_ancestor (GtkTreeStore *tree_store,
                            GtkTreeIter *iter,
                            GtkTreeIter *descendant);

Возвращает TRUE, если iter является предком descendant. То есть, iter является родителем (или прародителем, или прапрародителем) descendant.

gtk_tree_store_iter_depth ()

gint
gtk_tree_store_iter_depth (GtkTreeStore *tree_store,
                           GtkTreeIter *iter);

Возвращает глубину iter. Будет 0 для элементов на корневом уровне, 1 для элементов на уровень ниже и т. д.

gtk_tree_store_clear ()

void
gtk_tree_store_clear (GtkTreeStore *tree_store);

Удаляет все строки из tree_store

gtk_tree_store_iter_is_valid ()

gboolean
gtk_tree_store_iter_is_valid (GtkTreeStore *tree_store,
                              GtkTreeIter *iter);

ПРЕДУПРЕЖДЕНИЕ: Эта функция медленная. Используйте её только для отладки и/или тестирования.

Проверяет, является ли данный итератор допустимым для этого GtkTreeStore.

Since: 2.2

gtk_tree_store_reorder ()

void
gtk_tree_store_reorder (GtkTreeStore *tree_store,
                        GtkTreeIter *parent,
                        gint *new_order);

Переупорядочивает потомков parent в tree_store, следуя порядку, указанному в new_order. Обратите внимание, что эта функция работает только с несортированными хранилищами.

[skip]

Since: 2.2

gtk_tree_store_swap ()

void
gtk_tree_store_swap (GtkTreeStore *tree_store,
                     GtkTreeIter *a,
                     GtkTreeIter *b);

Меняет местами a и b на одном уровне tree_store. Обратите внимание, что эта функция работает только с несортированными хранилищами.

Since: 2.2

gtk_tree_store_move_before ()

void
gtk_tree_store_move_before (GtkTreeStore *tree_store,
                            GtkTreeIter *iter,
                            GtkTreeIter *position);

Перемещает iter в tree_store перед position. iter и position должны быть на одном уровне. Если position равно NULL, iter будет перемещено в конец уровня.

Since: 2.2

gtk_tree_store_move_after ()

void
gtk_tree_store_move_after (GtkTreeStore *tree_store,
                           GtkTreeIter *iter,
                           GtkTreeIter *position);

Перемещает iter в tree_store после position. iter и position должны быть на одном уровне. Если position равно NULL, iter будет перемещено в начало уровня.

Since: 2.2