~ubuntu-branches/ubuntu/raring/gtk+2.0/raring-proposed

void (<a class="link" href="GtkBuilder.html#GtkBuilderConnectFunc" title="GtkBuilderConnectFunc ()">*GtkBuilderConnectFunc</a>) (<code><a class="link" href="GtkBuilder.html" title="GtkBuilder">GtkBuilder</a> *builder</code>,

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *object</code>,

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *signal_name</code>,

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *handler_name</code>,

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *connect_object</code>,

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#GConnectFlags">GConnectFlags</a> flags</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);

<code>GObject *object</code>,

<code>const gchar *signal_name</code>,

<code>const gchar *handler_name</code>,

<code>GObject *connect_object</code>,

<code>GConnectFlags flags</code>,

<code>gpointer user_data</code>);

enum <a class="link" href="GtkBuilder.html#GtkBuilderError" title="enum GtkBuilderError">GtkBuilderError</a>;

<a class="link" href="GtkBuilder.html" title="GtkBuilder">GtkBuilder</a> * <a class="link" href="GtkBuilder.html#gtk-builder-new" title="gtk_builder_new ()">gtk_builder_new</a> (<code>void</code>);

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> <a class="link" href="GtkBuilder.html#gtk-builder-add-from-file" title="gtk_builder_add_from_file ()">gtk_builder_add_from_file</a> (<code><a class="link" href="GtkBuilder.html" title="GtkBuilder">GtkBuilder</a> *builder</code>,

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *filename</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> <a class="link" href="GtkBuilder.html#gtk-builder-add-from-string" title="gtk_builder_add_from_string ()">gtk_builder_add_from_string</a> (<code><a class="link" href="GtkBuilder.html" title="GtkBuilder">GtkBuilder</a> *builder</code>,

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *buffer</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize">gsize</a> length</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> <a class="link" href="GtkBuilder.html#gtk-builder-add-objects-from-file" title="gtk_builder_add_objects_from_file ()">gtk_builder_add_objects_from_file</a> (<code><a class="link" href="GtkBuilder.html" title="GtkBuilder">GtkBuilder</a> *builder</code>,

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *filename</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> **object_ids</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> <a class="link" href="GtkBuilder.html#gtk-builder-add-objects-from-string" title="gtk_builder_add_objects_from_string ()">gtk_builder_add_objects_from_string</a> (<code><a class="link" href="GtkBuilder.html" title="GtkBuilder">GtkBuilder</a> *builder</code>,

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *buffer</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize">gsize</a> length</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> **object_ids</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);

<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> * <a class="link" href="GtkBuilder.html#gtk-builder-get-object" title="gtk_builder_get_object ()">gtk_builder_get_object</a> (<code><a class="link" href="GtkBuilder.html" title="GtkBuilder">GtkBuilder</a> *builder</code>,

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *name</code>);

<a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList">GSList</a> * <a class="link" href="GtkBuilder.html#gtk-builder-get-objects" title="gtk_builder_get_objects ()">gtk_builder_get_objects</a> (<code><a class="link" href="GtkBuilder.html" title="GtkBuilder">GtkBuilder</a> *builder</code>);

guint <a class="link" href="GtkBuilder.html#gtk-builder-add-from-file" title="gtk_builder_add_from_file ()">gtk_builder_add_from_file</a> (<code><a class="link" href="GtkBuilder.html" title="GtkBuilder">GtkBuilder</a> *builder</code>,

<code>const gchar *filename</code>,

<code>GError **error</code>);

guint <a class="link" href="GtkBuilder.html#gtk-builder-add-from-string" title="gtk_builder_add_from_string ()">gtk_builder_add_from_string</a> (<code><a class="link" href="GtkBuilder.html" title="GtkBuilder">GtkBuilder</a> *builder</code>,

<code>const gchar *buffer</code>,

<code>gsize length</code>,

<code>GError **error</code>);

guint <a class="link" href="GtkBuilder.html#gtk-builder-add-objects-from-file" title="gtk_builder_add_objects_from_file ()">gtk_builder_add_objects_from_file</a> (<code><a class="link" href="GtkBuilder.html" title="GtkBuilder">GtkBuilder</a> *builder</code>,

<code>const gchar *filename</code>,

<code>gchar **object_ids</code>,

<code>GError **error</code>);

guint <a class="link" href="GtkBuilder.html#gtk-builder-add-objects-from-string" title="gtk_builder_add_objects_from_string ()">gtk_builder_add_objects_from_string</a> (<code><a class="link" href="GtkBuilder.html" title="GtkBuilder">GtkBuilder</a> *builder</code>,

<code>const gchar *buffer</code>,

<code>gsize length</code>,

<code>gchar **object_ids</code>,

<code>GError **error</code>);

GObject * <a class="link" href="GtkBuilder.html#gtk-builder-get-object" title="gtk_builder_get_object ()">gtk_builder_get_object</a> (<code><a class="link" href="GtkBuilder.html" title="GtkBuilder">GtkBuilder</a> *builder</code>,

<code>const gchar *name</code>);

GSList * <a class="link" href="GtkBuilder.html#gtk-builder-get-objects" title="gtk_builder_get_objects ()">gtk_builder_get_objects</a> (<code><a class="link" href="GtkBuilder.html" title="GtkBuilder">GtkBuilder</a> *builder</code>);

void <a class="link" href="GtkBuilder.html#gtk-builder-connect-signals" title="gtk_builder_connect_signals ()">gtk_builder_connect_signals</a> (<code><a class="link" href="GtkBuilder.html" title="GtkBuilder">GtkBuilder</a> *builder</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);

<code>gpointer user_data</code>);

void <a class="link" href="GtkBuilder.html#gtk-builder-connect-signals-full" title="gtk_builder_connect_signals_full ()">gtk_builder_connect_signals_full</a> (<code><a class="link" href="GtkBuilder.html" title="GtkBuilder">GtkBuilder</a> *builder</code>,

<code><a class="link" href="GtkBuilder.html#GtkBuilderConnectFunc" title="GtkBuilderConnectFunc ()">GtkBuilderConnectFunc</a> func</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);

<code>gpointer user_data</code>);

void <a class="link" href="GtkBuilder.html#gtk-builder-set-translation-domain" title="gtk_builder_set_translation_domain ()">gtk_builder_set_translation_domain</a> (<code><a class="link" href="GtkBuilder.html" title="GtkBuilder">GtkBuilder</a> *builder</code>,

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *domain</code>);

const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> * <a class="link" href="GtkBuilder.html#gtk-builder-get-translation-domain" title="gtk_builder_get_translation_domain ()">gtk_builder_get_translation_domain</a> (<code><a class="link" href="GtkBuilder.html" title="GtkBuilder">GtkBuilder</a> *builder</code>);

<a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType">GType</a> <a class="link" href="GtkBuilder.html#gtk-builder-get-type-from-name" title="gtk_builder_get_type_from_name ()">gtk_builder_get_type_from_name</a> (<code><a class="link" href="GtkBuilder.html" title="GtkBuilder">GtkBuilder</a> *builder</code>,

<code>const gchar *domain</code>);

const gchar * <a class="link" href="GtkBuilder.html#gtk-builder-get-translation-domain" title="gtk_builder_get_translation_domain ()">gtk_builder_get_translation_domain</a> (<code><a class="link" href="GtkBuilder.html" title="GtkBuilder">GtkBuilder</a> *builder</code>);

GType <a class="link" href="GtkBuilder.html#gtk-builder-get-type-from-name" title="gtk_builder_get_type_from_name ()">gtk_builder_get_type_from_name</a> (<code><a class="link" href="GtkBuilder.html" title="GtkBuilder">GtkBuilder</a> *builder</code>,

<code>const char *type_name</code>);

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="GtkBuilder.html#gtk-builder-value-from-string" title="gtk_builder_value_from_string ()">gtk_builder_value_from_string</a> (<code><a class="link" href="GtkBuilder.html" title="GtkBuilder">GtkBuilder</a> *builder</code>,

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-GParamSpec.html#GParamSpec">GParamSpec</a> *pspec</code>,

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *string</code>,

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue">GValue</a> *value</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="GtkBuilder.html#gtk-builder-value-from-string-type" title="gtk_builder_value_from_string_type ()">gtk_builder_value_from_string_type</a> (<code><a class="link" href="GtkBuilder.html" title="GtkBuilder">GtkBuilder</a> *builder</code>,

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType">GType</a> type</code>,

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *string</code>,

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue">GValue</a> *value</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);

gboolean <a class="link" href="GtkBuilder.html#gtk-builder-value-from-string" title="gtk_builder_value_from_string ()">gtk_builder_value_from_string</a> (<code><a class="link" href="GtkBuilder.html" title="GtkBuilder">GtkBuilder</a> *builder</code>,

<code>GParamSpec *pspec</code>,

<code>const gchar *string</code>,

<code>GValue *value</code>,

<code>GError **error</code>);

gboolean <a class="link" href="GtkBuilder.html#gtk-builder-value-from-string-type" title="gtk_builder_value_from_string_type ()">gtk_builder_value_from_string_type</a> (<code><a class="link" href="GtkBuilder.html" title="GtkBuilder">GtkBuilder</a> *builder</code>,

<code>GType type</code>,

<code>const gchar *string</code>,

<code>GValue *value</code>,

<code>GError **error</code>);

#define <a class="link" href="GtkBuilder.html#GTK-BUILDER-WARN-INVALID-CHILD-TYPE:CAPS" title="GTK_BUILDER_WARN_INVALID_CHILD_TYPE()">GTK_BUILDER_WARN_INVALID_CHILD_TYPE</a> (object,

type)

#define <a class="link" href="GtkBuilder.html#GTK-BUILDER-ERROR:CAPS" title="GTK_BUILDER_ERROR">GTK_BUILDER_ERROR</a>

101

102

<a name="GtkBuilder.object-hierarchy"></a><h2>Object Hierarchy</h2>

103

104

<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>

104

GObject

105

+----GtkBuilder

106

</pre>

107

</div>

108

109

<a name="GtkBuilder.properties"></a><h2>Properties</h2>

110

111

"<a class="link" href="GtkBuilder.html#GtkBuilder--translation-domain" title='The "translation-domain" property'>translation-domain</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a>* : Read / Write

111

"<a class="link" href="GtkBuilder.html#GtkBuilder--translation-domain" title='The "translation-domain" property'>translation-domain</a>" gchar* : Read / Write

112

</pre>

113

</div>

114

137

larger hierarchy constructed by the builder (in which case you should

138

not have to worry about their lifecycle), or without a parent, in which

139

case they have to be added to some container to make use of them.

140

Non-widget objects need to be reffed with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-ref"><code class="function">g_object_ref()</code></a> to keep them

140

Non-widget objects need to be reffed with <code class="function">g_object_ref()</code> to keep them

141

beyond the lifespan of the builder.

142

143

251

GtkBuilder can parse textual representations for the most

252

common property types: characters, strings, integers, floating-point

253

numbers, booleans (strings like "TRUE", "t", "yes", "y", "1" are

254

interpreted as <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, strings like "FALSE, "f", "no", "n", "0" are

255

interpreted as <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>), enumerations (can be specified by their

254

interpreted as <code class="literal">TRUE</code>, strings like "FALSE, "f", "no", "n", "0" are

255

interpreted as <code class="literal">FALSE</code>), enumerations (can be specified by their

256

name, nick or integer value), flags (can be specified by their name,

257

nick, integer value, optionally combined with "|", e.g.

258

"GTK_VISIBLE|GTK_REALIZED") and colors (in a format understood by

259

<a href="http://library.gnome.org/devel/gdk3/gdk-Colormaps-and-Colors.html#gdk-color-parse"><code class="function">gdk_color_parse()</code></a>). Objects can be referred to by their name.

259

<a href="../gdk2/gdk2-Colormaps-and-Colors.html#gdk-color-parse"><code class="function">gdk_color_parse()</code></a>). Objects can be referred to by their name.

260

Pixbufs can be specified as a filename of an image file to load.

261

In general, GtkBuilder allows forward references to objects —

262

an object doesn't have to constructed before it can be referred to.

267

Signal handlers are set up with the <signal> element.

268

The "name" attribute specifies the name of the signal, and the

269

"handler" attribute specifies the function to connect to the signal.

270

By default, GTK+ tries to find the handler using <a href="http://library.gnome.org/devel/glib/unstable/glib-Dynamic-Loading-of-Modules.html#g-module-symbol"><code class="function">g_module_symbol()</code></a>,

270

By default, GTK+ tries to find the handler using <code class="function">g_module_symbol()</code>,

271

but this can be changed by passing a custom <a class="link" href="GtkBuilder.html#GtkBuilderConnectFunc" title="GtkBuilderConnectFunc ()">GtkBuilderConnectFunc</a>

272

to <a class="link" href="GtkBuilder.html#gtk-builder-connect-signals-full" title="gtk_builder_connect_signals_full ()"><code class="function">gtk_builder_connect_signals_full()</code></a>. The remaining attributes,

273

"after", "swapped" and "object", have the same meaning as the

274

corresponding parameters of the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#g-signal-connect-object"><code class="function">g_signal_connect_object()</code></a> or

275

<a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#g-signal-connect-data"><code class="function">g_signal_connect_data()</code></a> functions. A "last_modification_time" attribute

274

corresponding parameters of the <code class="function">g_signal_connect_object()</code> or

275

<code class="function">g_signal_connect_data()</code> functions. A "last_modification_time" attribute

276

is also allowed, but it does not have a meaning to the builder.

277

278

292

the sections describing the widget-specific portions of UI definitions.

293

294

295

<a name="idp112205808"></a>Example 61. A GtkBuilder UI Definition

295

<a name="idp114770336"></a>Example 61. A GtkBuilder UI Definition

296

297

298

<tbody>

329

<child>

330

331

332

332

333

334

</object>

335

</child>

392

393

<a name="GtkBuilderConnectFunc"></a><h3>GtkBuilderConnectFunc ()</h3>

394

<pre class="programlisting">void (*GtkBuilderConnectFunc) (<code><a class="link" href="GtkBuilder.html" title="GtkBuilder">GtkBuilder</a> *builder</code>,

395

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *object</code>,

396

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *signal_name</code>,

397

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *handler_name</code>,

398

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *connect_object</code>,

399

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#GConnectFlags">GConnectFlags</a> flags</code>,

400

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

395

<code>GObject *object</code>,

396

<code>const gchar *signal_name</code>,

397

<code>const gchar *handler_name</code>,

398

<code>GObject *connect_object</code>,

399

<code>GConnectFlags flags</code>,

400

<code>gpointer user_data</code>);</pre>

401

402

This is the signature of a function used to connect signals. It is used

403

by the <a class="link" href="GtkBuilder.html#gtk-builder-connect-signals" title="gtk_builder_connect_signals ()"><code class="function">gtk_builder_connect_signals()</code></a> and <a class="link" href="GtkBuilder.html#gtk-builder-connect-signals-full" title="gtk_builder_connect_signals_full ()"><code class="function">gtk_builder_connect_signals_full()</code></a>

430

</tr>

431

<tr>

432

<td><code>connect_object</code> :</td>

433

<td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>, if non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, use <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#g-signal-connect-object"><code class="function">g_signal_connect_object()</code></a>

433

<td>a GObject, if non-<a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>, use <code class="function">g_signal_connect_object()</code>

434

</td>

435

</tr>

436

<tr>

437

<td><code>flags</code> :</td>

438

<td>

439

<a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#GConnectFlags">GConnectFlags</a> to use</td>

439

GConnectFlags to use</td>

440

</tr>

441

<tr>

442

474

<tr>

475

<td><a name="GTK-BUILDER-ERROR-INVALID-TYPE-FUNCTION:CAPS"></a><code class="literal">GTK_BUILDER_ERROR_INVALID_TYPE_FUNCTION</code></td>

476

<td>A type-func attribute didn't name

477

a function that returns a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType">GType</a>.

477

a function that returns a GType.

478

</td>

479

</tr>

480

<tr>

552

<hr>

553

554

<a name="gtk-builder-add-from-file"></a><h3>gtk_builder_add_from_file ()</h3>

555

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> gtk_builder_add_from_file (<code><a class="link" href="GtkBuilder.html" title="GtkBuilder">GtkBuilder</a> *builder</code>,

556

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *filename</code>,

557

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

555

<pre class="programlisting">guint gtk_builder_add_from_file (<code><a class="link" href="GtkBuilder.html" title="GtkBuilder">GtkBuilder</a> *builder</code>,

556

<code>const gchar *filename</code>,

557

<code>GError **error</code>);</pre>

558

559

Parses a file containing a <a class="link" href="GtkBuilder.html#BUILDER-UI" title="GtkBuilder UI Definitions">GtkBuilder

560

UI definition</a> and merges it with the current contents of <code>builder</code>.

561

562

563

Upon errors 0 will be returned and <code>error</code> will be assigned a

564

<a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> from the <a class="link" href="GtkBuilder.html#GTK-BUILDER-ERROR:CAPS" title="GTK_BUILDER_ERROR">GTK_BUILDER_ERROR</a>, <a href="http://library.gnome.org/devel/glib/unstable/glib-Simple-XML-Subset-Parser.html#G-MARKUP-ERROR:CAPS">G_MARKUP_ERROR</a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-File-Utilities.html#G-FILE-ERROR:CAPS">G_FILE_ERROR</a>

564

GError from the <a class="link" href="GtkBuilder.html#GTK-BUILDER-ERROR:CAPS" title="GTK_BUILDER_ERROR">GTK_BUILDER_ERROR</a>, G_MARKUP_ERROR or G_FILE_ERROR

565

domain.

566

567

581

</tr>

582

<tr>

583

<td><code>error</code> :</td>

584

<td>return location for an error, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

584

<td>return location for an error, or <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

585

</td>

586

</tr>

587

<tr>

595

<hr>

596

597

<a name="gtk-builder-add-from-string"></a><h3>gtk_builder_add_from_string ()</h3>

598

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> gtk_builder_add_from_string (<code><a class="link" href="GtkBuilder.html" title="GtkBuilder">GtkBuilder</a> *builder</code>,

599

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *buffer</code>,

600

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize">gsize</a> length</code>,

601

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

598

<pre class="programlisting">guint gtk_builder_add_from_string (<code><a class="link" href="GtkBuilder.html" title="GtkBuilder">GtkBuilder</a> *builder</code>,

599

<code>const gchar *buffer</code>,

600

<code>gsize length</code>,

601

<code>GError **error</code>);</pre>

602

603

Parses a string containing a <a class="link" href="GtkBuilder.html#BUILDER-UI" title="GtkBuilder UI Definitions">GtkBuilder

604

UI definition</a> and merges it with the current contents of <code>builder</code>.

605

606

607

Upon errors 0 will be returned and <code>error</code> will be assigned a

608

<a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> from the <a class="link" href="GtkBuilder.html#GTK-BUILDER-ERROR:CAPS" title="GTK_BUILDER_ERROR">GTK_BUILDER_ERROR</a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Simple-XML-Subset-Parser.html#G-MARKUP-ERROR:CAPS">G_MARKUP_ERROR</a> domain.

608

GError from the <a class="link" href="GtkBuilder.html#GTK-BUILDER-ERROR:CAPS" title="GTK_BUILDER_ERROR">GTK_BUILDER_ERROR</a> or G_MARKUP_ERROR domain.

609

610

611

628

</tr>

629

<tr>

630

<td><code>error</code> :</td>

631

632

</td>

633

</tr>

634

<tr>

642

<hr>

643

644

<a name="gtk-builder-add-objects-from-file"></a><h3>gtk_builder_add_objects_from_file ()</h3>

645

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> gtk_builder_add_objects_from_file (<code><a class="link" href="GtkBuilder.html" title="GtkBuilder">GtkBuilder</a> *builder</code>,

646

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *filename</code>,

647

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> **object_ids</code>,

648

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

645

<pre class="programlisting">guint gtk_builder_add_objects_from_file (<code><a class="link" href="GtkBuilder.html" title="GtkBuilder">GtkBuilder</a> *builder</code>,

646

<code>const gchar *filename</code>,

647

<code>gchar **object_ids</code>,

648

<code>GError **error</code>);</pre>

649

650

Parses a file containing a <a class="link" href="GtkBuilder.html#BUILDER-UI" title="GtkBuilder UI Definitions">GtkBuilder

651

UI definition</a> building only the requested objects and merges

653

654

655

Upon errors 0 will be returned and <code>error</code> will be assigned a

656

657

domain.

658

659

689

</tr>

690

<tr>

691

<td><code>error</code> :</td>

692

693

</td>

694

</tr>

695

<tr>

703

<hr>

704

705

<a name="gtk-builder-add-objects-from-string"></a><h3>gtk_builder_add_objects_from_string ()</h3>

706

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> gtk_builder_add_objects_from_string (<code><a class="link" href="GtkBuilder.html" title="GtkBuilder">GtkBuilder</a> *builder</code>,

707

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *buffer</code>,

708

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize">gsize</a> length</code>,

709

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> **object_ids</code>,

710

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

706

<pre class="programlisting">guint gtk_builder_add_objects_from_string (<code><a class="link" href="GtkBuilder.html" title="GtkBuilder">GtkBuilder</a> *builder</code>,

707

<code>const gchar *buffer</code>,

708

<code>gsize length</code>,

709

<code>gchar **object_ids</code>,

710

<code>GError **error</code>);</pre>

711

712

Parses a string containing a <a class="link" href="GtkBuilder.html#BUILDER-UI" title="GtkBuilder UI Definitions">GtkBuilder

713

UI definition</a> building only the requested objects and merges

715

716

717

Upon errors 0 will be returned and <code>error</code> will be assigned a

718

<a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> from the <a class="link" href="GtkBuilder.html#GTK-BUILDER-ERROR:CAPS" title="GTK_BUILDER_ERROR">GTK_BUILDER_ERROR</a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Simple-XML-Subset-Parser.html#G-MARKUP-ERROR:CAPS">G_MARKUP_ERROR</a> domain.

718

GError from the <a class="link" href="GtkBuilder.html#GTK-BUILDER-ERROR:CAPS" title="GTK_BUILDER_ERROR">GTK_BUILDER_ERROR</a> or G_MARKUP_ERROR domain.

719

720

721

754

</tr>

755

<tr>

756

<td><code>error</code> :</td>

757

758

</td>

759

</tr>

760

<tr>

768

<hr>

769

770

<a name="gtk-builder-get-object"></a><h3>gtk_builder_get_object ()</h3>

771

<pre class="programlisting"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> * gtk_builder_get_object (<code><a class="link" href="GtkBuilder.html" title="GtkBuilder">GtkBuilder</a> *builder</code>,

772

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *name</code>);</pre>

771

<pre class="programlisting">GObject * gtk_builder_get_object (<code><a class="link" href="GtkBuilder.html" title="GtkBuilder">GtkBuilder</a> *builder</code>,

772

<code>const gchar *name</code>);</pre>

773

774

Gets the object named <code>name</code>. Note that this function does not

775

increment the reference count of the returned object.

791

</tr>

792

<tr>

793

<td>Returns :</td>

794

<td>the object named <code>name</code> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if

794

<td>the object named <code>name</code> or <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a> if

795

it could not be found in the object tree. [<acronym title="Don't free data after the code is done.">transfer none</acronym>]

796

</td>

797

</tr>

802

<hr>

803

804

<a name="gtk-builder-get-objects"></a><h3>gtk_builder_get_objects ()</h3>

805

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList">GSList</a> * gtk_builder_get_objects (<code><a class="link" href="GtkBuilder.html" title="GtkBuilder">GtkBuilder</a> *builder</code>);</pre>

805

<pre class="programlisting">GSList * gtk_builder_get_objects (<code><a class="link" href="GtkBuilder.html" title="GtkBuilder">GtkBuilder</a> *builder</code>);</pre>

806

807

Gets all objects that have been constructed by <code>builder</code>. Note that

808

this function does not increment the reference counts of the returned

821

</tr>

822

<tr>

823

<td>Returns :</td>

824

<td>a newly-allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList">GSList</a> containing all the objects

824

<td>a newly-allocated GSList containing all the objects

825

constructed by the <a class="link" href="GtkBuilder.html" title="GtkBuilder">GtkBuilder</a> instance. It should be freed by

826

<a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#g-slist-free"><code class="function">g_slist_free()</code></a>. [<acronym title="Generics and defining elements of containers and arrays.">element-type</acronym> GObject][<acronym title="Free data container after the code is done.">transfer container</acronym>]

826

<code class="function">g_slist_free()</code>. [<acronym title="Generics and defining elements of containers and arrays.">element-type</acronym> GObject][<acronym title="Free data container after the code is done.">transfer container</acronym>]

827

</td>

828

</tr>

829

</tbody>

834

835

<a name="gtk-builder-connect-signals"></a><h3>gtk_builder_connect_signals ()</h3>

836

<pre class="programlisting">void gtk_builder_connect_signals (<code><a class="link" href="GtkBuilder.html" title="GtkBuilder">GtkBuilder</a> *builder</code>,

837

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

837

<code>gpointer user_data</code>);</pre>

838

839

This method is a simpler variation of <a class="link" href="GtkBuilder.html#gtk-builder-connect-signals-full" title="gtk_builder_connect_signals_full ()"><code class="function">gtk_builder_connect_signals_full()</code></a>.

840

It uses <a href="http://library.gnome.org/devel/glib/unstable/glib-Dynamic-Loading-of-Modules.html#GModule">GModule</a>'s introspective features (by opening the module <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>)

840

It uses GModule's introspective features (by opening the module <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>)

841

to look at the application's symbol table. From here it tries to match

842

the signal handler names given in the interface description with

843

symbols in the application and connects the signals.

844

845

846

Note that this function will not work correctly if <a href="http://library.gnome.org/devel/glib/unstable/glib-Dynamic-Loading-of-Modules.html#GModule">GModule</a> is not

846

Note that this function will not work correctly if GModule is not

847

supported on the platform.

848

849

850

When compiling applications for Windows, you must declare signal callbacks

851

with <a href="http://library.gnome.org/devel/glib/unstable/glib-Dynamic-Loading-of-Modules.html#G-MODULE-EXPORT:CAPS">G_MODULE_EXPORT</a>, or they will not be put in the symbol table.

851

with G_MODULE_EXPORT, or they will not be put in the symbol table.

852

On Linux and Unices, this is not necessary; applications should instead

853

be compiled with the -Wl,--export-dynamic CFLAGS, and linked against

854

gmodule-export-2.0.

877

<a name="gtk-builder-connect-signals-full"></a><h3>gtk_builder_connect_signals_full ()</h3>

878

<pre class="programlisting">void gtk_builder_connect_signals_full (<code><a class="link" href="GtkBuilder.html" title="GtkBuilder">GtkBuilder</a> *builder</code>,

879

<code><a class="link" href="GtkBuilder.html#GtkBuilderConnectFunc" title="GtkBuilderConnectFunc ()">GtkBuilderConnectFunc</a> func</code>,

880

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

880

<code>gpointer user_data</code>);</pre>

881

882

This function can be thought of the interpreted language binding

883

version of <a class="link" href="GtkBuilder.html#gtk-builder-connect-signals" title="gtk_builder_connect_signals ()"><code class="function">gtk_builder_connect_signals()</code></a>, except that it does not

911

912

<a name="gtk-builder-set-translation-domain"></a><h3>gtk_builder_set_translation_domain ()</h3>

913

<pre class="programlisting">void gtk_builder_set_translation_domain (<code><a class="link" href="GtkBuilder.html" title="GtkBuilder">GtkBuilder</a> *builder</code>,

914

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *domain</code>);</pre>

914

<code>const gchar *domain</code>);</pre>

915

916

Sets the translation domain of <code>builder</code>.

917

See <a class="link" href="GtkBuilder.html#GtkBuilder--translation-domain" title='The "translation-domain" property'>"translation-domain"</a>.

929

</tr>

930

<tr>

931

<td><code>domain</code> :</td>

932

<td>the translation domain or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

932

<td>the translation domain or <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

933

</td>

934

</tr>

935

</tbody>

939

<hr>

940

941

<a name="gtk-builder-get-translation-domain"></a><h3>gtk_builder_get_translation_domain ()</h3>

942

<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> * gtk_builder_get_translation_domain (<code><a class="link" href="GtkBuilder.html" title="GtkBuilder">GtkBuilder</a> *builder</code>);</pre>

942

<pre class="programlisting">const gchar * gtk_builder_get_translation_domain (<code><a class="link" href="GtkBuilder.html" title="GtkBuilder">GtkBuilder</a> *builder</code>);</pre>

943

944

Gets the translation domain of <code>builder</code>.

945

966

<hr>

967

968

<a name="gtk-builder-get-type-from-name"></a><h3>gtk_builder_get_type_from_name ()</h3>

969

<pre class="programlisting"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType">GType</a> gtk_builder_get_type_from_name (<code><a class="link" href="GtkBuilder.html" title="GtkBuilder">GtkBuilder</a> *builder</code>,

969

<pre class="programlisting">GType gtk_builder_get_type_from_name (<code><a class="link" href="GtkBuilder.html" title="GtkBuilder">GtkBuilder</a> *builder</code>,

970

<code>const char *type_name</code>);</pre>

971

972

Looks up a type by name, using the virtual function that

990

</tr>

991

<tr>

992

<td>Returns :</td>

993

<td>the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType">GType</a> found for <code>type_name</code> or <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-TYPE-INVALID:CAPS">G_TYPE_INVALID</a>

993

<td>the GType found for <code>type_name</code> or G_TYPE_INVALID

994

if no type was found</td>

995

</tr>

996

</tbody>

1000

<hr>

1001

1002

<a name="gtk-builder-value-from-string"></a><h3>gtk_builder_value_from_string ()</h3>

1003

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> gtk_builder_value_from_string (<code><a class="link" href="GtkBuilder.html" title="GtkBuilder">GtkBuilder</a> *builder</code>,

1004

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-GParamSpec.html#GParamSpec">GParamSpec</a> *pspec</code>,

1005

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *string</code>,

1006

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue">GValue</a> *value</code>,

1007

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

1003

<pre class="programlisting">gboolean gtk_builder_value_from_string (<code><a class="link" href="GtkBuilder.html" title="GtkBuilder">GtkBuilder</a> *builder</code>,

1004

<code>GParamSpec *pspec</code>,

1005

<code>const gchar *string</code>,

1006

<code>GValue *value</code>,

1007

<code>GError **error</code>);</pre>

1008

1009

This function demarshals a value from a string. This function

1010

calls <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#g-value-init"><code class="function">g_value_init()</code></a> on the <code>value</code> argument, so it need not be

1010

calls <code class="function">g_value_init()</code> on the <code>value</code> argument, so it need not be

1011

initialised beforehand.

1012

1013

1014

This function can handle char, uchar, boolean, int, uint, long,

1015

ulong, enum, flags, float, double, string, <a href="http://library.gnome.org/devel/gdk3/gdk-Colormaps-and-Colors.html#GdkColor">GdkColor</a> and

1015

ulong, enum, flags, float, double, string, <a href="../gdk2/gdk2-Colormaps-and-Colors.html#GdkColor">GdkColor</a> and

1016

<a class="link" href="GtkAdjustment.html" title="GtkAdjustment">GtkAdjustment</a> type values. Support for <a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> type values is

1017

still to come.

1018

1019

1020

Upon errors <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> will be returned and <code>error</code> will be assigned a

1021

1020

Upon errors <code class="literal">FALSE</code> will be returned and <code>error</code> will be assigned a

1021

GError from the <a class="link" href="GtkBuilder.html#GTK-BUILDER-ERROR:CAPS" title="GTK_BUILDER_ERROR">GTK_BUILDER_ERROR</a> domain.

1022

1023

1024

1033

</tr>

1034

<tr>

1035

<td><code>pspec</code> :</td>

1036

<td>the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-GParamSpec.html#GParamSpec">GParamSpec</a> for the property</td>

1036

<td>the GParamSpec for the property</td>

1037

</tr>

1038

<tr>

1039

<td><code>string</code> :</td>

1041

</tr>

1042

<tr>

1043

<td><code>value</code> :</td>

1044

<td>the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue">GValue</a> to store the result in. [<acronym title="Parameter for returning results. Default is transfer full.">out</acronym>]

1044

<td>the GValue to store the result in. [<acronym title="Parameter for returning results. Default is transfer full.">out</acronym>]

1045

</td>

1046

</tr>

1047

<tr>

1048

<td><code>error</code> :</td>

1049

1050

</td>

1051

</tr>

1052

<tr>

1053

<td>Returns :</td>

1054

<td>

1055

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on success</td>

1055

<code class="literal">TRUE</code> on success</td>

1056

</tr>

1057

</tbody>

1058

</table></div>

1061

<hr>

1062

1063

<a name="gtk-builder-value-from-string-type"></a><h3>gtk_builder_value_from_string_type ()</h3>

1064

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> gtk_builder_value_from_string_type (<code><a class="link" href="GtkBuilder.html" title="GtkBuilder">GtkBuilder</a> *builder</code>,

1065

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType">GType</a> type</code>,

1066

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *string</code>,

1067

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue">GValue</a> *value</code>,

1068

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

1064

<pre class="programlisting">gboolean gtk_builder_value_from_string_type (<code><a class="link" href="GtkBuilder.html" title="GtkBuilder">GtkBuilder</a> *builder</code>,

1065

<code>GType type</code>,

1066

<code>const gchar *string</code>,

1067

<code>GValue *value</code>,

1068

<code>GError **error</code>);</pre>

1069

1070

Like <a class="link" href="GtkBuilder.html#gtk-builder-value-from-string" title="gtk_builder_value_from_string ()"><code class="function">gtk_builder_value_from_string()</code></a>, this function demarshals

1071

a value from a string, but takes a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType">GType</a> instead of <a href="http://library.gnome.org/devel/gobject/unstable/gobject-GParamSpec.html#GParamSpec">GParamSpec</a>.

1072

This function calls <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#g-value-init"><code class="function">g_value_init()</code></a> on the <code>value</code> argument, so it

1071

a value from a string, but takes a GType instead of GParamSpec.

1072

This function calls <code class="function">g_value_init()</code> on the <code>value</code> argument, so it

1073

need not be initialised beforehand.

1074

1075

1076

1077

1076

Upon errors <code class="literal">FALSE</code> will be returned and <code>error</code> will be assigned a

1077

GError from the <a class="link" href="GtkBuilder.html#GTK-BUILDER-ERROR:CAPS" title="GTK_BUILDER_ERROR">GTK_BUILDER_ERROR</a> domain.

1078

1079

1080

1089

</tr>

1090

<tr>

1091

1092

<td>the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType">GType</a> of the value</td>

1092

<td>the GType of the value</td>

1093

</tr>

1094

<tr>

1095

<td><code>string</code> :</td>

1097

</tr>

1098

<tr>

1099

<td><code>value</code> :</td>

1100

1101

</td>

1102

</tr>

1103

<tr>

1104

<td><code>error</code> :</td>

1105

1106

</td>

1107

</tr>

1108

<tr>

1109

<td>Returns :</td>

1110

<td>

1111

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on success</td>

1111

<code class="literal">TRUE</code> on success</td>

1112

</tr>

1113

</tbody>

1114

</table></div>

1145

<pre class="programlisting">#define GTK_BUILDER_ERROR (gtk_builder_error_quark ())

1146

</pre>

1147

1148

The <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> quark for <a class="link" href="GtkBuilder.html" title="GtkBuilder">GtkBuilder</a> errors

1148

The GError quark for <a class="link" href="GtkBuilder.html" title="GtkBuilder">GtkBuilder</a> errors

1149

1150

</div>

1151

</div>

1153

<a name="GtkBuilder.property-details"></a><h2>Property Details</h2>

1154

1155

<a name="GtkBuilder--translation-domain"></a><h3>The <code class="literal">"translation-domain"</code> property</h3>

1156

<pre class="programlisting"> "translation-domain" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a>* : Read / Write</pre>

1156

<pre class="programlisting"> "translation-domain" gchar* : Read / Write</pre>

1157

1158

The translation domain used when translating property values that

1159

have been marked as translatable in interface descriptions.

1160

If the translation domain is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, <a class="link" href="GtkBuilder.html" title="GtkBuilder">GtkBuilder</a> uses <code class="function">gettext()</code>,

1161

otherwise <a href="http://library.gnome.org/devel/glib/unstable/glib-I18N.html#g-dgettext"><code class="function">g_dgettext()</code></a>.

1160

If the translation domain is <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>, <a class="link" href="GtkBuilder.html" title="GtkBuilder">GtkBuilder</a> uses <code class="function">gettext()</code>,

1161

otherwise <code class="function">g_dgettext()</code>.

1162

1163

Default value: NULL

1164

Since 2.12

1167

</div>

1168

1169

<hr>

1170

Generated by GTK-Doc V1.18.1</div>

1170

Generated by GTK-Doc V1.18</div>

1171

</body>

1172

</html>

b'\\ No newline at end of file'

Older »