方法
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,则必须将其初始化为NULLGError*。如果没有错误,方法将保留初始化为 NULL的论点。在发生错误的情况下,论点将设置为一个新的 GError;调用者将拥有数据,并负责释放它。