方法

GtkTreeModelref_node

已弃用:4.10 

声明 [源]

void
gtk_tree_model_ref_node (
  GtkTreeModel* tree_model,
  GtkTreeIter* iter
)

描述 [源]

允许树引用节点。

这对于模型实现来说是一个可选的方法。更具体地说,模型可以忽略此调用,因为它主要存在于性能原因。

此函数主要用作视图告知缓存模型节点何时正在显示(因此,是否要缓存该节点)的一种方式。正在显示意味着节点在一个展开的分支中,无论节点当前是否在视口中可见。例如,基于文件系统的模型不希望将整个文件层次结构保存在内存中,而只保存当前由每个当前视图显示的部分。

应期望模型能够在不考虑其引用状态的情况下获得一个迭代器。

自 4.10 版本起已弃用

请在新编写的代码中不要使用它。

参数

iter

类型: GtkTreeIter

GtkTreeIter

数据由方法的调用者所有。