方法

GtkListBoxbind_model

声明 [src]

void
gtk_list_box_bind_model (
  GtkListBox* box,
  GListModel* model,
  GtkListBoxCreateWidgetFunc create_widget_func,
  gpointer user_data,
  GDestroyNotify user_data_free_func
)

描述 [src]

将 model 绑定到 box。

如果 box 已经与一个模型绑定，那么之前的绑定会被销毁。

清除 box 的内容，然后用表示 model 中项的控件填充。每当 model 发生变化时，都会更新 box。如果 model 为 NULL，则 box 将保持为空。

当 box 绑定到模型时，直接添加或删除控件（例如，使用 gtk_list_box_insert()）是不确定的。

注意，使用模型与 GtkListBox 中的过滤和排序功能不兼容。当使用模型时，过滤和排序应由模型实现。

参数

model

类型: GObject

要绑定到 box 的 GListModel。

该参数可以是 NULL。

数据由方法调用者所有。

create_widget_func

类型: GtkListBoxCreateWidgetFunc

一个用于为项或 NULL 创建控件的函数，如果你还传递了 NULL 作为 model。

该参数可以是 NULL。

user_data

类型: gpointer

传递给 create_widget_func 的用户数据。

该参数可以是 NULL。

数据由方法调用者所有。

user_data_free_func

类型: GDestroyNotify

用于释放 user_data 的函数。