<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>gtkmm: Gtk::Builder Class Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.3 -->
<div id="top">
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td style="padding-left: 0.5em;">
<div id="projectname">gtkmm <span id="projectnumber">2.24.4</span></div>
</td>
</tr>
</tbody>
</table>
</div>
<div id="navrow1" class="tabs">
<ul class="tablist">
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="pages.html"><span>Related Pages</span></a></li>
<li><a href="modules.html"><span>Modules</span></a></li>
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
<li class="current"><a href="annotated.html"><span>Classes</span></a></li>
</ul>
</div>
<div id="navrow2" class="tabs2">
<ul class="tablist">
<li><a href="annotated.html"><span>Class List</span></a></li>
<li><a href="classes.html"><span>Class Index</span></a></li>
<li><a href="inherits.html"><span>Class Hierarchy</span></a></li>
<li><a href="functions.html"><span>Class Members</span></a></li>
</ul>
</div>
<div id="nav-path" class="navpath">
<ul>
<li class="navelem"><a class="el" href="namespaceGtk.html">Gtk</a> </li>
<li class="navelem"><a class="el" href="classGtk_1_1Builder.html">Builder</a> </li>
</ul>
</div>
</div>
<div class="header">
<div class="summary">
<a href="#pub-methods">Public Member Functions</a> |
<a href="#pub-static-methods">Static Public Member Functions</a> |
<a href="#pro-methods">Protected Member Functions</a> |
<a href="#related">Related Functions</a> </div>
<div class="headertitle">
<h1>Gtk::Builder Class Reference</h1> </div>
</div>
<div class="contents">
<!-- doxytag: class="Gtk::Builder" --><!-- doxytag: inherits="Glib::Object" -->
<p>Build an interface from a UI definition description. <a href="#_details">More...</a></p>
<div class="dynheader">
Inheritance diagram for Gtk::Builder:</div>
<div class="dyncontent">
<div class="center"><img src="classGtk_1_1Builder__inherit__graph.png" border="0" usemap="#Gtk_1_1Builder_inherit__map" alt="Inheritance graph"/></div>
<map name="Gtk_1_1Builder_inherit__map" id="Gtk_1_1Builder_inherit__map">
<area shape="rect" id="node2" href="../../../glibmm-2.4/reference/html/classGlib_1_1Object.html" title="Glib::Object" alt="" coords="21,160,115,189"/><area shape="rect" id="node4" href="../../../glibmm-2.4/reference/html/classGlib_1_1ObjectBase.html" title="Glib::ObjectBase" alt="" coords="5,83,131,112"/><area shape="rect" id="node6" href="../../../libsigc++-2.0/reference/html/structsigc_1_1trackable.html" title="sigc::trackable" alt="" coords="11,5,125,35"/></map>
<center><span class="legend">[<a href="graph_legend.html">legend</a>]</span></center></div>
<div class="dynheader">
Collaboration diagram for Gtk::Builder:</div>
<div class="dyncontent">
<div class="center"><img src="classGtk_1_1Builder__coll__graph.png" border="0" usemap="#Gtk_1_1Builder_coll__map" alt="Collaboration graph"/></div>
<map name="Gtk_1_1Builder_coll__map" id="Gtk_1_1Builder_coll__map">
<area shape="rect" id="node2" href="../../../glibmm-2.4/reference/html/classGlib_1_1Object.html" title="Glib::Object" alt="" coords="21,160,115,189"/><area shape="rect" id="node4" href="../../../glibmm-2.4/reference/html/classGlib_1_1ObjectBase.html" title="Glib::ObjectBase" alt="" coords="5,83,131,112"/><area shape="rect" id="node6" href="../../../libsigc++-2.0/reference/html/structsigc_1_1trackable.html" title="sigc::trackable" alt="" coords="11,5,125,35"/></map>
<center><span class="legend">[<a href="graph_legend.html">legend</a>]</span></center></div>
<p><a href="classGtk_1_1Builder-members.html">List of all members.</a></p>
<table class="memberdecls">
<tr><td colspan="2"><h2><a name="pub-methods"></a>
Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Builder.html#aff47bcf93d49acef9de2c697774cd53b">~Builder</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">GtkBuilder* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Builder.html#a16ab17cd36e636c3f1495ca2ef2a4f49">gobj</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C GObject. <a href="#a16ab17cd36e636c3f1495ca2ef2a4f49"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const GtkBuilder* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Builder.html#a0d39f2751484ec95216add8f6629cc7d">gobj</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C GObject. <a href="#a0d39f2751484ec95216add8f6629cc7d"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">GtkBuilder* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Builder.html#a43185cdda8ad880fab2b3a9a2c1332d6">gobj_copy</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. <a href="#a43185cdda8ad880fab2b3a9a2c1332d6"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Builder.html#aa3f4af4e7eaf7861c8283dc0dbd5254c">add_from_file</a> (const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a>& filename)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Parses a file containing a GtkBuilder UI definition, and merges it with the current contents of the builder. <a href="#aa3f4af4e7eaf7861c8283dc0dbd5254c"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Builder.html#a80771efbfbe5bbc053e8deee93e1e118">add_from_file</a> (const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a>& filename, const char* object_id)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Parses a file containing a GtkBuilder UI definition, building only the requested object, and merges it with the current contents of the builder. <a href="#a80771efbfbe5bbc053e8deee93e1e118"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Builder.html#a1f9c1e96d66b561bf63df23a32561f9f">add_from_file</a> (const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a>& filename, const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>& object_id)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Parses a file containing a GtkBuilder UI definition, building only the requested object, and merges it with the current contents of the builder. <a href="#a1f9c1e96d66b561bf63df23a32561f9f"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Builder.html#aec111515605a74e40b0eb380043a31f6">add_from_file</a> (const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a>& filename, const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ArrayHandle.html">Glib::StringArrayHandle</a>& object_ids)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Parses a file containing a. <a href="#aec111515605a74e40b0eb380043a31f6"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Builder.html#ae3520ee31a98ac30b728f93522de8df5">add_from_string</a> (const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>& buffer)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Parses a string containing a GtkBuilder UI definition and merges it with the current contents of the builder. <a href="#ae3520ee31a98ac30b728f93522de8df5"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Builder.html#aac7d6c42f7a53f8be084841948b157d0">add_from_string</a> (const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>& buffer, const char* object_id)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Parses a string containing a GtkBuilder UI definition, building only the requested object, and merges it with the current contents of the builder. <a href="#aac7d6c42f7a53f8be084841948b157d0"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Builder.html#a4fa5d22555a5e0f6e532685fde688734">add_from_string</a> (const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>& buffer, const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>& object_id)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Parses a string containing a GtkBuilder UI definition, building only the requested object, and merges it with the current contents of the builder. <a href="#a4fa5d22555a5e0f6e532685fde688734"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Builder.html#a7951e1af21938530adccc92a0d00b453">add_from_string</a> (const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>& buffer, const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ArrayHandle.html">Glib::StringArrayHandle</a>& object_ids)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Parses a string containing a GtkBuilder UI definition, building only the requested objects, and merges it with the current contents of the builder. <a href="#a7951e1af21938530adccc92a0d00b453"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Builder.html#ab8c6679c1296d6c4d8590ef907de4d5a">add_from_string</a> (const char* buffer, gsize length)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Parses a string containing a GtkBuilder UI definition and merges it with the current contents of the builder. <a href="#ab8c6679c1296d6c4d8590ef907de4d5a"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1Object.html">Glib::Object</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Builder.html#a2e2dfd63721cf7dd648e262ed6630f0c">get_object</a> (const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>& name)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the object named <em>name</em>. <a href="#a2e2dfd63721cf7dd648e262ed6630f0c"></a><br/></td></tr>
<tr><td class="memTemplParams" colspan="2">template<class T_Widget > </td></tr>
<tr><td class="memTemplItemLeft" align="right" valign="top">void </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="classGtk_1_1Builder.html#a6604abee829e66e0d5d97072227e7cd3">get_widget</a> (const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>& name, T_Widget*& widget)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get a widget from the <a class="el" href="classGtk_1_1Builder.html" title="Build an interface from a UI definition description.">Builder</a> file. <a href="#a6604abee829e66e0d5d97072227e7cd3"></a><br/></td></tr>
<tr><td class="memTemplParams" colspan="2">template<class T_Widget > </td></tr>
<tr><td class="memTemplItemLeft" align="right" valign="top">void </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="classGtk_1_1Builder.html#a945dbd52e16b13a3c46809572e5a2877">get_widget_derived</a> (const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>& name, T_Widget*& widget)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">This provides a pointer to a widget whose details are specified in the GtkBuilder file, but which is implemented by your own derived class. <a href="#a945dbd52e16b13a3c46809572e5a2877"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Builder.html#a9f696bcf8d214f38d61d0d558d641245">set_translation_domain</a> (const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>& domain)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the translation domain of <em>builder</em>. <a href="#a9f696bcf8d214f38d61d0d558d641245"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Builder.html#a15fbbeccac6df2f40343a688a3ab7257">get_translation_domain</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the translation domain of <em>builder</em>. <a href="#a15fbbeccac6df2f40343a688a3ab7257"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a><br class="typebreak"/>
< <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Builder.html#a9af6cfd8a039d34e0eb134e782027242">property_translation_domain</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">The translation domain used by gettext. <a href="#a9af6cfd8a039d34e0eb134e782027242"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><br class="typebreak"/>
< <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Builder.html#a4641c283b6979640541cd651f0c56a7b">property_translation_domain</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">The translation domain used by gettext. <a href="#a4641c283b6979640541cd651f0c56a7b"></a><br/></td></tr>
<tr><td colspan="2"><h2><a name="pub-static-methods"></a>
Static Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGtk_1_1Builder.html">Builder</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Builder.html#a3e7bd7f95c1ea1f06b4c2c16458403ce">create</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Creates a new builder object. <a href="#a3e7bd7f95c1ea1f06b4c2c16458403ce"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGtk_1_1Builder.html">Builder</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Builder.html#a6c5ea61bdb933606650e7f437d544edd">create_from_file</a> (const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a>& filename)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Parses a file containing a GtkBuilder UI definition. <a href="#a6c5ea61bdb933606650e7f437d544edd"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGtk_1_1Builder.html">Builder</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Builder.html#ae851b019aeb1b8c0891be99ece184146">create_from_file</a> (const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a>& filename, const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>& object_id)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Parses a file containing a GtkBuilder UI definition, building only the requested object. <a href="#ae851b019aeb1b8c0891be99ece184146"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGtk_1_1Builder.html">Builder</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Builder.html#a85a5dbb75e4d2fbdcfee52870eb582f0">create_from_file</a> (const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a>& filename, const char* object_id)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Parses a file containing a GtkBuilder UI definition, building only the requested object. <a href="#a85a5dbb75e4d2fbdcfee52870eb582f0"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGtk_1_1Builder.html">Builder</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Builder.html#a1e6af5278b9f522c28c341bea9fc277d">create_from_file</a> (const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a>& filename, const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ArrayHandle.html">Glib::StringArrayHandle</a>& object_ids)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Parses a file containing a GtkBuilder UI definition, building only the requested objects. <a href="#a1e6af5278b9f522c28c341bea9fc277d"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGtk_1_1Builder.html">Builder</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Builder.html#a05f80c899de87e17683af6e5efcb4b41">create_from_string</a> (const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>& buffer)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Parses a string containing a GtkBuilder UI definition. <a href="#a05f80c899de87e17683af6e5efcb4b41"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGtk_1_1Builder.html">Builder</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Builder.html#abba4d2c8c9eca2663137611854423f3f">create_from_string</a> (const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>& buffer, const char* object_id)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Parses a string containing a GtkBuilder UI definition building only the requested object. <a href="#abba4d2c8c9eca2663137611854423f3f"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGtk_1_1Builder.html">Builder</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Builder.html#a500d841b1e8c9b25034ed24625076227">create_from_string</a> (const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>& buffer, const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>& object_id)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Parses a string containing a GtkBuilder UI definition building only the requested object. <a href="#a500d841b1e8c9b25034ed24625076227"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGtk_1_1Builder.html">Builder</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Builder.html#a8b54b4062bc296969c08a859155f35e4">create_from_string</a> (const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>& buffer, const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ArrayHandle.html">Glib::StringArrayHandle</a>& object_ids)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Parses a string containing a GtkBuilder UI definition building only the requested objects. <a href="#a8b54b4062bc296969c08a859155f35e4"></a><br/></td></tr>
<tr><td colspan="2"><h2><a name="pro-methods"></a>
Protected Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Builder.html#a0ba100f27aca463391d4399f6f1880ab">Builder</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classGtk_1_1Widget.html">Gtk::Widget</a>* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Builder.html#aff746219ab6618caab01984c57ee0161">get_widget_checked</a> (const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>& name, GType <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01173.html#ga2c2933c16c723af4d77eb939438617ca">type</a>)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">GtkWidget* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Builder.html#a94c23a6163a95da0cb5184dcf2544d4a">get_cwidget</a> (const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>& name)</td></tr>
<tr><td colspan="2"><h2><a name="related"></a>
Related Functions</h2></td></tr>
<tr><td colspan="2">(Note that these are not member functions.) <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGtk_1_1Builder.html">Gtk::Builder</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Builder.html#a0eed615bfe0b8ce06257406172956946">wrap</a> (GtkBuilder* object, bool take_copy=false)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">A <a class="elRef" href="../../../glibmm-2.4/reference/html/namespaceGlib.html#a671306f4a3a0cae5ab4d7a9d54886592">Glib::wrap()</a> method for this object. <a href="#a0eed615bfe0b8ce06257406172956946"></a><br/></td></tr>
</table>
<hr/><a name="_details"></a><h2>Detailed Description</h2>
<div class="textblock"><p>Build an interface from a UI definition description. </p>
<p>This object represents an `instantiation' of an UI definition description. When one of these objects is created, the XML file is read, and the interface is created. The <a class="el" href="classGtk_1_1Builder.html" title="Build an interface from a UI definition description.">Gtk::Builder</a> object then provides an interface for accessing the widgets in the interface by the names assigned to them inside the UI description.</p>
<dl class="since_2_12"><dt><b><a class="el" href="since_2_12.html#_since_2_12000020">Since gtkmm 2.12:</a></b></dt><dd></dd></dl>
</div><hr/><h2>Constructor & Destructor Documentation</h2>
<a class="anchor" id="aff47bcf93d49acef9de2c697774cd53b"></a><!-- doxytag: member="Gtk::Builder::~Builder" ref="aff47bcf93d49acef9de2c697774cd53b" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual Gtk::Builder::~Builder </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
</div>
</div>
<a class="anchor" id="a0ba100f27aca463391d4399f6f1880ab"></a><!-- doxytag: member="Gtk::Builder::Builder" ref="a0ba100f27aca463391d4399f6f1880ab" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">Gtk::Builder::Builder </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td><code> [protected]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
</div>
</div>
<hr/><h2>Member Function Documentation</h2>
<a class="anchor" id="aa3f4af4e7eaf7861c8283dc0dbd5254c"></a><!-- doxytag: member="Gtk::Builder::add_from_file" ref="aa3f4af4e7eaf7861c8283dc0dbd5254c" args="(const std::string &filename)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Gtk::Builder::add_from_file </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td>
<td class="paramname"><em>filename</em></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Parses a file containing a GtkBuilder UI definition, and merges it with the current contents of the builder. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">buffer</td><td>The file to parse. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>true on success or false if an error occurred. </dd></dl>
<dl><dt><b>Exceptions:</b></dt><dd>
<table class="exception">
<tr><td class="paramname"><a class="el" href="classGtk_1_1BuilderError.html" title="Exception class for Gdk::Builder errors.">BuilderError</a>,<a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1MarkupError.html">Glib::MarkupError</a>,<a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1MarkupError.html">Glib::MarkupError</a></td><td></td></tr>
</table>
</dd>
</dl>
<dl class="since_2_14"><dt><b><a class="el" href="since_2_14.html#_since_2_14000031">Since gtkmm 2.14:</a></b></dt><dd></dd></dl>
</div>
</div>
<a class="anchor" id="aec111515605a74e40b0eb380043a31f6"></a><!-- doxytag: member="Gtk::Builder::add_from_file" ref="aec111515605a74e40b0eb380043a31f6" args="(const std::string &filename, const Glib::StringArrayHandle &object_ids)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Gtk::Builder::add_from_file </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td>
<td class="paramname"><em>filename</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ArrayHandle.html">Glib::StringArrayHandle</a> & </td>
<td class="paramname"><em>object_ids</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Parses a file containing a. </p>
<dl class="since_2_14"><dt><b><a class="el" href="since_2_14.html#_since_2_14000033">Since gtkmm 2.14:</a></b></dt><dd></dd></dl>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">filename</td><td>The name of the file to parse. </td></tr>
<tr><td class="paramname">object_ids</td><td>Nul-terminated array of objects to build. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A positive value on success, 0 if an error occurred. </dd></dl>
</div>
</div>
<a class="anchor" id="a80771efbfbe5bbc053e8deee93e1e118"></a><!-- doxytag: member="Gtk::Builder::add_from_file" ref="a80771efbfbe5bbc053e8deee93e1e118" args="(const std::string &filename, const char *object_id)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Gtk::Builder::add_from_file </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td>
<td class="paramname"><em>filename</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>object_id</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Parses a file containing a GtkBuilder UI definition, building only the requested object, and merges it with the current contents of the builder. </p>
<p>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 explicitely list all of them.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">buffer</td><td>The file to parse. </td></tr>
<tr><td class="paramname">The</td><td>object to build. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>true on success or false if an error occurred. </dd></dl>
<dl><dt><b>Exceptions:</b></dt><dd>
<table class="exception">
<tr><td class="paramname"><a class="el" href="classGtk_1_1BuilderError.html" title="Exception class for Gdk::Builder errors.">BuilderError</a>,<a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1MarkupError.html">Glib::MarkupError</a>,<a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1MarkupError.html">Glib::MarkupError</a></td><td></td></tr>
</table>
</dd>
</dl>
<dl class="since_2_16"><dt><b><a class="el" href="since_2_16.html#_since_2_16000033">Since gtkmm 2.16:</a></b></dt><dd></dd></dl>
</div>
</div>
<a class="anchor" id="a1f9c1e96d66b561bf63df23a32561f9f"></a><!-- doxytag: member="Gtk::Builder::add_from_file" ref="a1f9c1e96d66b561bf63df23a32561f9f" args="(const std::string &filename, const Glib::ustring &object_id)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Gtk::Builder::add_from_file </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td>
<td class="paramname"><em>filename</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td>
<td class="paramname"><em>object_id</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Parses a file containing a GtkBuilder UI definition, building only the requested object, and merges it with the current contents of the builder. </p>
<p>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 explicitely list all of them.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">buffer</td><td>The file to parse. </td></tr>
<tr><td class="paramname">The</td><td>object to build. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>true on success or false if an error occurred. </dd></dl>
<dl><dt><b>Exceptions:</b></dt><dd>
<table class="exception">
<tr><td class="paramname"><a class="el" href="classGtk_1_1BuilderError.html" title="Exception class for Gdk::Builder errors.">BuilderError</a>,<a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1MarkupError.html">Glib::MarkupError</a>,<a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1MarkupError.html">Glib::MarkupError</a></td><td></td></tr>
</table>
</dd>
</dl>
<dl class="since_2_14"><dt><b><a class="el" href="since_2_14.html#_since_2_14000032">Since gtkmm 2.14:</a></b></dt><dd></dd></dl>
</div>
</div>
<a class="anchor" id="ae3520ee31a98ac30b728f93522de8df5"></a><!-- doxytag: member="Gtk::Builder::add_from_string" ref="ae3520ee31a98ac30b728f93522de8df5" args="(const Glib::ustring &buffer)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Gtk::Builder::add_from_string </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td>
<td class="paramname"><em>buffer</em></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Parses a string containing a GtkBuilder UI definition and merges it with the current contents of the builder. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">buffer</td><td>The string to parse. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>true on success or false if an error occurred. </dd></dl>
<dl><dt><b>Exceptions:</b></dt><dd>
<table class="exception">
<tr><td class="paramname"><a class="el" href="classGtk_1_1BuilderError.html" title="Exception class for Gdk::Builder errors.">BuilderError</a>,<a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1MarkupError.html">Glib::MarkupError</a></td><td></td></tr>
</table>
</dd>
</dl>
<dl class="since_2_12"><dt><b><a class="el" href="since_2_12.html#_since_2_12000023">Since gtkmm 2.12:</a></b></dt><dd></dd></dl>
</div>
</div>
<a class="anchor" id="aac7d6c42f7a53f8be084841948b157d0"></a><!-- doxytag: member="Gtk::Builder::add_from_string" ref="aac7d6c42f7a53f8be084841948b157d0" args="(const Glib::ustring &buffer, const char *object_id)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Gtk::Builder::add_from_string </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td>
<td class="paramname"><em>buffer</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>object_id</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Parses a string containing a GtkBuilder UI definition, building only the requested object, and merges it with the current contents of the builder. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">buffer</td><td>The string to parse. </td></tr>
<tr><td class="paramname">The</td><td>object to build. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>true on success or false if an error occurred. </dd></dl>
<dl><dt><b>Exceptions:</b></dt><dd>
<table class="exception">
<tr><td class="paramname"><a class="el" href="classGtk_1_1BuilderError.html" title="Exception class for Gdk::Builder errors.">BuilderError</a>,<a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1MarkupError.html">Glib::MarkupError</a></td><td></td></tr>
</table>
</dd>
</dl>
<dl class="since_2_16"><dt><b><a class="el" href="since_2_16.html#_since_2_16000034">Since gtkmm 2.16:</a></b></dt><dd></dd></dl>
</div>
</div>
<a class="anchor" id="a4fa5d22555a5e0f6e532685fde688734"></a><!-- doxytag: member="Gtk::Builder::add_from_string" ref="a4fa5d22555a5e0f6e532685fde688734" args="(const Glib::ustring &buffer, const Glib::ustring &object_id)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Gtk::Builder::add_from_string </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td>
<td class="paramname"><em>buffer</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td>
<td class="paramname"><em>object_id</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Parses a string containing a GtkBuilder UI definition, building only the requested object, and merges it with the current contents of the builder. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">buffer</td><td>The string to parse. </td></tr>
<tr><td class="paramname">The</td><td>object to build. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>true on success or false if an error occurred. </dd></dl>
<dl><dt><b>Exceptions:</b></dt><dd>
<table class="exception">
<tr><td class="paramname"><a class="el" href="classGtk_1_1BuilderError.html" title="Exception class for Gdk::Builder errors.">BuilderError</a>,<a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1MarkupError.html">Glib::MarkupError</a></td><td></td></tr>
</table>
</dd>
</dl>
<dl class="since_2_14"><dt><b><a class="el" href="since_2_14.html#_since_2_14000034">Since gtkmm 2.14:</a></b></dt><dd></dd></dl>
</div>
</div>
<a class="anchor" id="a7951e1af21938530adccc92a0d00b453"></a><!-- doxytag: member="Gtk::Builder::add_from_string" ref="a7951e1af21938530adccc92a0d00b453" args="(const Glib::ustring &buffer, const Glib::StringArrayHandle &object_ids)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Gtk::Builder::add_from_string </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td>
<td class="paramname"><em>buffer</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ArrayHandle.html">Glib::StringArrayHandle</a> & </td>
<td class="paramname"><em>object_ids</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Parses a string containing a GtkBuilder UI definition, building only the requested objects, and merges it with the current contents of the builder. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">buffer</td><td>The string to parse. </td></tr>
<tr><td class="paramname">The</td><td>objects to build. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>true on success or false if an error occurred. </dd></dl>
<dl><dt><b>Exceptions:</b></dt><dd>
<table class="exception">
<tr><td class="paramname"><a class="el" href="classGtk_1_1BuilderError.html" title="Exception class for Gdk::Builder errors.">BuilderError</a>,<a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1MarkupError.html">Glib::MarkupError</a></td><td></td></tr>
</table>
</dd>
</dl>
<dl class="since_2_14"><dt><b><a class="el" href="since_2_14.html#_since_2_14000035">Since gtkmm 2.14:</a></b></dt><dd></dd></dl>
</div>
</div>
<a class="anchor" id="ab8c6679c1296d6c4d8590ef907de4d5a"></a><!-- doxytag: member="Gtk::Builder::add_from_string" ref="ab8c6679c1296d6c4d8590ef907de4d5a" args="(const char *buffer, gsize length)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Gtk::Builder::add_from_string </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>buffer</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">gsize </td>
<td class="paramname"><em>length</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Parses a string containing a GtkBuilder UI definition and merges it with the current contents of the builder. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">buffer</td><td>The string to parse. </td></tr>
<tr><td class="paramname">length</td><td>The length of <em>buffer</em> (may be -1 if is nul-terminated). </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>true on success or false if an error occurred. </dd></dl>
<dl><dt><b>Exceptions:</b></dt><dd>
<table class="exception">
<tr><td class="paramname"><a class="el" href="classGtk_1_1BuilderError.html" title="Exception class for Gdk::Builder errors.">BuilderError</a>,<a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1MarkupError.html">Glib::MarkupError</a></td><td></td></tr>
</table>
</dd>
</dl>
<dl class="since_2_12"><dt><b><a class="el" href="since_2_12.html#_since_2_12000024">Since gtkmm 2.12:</a></b></dt><dd></dd></dl>
</div>
</div>
<a class="anchor" id="a3e7bd7f95c1ea1f06b4c2c16458403ce"></a><!-- doxytag: member="Gtk::Builder::create" ref="a3e7bd7f95c1ea1f06b4c2c16458403ce" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classGtk_1_1Builder.html">Builder</a>> Gtk::Builder::create </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Creates a new builder object. </p>
</div>
</div>
<a class="anchor" id="a6c5ea61bdb933606650e7f437d544edd"></a><!-- doxytag: member="Gtk::Builder::create_from_file" ref="a6c5ea61bdb933606650e7f437d544edd" args="(const std::string &filename)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classGtk_1_1Builder.html">Builder</a>> Gtk::Builder::create_from_file </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td>
<td class="paramname"><em>filename</em></td><td>)</td>
<td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Parses a file containing a GtkBuilder UI definition. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">filename</td><td>the name of the file to parse. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A new <a class="el" href="classGtk_1_1Builder.html" title="Build an interface from a UI definition description.">Builder</a> object, or a null pointer if an error occurred. </dd></dl>
<dl><dt><b>Exceptions:</b></dt><dd>
<table class="exception">
<tr><td class="paramname"><a class="el" href="classGtk_1_1BuilderError.html" title="Exception class for Gdk::Builder errors.">BuilderError</a>,<a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1MarkupError.html">Glib::MarkupError</a>,<a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1FileError.html">Glib::FileError</a></td><td></td></tr>
</table>
</dd>
</dl>
<dl class="since_2_12"><dt><b><a class="el" href="since_2_12.html#_since_2_12000021">Since gtkmm 2.12:</a></b></dt><dd></dd></dl>
</div>
</div>
<a class="anchor" id="a1e6af5278b9f522c28c341bea9fc277d"></a><!-- doxytag: member="Gtk::Builder::create_from_file" ref="a1e6af5278b9f522c28c341bea9fc277d" args="(const std::string &filename, const Glib::StringArrayHandle &object_ids)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classGtk_1_1Builder.html">Builder</a>> Gtk::Builder::create_from_file </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td>
<td class="paramname"><em>filename</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ArrayHandle.html">Glib::StringArrayHandle</a> & </td>
<td class="paramname"><em>object_ids</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Parses a file containing a GtkBuilder UI definition, building only the requested objects. </p>
<p>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 explicitely list all of them.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">filename</td><td>the name of the file to parse. </td></tr>
<tr><td class="paramname">object_ids</td><td>The objects to build. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A new <a class="el" href="classGtk_1_1Builder.html" title="Build an interface from a UI definition description.">Builder</a> object, or a null pointer if an error occurred. </dd></dl>
<dl><dt><b>Exceptions:</b></dt><dd>
<table class="exception">
<tr><td class="paramname"><a class="el" href="classGtk_1_1BuilderError.html" title="Exception class for Gdk::Builder errors.">BuilderError</a>,<a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1MarkupError.html">Glib::MarkupError</a>,<a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1FileError.html">Glib::FileError</a></td><td></td></tr>
</table>
</dd>
</dl>
<dl class="since_2_14"><dt><b><a class="el" href="since_2_14.html#_since_2_14000028">Since gtkmm 2.14:</a></b></dt><dd></dd></dl>
</div>
</div>
<a class="anchor" id="ae851b019aeb1b8c0891be99ece184146"></a><!-- doxytag: member="Gtk::Builder::create_from_file" ref="ae851b019aeb1b8c0891be99ece184146" args="(const std::string &filename, const Glib::ustring &object_id)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classGtk_1_1Builder.html">Builder</a>> Gtk::Builder::create_from_file </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td>
<td class="paramname"><em>filename</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td>
<td class="paramname"><em>object_id</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Parses a file containing a GtkBuilder UI definition, building only the requested object. </p>
<p>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 explicitely list all of them.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">filename</td><td>the name of the file to parse. </td></tr>
<tr><td class="paramname">object_id</td><td>The object to build. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A new <a class="el" href="classGtk_1_1Builder.html" title="Build an interface from a UI definition description.">Builder</a> object, or a null pointer if an error occurred. </dd></dl>
<dl><dt><b>Exceptions:</b></dt><dd>
<table class="exception">
<tr><td class="paramname"><a class="el" href="classGtk_1_1BuilderError.html" title="Exception class for Gdk::Builder errors.">BuilderError</a>,<a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1MarkupError.html">Glib::MarkupError</a>,<a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1FileError.html">Glib::FileError</a></td><td></td></tr>
</table>
</dd>
</dl>
<dl class="since_2_14"><dt><b><a class="el" href="since_2_14.html#_since_2_14000027">Since gtkmm 2.14:</a></b></dt><dd></dd></dl>
</div>
</div>
<a class="anchor" id="a85a5dbb75e4d2fbdcfee52870eb582f0"></a><!-- doxytag: member="Gtk::Builder::create_from_file" ref="a85a5dbb75e4d2fbdcfee52870eb582f0" args="(const std::string &filename, const char *object_id)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classGtk_1_1Builder.html">Builder</a>> Gtk::Builder::create_from_file </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td>
<td class="paramname"><em>filename</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>object_id</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Parses a file containing a GtkBuilder UI definition, building only the requested object. </p>
<p>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 explicitely list all of them.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">filename</td><td>the name of the file to parse. </td></tr>
<tr><td class="paramname">object_id</td><td>The object to build. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A new <a class="el" href="classGtk_1_1Builder.html" title="Build an interface from a UI definition description.">Builder</a> object, or a null pointer if an error occurred. </dd></dl>
<dl><dt><b>Exceptions:</b></dt><dd>
<table class="exception">
<tr><td class="paramname"><a class="el" href="classGtk_1_1BuilderError.html" title="Exception class for Gdk::Builder errors.">BuilderError</a>,<a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1MarkupError.html">Glib::MarkupError</a>,<a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1FileError.html">Glib::FileError</a></td><td></td></tr>
</table>
</dd>
</dl>
<dl class="since_2_16"><dt><b><a class="el" href="since_2_16.html#_since_2_16000031">Since gtkmm 2.16:</a></b></dt><dd></dd></dl>
</div>
</div>
<a class="anchor" id="a05f80c899de87e17683af6e5efcb4b41"></a><!-- doxytag: member="Gtk::Builder::create_from_string" ref="a05f80c899de87e17683af6e5efcb4b41" args="(const Glib::ustring &buffer)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classGtk_1_1Builder.html">Builder</a>> Gtk::Builder::create_from_string </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td>
<td class="paramname"><em>buffer</em></td><td>)</td>
<td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Parses a string containing a GtkBuilder UI definition. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">buffer,:</td><td>the string to parse </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A new <a class="el" href="classGtk_1_1Builder.html" title="Build an interface from a UI definition description.">Builder</a> object, or a null pointer if an error occurred. </dd></dl>
<dl><dt><b>Exceptions:</b></dt><dd>
<table class="exception">
<tr><td class="paramname"><a class="el" href="classGtk_1_1BuilderError.html" title="Exception class for Gdk::Builder errors.">BuilderError</a>,<a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1MarkupError.html">Glib::MarkupError</a></td><td></td></tr>
</table>
</dd>
</dl>
<dl class="since_2_12"><dt><b><a class="el" href="since_2_12.html#_since_2_12000022">Since gtkmm 2.12:</a></b></dt><dd></dd></dl>
</div>
</div>
<a class="anchor" id="abba4d2c8c9eca2663137611854423f3f"></a><!-- doxytag: member="Gtk::Builder::create_from_string" ref="abba4d2c8c9eca2663137611854423f3f" args="(const Glib::ustring &buffer, const char *object_id)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classGtk_1_1Builder.html">Builder</a>> Gtk::Builder::create_from_string </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td>
<td class="paramname"><em>buffer</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>object_id</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Parses a string containing a GtkBuilder UI definition building only the requested object. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">buffer</td><td>The string to parse. </td></tr>
<tr><td class="paramname">object_id</td><td>The object to build. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A new <a class="el" href="classGtk_1_1Builder.html" title="Build an interface from a UI definition description.">Builder</a> object, or a null pointer if an error occurred. </dd></dl>
<dl><dt><b>Exceptions:</b></dt><dd>
<table class="exception">
<tr><td class="paramname"><a class="el" href="classGtk_1_1BuilderError.html" title="Exception class for Gdk::Builder errors.">BuilderError</a>,<a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1MarkupError.html">Glib::MarkupError</a></td><td></td></tr>
</table>
</dd>
</dl>
<dl class="since_2_16"><dt><b><a class="el" href="since_2_16.html#_since_2_16000032">Since gtkmm 2.16:</a></b></dt><dd></dd></dl>
</div>
</div>
<a class="anchor" id="a500d841b1e8c9b25034ed24625076227"></a><!-- doxytag: member="Gtk::Builder::create_from_string" ref="a500d841b1e8c9b25034ed24625076227" args="(const Glib::ustring &buffer, const Glib::ustring &object_id)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classGtk_1_1Builder.html">Builder</a>> Gtk::Builder::create_from_string </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td>
<td class="paramname"><em>buffer</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td>
<td class="paramname"><em>object_id</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Parses a string containing a GtkBuilder UI definition building only the requested object. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">buffer</td><td>The string to parse. </td></tr>
<tr><td class="paramname">object_id</td><td>The object to build. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A new <a class="el" href="classGtk_1_1Builder.html" title="Build an interface from a UI definition description.">Builder</a> object, or a null pointer if an error occurred. </dd></dl>
<dl><dt><b>Exceptions:</b></dt><dd>
<table class="exception">
<tr><td class="paramname"><a class="el" href="classGtk_1_1BuilderError.html" title="Exception class for Gdk::Builder errors.">BuilderError</a>,<a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1MarkupError.html">Glib::MarkupError</a></td><td></td></tr>
</table>
</dd>
</dl>
<dl class="since_2_14"><dt><b><a class="el" href="since_2_14.html#_since_2_14000029">Since gtkmm 2.14:</a></b></dt><dd></dd></dl>
</div>
</div>
<a class="anchor" id="a8b54b4062bc296969c08a859155f35e4"></a><!-- doxytag: member="Gtk::Builder::create_from_string" ref="a8b54b4062bc296969c08a859155f35e4" args="(const Glib::ustring &buffer, const Glib::StringArrayHandle &object_ids)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classGtk_1_1Builder.html">Builder</a>> Gtk::Builder::create_from_string </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td>
<td class="paramname"><em>buffer</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ArrayHandle.html">Glib::StringArrayHandle</a> & </td>
<td class="paramname"><em>object_ids</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Parses a string containing a GtkBuilder UI definition building only the requested objects. </p>
<p>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 explicitely list all of them.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">buffer</td><td>the string to parse </td></tr>
<tr><td class="paramname">object_ids</td><td>The objects to build. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A new <a class="el" href="classGtk_1_1Builder.html" title="Build an interface from a UI definition description.">Builder</a> object, or a null pointer if an error occurred. </dd></dl>
<dl><dt><b>Exceptions:</b></dt><dd>
<table class="exception">
<tr><td class="paramname"><a class="el" href="classGtk_1_1BuilderError.html" title="Exception class for Gdk::Builder errors.">BuilderError</a>,<a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1MarkupError.html">Glib::MarkupError</a></td><td></td></tr>
</table>
</dd>
</dl>
<dl class="since_2_14"><dt><b><a class="el" href="since_2_14.html#_since_2_14000030">Since gtkmm 2.14:</a></b></dt><dd></dd></dl>
</div>
</div>
<a class="anchor" id="a94c23a6163a95da0cb5184dcf2544d4a"></a><!-- doxytag: member="Gtk::Builder::get_cwidget" ref="a94c23a6163a95da0cb5184dcf2544d4a" args="(const Glib::ustring &name)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">GtkWidget* Gtk::Builder::get_cwidget </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td>
<td class="paramname"><em>name</em></td><td>)</td>
<td><code> [protected]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
</div>
</div>
<a class="anchor" id="a2e2dfd63721cf7dd648e262ed6630f0c"></a><!-- doxytag: member="Gtk::Builder::get_object" ref="a2e2dfd63721cf7dd648e262ed6630f0c" args="(const Glib::ustring &name)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1Object.html">Glib::Object</a>> Gtk::Builder::get_object </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td>
<td class="paramname"><em>name</em></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Gets the object named <em>name</em>. </p>
<p>Note that this function does not increment the reference count of the returned object.</p>
<dl class="since_2_12"><dt><b><a class="el" href="since_2_12.html#_since_2_12000025">Since gtkmm 2.12:</a></b></dt><dd></dd></dl>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">name</td><td>Name of object to get. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The object named <em>name</em> or <code>0</code> if it could not be found in the object tree. </dd></dl>
</div>
</div>
<a class="anchor" id="a15fbbeccac6df2f40343a688a3ab7257"></a><!-- doxytag: member="Gtk::Builder::get_translation_domain" ref="a15fbbeccac6df2f40343a688a3ab7257" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> Gtk::Builder::get_translation_domain </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Gets the translation domain of <em>builder</em>. </p>
<dl class="since_2_12"><dt><b><a class="el" href="since_2_12.html#_since_2_12000027">Since gtkmm 2.12:</a></b></dt><dd></dd></dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The translation domain. This string is owned by the builder object and must not be modified or freed. </dd></dl>
</div>
</div>
<a class="anchor" id="a6604abee829e66e0d5d97072227e7cd3"></a><!-- doxytag: member="Gtk::Builder::get_widget" ref="a6604abee829e66e0d5d97072227e7cd3" args="(const Glib::ustring &name, T_Widget *&widget)" -->
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template <class T_Widget > </div>
<table class="memname">
<tr>
<td class="memname">void Gtk::Builder::get_widget </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td>
<td class="paramname"><em>name</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">T_Widget *& </td>
<td class="paramname"><em>widget</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Get a widget from the <a class="el" href="classGtk_1_1Builder.html" title="Build an interface from a UI definition description.">Builder</a> file. </p>
<p>For instance: </p>
<div class="fragment"><pre class="fragment"> <a class="code" href="classGtk_1_1Table.html" title="Pack widgets in regular patterns.">Gtk::Table</a>* pTable = 0;
refXml->get_widget(<span class="stringliteral">"mytable"</span>, pTable);
</pre></div><p> This method prints a warning message to the console if the widget doesn't exist or has the wrong type, so you don't need to check that manually.</p>
<p>Note that you are responsible for deleting top-level widgets (windows and dialogs) instantiated by the <a class="el" href="classGtk_1_1Builder.html" title="Build an interface from a UI definition description.">Builder</a> object. Other widgets are instantiated as managed so they will be deleted automatically if you add them to a container widget.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">name</td><td>The name of the widget. </td></tr>
</table>
</dd>
</dl>
<dl><dt><b>Return values:</b></dt><dd>
<table class="retval">
<tr><td class="paramname">widget</td><td>A pointer to the widget, or <code>0</code> on failure. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="aff746219ab6618caab01984c57ee0161"></a><!-- doxytag: member="Gtk::Builder::get_widget_checked" ref="aff746219ab6618caab01984c57ee0161" args="(const Glib::ustring &name, GType type)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classGtk_1_1Widget.html">Gtk::Widget</a>* Gtk::Builder::get_widget_checked </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td>
<td class="paramname"><em>name</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">GType </td>
<td class="paramname"><em>type</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [protected]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
</div>
</div>
<a class="anchor" id="a945dbd52e16b13a3c46809572e5a2877"></a><!-- doxytag: member="Gtk::Builder::get_widget_derived" ref="a945dbd52e16b13a3c46809572e5a2877" args="(const Glib::ustring &name, T_Widget *&widget)" -->
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template <class T_Widget > </div>
<table class="memname">
<tr>
<td class="memname">void Gtk::Builder::get_widget_derived </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td>
<td class="paramname"><em>name</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">T_Widget *& </td>
<td class="paramname"><em>widget</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>This provides a pointer to a widget whose details are specified in the GtkBuilder file, but which is implemented by your own derived class. </p>
<p>Your class must have a constructor like so: </p>
<div class="fragment"><pre class="fragment"> DerivedDialog::DerivedDialog(BaseObjectType* cobject, <span class="keyword">const</span> <a class="codeRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr<Gtk::Builder></a>& refBuilder)
: Gtk::Dialog(cobject) <span class="comment">//Calls the base class constructor</span>
</pre></div><p>For instance: </p>
<div class="fragment"><pre class="fragment"> Gtk::DerivedBox* pBox = 0;
refXml->get_widget_derived(<span class="stringliteral">"mybox"</span>, pBox);
</pre></div><dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">name</td><td>The name of the widget. </td></tr>
</table>
</dd>
</dl>
<dl><dt><b>Return values:</b></dt><dd>
<table class="retval">
<tr><td class="paramname">widget</td><td>A pointer to the widget, or <code>0</code> on failure. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="a16ab17cd36e636c3f1495ca2ef2a4f49"></a><!-- doxytag: member="Gtk::Builder::gobj" ref="a16ab17cd36e636c3f1495ca2ef2a4f49" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">GtkBuilder* Gtk::Builder::gobj </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td><code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Provides access to the underlying C GObject. </p>
<p>Reimplemented from <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ObjectBase.html#a4c6efc18be8cb9c56e58fc0bd20fafbe">Glib::ObjectBase</a>.</p>
</div>
</div>
<a class="anchor" id="a0d39f2751484ec95216add8f6629cc7d"></a><!-- doxytag: member="Gtk::Builder::gobj" ref="a0d39f2751484ec95216add8f6629cc7d" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const GtkBuilder* Gtk::Builder::gobj </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const<code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Provides access to the underlying C GObject. </p>
<p>Reimplemented from <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ObjectBase.html#a778a94181132976bbfb0519793f3b32e">Glib::ObjectBase</a>.</p>
</div>
</div>
<a class="anchor" id="a43185cdda8ad880fab2b3a9a2c1332d6"></a><!-- doxytag: member="Gtk::Builder::gobj_copy" ref="a43185cdda8ad880fab2b3a9a2c1332d6" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">GtkBuilder* Gtk::Builder::gobj_copy </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. </p>
</div>
</div>
<a class="anchor" id="a4641c283b6979640541cd651f0c56a7b"></a><!-- doxytag: member="Gtk::Builder::property_translation_domain" ref="a4641c283b6979640541cd651f0c56a7b" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><<a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>> Gtk::Builder::property_translation_domain </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>The translation domain used by gettext. </p>
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes. </dd></dl>
</div>
</div>
<a class="anchor" id="a9af6cfd8a039d34e0eb134e782027242"></a><!-- doxytag: member="Gtk::Builder::property_translation_domain" ref="a9af6cfd8a039d34e0eb134e782027242" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a><<a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>> Gtk::Builder::property_translation_domain </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>The translation domain used by gettext. </p>
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes. </dd></dl>
</div>
</div>
<a class="anchor" id="a9f696bcf8d214f38d61d0d558d641245"></a><!-- doxytag: member="Gtk::Builder::set_translation_domain" ref="a9f696bcf8d214f38d61d0d558d641245" args="(const Glib::ustring &domain)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gtk::Builder::set_translation_domain </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td>
<td class="paramname"><em>domain</em></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Sets the translation domain of <em>builder</em>. </p>
<p>See <a class="el" href="classGtk_1_1Builder.html" title="Build an interface from a UI definition description.">Gtk::Builder</a>:translation-domain.</p>
<dl class="since_2_12"><dt><b><a class="el" href="since_2_12.html#_since_2_12000026">Since gtkmm 2.12:</a></b></dt><dd></dd></dl>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">domain</td><td>The translation domain or <code>0</code>. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<hr/><h2>Friends And Related Function Documentation</h2>
<a class="anchor" id="a0eed615bfe0b8ce06257406172956946"></a><!-- doxytag: member="Gtk::Builder::wrap" ref="a0eed615bfe0b8ce06257406172956946" args="(GtkBuilder *object, bool take_copy=false)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGtk_1_1Builder.html">Gtk::Builder</a> > wrap </td>
<td>(</td>
<td class="paramtype">GtkBuilder * </td>
<td class="paramname"><em>object</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"><em>take_copy</em> = <code>false</code> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [related]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>A <a class="elRef" href="../../../glibmm-2.4/reference/html/namespaceGlib.html#a671306f4a3a0cae5ab4d7a9d54886592">Glib::wrap()</a> method for this object. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">object</td><td>The C instance. </td></tr>
<tr><td class="paramname">take_copy</td><td>False if the result should take ownership of the C instance. True if it should take a new copy or ref. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A C++ instance that wraps this C instance. </dd></dl>
</div>
</div>
<hr/>The documentation for this class was generated from the following file:<ul>
<li>gtkmm/builder.h</li>
</ul>
</div>
<hr class="footer"/><address class="footer"><small>Generated on Tue Jun 25 2013 for gtkmm by 
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.7.3 </small></address>
</body>
</html>
