Method
GtkBuilderadd_objects_from_string
Declaration [src]
gboolean
gtk_builder_add_objects_from_string (
GtkBuilder* builder,
const char* buffer,
gssize length,
const char** object_ids,
GError** error
)
Description [src]
Parses a string containing a UI definition, building only the
requested objects and merges them with the current contents of
builder
.
Upon errors FALSE
will be returned and error
will be assigned a
GError
from the GTK_BUILDER_ERROR
or G_MARKUP_ERROR
domain.
If you are adding an object that depends on an object that is not
its child (for instance a GtkTreeView
that depends on its
GtkTreeModel
), you have to explicitly list all of them in object_ids
.
Parameters
buffer
-
Type:
const char*
The string to parse.
The data is owned by the caller of the function. The value is a NUL terminated UTF-8 string. length
-
Type:
gssize
The length of
buffer
(may be -1 ifbuffer
is nul-terminated) object_ids
-
Type: An array of
utf8
Nul-terminated array of objects to build.
The array must be NULL
-terminated.The data is owned by the caller of the function. Each element is a NUL terminated UTF-8 string. error
-
Type:
GError **
The return location for an error.
The argument can be NULL
.The argument will be set to NULL
by the function if there are no errors.In case of error, the argument will be set and the caller will take ownership of the data, and be responsible for freeing it.