函数

GtkTreeRowReferencenew_proxy

已弃用：4.10

声明 [src]

GtkTreeRowReference*
gtk_tree_row_reference_new_proxy (
  GObject* proxy,
  GtkTreeModel* model,
  GtkTreePath* path
)

描述 [src]

您不需要使用此函数。

根据 path 创建行引用。

此引用将一直指向由 path 指向的节点，只要它存在。如果 path 不是 model 中的有效路径，则返回 NULL。但是，与使用 gtk_tree_row_reference_new() 创建的引用不同，它不会监听模型变化。行引用的创建者必须显式使用 gtk_tree_row_reference_inserted()，gtk_tree_row_reference_deleted()，gtk_tree_row_reference_reordered() 来执行此操作。

这些函数必须在模型发出相应信号时对代理的每个代理调用一次。此单次调用更新该代理的所有行引用。由于内置的 GTK 对象例如 GtkTreeView 已在内部使用该机制，因此将它们用作代理对象会产生不可预测的结果。此外，由于内部实现的原因，将相同的对象作为 model 和 proxy 传送不起作用。

此类行引用主要用于需要仔细监控行引用何时更新的结构，通常不需要大多数应用程序。

自 4.10 版起已弃用

请勿在新的代码中使用它。

参数

proxy

类型: GObject

一个代理 GObject。

数据由函数的调用者拥有。

model

类型: GtkTreeModel

A GtkTreeModel。

数据由函数的调用者拥有。

path

类型: GtkTreePath

要监视的有效 GtkTreePath。

数据由函数的调用者拥有。

返回值

类型: GtkTreeRowReference

一个新分配的 GtkTreeRowReference。

函数的调用者拥有数据，并负责释放它。

返回值可以是 NULL。