方法
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_ERROR
或 G_MARKUP_ERROR
域的 GError
。
如果您正在添加一个依赖于非子对象的对象(例如,一个取决于其 GtkTreeModel
的 GtkTreeView
),您必须明确地在 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
;调用者将获取数据的所有权,并负责释放它。