GtkListStore

gtk_list_store_new ()

GtkListStore *
gtk_list_store_new (gint n_columns,
                    ...);

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

Например, gtk_list_store_new (3, G_TYPE_INT, G_TYPE_STRING, GDK_TYPE_PIXBUF); создаст новый GtkListStore с тремя столбцами, соответственно, типа int, string и GdkPixbuf.

gtk_list_store_newv ()

GtkListStore *
gtk_list_store_newv (gint n_columns,
                     GType *types);

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

[rename-to gtk_list_store_new]

gtk_list_store_set_column_types ()

void
gtk_list_store_set_column_types (GtkListStore *list_store,
                                 gint n_columns,
                                 GType *types);

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

gtk_list_store_set ()

void
gtk_list_store_set (GtkListStore *list_store,
                    GtkTreeIter *iter,
                    ...);

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

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

gtk_list_store_set_valist ()

void
gtk_list_store_set_valist (GtkListStore *list_store,
                           GtkTreeIter *iter,
                           va_list var_args);

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

gtk_list_store_set_value ()

void
gtk_list_store_set_value (GtkListStore *list_store,
                          GtkTreeIter *iter,
                          gint column,
                          GValue *value);

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

gtk_list_store_set_valuesv ()

void
gtk_list_store_set_valuesv (GtkListStore *list_store,
                            GtkTreeIter *iter,
                            gint *columns,
                            GValue *values,
                            gint n_values);

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

[rename-to gtk_list_store_set]

С: 2.12

gtk_list_store_remove ()

gboolean
gtk_list_store_remove (GtkListStore *list_store,
                       GtkTreeIter *iter);

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

gtk_list_store_insert ()

void
gtk_list_store_insert (GtkListStore *list_store,
                       GtkTreeIter *iter,
                       gint position);

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

gtk_list_store_insert_before ()

void
gtk_list_store_insert_before (GtkListStore *list_store,
                              GtkTreeIter *iter,
                              GtkTreeIter *sibling);

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

gtk_list-store_insert_after ()

void
gtk_list_store_insert_after (GtkListStore *list_store,
                             GtkTreeIter *iter,
                             GtkTreeIter *sibling);

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

gtk_list_store_insert_with_values ()

void
gtk_list_store_insert_with_values (GtkListStore *list_store,
                                   GtkTreeIter *iter,
                                   gint position,
                                   ...);

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

Вызов gtk_list_store_insert_with_values (list_store, iter, position...) эквивалентен вызову

enum{
  COLUMN_STRING,
  COLUMN_INT,
  COLUMN_BOOLEAN,
  N_COLUMNS
};

{
GtkListStore*list_store;
GtkTreePath*path;
GtkTreeIter iter;
gint i;

  list_store =gtk_list_store_new(N_COLUMNS,
                                   G_TYPE_STRING,
                                   G_TYPE_INT,
                                   G_TYPE_BOOLEAN);

for(i =0; i <10; i++)
{
gchar*some_data;

      some_data =get_some_data(i);

// Add a new row to the model
gtk_list_store_append(list_store,&iter);
gtk_list_store_set(list_store,&iter,
                          COLUMN_STRING, some_data,
                          COLUMN_INT, i,
                          COLUMN_BOOLEAN,  FALSE,
-1);

// As the store will keep a copy of the string internally,
// we free some_data.
g_free(some_data);
}

// Modify a particular row
  path =gtk_tree_path_new_from_string("4");
gtk_tree_model_get_iter(GTK_TREE_MODEL(list_store),
&iter,
                           path);
gtk_tree_path_free(path);
gtk_list_store_set(list_store,&iter,
                      COLUMN_BOOLEAN, TRUE,
-1);
}

с той разницей, что первый вызов генерирует только сигнал row_inserted, в то время как второй генерирует row_inserted, row_changed и, если список отсортирован, rows_reordered. Так как многократное излучение сигнала rows_reordered может негативно повлиять на производительность программы, gtk_list_store_insert_with_values() предпочтительнее при вставке строк в отсортированный список.

Since: 2.6

gtk_list_store_insert_with_valuesv ()

void
gtk_list_store_insert_with_valuesv (GtkListStore *list_store,
                                    GtkTreeIter *iter,
                                    gint position,
                                    gint *columns,
                                    GValue *values,
                                    gint n_values);

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

С: 2.6

gtk_list_store_prepend ()

void
gtk_list_store_prepend (GtkListStore *list_store,
                        GtkTreeIter *iter);

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

gtk_list_store_append ()

void
gtk_list_store_append (GtkListStore *list_store,
                       GtkTreeIter *iter);

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

gtk_list_store_clear ()

void
gtk_list_store_clear (GtkListStore *list_store);

Удаляет все строки из списка хранилищ.

gtk_list_store_iter_is_valid ()

gboolean
gtk_list_store_iter_is_valid (GtkListStore *list_store,
                              GtkTreeIter *iter);

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

С: 2.2

gtk_list_store_reorder ()

void
gtk_list_store_reorder (GtkListStore *store,
                        gint *new_order);

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

С: 2.2

gtk_list_store_swap ()

void
gtk_list_store_swap (GtkListStore *store,
                     GtkTreeIter *a,
                     GtkTreeIter *b);

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

С: 2.2

gtk_list_store_move_before ()

void
gtk_list_store_move_before (GtkListStore *store,
                            GtkTreeIter *iter,
                            GtkTreeIter *position);

Перемещает iter в store на позицию перед position . Обратите внимание, что эта функция работает только с несортированными хранилищами. Если position равно NULL, iter будет перемещено в конец списка.

С: 2.2

gtk_list_store_move_after ()

void
gtk_list_store_move_after (GtkListStore *store,
                           GtkTreeIter *iter,
                           GtkTreeIter *position);

Перемещает iter в store на позицию после position. Обратите внимание, что эта функция работает только с неупорядоченными хранилищами. Если position является NULL, iter будет перемещено в начало списка.

Since: 2.2