方法

声明 [源]

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

描述 [源]

解析包含 UI 定义的字符串并将其与当前的内容合并到 builder 中。

该函数在有需要调用 gtk_builder_set_current_object() 以添加用户数据到回调函数，并在加载 GtkBuilder UI 之前时很有用。否则，你可能想使用 gtk_builder_new_from_string()。

当出现错误时，将返回 FALSE，并将 error 赋值为来自 GTK_BUILDER_ERROR、G_MARKUP_ERROR 或 G_VARIANT_PARSE_ERROR 域的 GError。

尝试处理此调用的失败并不是一个合理的做法。当检测到错误时，唯一合理的事情是调用 g_error()。

参数

buffer

类型： const char*

要解析的字符串。

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

类型： gssize

buffer 的长度（如果 buffer 以 NUL 结尾，则可能为 -1）。

error

类型： 

一个可恢复错误的返回位置。

该参数可以是 NULL。
如果返回位置不是 NULL，那么必须将其初始化为一个 NULL 的 GError*。
如果没有错误，方法将通过该参数将值初始化为 NULL。
如果在错误情况下，该参数将被设置为一个新的 GError；调用者将获取数据的所有权，并负责释放它。

返回值

类型: gboolean

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