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

Эта функция предназначена в первую очередь для GObject, унаследованных от 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]

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

С: 2.2