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

#include <gtk/gtk.h>


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

gtktreestore* gtk_tree_store_newv           (gint n_columns,
                                             gtype *types);
void        gtk_tree_store_set_column_types (gtktreestore *tree_store,
                                             gint n_columns,
                                             gtype *types);
void        gtk_tree_store_set_value        (gtktreestore *tree_store,
                                             gtktreeiter *iter,
                                             gint column,
                                             gvalue *value);
void        gtk_tree_store_set              (gtktreestore *tree_store,
                                             gtktreeiter *iter,
                                             ...);
void        gtk_tree_store_set_valist       (gtktreestore *tree_store,
                                             gtktreeiter *iter,
                                             va_list var_args);

gboolean    gtk_tree_store_remove           (gtktreestore *tree_store,
                                             gtktreeiter *iter);
void        gtk_tree_store_insert           (gtktreestore *tree_store,
                                             gtktreeiter *iter,
                                             gtktreeiter *parent,
                                             gint position);
void        gtk_tree_store_insert_before    (gtktreestore *tree_store,
                                             gtktreeiter *iter,
                                             gtktreeiter *parent,
                                             gtktreeiter *sibling);
void        gtk_tree_store_insert_after     (gtktreestore *tree_store,
                                             gtktreeiter *iter,
                                             gtktreeiter *parent,
                                             gtktreeiter *sibling);
void        gtk_tree_store_insert_with_values

                                            (gtktreestore *tree_store,
                                             gtktreeiter *iter,
                                             gtktreeiter *parent,
                                             gint position,
                                             ...);
void        gtk_tree_store_insert_with_valuesv
                                            (gtktreestore *tree_store,
                                             gtktreeiter *iter,
                                             gtktreeiter *parent,
                                             gint position,
                                             gint *columns,
                                             gvalue *values,
                                             gint n_values);
void        gtk_tree_store_prepend          (gtktreestore *tree_store,
                                             gtktreeiter *iter,
                                             gtktreeiter *parent);
void        gtk_tree_store_append           (gtktreestore *tree_store,
                                             gtktreeiter *iter,
                                             gtktreeiter *parent);

gboolean    gtk_tree_store_is_ancestor      (gtktreestore *tree_store,
                                             gtktreeiter *iter,
                                             gtktreeiter *descendant);
gint        gtk_tree_store_iter_depth       (gtktreestore *tree_store,
                                             gtktreeiter *iter);
void        gtk_tree_store_clear            (gtktreestore *tree_store);

gboolean    gtk_tree_store_iter_is_valid    (gtktreestore *tree_store,
                                             gtktreeiter *iter);
void        gtk_tree_store_reorder          (gtktreestore *tree_store,
                                             gtktreeiter *parent,
                                             gint *new_order);
void        gtk_tree_store_swap             (gtktreestore *tree_store,
                                             gtktreeiter *a,
                                             gtktreeiter *b);
void        gtk_tree_store_move_before      (gtktreestore *tree_store,
                                             gtktreeiter *iter,
                                             gtktreeiter *position);
void        gtk_tree_store_move_after       (gtktreestore *tree_store,
                                             gtktreeiter *iter,
                                             gtktreeiter *position);

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

  gobject
   +----gtktreestore

осуществляемые интерфейсы

gtktreestore осуществляет gtktreemodel, gtktreedragsource, gtktreedragdest и gtktreesortable.

описание

объект gtktreestore это модель списка используемая с виджетом gtktreeview. он реализует интерфейс gtktreemodel, и логически может использовать все методы доступные в нем. он также реализует интерфейс gtktreesortable поэтому может быть отсортирован. наконец, он реализует интерфейс drag and drop.

детали

gtktreestore

typedef struct _gtktreestore gtktreestore;

gtk_tree_store_new ()

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

создаёт новое дерево хранения с n_columns столбцов для каждого из которых помещается тип. помните, поддерживаются только стандартные фундаментальные типы gobject.

например, gtk_tree_store_new (3, g_type_int, g_type_string, gdk_type_pixbuf); создаст новый gtktreestore с деревом столбцов, типов int, string и gdkpixbuf соответственно.

gtk_tree_store_newv ()

gtktreestore* gtk_tree_store_newv           (gint n_columns,
                                             gtype *types);

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

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

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_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 больше чем количество строк в уровне, то новая строка вставляется в конец списка. 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 's. если 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 's. если 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 больше чем количество строк в списке, то новая строка добавляется к списку. строка будет заполнена значениями полученных из этой функции.

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

gtk_tree_store_insert (tree_store, iter, position);
gtk_tree_store_set (tree_store, iter, ...);

разница с предыдущим только в издании сигнала 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() которая принимает столбцы и значения как два массива, вместо переменного списка аргументов. эта функция в основном применяется для языковых привязок.

начиная с версии 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.

начиная с версии 2.2

gtk_tree_store_reorder ()

void        gtk_tree_store_reorder          (gtktreestore *tree_store,
                                             gtktreeiter *parent,
                                             gint *new_order);

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

начиная с версии 2.2

gtk_tree_store_swap ()

void        gtk_tree_store_swap             (gtktreestore *tree_store,
                                             gtktreeiter *a,
                                             gtktreeiter *b);

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

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

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

начиная с версии 2.2

смотрите также

gtktreemodel, gtktreestore