方法

GtkTreeStoreinsert_with_values

已弃用:4.10 

声明 [src]

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

描述 [src]

在指定位置创建一个新的行。

iter 参数将被更改以指向这个新行。

如果 position 为 -1 或大于列表中的行数,则新行将追加到列表中。行将使用此函数提供的值填充。

调用

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

自 4.10 版本起已弃用

使用 GtkTreeListModel 代替。

此方法对语言绑定不可直接使用。

此方法的实现由语言绑定中的 gtk_tree_store_insert_with_valuesv() 提供。

参数

iter

类型: GtkTreeIter

要设置的未设置的新行的 GtkTreeIter

此参数将由函数设置。
此参数可以是 NULL
返回的数据归实例所有。
parent

类型: GtkTreeIter

有效的 GtkTreeIter

此参数可以是 NULL
数据由方法调用者所有。
position

类型: int

插入新行时使用的位置,或 -1 以将新行追加到现有行之后。

...

类型: 

列号和值的配对,以 -1 结尾。