方法

GtkBuilderadd_objects_from_file

声明 [src]

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

描述 [src]

解析包含 UI 定义文件的文件,仅构建请求的对象,并将它们与 builder 当前内容合并。

在出现错误时,将返回 0,并将 error 赋值为来自 GTK_BUILDER_ERROR,G_MARKUP_ERROR 或 G_FILE_ERROR 域的 GError。

如果您正在添加一个依赖于非子对象(例如,一个依赖于其 GtkTreeModel 的 GtkTreeView)的对象,则必须显式地在 object_ids 中列出所有这些对象。

参数

filename

类型: const char*

要解析的文件名。

数据由方法调用者拥有。
值是一个平台本地域符串,在 Unix 上使用操作系统首选编码,在 Windows 上使用 UTF-8。
object_ids

类型: utf8 数组的集合

要构建的对象的空终止数组。

数组必须以 NULL 结尾。
数据由方法调用者拥有。
每个元素都是一个空终止的 UTF-8 字符串。
error

类型: GError **

可恢复错误的返回位置。

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

返回值

类型: gboolean

成功返回TRUE,如果发生错误返回FALSE