方法
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_ERROR
、G_MARKUP_ERROR
或 G_FILE_ERROR
域分配的 GError
。
尝试处理此调用的失败并不合理。你不应该使用此功能处理未经验证的文件(即:不是你的应用程序部分的文件)。损坏的 GtkBuilder
文件可能会轻松地使你的程序崩溃,并且在导致失败之前可能会泄漏内存。当检测到错误时,唯一合理的事情是调用 g_error()
。
参数
filename
-
类型:
const char*
要解析的文件名。
数据由方法的调用者拥有。 值是一个平台本机字符串,在 Unix 上使用首选的 OS 编码,在 Windows 上使用 UTF-8。 error
-
类型:
GError **
恢复性错误的返回位置。
该论点可以是 NULL
。如果返回位置不是 NULL
,则必须将其初始化为NULL
GError*
。如果没有错误,方法将保留初始化为 NULL
的论点。在发生错误的情况下,论点将设置为一个新的 GError
;调用者将拥有数据,并负责释放它。