方法

GtkBuilderadd_objects_from_string

声明 [源]

gboolean
gtk_builder_add_objects_from_string (
  GtkBuilder* builder,
  const char* buffer,
  gssize length,
  const char** object_ids,
  GError** error
)

描述 [源]

解析包含 UI 定义的字符串,只构建请求的对象,并将它们合并到 builder 的当前内容中。

出现错误时,将返回 FALSE,并将 error 分配给来自 GTK_BUILDER_ERRORG_MARKUP_ERROR 域的 GError

如果您正在添加一个依赖于非子对象的对象(例如,一个取决于其 GtkTreeModelGtkTreeView),您必须明确地在 object_ids 中列出所有这些对象。

参数

buffer

类型: const char*

要解析的字符串。

数据归方法调用者所有。
值是一个以 NUL 结尾的 UTF-8 字符串。
length

类型: gssize

buffer 的长度(如果 buffer 是空终止的,则可能为 -1)。

object_ids

类型:一个 utf8 的数组

要构建的对象的空终止数组。

该数组必须以 NULL 终止。
数据归方法调用者所有。
每个元素是一个以 NUL 结尾的 UTF-8 字符串。
error

类型: GError **

可恢复错误的返回位置。

该参数可以是 NULL
如果返回位置不为 NULL,那么您必须将其初始化为一个空 GError*
如果没有错误,方法将保留�始化参数为 NULL
在出现错误的情况下,将设置参数为一个新的 GError;调用者将获取数据的所有权,并负责释放它。

返回值

类型: gboolean

成功时返回TRUE,发生错误时返回FALSE。