1
\alias{gtkBuilderAddObjectsFromFile}
2
\name{gtkBuilderAddObjectsFromFile}
3
\title{gtkBuilderAddObjectsFromFile}
4
\description{Parses a file containing a GtkBuilder
5
UI definition building only the requested objects and merges
6
them with the current contents of \code{builder}. }
7
\usage{gtkBuilderAddObjectsFromFile(object, filename, object.ids, .errwarn = TRUE)}
9
\item{\verb{object}}{a \code{\link{GtkBuilder}}}
10
\item{\verb{filename}}{the name of the file to parse}
11
\item{\verb{object.ids}}{array of objects to build}
12
\item{.errwarn}{Whether to issue a warning on error or fail silently}
14
\details{Upon errors 0 will be returned and \code{error} will be assigned a
15
\code{\link{GError}} from the \verb{GTK_BUILDER_ERROR}, \verb{G_MARKUP_ERROR} or \verb{G_FILE_ERROR}
17
\strong{PLEASE NOTE:} If you are adding an object that depends on an object that is not
18
its child (for instance a \code{\link{GtkTreeView}} that depends on its
19
\code{\link{GtkTreeModel}}), you have to explicitely list all of them in \code{object.ids}. Since 2.14}
21
A list containing the following elements:
22
\item{retval}{[numeric] A positive value on success, 0 if an error occurred}
23
\item{\verb{error}}{ return location for an error, or \code{NULL}. \emph{[ \acronym{allow-none} ]}}
25
\note{If you are adding an object that depends on an object that is not
26
its child (for instance a \code{\link{GtkTreeView}} that depends on its
27
\code{\link{GtkTreeModel}}), you have to explicitely list all of them in \code{object.ids}. }
28
\author{Derived by RGtkGen from GTK+ documentation}