方法

GtkBuilderadd_from_file

声明 [源代码]

gboolean
gtk_builder_add_from_file (
  GtkBuilder* builder,
  const char* filename,
  GError** error
)

描述 [源代码]

解析包含 UI 定义的文件,并将其与当前 builder 的内容合并。

此函数在需要调用 gtk_builder_set_current_object() 添加用户数据到回调并在加载 GtkBuilder UI 之前很有用。否则,你可能希望使用 gtk_builder_new_from_file()

如果发生错误,将返回 0,并将 error 分配到从 GTK_BUILDER_ERRORG_MARKUP_ERRORG_FILE_ERROR 域分配的 GError

尝试处理此调用的失败并不合理。你不应该使用此功能处理未经验证的文件(即:不是你的应用程序部分的文件)。损坏的 GtkBuilder 文件可能会轻松地使你的程序崩溃,并且在导致失败之前可能会泄漏内存。当检测到错误时,唯一合理的事情是调用 g_error()

参数

filename

类型: const char*

要解析的文件名。

数据由方法的调用者拥有。
值是一个平台本机字符串,在 Unix 上使用首选的 OS 编码,在 Windows 上使用 UTF-8。
error

类型: GError **

恢复性错误的返回位置。

该论点可以是 NULL
如果返回位置不是 NULL,则必须将其初始化为 NULL GError*
如果没有错误,方法将保留初始化为 NULL 的论点。
在发生错误的情况下,论点将设置为一个新的 GError;调用者将拥有数据,并负责释放它。

返回值

类型: gboolean

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