1
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2
<html xmlns="http://www.w3.org/1999/xhtml">
4
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
5
<title>gtkmm: Gtk::Builder Class Reference</title>
6
<link href="tabs.css" rel="stylesheet" type="text/css"/>
7
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
10
<!-- Generated by Doxygen 1.7.3 -->
13
<table cellspacing="0" cellpadding="0">
15
<tr style="height: 56px;">
16
<td style="padding-left: 0.5em;">
17
<div id="projectname">gtkmm <span id="projectnumber">2.24.2</span></div>
23
<div id="navrow1" class="tabs">
25
<li><a href="index.html"><span>Main Page</span></a></li>
26
<li><a href="pages.html"><span>Related Pages</span></a></li>
27
<li><a href="modules.html"><span>Modules</span></a></li>
28
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
29
<li class="current"><a href="annotated.html"><span>Classes</span></a></li>
32
<div id="navrow2" class="tabs2">
34
<li><a href="annotated.html"><span>Class List</span></a></li>
35
<li><a href="classes.html"><span>Class Index</span></a></li>
36
<li><a href="inherits.html"><span>Class Hierarchy</span></a></li>
37
<li><a href="functions.html"><span>Class Members</span></a></li>
40
<div id="nav-path" class="navpath">
42
<li class="navelem"><a class="el" href="namespaceGtk.html">Gtk</a> </li>
43
<li class="navelem"><a class="el" href="classGtk_1_1Builder.html">Builder</a> </li>
49
<a href="#pub-methods">Public Member Functions</a> |
50
<a href="#pub-static-methods">Static Public Member Functions</a> |
51
<a href="#pro-methods">Protected Member Functions</a> |
52
<a href="#related">Related Functions</a> </div>
53
<div class="headertitle">
54
<h1>Gtk::Builder Class Reference</h1> </div>
56
<div class="contents">
57
<!-- doxytag: class="Gtk::Builder" --><!-- doxytag: inherits="Glib::Object" -->
58
<p>Build an interface from a UI definition description. <a href="#_details">More...</a></p>
59
<div class="dynheader">
60
Inheritance diagram for Gtk::Builder:</div>
61
<div class="dyncontent">
62
<div class="center"><img src="classGtk_1_1Builder__inherit__graph.png" border="0" usemap="#Gtk_1_1Builder_inherit__map" alt="Inheritance graph"/></div>
63
<map name="Gtk_1_1Builder_inherit__map" id="Gtk_1_1Builder_inherit__map">
64
<area shape="rect" id="node2" href="../../../glibmm-2.4/reference/html/classGlib_1_1Object.html" title="Glib::Object" alt="" coords="20,166,111,197"/><area shape="rect" id="node4" href="../../../glibmm-2.4/reference/html/classGlib_1_1ObjectBase.html" title="Glib::ObjectBase" alt="" coords="5,86,125,117"/><area shape="rect" id="node6" href="../../../libsigc++-2.0/reference/html/structsigc_1_1trackable.html" title="sigc::trackable" alt="" coords="12,6,119,37"/></map>
65
<center><span class="legend">[<a href="graph_legend.html">legend</a>]</span></center></div>
66
<div class="dynheader">
67
Collaboration diagram for Gtk::Builder:</div>
68
<div class="dyncontent">
69
<div class="center"><img src="classGtk_1_1Builder__coll__graph.png" border="0" usemap="#Gtk_1_1Builder_coll__map" alt="Collaboration graph"/></div>
70
<map name="Gtk_1_1Builder_coll__map" id="Gtk_1_1Builder_coll__map">
71
<area shape="rect" id="node2" href="../../../glibmm-2.4/reference/html/classGlib_1_1Object.html" title="Glib::Object" alt="" coords="20,166,111,197"/><area shape="rect" id="node4" href="../../../glibmm-2.4/reference/html/classGlib_1_1ObjectBase.html" title="Glib::ObjectBase" alt="" coords="5,86,125,117"/><area shape="rect" id="node6" href="../../../libsigc++-2.0/reference/html/structsigc_1_1trackable.html" title="sigc::trackable" alt="" coords="12,6,119,37"/></map>
72
<center><span class="legend">[<a href="graph_legend.html">legend</a>]</span></center></div>
74
<p><a href="classGtk_1_1Builder-members.html">List of all members.</a></p>
75
<table class="memberdecls">
76
<tr><td colspan="2"><h2><a name="pub-methods"></a>
77
Public Member Functions</h2></td></tr>
78
<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>
79
<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>
80
<tr><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C GObject. <a href="#a16ab17cd36e636c3f1495ca2ef2a4f49"></a><br/></td></tr>
81
<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>
82
<tr><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C GObject. <a href="#a0d39f2751484ec95216add8f6629cc7d"></a><br/></td></tr>
83
<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>
84
<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>
85
<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/a01591.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a>& filename)</td></tr>
86
<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>
87
<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/a01591.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a>& filename, const char* object_id)</td></tr>
88
<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>
89
<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/a01591.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>
90
<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>
91
<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/a01591.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>
92
<tr><td class="mdescLeft"> </td><td class="mdescRight">Parses a file containing a. <a href="#aec111515605a74e40b0eb380043a31f6"></a><br/></td></tr>
93
<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>
94
<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>
95
<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>
96
<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>
97
<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>
98
<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>
99
<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>
100
<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>
101
<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>
102
<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>
103
<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>
104
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the object named <em>name</em>. <a href="#a2e2dfd63721cf7dd648e262ed6630f0c"></a><br/></td></tr>
105
<tr><td class="memTemplParams" colspan="2">template<class T_Widget > </td></tr>
106
<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>
107
<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>
108
<tr><td class="memTemplParams" colspan="2">template<class T_Widget > </td></tr>
109
<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>
110
<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>
111
<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>
112
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the translation domain of <em>builder</em>. <a href="#a9f696bcf8d214f38d61d0d558d641245"></a><br/></td></tr>
113
<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>
114
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the translation domain of <em>builder</em>. <a href="#a15fbbeccac6df2f40343a688a3ab7257"></a><br/></td></tr>
115
<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"/>
116
< <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>
117
<tr><td class="mdescLeft"> </td><td class="mdescRight">The translation domain used by gettext. <a href="#a9af6cfd8a039d34e0eb134e782027242"></a><br/></td></tr>
118
<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"/>
119
< <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>
120
<tr><td class="mdescLeft"> </td><td class="mdescRight">The translation domain used by gettext. <a href="#a4641c283b6979640541cd651f0c56a7b"></a><br/></td></tr>
121
<tr><td colspan="2"><h2><a name="pub-static-methods"></a>
122
Static Public Member Functions</h2></td></tr>
123
<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>
124
<tr><td class="mdescLeft"> </td><td class="mdescRight">Creates a new builder object. <a href="#a3e7bd7f95c1ea1f06b4c2c16458403ce"></a><br/></td></tr>
125
<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/a01591.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a>& filename)</td></tr>
126
<tr><td class="mdescLeft"> </td><td class="mdescRight">Parses a file containing a GtkBuilder UI definition. <a href="#a6c5ea61bdb933606650e7f437d544edd"></a><br/></td></tr>
127
<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/a01591.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>
128
<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>
129
<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/a01591.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a>& filename, const char* object_id)</td></tr>
130
<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>
131
<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/a01591.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>
132
<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>
133
<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>
134
<tr><td class="mdescLeft"> </td><td class="mdescRight">Parses a string containing a GtkBuilder UI definition. <a href="#a05f80c899de87e17683af6e5efcb4b41"></a><br/></td></tr>
135
<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>
136
<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>
137
<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>
138
<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>
139
<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>
140
<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>
141
<tr><td colspan="2"><h2><a name="pro-methods"></a>
142
Protected Member Functions</h2></td></tr>
143
<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>
144
<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/a01565.html#ga79d96b6335c46a5a2a7386970a91cd9b">type</a>)</td></tr>
145
<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>
146
<tr><td colspan="2"><h2><a name="related"></a>
147
Related Functions</h2></td></tr>
148
<tr><td colspan="2">(Note that these are not member functions.) <br/></td></tr>
149
<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>
150
<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>
152
<hr/><a name="_details"></a><h2>Detailed Description</h2>
153
<div class="textblock"><p>Build an interface from a UI definition description. </p>
154
<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>
155
<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>
156
</div><hr/><h2>Constructor & Destructor Documentation</h2>
157
<a class="anchor" id="aff47bcf93d49acef9de2c697774cd53b"></a><!-- doxytag: member="Gtk::Builder::~Builder" ref="aff47bcf93d49acef9de2c697774cd53b" args="()" -->
158
<div class="memitem">
159
<div class="memproto">
160
<table class="memname">
162
<td class="memname">virtual Gtk::Builder::~Builder </td>
164
<td class="paramname"></td><td>)</td>
165
<td><code> [virtual]</code></td>
173
<a class="anchor" id="a0ba100f27aca463391d4399f6f1880ab"></a><!-- doxytag: member="Gtk::Builder::Builder" ref="a0ba100f27aca463391d4399f6f1880ab" args="()" -->
174
<div class="memitem">
175
<div class="memproto">
176
<table class="memname">
178
<td class="memname">Gtk::Builder::Builder </td>
180
<td class="paramname"></td><td>)</td>
181
<td><code> [protected]</code></td>
189
<hr/><h2>Member Function Documentation</h2>
190
<a class="anchor" id="aa3f4af4e7eaf7861c8283dc0dbd5254c"></a><!-- doxytag: member="Gtk::Builder::add_from_file" ref="aa3f4af4e7eaf7861c8283dc0dbd5254c" args="(const std::string &filename)" -->
191
<div class="memitem">
192
<div class="memproto">
193
<table class="memname">
195
<td class="memname">bool Gtk::Builder::add_from_file </td>
197
<td class="paramtype">const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01591.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td>
198
<td class="paramname"><em>filename</em></td><td>)</td>
205
<p>Parses a file containing a GtkBuilder UI definition, and merges it with the current contents of the builder. </p>
206
<dl><dt><b>Parameters:</b></dt><dd>
207
<table class="params">
208
<tr><td class="paramname">buffer</td><td>The file to parse. </td></tr>
212
<dl class="return"><dt><b>Returns:</b></dt><dd>true on success or false if an error occurred. </dd></dl>
213
<dl><dt><b>Exceptions:</b></dt><dd>
214
<table class="exception">
215
<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>
219
<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>
223
<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)" -->
224
<div class="memitem">
225
<div class="memproto">
226
<table class="memname">
228
<td class="memname">bool Gtk::Builder::add_from_file </td>
230
<td class="paramtype">const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01591.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td>
231
<td class="paramname"><em>filename</em>, </td>
234
<td class="paramkey"></td>
236
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ArrayHandle.html">Glib::StringArrayHandle</a> & </td>
237
<td class="paramname"><em>object_ids</em> </td>
248
<p>Parses a file containing a. </p>
249
<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>
250
<dl><dt><b>Parameters:</b></dt><dd>
251
<table class="params">
252
<tr><td class="paramname">filename</td><td>The name of the file to parse. </td></tr>
253
<tr><td class="paramname">object_ids</td><td>Nul-terminated array of objects to build. </td></tr>
257
<dl class="return"><dt><b>Returns:</b></dt><dd>A positive value on success, 0 if an error occurred. </dd></dl>
261
<a class="anchor" id="a80771efbfbe5bbc053e8deee93e1e118"></a><!-- doxytag: member="Gtk::Builder::add_from_file" ref="a80771efbfbe5bbc053e8deee93e1e118" args="(const std::string &filename, const char *object_id)" -->
262
<div class="memitem">
263
<div class="memproto">
264
<table class="memname">
266
<td class="memname">bool Gtk::Builder::add_from_file </td>
268
<td class="paramtype">const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01591.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td>
269
<td class="paramname"><em>filename</em>, </td>
272
<td class="paramkey"></td>
274
<td class="paramtype">const char * </td>
275
<td class="paramname"><em>object_id</em> </td>
286
<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>
287
<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>
288
<dl><dt><b>Parameters:</b></dt><dd>
289
<table class="params">
290
<tr><td class="paramname">buffer</td><td>The file to parse. </td></tr>
291
<tr><td class="paramname">The</td><td>object to build. </td></tr>
295
<dl class="return"><dt><b>Returns:</b></dt><dd>true on success or false if an error occurred. </dd></dl>
296
<dl><dt><b>Exceptions:</b></dt><dd>
297
<table class="exception">
298
<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>
302
<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>
306
<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)" -->
307
<div class="memitem">
308
<div class="memproto">
309
<table class="memname">
311
<td class="memname">bool Gtk::Builder::add_from_file </td>
313
<td class="paramtype">const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01591.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td>
314
<td class="paramname"><em>filename</em>, </td>
317
<td class="paramkey"></td>
319
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td>
320
<td class="paramname"><em>object_id</em> </td>
331
<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>
332
<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>
333
<dl><dt><b>Parameters:</b></dt><dd>
334
<table class="params">
335
<tr><td class="paramname">buffer</td><td>The file to parse. </td></tr>
336
<tr><td class="paramname">The</td><td>object to build. </td></tr>
340
<dl class="return"><dt><b>Returns:</b></dt><dd>true on success or false if an error occurred. </dd></dl>
341
<dl><dt><b>Exceptions:</b></dt><dd>
342
<table class="exception">
343
<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>
347
<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>
351
<a class="anchor" id="ae3520ee31a98ac30b728f93522de8df5"></a><!-- doxytag: member="Gtk::Builder::add_from_string" ref="ae3520ee31a98ac30b728f93522de8df5" args="(const Glib::ustring &buffer)" -->
352
<div class="memitem">
353
<div class="memproto">
354
<table class="memname">
356
<td class="memname">bool Gtk::Builder::add_from_string </td>
358
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td>
359
<td class="paramname"><em>buffer</em></td><td>)</td>
366
<p>Parses a string containing a GtkBuilder UI definition and merges it with the current contents of the builder. </p>
367
<dl><dt><b>Parameters:</b></dt><dd>
368
<table class="params">
369
<tr><td class="paramname">buffer</td><td>The string to parse. </td></tr>
373
<dl class="return"><dt><b>Returns:</b></dt><dd>true on success or false if an error occurred. </dd></dl>
374
<dl><dt><b>Exceptions:</b></dt><dd>
375
<table class="exception">
376
<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>
380
<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>
384
<a class="anchor" id="aac7d6c42f7a53f8be084841948b157d0"></a><!-- doxytag: member="Gtk::Builder::add_from_string" ref="aac7d6c42f7a53f8be084841948b157d0" args="(const Glib::ustring &buffer, const char *object_id)" -->
385
<div class="memitem">
386
<div class="memproto">
387
<table class="memname">
389
<td class="memname">bool Gtk::Builder::add_from_string </td>
391
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td>
392
<td class="paramname"><em>buffer</em>, </td>
395
<td class="paramkey"></td>
397
<td class="paramtype">const char * </td>
398
<td class="paramname"><em>object_id</em> </td>
409
<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>
410
<dl><dt><b>Parameters:</b></dt><dd>
411
<table class="params">
412
<tr><td class="paramname">buffer</td><td>The string to parse. </td></tr>
413
<tr><td class="paramname">The</td><td>object to build. </td></tr>
417
<dl class="return"><dt><b>Returns:</b></dt><dd>true on success or false if an error occurred. </dd></dl>
418
<dl><dt><b>Exceptions:</b></dt><dd>
419
<table class="exception">
420
<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>
424
<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>
428
<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)" -->
429
<div class="memitem">
430
<div class="memproto">
431
<table class="memname">
433
<td class="memname">bool Gtk::Builder::add_from_string </td>
435
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td>
436
<td class="paramname"><em>buffer</em>, </td>
439
<td class="paramkey"></td>
441
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td>
442
<td class="paramname"><em>object_id</em> </td>
453
<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>
454
<dl><dt><b>Parameters:</b></dt><dd>
455
<table class="params">
456
<tr><td class="paramname">buffer</td><td>The string to parse. </td></tr>
457
<tr><td class="paramname">The</td><td>object to build. </td></tr>
461
<dl class="return"><dt><b>Returns:</b></dt><dd>true on success or false if an error occurred. </dd></dl>
462
<dl><dt><b>Exceptions:</b></dt><dd>
463
<table class="exception">
464
<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>
468
<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>
472
<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)" -->
473
<div class="memitem">
474
<div class="memproto">
475
<table class="memname">
477
<td class="memname">bool Gtk::Builder::add_from_string </td>
479
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td>
480
<td class="paramname"><em>buffer</em>, </td>
483
<td class="paramkey"></td>
485
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ArrayHandle.html">Glib::StringArrayHandle</a> & </td>
486
<td class="paramname"><em>object_ids</em> </td>
497
<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>
498
<dl><dt><b>Parameters:</b></dt><dd>
499
<table class="params">
500
<tr><td class="paramname">buffer</td><td>The string to parse. </td></tr>
501
<tr><td class="paramname">The</td><td>objects to build. </td></tr>
505
<dl class="return"><dt><b>Returns:</b></dt><dd>true on success or false if an error occurred. </dd></dl>
506
<dl><dt><b>Exceptions:</b></dt><dd>
507
<table class="exception">
508
<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>
512
<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>
516
<a class="anchor" id="ab8c6679c1296d6c4d8590ef907de4d5a"></a><!-- doxytag: member="Gtk::Builder::add_from_string" ref="ab8c6679c1296d6c4d8590ef907de4d5a" args="(const char *buffer, gsize length)" -->
517
<div class="memitem">
518
<div class="memproto">
519
<table class="memname">
521
<td class="memname">bool Gtk::Builder::add_from_string </td>
523
<td class="paramtype">const char * </td>
524
<td class="paramname"><em>buffer</em>, </td>
527
<td class="paramkey"></td>
529
<td class="paramtype">gsize </td>
530
<td class="paramname"><em>length</em> </td>
541
<p>Parses a string containing a GtkBuilder UI definition and merges it with the current contents of the builder. </p>
542
<dl><dt><b>Parameters:</b></dt><dd>
543
<table class="params">
544
<tr><td class="paramname">buffer</td><td>The string to parse. </td></tr>
545
<tr><td class="paramname">length</td><td>The length of <em>buffer</em> (may be -1 if is nul-terminated). </td></tr>
549
<dl class="return"><dt><b>Returns:</b></dt><dd>true on success or false if an error occurred. </dd></dl>
550
<dl><dt><b>Exceptions:</b></dt><dd>
551
<table class="exception">
552
<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>
556
<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>
560
<a class="anchor" id="a3e7bd7f95c1ea1f06b4c2c16458403ce"></a><!-- doxytag: member="Gtk::Builder::create" ref="a3e7bd7f95c1ea1f06b4c2c16458403ce" args="()" -->
561
<div class="memitem">
562
<div class="memproto">
563
<table class="memname">
565
<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>
567
<td class="paramname"></td><td>)</td>
568
<td><code> [static]</code></td>
574
<p>Creates a new builder object. </p>
578
<a class="anchor" id="a6c5ea61bdb933606650e7f437d544edd"></a><!-- doxytag: member="Gtk::Builder::create_from_file" ref="a6c5ea61bdb933606650e7f437d544edd" args="(const std::string &filename)" -->
579
<div class="memitem">
580
<div class="memproto">
581
<table class="memname">
583
<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>
585
<td class="paramtype">const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01591.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td>
586
<td class="paramname"><em>filename</em></td><td>)</td>
587
<td><code> [static]</code></td>
593
<p>Parses a file containing a GtkBuilder UI definition. </p>
594
<dl><dt><b>Parameters:</b></dt><dd>
595
<table class="params">
596
<tr><td class="paramname">filename</td><td>the name of the file to parse. </td></tr>
600
<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>
601
<dl><dt><b>Exceptions:</b></dt><dd>
602
<table class="exception">
603
<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>
607
<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>
611
<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)" -->
612
<div class="memitem">
613
<div class="memproto">
614
<table class="memname">
616
<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>
618
<td class="paramtype">const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01591.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td>
619
<td class="paramname"><em>filename</em>, </td>
622
<td class="paramkey"></td>
624
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ArrayHandle.html">Glib::StringArrayHandle</a> & </td>
625
<td class="paramname"><em>object_ids</em> </td>
630
<td></td><td><code> [static]</code></td>
636
<p>Parses a file containing a GtkBuilder UI definition, building only the requested objects. </p>
637
<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>
638
<dl><dt><b>Parameters:</b></dt><dd>
639
<table class="params">
640
<tr><td class="paramname">filename</td><td>the name of the file to parse. </td></tr>
641
<tr><td class="paramname">object_ids</td><td>The objects to build. </td></tr>
645
<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>
646
<dl><dt><b>Exceptions:</b></dt><dd>
647
<table class="exception">
648
<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>
652
<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>
656
<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)" -->
657
<div class="memitem">
658
<div class="memproto">
659
<table class="memname">
661
<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>
663
<td class="paramtype">const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01591.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td>
664
<td class="paramname"><em>filename</em>, </td>
667
<td class="paramkey"></td>
669
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td>
670
<td class="paramname"><em>object_id</em> </td>
675
<td></td><td><code> [static]</code></td>
681
<p>Parses a file containing a GtkBuilder UI definition, building only the requested object. </p>
682
<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>
683
<dl><dt><b>Parameters:</b></dt><dd>
684
<table class="params">
685
<tr><td class="paramname">filename</td><td>the name of the file to parse. </td></tr>
686
<tr><td class="paramname">object_id</td><td>The object to build. </td></tr>
690
<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>
691
<dl><dt><b>Exceptions:</b></dt><dd>
692
<table class="exception">
693
<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>
697
<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>
701
<a class="anchor" id="a85a5dbb75e4d2fbdcfee52870eb582f0"></a><!-- doxytag: member="Gtk::Builder::create_from_file" ref="a85a5dbb75e4d2fbdcfee52870eb582f0" args="(const std::string &filename, const char *object_id)" -->
702
<div class="memitem">
703
<div class="memproto">
704
<table class="memname">
706
<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>
708
<td class="paramtype">const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01591.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td>
709
<td class="paramname"><em>filename</em>, </td>
712
<td class="paramkey"></td>
714
<td class="paramtype">const char * </td>
715
<td class="paramname"><em>object_id</em> </td>
720
<td></td><td><code> [static]</code></td>
726
<p>Parses a file containing a GtkBuilder UI definition, building only the requested object. </p>
727
<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>
728
<dl><dt><b>Parameters:</b></dt><dd>
729
<table class="params">
730
<tr><td class="paramname">filename</td><td>the name of the file to parse. </td></tr>
731
<tr><td class="paramname">object_id</td><td>The object to build. </td></tr>
735
<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>
736
<dl><dt><b>Exceptions:</b></dt><dd>
737
<table class="exception">
738
<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>
742
<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>
746
<a class="anchor" id="a05f80c899de87e17683af6e5efcb4b41"></a><!-- doxytag: member="Gtk::Builder::create_from_string" ref="a05f80c899de87e17683af6e5efcb4b41" args="(const Glib::ustring &buffer)" -->
747
<div class="memitem">
748
<div class="memproto">
749
<table class="memname">
751
<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>
753
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td>
754
<td class="paramname"><em>buffer</em></td><td>)</td>
755
<td><code> [static]</code></td>
761
<p>Parses a string containing a GtkBuilder UI definition. </p>
762
<dl><dt><b>Parameters:</b></dt><dd>
763
<table class="params">
764
<tr><td class="paramname">buffer,:</td><td>the string to parse </td></tr>
768
<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>
769
<dl><dt><b>Exceptions:</b></dt><dd>
770
<table class="exception">
771
<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>
775
<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>
779
<a class="anchor" id="abba4d2c8c9eca2663137611854423f3f"></a><!-- doxytag: member="Gtk::Builder::create_from_string" ref="abba4d2c8c9eca2663137611854423f3f" args="(const Glib::ustring &buffer, const char *object_id)" -->
780
<div class="memitem">
781
<div class="memproto">
782
<table class="memname">
784
<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>
786
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td>
787
<td class="paramname"><em>buffer</em>, </td>
790
<td class="paramkey"></td>
792
<td class="paramtype">const char * </td>
793
<td class="paramname"><em>object_id</em> </td>
798
<td></td><td><code> [static]</code></td>
804
<p>Parses a string containing a GtkBuilder UI definition building only the requested object. </p>
805
<dl><dt><b>Parameters:</b></dt><dd>
806
<table class="params">
807
<tr><td class="paramname">buffer</td><td>The string to parse. </td></tr>
808
<tr><td class="paramname">object_id</td><td>The object to build. </td></tr>
812
<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>
813
<dl><dt><b>Exceptions:</b></dt><dd>
814
<table class="exception">
815
<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>
819
<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>
823
<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)" -->
824
<div class="memitem">
825
<div class="memproto">
826
<table class="memname">
828
<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>
830
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td>
831
<td class="paramname"><em>buffer</em>, </td>
834
<td class="paramkey"></td>
836
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td>
837
<td class="paramname"><em>object_id</em> </td>
842
<td></td><td><code> [static]</code></td>
848
<p>Parses a string containing a GtkBuilder UI definition building only the requested object. </p>
849
<dl><dt><b>Parameters:</b></dt><dd>
850
<table class="params">
851
<tr><td class="paramname">buffer</td><td>The string to parse. </td></tr>
852
<tr><td class="paramname">object_id</td><td>The object to build. </td></tr>
856
<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>
857
<dl><dt><b>Exceptions:</b></dt><dd>
858
<table class="exception">
859
<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>
863
<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>
867
<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)" -->
868
<div class="memitem">
869
<div class="memproto">
870
<table class="memname">
872
<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>
874
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td>
875
<td class="paramname"><em>buffer</em>, </td>
878
<td class="paramkey"></td>
880
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ArrayHandle.html">Glib::StringArrayHandle</a> & </td>
881
<td class="paramname"><em>object_ids</em> </td>
886
<td></td><td><code> [static]</code></td>
892
<p>Parses a string containing a GtkBuilder UI definition building only the requested objects. </p>
893
<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>
894
<dl><dt><b>Parameters:</b></dt><dd>
895
<table class="params">
896
<tr><td class="paramname">buffer</td><td>the string to parse </td></tr>
897
<tr><td class="paramname">object_ids</td><td>The objects to build. </td></tr>
901
<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>
902
<dl><dt><b>Exceptions:</b></dt><dd>
903
<table class="exception">
904
<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>
908
<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>
912
<a class="anchor" id="a94c23a6163a95da0cb5184dcf2544d4a"></a><!-- doxytag: member="Gtk::Builder::get_cwidget" ref="a94c23a6163a95da0cb5184dcf2544d4a" args="(const Glib::ustring &name)" -->
913
<div class="memitem">
914
<div class="memproto">
915
<table class="memname">
917
<td class="memname">GtkWidget* Gtk::Builder::get_cwidget </td>
919
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td>
920
<td class="paramname"><em>name</em></td><td>)</td>
921
<td><code> [protected]</code></td>
929
<a class="anchor" id="a2e2dfd63721cf7dd648e262ed6630f0c"></a><!-- doxytag: member="Gtk::Builder::get_object" ref="a2e2dfd63721cf7dd648e262ed6630f0c" args="(const Glib::ustring &name)" -->
930
<div class="memitem">
931
<div class="memproto">
932
<table class="memname">
934
<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>
936
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td>
937
<td class="paramname"><em>name</em></td><td>)</td>
944
<p>Gets the object named <em>name</em>. </p>
945
<p>Note that this function does not increment the reference count of the returned object.</p>
946
<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>
947
<dl><dt><b>Parameters:</b></dt><dd>
948
<table class="params">
949
<tr><td class="paramname">name</td><td>Name of object to get. </td></tr>
953
<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>
957
<a class="anchor" id="a15fbbeccac6df2f40343a688a3ab7257"></a><!-- doxytag: member="Gtk::Builder::get_translation_domain" ref="a15fbbeccac6df2f40343a688a3ab7257" args="() const " -->
958
<div class="memitem">
959
<div class="memproto">
960
<table class="memname">
962
<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>
964
<td class="paramname"></td><td>)</td>
971
<p>Gets the translation domain of <em>builder</em>. </p>
972
<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>
973
<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>
977
<a class="anchor" id="a6604abee829e66e0d5d97072227e7cd3"></a><!-- doxytag: member="Gtk::Builder::get_widget" ref="a6604abee829e66e0d5d97072227e7cd3" args="(const Glib::ustring &name, T_Widget *&widget)" -->
978
<div class="memitem">
979
<div class="memproto">
980
<div class="memtemplate">
981
template <class T_Widget > </div>
982
<table class="memname">
984
<td class="memname">void Gtk::Builder::get_widget </td>
986
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td>
987
<td class="paramname"><em>name</em>, </td>
990
<td class="paramkey"></td>
992
<td class="paramtype">T_Widget *& </td>
993
<td class="paramname"><em>widget</em> </td>
998
<td></td><td><code> [inline]</code></td>
1002
<div class="memdoc">
1004
<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>
1005
<p>For instance: </p>
1006
<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;
1007
refXml->get_widget(<span class="stringliteral">"mytable"</span>, pTable);
1008
</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>
1009
<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>
1010
<dl><dt><b>Parameters:</b></dt><dd>
1011
<table class="params">
1012
<tr><td class="paramname">name</td><td>The name of the widget. </td></tr>
1016
<dl><dt><b>Return values:</b></dt><dd>
1017
<table class="retval">
1018
<tr><td class="paramname">widget</td><td>A pointer to the widget, or <code>0</code> on failure. </td></tr>
1025
<a class="anchor" id="aff746219ab6618caab01984c57ee0161"></a><!-- doxytag: member="Gtk::Builder::get_widget_checked" ref="aff746219ab6618caab01984c57ee0161" args="(const Glib::ustring &name, GType type)" -->
1026
<div class="memitem">
1027
<div class="memproto">
1028
<table class="memname">
1030
<td class="memname"><a class="el" href="classGtk_1_1Widget.html">Gtk::Widget</a>* Gtk::Builder::get_widget_checked </td>
1032
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td>
1033
<td class="paramname"><em>name</em>, </td>
1036
<td class="paramkey"></td>
1038
<td class="paramtype">GType </td>
1039
<td class="paramname"><em>type</em> </td>
1044
<td></td><td><code> [protected]</code></td>
1048
<div class="memdoc">
1052
<a class="anchor" id="a945dbd52e16b13a3c46809572e5a2877"></a><!-- doxytag: member="Gtk::Builder::get_widget_derived" ref="a945dbd52e16b13a3c46809572e5a2877" args="(const Glib::ustring &name, T_Widget *&widget)" -->
1053
<div class="memitem">
1054
<div class="memproto">
1055
<div class="memtemplate">
1056
template <class T_Widget > </div>
1057
<table class="memname">
1059
<td class="memname">void Gtk::Builder::get_widget_derived </td>
1061
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td>
1062
<td class="paramname"><em>name</em>, </td>
1065
<td class="paramkey"></td>
1067
<td class="paramtype">T_Widget *& </td>
1068
<td class="paramname"><em>widget</em> </td>
1073
<td></td><td><code> [inline]</code></td>
1077
<div class="memdoc">
1079
<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>
1080
<p>Your class must have a constructor like so: </p>
1081
<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)
1082
: Gtk::Dialog(cobject) <span class="comment">//Calls the base class constructor</span>
1083
</pre></div><p>For instance: </p>
1084
<div class="fragment"><pre class="fragment"> Gtk::DerivedBox* pBox = 0;
1085
refXml->get_widget_derived(<span class="stringliteral">"mybox"</span>, pBox);
1086
</pre></div><dl><dt><b>Parameters:</b></dt><dd>
1087
<table class="params">
1088
<tr><td class="paramname">name</td><td>The name of the widget. </td></tr>
1092
<dl><dt><b>Return values:</b></dt><dd>
1093
<table class="retval">
1094
<tr><td class="paramname">widget</td><td>A pointer to the widget, or <code>0</code> on failure. </td></tr>
1101
<a class="anchor" id="a16ab17cd36e636c3f1495ca2ef2a4f49"></a><!-- doxytag: member="Gtk::Builder::gobj" ref="a16ab17cd36e636c3f1495ca2ef2a4f49" args="()" -->
1102
<div class="memitem">
1103
<div class="memproto">
1104
<table class="memname">
1106
<td class="memname">GtkBuilder* Gtk::Builder::gobj </td>
1108
<td class="paramname"></td><td>)</td>
1109
<td><code> [inline]</code></td>
1113
<div class="memdoc">
1115
<p>Provides access to the underlying C GObject. </p>
1117
<p>Reimplemented from <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ObjectBase.html#a4c6efc18be8cb9c56e58fc0bd20fafbe">Glib::ObjectBase</a>.</p>
1121
<a class="anchor" id="a0d39f2751484ec95216add8f6629cc7d"></a><!-- doxytag: member="Gtk::Builder::gobj" ref="a0d39f2751484ec95216add8f6629cc7d" args="() const " -->
1122
<div class="memitem">
1123
<div class="memproto">
1124
<table class="memname">
1126
<td class="memname">const GtkBuilder* Gtk::Builder::gobj </td>
1128
<td class="paramname"></td><td>)</td>
1129
<td> const<code> [inline]</code></td>
1133
<div class="memdoc">
1135
<p>Provides access to the underlying C GObject. </p>
1137
<p>Reimplemented from <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ObjectBase.html#a778a94181132976bbfb0519793f3b32e">Glib::ObjectBase</a>.</p>
1141
<a class="anchor" id="a43185cdda8ad880fab2b3a9a2c1332d6"></a><!-- doxytag: member="Gtk::Builder::gobj_copy" ref="a43185cdda8ad880fab2b3a9a2c1332d6" args="()" -->
1142
<div class="memitem">
1143
<div class="memproto">
1144
<table class="memname">
1146
<td class="memname">GtkBuilder* Gtk::Builder::gobj_copy </td>
1148
<td class="paramname"></td><td>)</td>
1153
<div class="memdoc">
1155
<p>Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. </p>
1159
<a class="anchor" id="a4641c283b6979640541cd651f0c56a7b"></a><!-- doxytag: member="Gtk::Builder::property_translation_domain" ref="a4641c283b6979640541cd651f0c56a7b" args="() const " -->
1160
<div class="memitem">
1161
<div class="memproto">
1162
<table class="memname">
1164
<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>
1166
<td class="paramname"></td><td>)</td>
1171
<div class="memdoc">
1173
<p>The translation domain used by gettext. </p>
1174
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
1175
<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>
1179
<a class="anchor" id="a9af6cfd8a039d34e0eb134e782027242"></a><!-- doxytag: member="Gtk::Builder::property_translation_domain" ref="a9af6cfd8a039d34e0eb134e782027242" args="()" -->
1180
<div class="memitem">
1181
<div class="memproto">
1182
<table class="memname">
1184
<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>
1186
<td class="paramname"></td><td>)</td>
1191
<div class="memdoc">
1193
<p>The translation domain used by gettext. </p>
1194
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
1195
<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>
1199
<a class="anchor" id="a9f696bcf8d214f38d61d0d558d641245"></a><!-- doxytag: member="Gtk::Builder::set_translation_domain" ref="a9f696bcf8d214f38d61d0d558d641245" args="(const Glib::ustring &domain)" -->
1200
<div class="memitem">
1201
<div class="memproto">
1202
<table class="memname">
1204
<td class="memname">void Gtk::Builder::set_translation_domain </td>
1206
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td>
1207
<td class="paramname"><em>domain</em></td><td>)</td>
1212
<div class="memdoc">
1214
<p>Sets the translation domain of <em>builder</em>. </p>
1215
<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>
1216
<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>
1217
<dl><dt><b>Parameters:</b></dt><dd>
1218
<table class="params">
1219
<tr><td class="paramname">domain</td><td>The translation domain or <code>0</code>. </td></tr>
1226
<hr/><h2>Friends And Related Function Documentation</h2>
1227
<a class="anchor" id="a0eed615bfe0b8ce06257406172956946"></a><!-- doxytag: member="Gtk::Builder::wrap" ref="a0eed615bfe0b8ce06257406172956946" args="(GtkBuilder *object, bool take_copy=false)" -->
1228
<div class="memitem">
1229
<div class="memproto">
1230
<table class="memname">
1232
<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>
1234
<td class="paramtype">GtkBuilder * </td>
1235
<td class="paramname"><em>object</em>, </td>
1238
<td class="paramkey"></td>
1240
<td class="paramtype">bool </td>
1241
<td class="paramname"><em>take_copy</em> = <code>false</code> </td>
1246
<td></td><td><code> [related]</code></td>
1250
<div class="memdoc">
1252
<p>A <a class="elRef" href="../../../glibmm-2.4/reference/html/namespaceGlib.html#a671306f4a3a0cae5ab4d7a9d54886592">Glib::wrap()</a> method for this object. </p>
1253
<dl><dt><b>Parameters:</b></dt><dd>
1254
<table class="params">
1255
<tr><td class="paramname">object</td><td>The C instance. </td></tr>
1256
<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>
1260
<dl class="return"><dt><b>Returns:</b></dt><dd>A C++ instance that wraps this C instance. </dd></dl>
1264
<hr/>The documentation for this class was generated from the following file:<ul>
1265
<li>gtkmm/builder.h</li>
1268
<hr class="footer"/><address class="footer"><small>Generated on Fri Jul 8 2011 13:31:44 for gtkmm by 
1269
<a href="http://www.doxygen.org/index.html">
1270
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.7.3 </small></address>