GtkTreeStore

gtk_tree_store_new ()

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

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

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

gtk_tree_store_newv ()

GtkTreeStore *
gtk_tree_store_newv (int 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,
                                 int n_columns,
                                 GType *types);

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

gtk_tree_store_set_value ()

void
gtk_tree_store_set_value (GtkTreeStore *tree_store,
                          GtkTreeIter *iter,
                          int 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_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,
                            int *columns,
                            GValue *values,
                            int n_values);

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

[rename-to gtk_tree_store_set]

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,
                       int 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,
                                   int 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() следует предпочитать при вставке строк в отсортированное хранилище дерева.

gtk_tree_store_insert_with_valuesv ()

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

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

[rename-to gtk_tree_store_insert_with_values]

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 ()

int
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.

gtk_tree_store_reorder ()

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

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

[skip]

gtk_tree_store_swap ()

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

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

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 будет перемещено в конец уровня.

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 будет перемещено в начало уровня.