方法
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 结尾。