New upstream version 3.24.5
This commit is contained in:
Jeremy Bicha
@ -99,7 +99,7 @@
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="function_type">
|
||||
<span class="returnvalue">GCallback</span>
|
||||
<a href="https://developer.gnome.org/gobject/unstable/gobject-Closures.html#GCallback"><span class="returnvalue">GCallback</span></a>
|
||||
</td>
|
||||
<td class="function_name">
|
||||
<a class="link" href="GtkBuilder.html#gtk-builder-lookup-callback-symbol" title="gtk_builder_lookup_callback_symbol ()">gtk_builder_lookup_callback_symbol</a> <span class="c_punctuation">()</span>
|
||||
@ -107,7 +107,7 @@
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="function_type">
|
||||
<span class="returnvalue">guint</span>
|
||||
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>
|
||||
</td>
|
||||
<td class="function_name">
|
||||
<a class="link" href="GtkBuilder.html#gtk-builder-add-from-file" title="gtk_builder_add_from_file ()">gtk_builder_add_from_file</a> <span class="c_punctuation">()</span>
|
||||
@ -115,7 +115,7 @@
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="function_type">
|
||||
<span class="returnvalue">guint</span>
|
||||
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>
|
||||
</td>
|
||||
<td class="function_name">
|
||||
<a class="link" href="GtkBuilder.html#gtk-builder-add-from-resource" title="gtk_builder_add_from_resource ()">gtk_builder_add_from_resource</a> <span class="c_punctuation">()</span>
|
||||
@ -123,7 +123,7 @@
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="function_type">
|
||||
<span class="returnvalue">guint</span>
|
||||
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>
|
||||
</td>
|
||||
<td class="function_name">
|
||||
<a class="link" href="GtkBuilder.html#gtk-builder-add-from-string" title="gtk_builder_add_from_string ()">gtk_builder_add_from_string</a> <span class="c_punctuation">()</span>
|
||||
@ -131,7 +131,7 @@
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="function_type">
|
||||
<span class="returnvalue">guint</span>
|
||||
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>
|
||||
</td>
|
||||
<td class="function_name">
|
||||
<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> <span class="c_punctuation">()</span>
|
||||
@ -139,7 +139,7 @@
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="function_type">
|
||||
<span class="returnvalue">guint</span>
|
||||
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>
|
||||
</td>
|
||||
<td class="function_name">
|
||||
<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> <span class="c_punctuation">()</span>
|
||||
@ -147,7 +147,7 @@
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="function_type">
|
||||
<span class="returnvalue">guint</span>
|
||||
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>
|
||||
</td>
|
||||
<td class="function_name">
|
||||
<a class="link" href="GtkBuilder.html#gtk-builder-add-objects-from-resource" title="gtk_builder_add_objects_from_resource ()">gtk_builder_add_objects_from_resource</a> <span class="c_punctuation">()</span>
|
||||
@ -155,7 +155,7 @@
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="function_type">
|
||||
<span class="returnvalue">guint</span>
|
||||
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>
|
||||
</td>
|
||||
<td class="function_name">
|
||||
<a class="link" href="GtkBuilder.html#gtk-builder-extend-with-template" title="gtk_builder_extend_with_template ()">gtk_builder_extend_with_template</a> <span class="c_punctuation">()</span>
|
||||
@ -163,7 +163,7 @@
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="function_type">
|
||||
<span class="returnvalue">GObject</span> *
|
||||
<a href="https://developer.gnome.org/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-struct"><span class="returnvalue">GObject</span></a> *
|
||||
</td>
|
||||
<td class="function_name">
|
||||
<a class="link" href="GtkBuilder.html#gtk-builder-get-object" title="gtk_builder_get_object ()">gtk_builder_get_object</a> <span class="c_punctuation">()</span>
|
||||
@ -171,7 +171,7 @@
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="function_type">
|
||||
<span class="returnvalue">GSList</span> *
|
||||
<a href="https://developer.gnome.org/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="returnvalue">GSList</span></a> *
|
||||
</td>
|
||||
<td class="function_name">
|
||||
<a class="link" href="GtkBuilder.html#gtk-builder-get-objects" title="gtk_builder_get_objects ()">gtk_builder_get_objects</a> <span class="c_punctuation">()</span>
|
||||
@ -210,7 +210,7 @@
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="function_type">const <span class="returnvalue">gchar</span> *
|
||||
<td class="function_type">const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
|
||||
</td>
|
||||
<td class="function_name">
|
||||
<a class="link" href="GtkBuilder.html#gtk-builder-get-translation-domain" title="gtk_builder_get_translation_domain ()">gtk_builder_get_translation_domain</a> <span class="c_punctuation">()</span>
|
||||
@ -234,7 +234,7 @@
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="function_type">
|
||||
<span class="returnvalue">GType</span>
|
||||
<a href="https://developer.gnome.org/gobject/unstable/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a>
|
||||
</td>
|
||||
<td class="function_name">
|
||||
<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> <span class="c_punctuation">()</span>
|
||||
@ -242,7 +242,7 @@
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="function_type">
|
||||
<span class="returnvalue">gboolean</span>
|
||||
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
||||
</td>
|
||||
<td class="function_name">
|
||||
<a class="link" href="GtkBuilder.html#gtk-builder-value-from-string" title="gtk_builder_value_from_string ()">gtk_builder_value_from_string</a> <span class="c_punctuation">()</span>
|
||||
@ -250,7 +250,7 @@
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="function_type">
|
||||
<span class="returnvalue">gboolean</span>
|
||||
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
||||
</td>
|
||||
<td class="function_name">
|
||||
<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> <span class="c_punctuation">()</span>
|
||||
@ -275,7 +275,7 @@
|
||||
</colgroup>
|
||||
<tbody><tr>
|
||||
<td class="property_type">
|
||||
<span class="type">gchar</span> *</td>
|
||||
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
|
||||
<td class="property_name"><a class="link" href="GtkBuilder.html#GtkBuilder--translation-domain" title="The “translation-domain” property">translation-domain</a></td>
|
||||
<td class="property_flags">Read / Write</td>
|
||||
</tr></tbody>
|
||||
@ -306,7 +306,7 @@
|
||||
</div>
|
||||
<div class="refsect1">
|
||||
<a name="GtkBuilder.object-hierarchy"></a><h2>Object Hierarchy</h2>
|
||||
<pre class="screen"> GObject
|
||||
<pre class="screen"> <a href="https://developer.gnome.org/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-struct">GObject</a>
|
||||
<span class="lineart">╰──</span> GtkBuilder
|
||||
</pre>
|
||||
</div>
|
||||
@ -341,7 +341,7 @@ with <a class="link" href="GtkWidget.html#gtk-widget-destroy" title="gtk_widget_
|
||||
larger hierarchy constructed by the builder (in which case you should
|
||||
not have to worry about their lifecycle), or without a parent, in which
|
||||
case they have to be added to some container to make use of them.
|
||||
Non-widget objects need to be reffed with <code class="function">g_object_ref()</code> to keep them
|
||||
Non-widget objects need to be reffed with <a href="https://developer.gnome.org/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-ref"><code class="function">g_object_ref()</code></a> to keep them
|
||||
beyond the lifespan of the builder.</p>
|
||||
<p>The function <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 variants thereof can be
|
||||
used to connect handlers to the named signals in the description.</p>
|
||||
@ -399,12 +399,12 @@ may help the translators.</p>
|
||||
<p>GtkBuilder can parse textual representations for the most common
|
||||
property types: characters, strings, integers, floating-point numbers,
|
||||
booleans (strings like “TRUE”, “t”, “yes”, “y”, “1” are interpreted
|
||||
as <code class="literal">TRUE</code>, strings like “FALSE”, “f”, “no”, “n”, “0” are interpreted
|
||||
as <code class="literal">FALSE</code>), enumerations (can be specified by their name, nick or
|
||||
as <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, strings like “FALSE”, “f”, “no”, “n”, “0” are interpreted
|
||||
as <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>), enumerations (can be specified by their name, nick or
|
||||
integer value), flags (can be specified by their name, nick, integer
|
||||
value, optionally combined with “|”, e.g. “GTK_VISIBLE|GTK_REALIZED”)
|
||||
and colors (in a format understood by <a href="https://developer.gnome.org/gdk3/gdk3-RGBA-Colors.html#gdk-rgba-parse"><code class="function">gdk_rgba_parse()</code></a>).</p>
|
||||
<p>GVariants can be specified in the format understood by <code class="function">g_variant_parse()</code>,
|
||||
<p>GVariants can be specified in the format understood by <a href="https://developer.gnome.org/glib/unstable/glib-GVariant.html#g-variant-parse"><code class="function">g_variant_parse()</code></a>,
|
||||
and pixbufs can be specified as a filename of an image file to load.</p>
|
||||
<p>Objects can be referred to by their name and by default refer to
|
||||
objects declared in the local xml fragment and objects exposed via
|
||||
@ -419,16 +419,16 @@ property value using the attributes
|
||||
"bind-property" to specify the source property and optionally
|
||||
"bind-flags" to specify the binding flags
|
||||
Internally builder implement this using GBinding objects.
|
||||
For more information see <code class="function">g_object_bind_property()</code></p>
|
||||
For more information see <a href="https://developer.gnome.org/gobject/unstable/GBinding.html#g-object-bind-property"><code class="function">g_object_bind_property()</code></a></p>
|
||||
<p>Signal handlers are set up with the <signal> element. The “name”
|
||||
attribute specifies the name of the signal, and the “handler” attribute
|
||||
specifies the function to connect to the signal. By default, GTK+ tries
|
||||
to find the handler using <code class="function">g_module_symbol()</code>, but this can be changed by
|
||||
to find the handler using <a href="https://developer.gnome.org/glib/unstable/glib-Dynamic-Loading-of-Modules.html#g-module-symbol"><code class="function">g_module_symbol()</code></a>, but this can be changed by
|
||||
passing a custom <a class="link" href="GtkBuilder.html#GtkBuilderConnectFunc" title="GtkBuilderConnectFunc ()"><span class="type">GtkBuilderConnectFunc</span></a> 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, “after”,
|
||||
“swapped” and “object”, have the same meaning as the corresponding
|
||||
parameters of the <code class="function">g_signal_connect_object()</code> or
|
||||
<code class="function">g_signal_connect_data()</code> functions. A “last_modification_time”
|
||||
parameters of the <a href="https://developer.gnome.org/gobject/unstable/gobject-Signals.html#g-signal-connect-object"><code class="function">g_signal_connect_object()</code></a> or
|
||||
<a href="https://developer.gnome.org/gobject/unstable/gobject-Signals.html#g-signal-connect-data"><code class="function">g_signal_connect_data()</code></a> functions. A “last_modification_time”
|
||||
attribute is also allowed, but it does not have a meaning to the
|
||||
builder.</p>
|
||||
<p>Sometimes it is necessary to refer to widgets which have implicitly
|
||||
@ -484,7 +484,7 @@ sections describing the widget-specific portions of UI definitions.</p>
|
||||
<span class="normal"> </span><span class="symbol"><</span><span class="normal">child</span><span class="symbol">></span>
|
||||
<span class="normal"> </span><span class="symbol"><</span><span class="usertype">object</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"GtkButton"</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"ok_button"</span><span class="symbol">></span>
|
||||
<span class="normal"> </span><span class="symbol"><</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"label"</span><span class="symbol">></span><span class="normal">gtk</span><span class="symbol">-</span><span class="normal">ok</span><span class="symbol"></</span><span class="normal">property</span><span class="symbol">></span>
|
||||
<span class="normal"> </span><span class="symbol"><</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"use-stock"</span><span class="symbol">></span><span class="normal">TRUE</span><span class="symbol"></</span><span class="normal">property</span><span class="symbol">></span>
|
||||
<span class="normal"> </span><span class="symbol"><</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"use-stock"</span><span class="symbol">></span><span class="normal"><a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS">TRUE</a></span><span class="symbol"></</span><span class="normal">property</span><span class="symbol">></span>
|
||||
<span class="normal"> </span><span class="symbol"><</span><span class="usertype">signal</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"clicked"</span><span class="normal"> handler</span><span class="symbol">=</span><span class="string">"ok_button_clicked"</span><span class="symbol">/></span>
|
||||
<span class="normal"> </span><span class="symbol"></</span><span class="normal">object</span><span class="symbol">></span>
|
||||
<span class="normal"> </span><span class="symbol"></</span><span class="normal">child</span><span class="symbol">></span>
|
||||
@ -518,12 +518,12 @@ See the <a class="link" href="GtkWidget.html#composite-templates" title="Buildin
|
||||
<a name="GtkBuilderConnectFunc"></a><h3>GtkBuilderConnectFunc ()</h3>
|
||||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||||
<span class="c_punctuation">(</span>*GtkBuilderConnectFunc<span class="c_punctuation">)</span> (<em class="parameter"><code><a class="link" href="GtkBuilder.html" title="GtkBuilder"><span class="type">GtkBuilder</span></a> *builder</code></em>,
|
||||
<em class="parameter"><code><span class="type">GObject</span> *object</code></em>,
|
||||
<em class="parameter"><code>const <span class="type">gchar</span> *signal_name</code></em>,
|
||||
<em class="parameter"><code>const <span class="type">gchar</span> *handler_name</code></em>,
|
||||
<em class="parameter"><code><span class="type">GObject</span> *connect_object</code></em>,
|
||||
<em class="parameter"><code><span class="type">GConnectFlags</span> flags</code></em>,
|
||||
<em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre>
|
||||
<em class="parameter"><code><a href="https://developer.gnome.org/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-struct"><span class="type">GObject</span></a> *object</code></em>,
|
||||
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *signal_name</code></em>,
|
||||
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *handler_name</code></em>,
|
||||
<em class="parameter"><code><a href="https://developer.gnome.org/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-struct"><span class="type">GObject</span></a> *connect_object</code></em>,
|
||||
<em class="parameter"><code><a href="https://developer.gnome.org/gobject/unstable/gobject-Signals.html#GConnectFlags"><span class="type">GConnectFlags</span></a> flags</code></em>,
|
||||
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
|
||||
<p>This is the signature of a function used to connect signals. It is used
|
||||
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>
|
||||
methods. It is mainly intended for interpreted language bindings, but
|
||||
@ -561,12 +561,12 @@ subsequent calls will do nothing.</p>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="parameter_name"><p>connect_object</p></td>
|
||||
<td class="parameter_description"><p>a <span class="type">GObject</span>, if non-<code class="literal">NULL</code>, use <code class="function">g_signal_connect_object()</code>. </p></td>
|
||||
<td class="parameter_description"><p>a <a href="https://developer.gnome.org/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-struct"><span class="type">GObject</span></a>, if non-<a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, use <a href="https://developer.gnome.org/gobject/unstable/gobject-Signals.html#g-signal-connect-object"><code class="function">g_signal_connect_object()</code></a>. </p></td>
|
||||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="parameter_name"><p>flags</p></td>
|
||||
<td class="parameter_description"><p><span class="type">GConnectFlags</span> to use</p></td>
|
||||
<td class="parameter_description"><p><a href="https://developer.gnome.org/gobject/unstable/gobject-Signals.html#GConnectFlags"><span class="type">GConnectFlags</span></a> to use</p></td>
|
||||
<td class="parameter_annotations"> </td>
|
||||
</tr>
|
||||
<tr>
|
||||
@ -601,7 +601,7 @@ descriptions into a single builder.</p>
|
||||
<div class="refsect2">
|
||||
<a name="gtk-builder-new-from-file"></a><h3>gtk_builder_new_from_file ()</h3>
|
||||
<pre class="programlisting"><a class="link" href="GtkBuilder.html" title="GtkBuilder"><span class="returnvalue">GtkBuilder</span></a> *
|
||||
gtk_builder_new_from_file (<em class="parameter"><code>const <span class="type">gchar</span> *filename</code></em>);</pre>
|
||||
gtk_builder_new_from_file (<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *filename</code></em>);</pre>
|
||||
<p>Builds the <a class="link" href="GtkBuilder.html#BUILDER-UI" title="GtkBuilder UI Definitions">GtkBuilder UI definition</a>
|
||||
in the file <em class="parameter"><code>filename</code></em>
|
||||
.</p>
|
||||
@ -633,7 +633,7 @@ user interface descriptions that are shipped as part of your program.</p>
|
||||
<div class="refsect2">
|
||||
<a name="gtk-builder-new-from-resource"></a><h3>gtk_builder_new_from_resource ()</h3>
|
||||
<pre class="programlisting"><a class="link" href="GtkBuilder.html" title="GtkBuilder"><span class="returnvalue">GtkBuilder</span></a> *
|
||||
gtk_builder_new_from_resource (<em class="parameter"><code>const <span class="type">gchar</span> *resource_path</code></em>);</pre>
|
||||
gtk_builder_new_from_resource (<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *resource_path</code></em>);</pre>
|
||||
<p>Builds the <a class="link" href="GtkBuilder.html#BUILDER-UI" title="GtkBuilder UI Definitions">GtkBuilder UI definition</a>
|
||||
at <em class="parameter"><code>resource_path</code></em>
|
||||
.</p>
|
||||
@ -664,13 +664,13 @@ description, then the program will be aborted.</p>
|
||||
<div class="refsect2">
|
||||
<a name="gtk-builder-new-from-string"></a><h3>gtk_builder_new_from_string ()</h3>
|
||||
<pre class="programlisting"><a class="link" href="GtkBuilder.html" title="GtkBuilder"><span class="returnvalue">GtkBuilder</span></a> *
|
||||
gtk_builder_new_from_string (<em class="parameter"><code>const <span class="type">gchar</span> *string</code></em>,
|
||||
<em class="parameter"><code><span class="type">gssize</span> length</code></em>);</pre>
|
||||
gtk_builder_new_from_string (<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *string</code></em>,
|
||||
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gssize"><span class="type">gssize</span></a> length</code></em>);</pre>
|
||||
<p>Builds the user interface described by <em class="parameter"><code>string</code></em>
|
||||
(in the
|
||||
<a class="link" href="GtkBuilder.html#BUILDER-UI" title="GtkBuilder UI Definitions">GtkBuilder UI definition</a> format).</p>
|
||||
<p>If <em class="parameter"><code>string</code></em>
|
||||
is <code class="literal">NULL</code>-terminated, then <em class="parameter"><code>length</code></em>
|
||||
is <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated, then <em class="parameter"><code>length</code></em>
|
||||
should be -1.
|
||||
If <em class="parameter"><code>length</code></em>
|
||||
is not -1, then it is the length of <em class="parameter"><code>string</code></em>
|
||||
@ -714,8 +714,8 @@ from untrusted sources.</p>
|
||||
<a name="gtk-builder-add-callback-symbol"></a><h3>gtk_builder_add_callback_symbol ()</h3>
|
||||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||||
gtk_builder_add_callback_symbol (<em class="parameter"><code><a class="link" href="GtkBuilder.html" title="GtkBuilder"><span class="type">GtkBuilder</span></a> *builder</code></em>,
|
||||
<em class="parameter"><code>const <span class="type">gchar</span> *callback_name</code></em>,
|
||||
<em class="parameter"><code><span class="type">GCallback</span> callback_symbol</code></em>);</pre>
|
||||
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *callback_name</code></em>,
|
||||
<em class="parameter"><code><a href="https://developer.gnome.org/gobject/unstable/gobject-Closures.html#GCallback"><span class="type">GCallback</span></a> callback_symbol</code></em>);</pre>
|
||||
<p>Adds the <em class="parameter"><code>callback_symbol</code></em>
|
||||
to the scope of <em class="parameter"><code>builder</code></em>
|
||||
under the given <em class="parameter"><code>callback_name</code></em>
|
||||
@ -758,8 +758,8 @@ the global namespace.</p>
|
||||
<a name="gtk-builder-add-callback-symbols"></a><h3>gtk_builder_add_callback_symbols ()</h3>
|
||||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||||
gtk_builder_add_callback_symbols (<em class="parameter"><code><a class="link" href="GtkBuilder.html" title="GtkBuilder"><span class="type">GtkBuilder</span></a> *builder</code></em>,
|
||||
<em class="parameter"><code>const <span class="type">gchar</span> *first_callback_name</code></em>,
|
||||
<em class="parameter"><code><span class="type">GCallback</span> first_callback_symbol</code></em>,
|
||||
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_callback_name</code></em>,
|
||||
<em class="parameter"><code><a href="https://developer.gnome.org/gobject/unstable/gobject-Closures.html#GCallback"><span class="type">GCallback</span></a> first_callback_symbol</code></em>,
|
||||
<em class="parameter"><code>...</code></em>);</pre>
|
||||
<p>A convenience function to add many callbacks instead of calling
|
||||
<a class="link" href="GtkBuilder.html#gtk-builder-add-callback-symbol" title="gtk_builder_add_callback_symbol ()"><code class="function">gtk_builder_add_callback_symbol()</code></a> for each symbol.</p>
|
||||
@ -789,7 +789,7 @@ gtk_builder_add_callback_symbols (<em class="parameter"><code><a class="link" hr
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="parameter_name"><p>...</p></td>
|
||||
<td class="parameter_description"><p>A list of callback name and callback symbol pairs terminated with <code class="literal">NULL</code></p></td>
|
||||
<td class="parameter_description"><p>A list of callback name and callback symbol pairs terminated with <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
|
||||
<td class="parameter_annotations"> </td>
|
||||
</tr>
|
||||
</tbody>
|
||||
@ -800,9 +800,9 @@ gtk_builder_add_callback_symbols (<em class="parameter"><code><a class="link" hr
|
||||
<hr>
|
||||
<div class="refsect2">
|
||||
<a name="gtk-builder-lookup-callback-symbol"></a><h3>gtk_builder_lookup_callback_symbol ()</h3>
|
||||
<pre class="programlisting"><span class="returnvalue">GCallback</span>
|
||||
<pre class="programlisting"><a href="https://developer.gnome.org/gobject/unstable/gobject-Closures.html#GCallback"><span class="returnvalue">GCallback</span></a>
|
||||
gtk_builder_lookup_callback_symbol (<em class="parameter"><code><a class="link" href="GtkBuilder.html" title="GtkBuilder"><span class="type">GtkBuilder</span></a> *builder</code></em>,
|
||||
<em class="parameter"><code>const <span class="type">gchar</span> *callback_name</code></em>);</pre>
|
||||
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *callback_name</code></em>);</pre>
|
||||
<p>Fetches a symbol previously added to <em class="parameter"><code>builder</code></em>
|
||||
|
||||
with <a class="link" href="GtkBuilder.html#gtk-builder-add-callback-symbols" title="gtk_builder_add_callback_symbols ()"><code class="function">gtk_builder_add_callback_symbols()</code></a></p>
|
||||
@ -836,7 +836,7 @@ using <a class="link" href="GtkBuilder.html#gtk-builder-connect-signals-full" ti
|
||||
<a name="gtk-builder-lookup-callback-symbol.returns"></a><h4>Returns</h4>
|
||||
<p>The callback symbol in <em class="parameter"><code>builder</code></em>
|
||||
for <em class="parameter"><code>callback_name</code></em>
|
||||
, or <code class="literal">NULL</code>. </p>
|
||||
, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p>
|
||||
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
|
||||
</div>
|
||||
<p class="since">Since: <a class="link" href="api-index-3-10.html#api-index-3.10">3.10</a></p>
|
||||
@ -844,24 +844,24 @@ for <em class="parameter"><code>callback_name</code></em>
|
||||
<hr>
|
||||
<div class="refsect2">
|
||||
<a name="gtk-builder-add-from-file"></a><h3>gtk_builder_add_from_file ()</h3>
|
||||
<pre class="programlisting"><span class="returnvalue">guint</span>
|
||||
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>
|
||||
gtk_builder_add_from_file (<em class="parameter"><code><a class="link" href="GtkBuilder.html" title="GtkBuilder"><span class="type">GtkBuilder</span></a> *builder</code></em>,
|
||||
<em class="parameter"><code>const <span class="type">gchar</span> *filename</code></em>,
|
||||
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
|
||||
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *filename</code></em>,
|
||||
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
||||
<p>Parses a file containing a <a class="link" href="GtkBuilder.html#BUILDER-UI" title="GtkBuilder UI Definitions">GtkBuilder UI definition</a>
|
||||
and merges it with the current contents of <em class="parameter"><code>builder</code></em>
|
||||
.</p>
|
||||
<p>Most users will probably want to use <a class="link" href="GtkBuilder.html#gtk-builder-new-from-file" title="gtk_builder_new_from_file ()"><code class="function">gtk_builder_new_from_file()</code></a>.</p>
|
||||
<p>If an error occurs, 0 will be returned and <em class="parameter"><code>error</code></em>
|
||||
will be assigned a
|
||||
<span class="type">GError</span> from the <a class="link" href="GtkBuilder.html#GTK-BUILDER-ERROR:CAPS" title="GTK_BUILDER_ERROR"><span class="type">GTK_BUILDER_ERROR</span></a>, <span class="type">G_MARKUP_ERROR</span> or <span class="type">G_FILE_ERROR</span>
|
||||
<a href="https://developer.gnome.org/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> from the <a class="link" href="GtkBuilder.html#GTK-BUILDER-ERROR:CAPS" title="GTK_BUILDER_ERROR"><span class="type">GTK_BUILDER_ERROR</span></a>, <a href="https://developer.gnome.org/glib/unstable/glib-Simple-XML-Subset-Parser.html#G-MARKUP-ERROR:CAPS"><span class="type">G_MARKUP_ERROR</span></a> or <a href="https://developer.gnome.org/glib/unstable/glib-File-Utilities.html#G-FILE-ERROR:CAPS"><span class="type">G_FILE_ERROR</span></a>
|
||||
domain.</p>
|
||||
<p>It’s not really reasonable to attempt to handle failures of this
|
||||
call. You should not use this function with untrusted files (ie:
|
||||
files that are not part of your application). Broken <a class="link" href="GtkBuilder.html" title="GtkBuilder"><span class="type">GtkBuilder</span></a>
|
||||
files can easily crash your program, and it’s possible that memory
|
||||
was leaked leading up to the reported failure. The only reasonable
|
||||
thing to do when an error is detected is to call <code class="function">g_error()</code>.</p>
|
||||
thing to do when an error is detected is to call <a href="https://developer.gnome.org/glib/unstable/glib-Message-Logging.html#g-error"><code class="function">g_error()</code></a>.</p>
|
||||
<div class="refsect3">
|
||||
<a name="gtk-builder-add-from-file.parameters"></a><h4>Parameters</h4>
|
||||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||||
@ -883,7 +883,7 @@ thing to do when an error is detected is to call <code class="function">g_error(
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="parameter_name"><p>error</p></td>
|
||||
<td class="parameter_description"><p>return location for an error, or <code class="literal">NULL</code>. </p></td>
|
||||
<td class="parameter_description"><p>return location for an error, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
|
||||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
@ -898,21 +898,21 @@ thing to do when an error is detected is to call <code class="function">g_error(
|
||||
<hr>
|
||||
<div class="refsect2">
|
||||
<a name="gtk-builder-add-from-resource"></a><h3>gtk_builder_add_from_resource ()</h3>
|
||||
<pre class="programlisting"><span class="returnvalue">guint</span>
|
||||
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>
|
||||
gtk_builder_add_from_resource (<em class="parameter"><code><a class="link" href="GtkBuilder.html" title="GtkBuilder"><span class="type">GtkBuilder</span></a> *builder</code></em>,
|
||||
<em class="parameter"><code>const <span class="type">gchar</span> *resource_path</code></em>,
|
||||
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
|
||||
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *resource_path</code></em>,
|
||||
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
||||
<p>Parses a resource file containing a <a class="link" href="GtkBuilder.html#BUILDER-UI" title="GtkBuilder UI Definitions">GtkBuilder UI definition</a>
|
||||
and merges it with the current contents of <em class="parameter"><code>builder</code></em>
|
||||
.</p>
|
||||
<p>Most users will probably want to use <a class="link" href="GtkBuilder.html#gtk-builder-new-from-resource" title="gtk_builder_new_from_resource ()"><code class="function">gtk_builder_new_from_resource()</code></a>.</p>
|
||||
<p>If an error occurs, 0 will be returned and <em class="parameter"><code>error</code></em>
|
||||
will be assigned a
|
||||
<span class="type">GError</span> from the <a class="link" href="GtkBuilder.html#GTK-BUILDER-ERROR:CAPS" title="GTK_BUILDER_ERROR"><span class="type">GTK_BUILDER_ERROR</span></a>, <span class="type">G_MARKUP_ERROR</span> or <span class="type">G_RESOURCE_ERROR</span>
|
||||
<a href="https://developer.gnome.org/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> from the <a class="link" href="GtkBuilder.html#GTK-BUILDER-ERROR:CAPS" title="GTK_BUILDER_ERROR"><span class="type">GTK_BUILDER_ERROR</span></a>, <a href="https://developer.gnome.org/glib/unstable/glib-Simple-XML-Subset-Parser.html#G-MARKUP-ERROR:CAPS"><span class="type">G_MARKUP_ERROR</span></a> or <span class="type">G_RESOURCE_ERROR</span>
|
||||
domain.</p>
|
||||
<p>It’s not really reasonable to attempt to handle failures of this
|
||||
call. The only reasonable thing to do when an error is detected is
|
||||
to call <code class="function">g_error()</code>.</p>
|
||||
to call <a href="https://developer.gnome.org/glib/unstable/glib-Message-Logging.html#g-error"><code class="function">g_error()</code></a>.</p>
|
||||
<div class="refsect3">
|
||||
<a name="gtk-builder-add-from-resource.parameters"></a><h4>Parameters</h4>
|
||||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||||
@ -934,7 +934,7 @@ to call <code class="function">g_error()</code>.</p>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="parameter_name"><p>error</p></td>
|
||||
<td class="parameter_description"><p>return location for an error, or <code class="literal">NULL</code>. </p></td>
|
||||
<td class="parameter_description"><p>return location for an error, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
|
||||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
@ -949,22 +949,22 @@ to call <code class="function">g_error()</code>.</p>
|
||||
<hr>
|
||||
<div class="refsect2">
|
||||
<a name="gtk-builder-add-from-string"></a><h3>gtk_builder_add_from_string ()</h3>
|
||||
<pre class="programlisting"><span class="returnvalue">guint</span>
|
||||
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>
|
||||
gtk_builder_add_from_string (<em class="parameter"><code><a class="link" href="GtkBuilder.html" title="GtkBuilder"><span class="type">GtkBuilder</span></a> *builder</code></em>,
|
||||
<em class="parameter"><code>const <span class="type">gchar</span> *buffer</code></em>,
|
||||
<em class="parameter"><code><span class="type">gsize</span> length</code></em>,
|
||||
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
|
||||
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *buffer</code></em>,
|
||||
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> length</code></em>,
|
||||
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
||||
<p>Parses a string containing a <a class="link" href="GtkBuilder.html#BUILDER-UI" title="GtkBuilder UI Definitions">GtkBuilder UI definition</a>
|
||||
and merges it with the current contents of <em class="parameter"><code>builder</code></em>
|
||||
.</p>
|
||||
<p>Most users will probably want to use <a class="link" href="GtkBuilder.html#gtk-builder-new-from-string" title="gtk_builder_new_from_string ()"><code class="function">gtk_builder_new_from_string()</code></a>.</p>
|
||||
<p>Upon errors 0 will be returned and <em class="parameter"><code>error</code></em>
|
||||
will be assigned a
|
||||
<span class="type">GError</span> from the <a class="link" href="GtkBuilder.html#GTK-BUILDER-ERROR:CAPS" title="GTK_BUILDER_ERROR"><span class="type">GTK_BUILDER_ERROR</span></a>, <span class="type">G_MARKUP_ERROR</span> or
|
||||
<span class="type">G_VARIANT_PARSE_ERROR</span> domain.</p>
|
||||
<a href="https://developer.gnome.org/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> from the <a class="link" href="GtkBuilder.html#GTK-BUILDER-ERROR:CAPS" title="GTK_BUILDER_ERROR"><span class="type">GTK_BUILDER_ERROR</span></a>, <a href="https://developer.gnome.org/glib/unstable/glib-Simple-XML-Subset-Parser.html#G-MARKUP-ERROR:CAPS"><span class="type">G_MARKUP_ERROR</span></a> or
|
||||
<a href="https://developer.gnome.org/glib/unstable/glib-GVariant.html#G-VARIANT-PARSE-ERROR:CAPS"><span class="type">G_VARIANT_PARSE_ERROR</span></a> domain.</p>
|
||||
<p>It’s not really reasonable to attempt to handle failures of this
|
||||
call. The only reasonable thing to do when an error is detected is
|
||||
to call <code class="function">g_error()</code>.</p>
|
||||
to call <a href="https://developer.gnome.org/glib/unstable/glib-Message-Logging.html#g-error"><code class="function">g_error()</code></a>.</p>
|
||||
<div class="refsect3">
|
||||
<a name="gtk-builder-add-from-string.parameters"></a><h4>Parameters</h4>
|
||||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||||
@ -993,7 +993,7 @@ is nul-terminated)</p></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="parameter_name"><p>error</p></td>
|
||||
<td class="parameter_description"><p>return location for an error, or <code class="literal">NULL</code>. </p></td>
|
||||
<td class="parameter_description"><p>return location for an error, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
|
||||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
@ -1008,18 +1008,18 @@ is nul-terminated)</p></td>
|
||||
<hr>
|
||||
<div class="refsect2">
|
||||
<a name="gtk-builder-add-objects-from-file"></a><h3>gtk_builder_add_objects_from_file ()</h3>
|
||||
<pre class="programlisting"><span class="returnvalue">guint</span>
|
||||
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>
|
||||
gtk_builder_add_objects_from_file (<em class="parameter"><code><a class="link" href="GtkBuilder.html" title="GtkBuilder"><span class="type">GtkBuilder</span></a> *builder</code></em>,
|
||||
<em class="parameter"><code>const <span class="type">gchar</span> *filename</code></em>,
|
||||
<em class="parameter"><code><span class="type">gchar</span> **object_ids</code></em>,
|
||||
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
|
||||
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *filename</code></em>,
|
||||
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **object_ids</code></em>,
|
||||
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
||||
<p>Parses a file containing a <a class="link" href="GtkBuilder.html#BUILDER-UI" title="GtkBuilder UI Definitions">GtkBuilder UI definition</a>
|
||||
building only the requested objects and merges
|
||||
them with the current contents of <em class="parameter"><code>builder</code></em>
|
||||
.</p>
|
||||
<p>Upon errors 0 will be returned and <em class="parameter"><code>error</code></em>
|
||||
will be assigned a
|
||||
<span class="type">GError</span> from the <a class="link" href="GtkBuilder.html#GTK-BUILDER-ERROR:CAPS" title="GTK_BUILDER_ERROR"><span class="type">GTK_BUILDER_ERROR</span></a>, <span class="type">G_MARKUP_ERROR</span> or <span class="type">G_FILE_ERROR</span>
|
||||
<a href="https://developer.gnome.org/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> from the <a class="link" href="GtkBuilder.html#GTK-BUILDER-ERROR:CAPS" title="GTK_BUILDER_ERROR"><span class="type">GTK_BUILDER_ERROR</span></a>, <a href="https://developer.gnome.org/glib/unstable/glib-Simple-XML-Subset-Parser.html#G-MARKUP-ERROR:CAPS"><span class="type">G_MARKUP_ERROR</span></a> or <a href="https://developer.gnome.org/glib/unstable/glib-File-Utilities.html#G-FILE-ERROR:CAPS"><span class="type">G_FILE_ERROR</span></a>
|
||||
domain.</p>
|
||||
<p>If you are adding an object that depends on an object that is not
|
||||
its child (for instance a <a class="link" href="GtkTreeView.html" title="GtkTreeView"><span class="type">GtkTreeView</span></a> that depends on its
|
||||
@ -1051,7 +1051,7 @@ its child (for instance a <a class="link" href="GtkTreeView.html" title="GtkTree
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="parameter_name"><p>error</p></td>
|
||||
<td class="parameter_description"><p>return location for an error, or <code class="literal">NULL</code>. </p></td>
|
||||
<td class="parameter_description"><p>return location for an error, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
|
||||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
@ -1066,19 +1066,19 @@ its child (for instance a <a class="link" href="GtkTreeView.html" title="GtkTree
|
||||
<hr>
|
||||
<div class="refsect2">
|
||||
<a name="gtk-builder-add-objects-from-string"></a><h3>gtk_builder_add_objects_from_string ()</h3>
|
||||
<pre class="programlisting"><span class="returnvalue">guint</span>
|
||||
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>
|
||||
gtk_builder_add_objects_from_string (<em class="parameter"><code><a class="link" href="GtkBuilder.html" title="GtkBuilder"><span class="type">GtkBuilder</span></a> *builder</code></em>,
|
||||
<em class="parameter"><code>const <span class="type">gchar</span> *buffer</code></em>,
|
||||
<em class="parameter"><code><span class="type">gsize</span> length</code></em>,
|
||||
<em class="parameter"><code><span class="type">gchar</span> **object_ids</code></em>,
|
||||
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
|
||||
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *buffer</code></em>,
|
||||
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> length</code></em>,
|
||||
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **object_ids</code></em>,
|
||||
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
||||
<p>Parses a string containing a <a class="link" href="GtkBuilder.html#BUILDER-UI" title="GtkBuilder UI Definitions">GtkBuilder UI definition</a>
|
||||
building only the requested objects and merges
|
||||
them with the current contents of <em class="parameter"><code>builder</code></em>
|
||||
.</p>
|
||||
<p>Upon errors 0 will be returned and <em class="parameter"><code>error</code></em>
|
||||
will be assigned a
|
||||
<span class="type">GError</span> from the <a class="link" href="GtkBuilder.html#GTK-BUILDER-ERROR:CAPS" title="GTK_BUILDER_ERROR"><span class="type">GTK_BUILDER_ERROR</span></a> or <span class="type">G_MARKUP_ERROR</span> domain.</p>
|
||||
<a href="https://developer.gnome.org/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> from the <a class="link" href="GtkBuilder.html#GTK-BUILDER-ERROR:CAPS" title="GTK_BUILDER_ERROR"><span class="type">GTK_BUILDER_ERROR</span></a> or <a href="https://developer.gnome.org/glib/unstable/glib-Simple-XML-Subset-Parser.html#G-MARKUP-ERROR:CAPS"><span class="type">G_MARKUP_ERROR</span></a> domain.</p>
|
||||
<p>If you are adding an object that depends on an object that is not
|
||||
its child (for instance a <a class="link" href="GtkTreeView.html" title="GtkTreeView"><span class="type">GtkTreeView</span></a> that depends on its
|
||||
<a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a>), you have to explicitly list all of them in <em class="parameter"><code>object_ids</code></em>
|
||||
@ -1116,7 +1116,7 @@ is nul-terminated)</p></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="parameter_name"><p>error</p></td>
|
||||
<td class="parameter_description"><p>return location for an error, or <code class="literal">NULL</code>. </p></td>
|
||||
<td class="parameter_description"><p>return location for an error, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
|
||||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
@ -1131,18 +1131,18 @@ is nul-terminated)</p></td>
|
||||
<hr>
|
||||
<div class="refsect2">
|
||||
<a name="gtk-builder-add-objects-from-resource"></a><h3>gtk_builder_add_objects_from_resource ()</h3>
|
||||
<pre class="programlisting"><span class="returnvalue">guint</span>
|
||||
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>
|
||||
gtk_builder_add_objects_from_resource (<em class="parameter"><code><a class="link" href="GtkBuilder.html" title="GtkBuilder"><span class="type">GtkBuilder</span></a> *builder</code></em>,
|
||||
<em class="parameter"><code>const <span class="type">gchar</span> *resource_path</code></em>,
|
||||
<em class="parameter"><code><span class="type">gchar</span> **object_ids</code></em>,
|
||||
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
|
||||
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *resource_path</code></em>,
|
||||
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **object_ids</code></em>,
|
||||
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
||||
<p>Parses a resource file containing a <a class="link" href="GtkBuilder.html#BUILDER-UI" title="GtkBuilder UI Definitions">GtkBuilder UI definition</a>
|
||||
building only the requested objects and merges
|
||||
them with the current contents of <em class="parameter"><code>builder</code></em>
|
||||
.</p>
|
||||
<p>Upon errors 0 will be returned and <em class="parameter"><code>error</code></em>
|
||||
will be assigned a
|
||||
<span class="type">GError</span> from the <a class="link" href="GtkBuilder.html#GTK-BUILDER-ERROR:CAPS" title="GTK_BUILDER_ERROR"><span class="type">GTK_BUILDER_ERROR</span></a>, <span class="type">G_MARKUP_ERROR</span> or <span class="type">G_RESOURCE_ERROR</span>
|
||||
<a href="https://developer.gnome.org/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> from the <a class="link" href="GtkBuilder.html#GTK-BUILDER-ERROR:CAPS" title="GTK_BUILDER_ERROR"><span class="type">GTK_BUILDER_ERROR</span></a>, <a href="https://developer.gnome.org/glib/unstable/glib-Simple-XML-Subset-Parser.html#G-MARKUP-ERROR:CAPS"><span class="type">G_MARKUP_ERROR</span></a> or <span class="type">G_RESOURCE_ERROR</span>
|
||||
domain.</p>
|
||||
<p>If you are adding an object that depends on an object that is not
|
||||
its child (for instance a <a class="link" href="GtkTreeView.html" title="GtkTreeView"><span class="type">GtkTreeView</span></a> that depends on its
|
||||
@ -1174,7 +1174,7 @@ its child (for instance a <a class="link" href="GtkTreeView.html" title="GtkTree
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="parameter_name"><p>error</p></td>
|
||||
<td class="parameter_description"><p>return location for an error, or <code class="literal">NULL</code>. </p></td>
|
||||
<td class="parameter_description"><p>return location for an error, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
|
||||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
@ -1189,13 +1189,13 @@ its child (for instance a <a class="link" href="GtkTreeView.html" title="GtkTree
|
||||
<hr>
|
||||
<div class="refsect2">
|
||||
<a name="gtk-builder-extend-with-template"></a><h3>gtk_builder_extend_with_template ()</h3>
|
||||
<pre class="programlisting"><span class="returnvalue">guint</span>
|
||||
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>
|
||||
gtk_builder_extend_with_template (<em class="parameter"><code><a class="link" href="GtkBuilder.html" title="GtkBuilder"><span class="type">GtkBuilder</span></a> *builder</code></em>,
|
||||
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>,
|
||||
<em class="parameter"><code><span class="type">GType</span> template_type</code></em>,
|
||||
<em class="parameter"><code>const <span class="type">gchar</span> *buffer</code></em>,
|
||||
<em class="parameter"><code><span class="type">gsize</span> length</code></em>,
|
||||
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
|
||||
<em class="parameter"><code><a href="https://developer.gnome.org/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> template_type</code></em>,
|
||||
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *buffer</code></em>,
|
||||
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> length</code></em>,
|
||||
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
||||
<p>Main private entry point for building composite container
|
||||
components from template XML.</p>
|
||||
<p>This is exported purely to let gtk-builder-tool validate
|
||||
@ -1238,7 +1238,7 @@ is nul-terminated)</p></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="parameter_name"><p>error</p></td>
|
||||
<td class="parameter_description"><p>return location for an error, or <code class="literal">NULL</code>. </p></td>
|
||||
<td class="parameter_description"><p>return location for an error, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
|
||||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
@ -1252,9 +1252,9 @@ is nul-terminated)</p></td>
|
||||
<hr>
|
||||
<div class="refsect2">
|
||||
<a name="gtk-builder-get-object"></a><h3>gtk_builder_get_object ()</h3>
|
||||
<pre class="programlisting"><span class="returnvalue">GObject</span> *
|
||||
<pre class="programlisting"><a href="https://developer.gnome.org/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-struct"><span class="returnvalue">GObject</span></a> *
|
||||
gtk_builder_get_object (<em class="parameter"><code><a class="link" href="GtkBuilder.html" title="GtkBuilder"><span class="type">GtkBuilder</span></a> *builder</code></em>,
|
||||
<em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>);</pre>
|
||||
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>);</pre>
|
||||
<p>Gets the object named <em class="parameter"><code>name</code></em>
|
||||
. Note that this function does not
|
||||
increment the reference count of the returned object.</p>
|
||||
@ -1283,7 +1283,7 @@ increment the reference count of the returned object.</p>
|
||||
<div class="refsect3">
|
||||
<a name="gtk-builder-get-object.returns"></a><h4>Returns</h4>
|
||||
<p>the object named <em class="parameter"><code>name</code></em>
|
||||
or <code class="literal">NULL</code> if
|
||||
or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if
|
||||
it could not be found in the object tree. </p>
|
||||
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||||
</div>
|
||||
@ -1292,7 +1292,7 @@ it could not be found in the object tree. </p>
|
||||
<hr>
|
||||
<div class="refsect2">
|
||||
<a name="gtk-builder-get-objects"></a><h3>gtk_builder_get_objects ()</h3>
|
||||
<pre class="programlisting"><span class="returnvalue">GSList</span> *
|
||||
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="returnvalue">GSList</span></a> *
|
||||
gtk_builder_get_objects (<em class="parameter"><code><a class="link" href="GtkBuilder.html" title="GtkBuilder"><span class="type">GtkBuilder</span></a> *builder</code></em>);</pre>
|
||||
<p>Gets all objects that have been constructed by <em class="parameter"><code>builder</code></em>
|
||||
. Note that
|
||||
@ -1315,9 +1315,9 @@ objects.</p>
|
||||
</div>
|
||||
<div class="refsect3">
|
||||
<a name="gtk-builder-get-objects.returns"></a><h4>Returns</h4>
|
||||
<p>a newly-allocated <span class="type">GSList</span> containing all the objects
|
||||
<p>a newly-allocated <a href="https://developer.gnome.org/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> containing all the objects
|
||||
constructed by the <a class="link" href="GtkBuilder.html" title="GtkBuilder"><span class="type">GtkBuilder</span></a> instance. It should be freed by
|
||||
<code class="function">g_slist_free()</code>. </p>
|
||||
<a href="https://developer.gnome.org/glib/unstable/glib-Singly-Linked-Lists.html#g-slist-free"><code class="function">g_slist_free()</code></a>. </p>
|
||||
<p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GObject][<acronym title="Free data container after the code is done."><span class="acronym">transfer container</span></acronym>]</span></p>
|
||||
</div>
|
||||
<p class="since">Since: 2.12</p>
|
||||
@ -1327,8 +1327,8 @@ constructed by the <a class="link" href="GtkBuilder.html" title="GtkBuilder"><sp
|
||||
<a name="gtk-builder-expose-object"></a><h3>gtk_builder_expose_object ()</h3>
|
||||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||||
gtk_builder_expose_object (<em class="parameter"><code><a class="link" href="GtkBuilder.html" title="GtkBuilder"><span class="type">GtkBuilder</span></a> *builder</code></em>,
|
||||
<em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>,
|
||||
<em class="parameter"><code><span class="type">GObject</span> *object</code></em>);</pre>
|
||||
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
|
||||
<em class="parameter"><code><a href="https://developer.gnome.org/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-struct"><span class="type">GObject</span></a> *object</code></em>);</pre>
|
||||
<p>Add <em class="parameter"><code>object</code></em>
|
||||
to the <em class="parameter"><code>builder</code></em>
|
||||
object pool so it can be referenced just like any
|
||||
@ -1367,23 +1367,23 @@ other object built by builder.</p>
|
||||
<a name="gtk-builder-connect-signals"></a><h3>gtk_builder_connect_signals ()</h3>
|
||||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||||
gtk_builder_connect_signals (<em class="parameter"><code><a class="link" href="GtkBuilder.html" title="GtkBuilder"><span class="type">GtkBuilder</span></a> *builder</code></em>,
|
||||
<em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre>
|
||||
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
|
||||
<p>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>.
|
||||
It uses symbols explicitly added to <em class="parameter"><code>builder</code></em>
|
||||
with prior calls to
|
||||
<a class="link" href="GtkBuilder.html#gtk-builder-add-callback-symbol" title="gtk_builder_add_callback_symbol ()"><code class="function">gtk_builder_add_callback_symbol()</code></a>. In the case that symbols are not
|
||||
explicitly added; it uses <span class="type">GModule</span>’s introspective features (by opening the module <code class="literal">NULL</code>)
|
||||
explicitly added; it uses <a href="https://developer.gnome.org/glib/unstable/glib-Dynamic-Loading-of-Modules.html#GModule"><span class="type">GModule</span></a>’s introspective features (by opening the module <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>)
|
||||
to look at the application’s symbol table. From here it tries to match
|
||||
the signal handler names given in the interface description with
|
||||
symbols in the application and connects the signals. Note that this
|
||||
function can only be called once, subsequent calls will do nothing.</p>
|
||||
<p>Note that unless <a class="link" href="GtkBuilder.html#gtk-builder-add-callback-symbol" title="gtk_builder_add_callback_symbol ()"><code class="function">gtk_builder_add_callback_symbol()</code></a> is called for
|
||||
all signal callbacks which are referenced by the loaded XML, this
|
||||
function will require that <span class="type">GModule</span> be supported on the platform.</p>
|
||||
<p>If you rely on <span class="type">GModule</span> support to lookup callbacks in the symbol table,
|
||||
function will require that <a href="https://developer.gnome.org/glib/unstable/glib-Dynamic-Loading-of-Modules.html#GModule"><span class="type">GModule</span></a> be supported on the platform.</p>
|
||||
<p>If you rely on <a href="https://developer.gnome.org/glib/unstable/glib-Dynamic-Loading-of-Modules.html#GModule"><span class="type">GModule</span></a> support to lookup callbacks in the symbol table,
|
||||
the following details should be noted:</p>
|
||||
<p>When compiling applications for Windows, you must declare signal callbacks
|
||||
with <span class="type">G_MODULE_EXPORT</span>, or they will not be put in the symbol table.
|
||||
with <a href="https://developer.gnome.org/glib/unstable/glib-Dynamic-Loading-of-Modules.html#G-MODULE-EXPORT:CAPS"><span class="type">G_MODULE_EXPORT</span></a>, or they will not be put in the symbol table.
|
||||
On Linux and Unices, this is not necessary; applications should instead
|
||||
be compiled with the -Wl,--export-dynamic CFLAGS, and linked against
|
||||
gmodule-export-2.0.</p>
|
||||
@ -1417,7 +1417,7 @@ gmodule-export-2.0.</p>
|
||||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||||
gtk_builder_connect_signals_full (<em class="parameter"><code><a class="link" href="GtkBuilder.html" title="GtkBuilder"><span class="type">GtkBuilder</span></a> *builder</code></em>,
|
||||
<em class="parameter"><code><a class="link" href="GtkBuilder.html#GtkBuilderConnectFunc" title="GtkBuilderConnectFunc ()"><span class="type">GtkBuilderConnectFunc</span></a> func</code></em>,
|
||||
<em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre>
|
||||
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
|
||||
<p>This function can be thought of the interpreted language binding
|
||||
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
|
||||
require GModule to function correctly.</p>
|
||||
@ -1455,7 +1455,7 @@ require GModule to function correctly.</p>
|
||||
<a name="gtk-builder-set-translation-domain"></a><h3>gtk_builder_set_translation_domain ()</h3>
|
||||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||||
gtk_builder_set_translation_domain (<em class="parameter"><code><a class="link" href="GtkBuilder.html" title="GtkBuilder"><span class="type">GtkBuilder</span></a> *builder</code></em>,
|
||||
<em class="parameter"><code>const <span class="type">gchar</span> *domain</code></em>);</pre>
|
||||
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *domain</code></em>);</pre>
|
||||
<p>Sets the translation domain of <em class="parameter"><code>builder</code></em>
|
||||
.
|
||||
See <a class="link" href="GtkBuilder.html#GtkBuilder--translation-domain" title="The “translation-domain” property"><span class="type">“translation-domain”</span></a>.</p>
|
||||
@ -1475,7 +1475,7 @@ See <a class="link" href="GtkBuilder.html#GtkBuilder--translation-domain" title=
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="parameter_name"><p>domain</p></td>
|
||||
<td class="parameter_description"><p>the translation domain or <code class="literal">NULL</code>. </p></td>
|
||||
<td class="parameter_description"><p>the translation domain or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
|
||||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
@ -1486,7 +1486,7 @@ See <a class="link" href="GtkBuilder.html#GtkBuilder--translation-domain" title=
|
||||
<hr>
|
||||
<div class="refsect2">
|
||||
<a name="gtk-builder-get-translation-domain"></a><h3>gtk_builder_get_translation_domain ()</h3>
|
||||
<pre class="programlisting">const <span class="returnvalue">gchar</span> *
|
||||
<pre class="programlisting">const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
|
||||
gtk_builder_get_translation_domain (<em class="parameter"><code><a class="link" href="GtkBuilder.html" title="GtkBuilder"><span class="type">GtkBuilder</span></a> *builder</code></em>);</pre>
|
||||
<p>Gets the translation domain of <em class="parameter"><code>builder</code></em>
|
||||
.</p>
|
||||
@ -1522,7 +1522,7 @@ gtk_builder_set_application (<em class="parameter"><code><a class="link" href="G
|
||||
.</p>
|
||||
<p>You only need this function if there is more than one <span class="type">GApplication</span>
|
||||
in your process. <em class="parameter"><code>application</code></em>
|
||||
cannot be <code class="literal">NULL</code>.</p>
|
||||
cannot be <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
|
||||
<div class="refsect3">
|
||||
<a name="gtk-builder-set-application.parameters"></a><h4>Parameters</h4>
|
||||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||||
@ -1576,7 +1576,7 @@ for constructing proxies, use <a class="link" href="GtkBuilder.html#gtk-builder-
|
||||
<div class="refsect3">
|
||||
<a name="gtk-builder-get-application.returns"></a><h4>Returns</h4>
|
||||
<p>the application being used by the builder,
|
||||
or <code class="literal">NULL</code>. </p>
|
||||
or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p>
|
||||
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||||
</div>
|
||||
<p class="since">Since: <a class="link" href="api-index-3-10.html#api-index-3.10">3.10</a></p>
|
||||
@ -1584,7 +1584,7 @@ or <code class="literal">NULL</code>. </p>
|
||||
<hr>
|
||||
<div class="refsect2">
|
||||
<a name="gtk-builder-get-type-from-name"></a><h3>gtk_builder_get_type_from_name ()</h3>
|
||||
<pre class="programlisting"><span class="returnvalue">GType</span>
|
||||
<pre class="programlisting"><a href="https://developer.gnome.org/gobject/unstable/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a>
|
||||
gtk_builder_get_type_from_name (<em class="parameter"><code><a class="link" href="GtkBuilder.html" title="GtkBuilder"><span class="type">GtkBuilder</span></a> *builder</code></em>,
|
||||
<em class="parameter"><code>const <span class="type">char</span> *type_name</code></em>);</pre>
|
||||
<p>Looks up a type by name, using the virtual function that
|
||||
@ -1614,8 +1614,8 @@ implementing the <a class="link" href="GtkBuildable.html" title="GtkBuildable"><
|
||||
</div>
|
||||
<div class="refsect3">
|
||||
<a name="gtk-builder-get-type-from-name.returns"></a><h4>Returns</h4>
|
||||
<p> the <span class="type">GType</span> found for <em class="parameter"><code>type_name</code></em>
|
||||
or <span class="type">G_TYPE_INVALID</span>
|
||||
<p> the <a href="https://developer.gnome.org/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> found for <em class="parameter"><code>type_name</code></em>
|
||||
or <a href="https://developer.gnome.org/gobject/unstable/gobject-Type-Information.html#G-TYPE-INVALID:CAPS"><span class="type">G_TYPE_INVALID</span></a>
|
||||
if no type was found</p>
|
||||
</div>
|
||||
<p class="since">Since: 2.12</p>
|
||||
@ -1623,23 +1623,23 @@ if no type was found</p>
|
||||
<hr>
|
||||
<div class="refsect2">
|
||||
<a name="gtk-builder-value-from-string"></a><h3>gtk_builder_value_from_string ()</h3>
|
||||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||||
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
||||
gtk_builder_value_from_string (<em class="parameter"><code><a class="link" href="GtkBuilder.html" title="GtkBuilder"><span class="type">GtkBuilder</span></a> *builder</code></em>,
|
||||
<em class="parameter"><code><span class="type">GParamSpec</span> *pspec</code></em>,
|
||||
<em class="parameter"><code>const <span class="type">gchar</span> *string</code></em>,
|
||||
<em class="parameter"><code><span class="type">GValue</span> *value</code></em>,
|
||||
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
|
||||
<em class="parameter"><code><a href="https://developer.gnome.org/gobject/unstable/gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> *pspec</code></em>,
|
||||
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *string</code></em>,
|
||||
<em class="parameter"><code><a href="https://developer.gnome.org/gobject/unstable/gobject-Generic-values.html#GValue-struct"><span class="type">GValue</span></a> *value</code></em>,
|
||||
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
||||
<p>This function demarshals a value from a string. This function
|
||||
calls <code class="function">g_value_init()</code> on the <em class="parameter"><code>value</code></em>
|
||||
calls <a href="https://developer.gnome.org/gobject/unstable/gobject-Generic-values.html#g-value-init"><code class="function">g_value_init()</code></a> on the <em class="parameter"><code>value</code></em>
|
||||
argument, so it need not be
|
||||
initialised beforehand.</p>
|
||||
<p>This function can handle char, uchar, boolean, int, uint, long,
|
||||
ulong, enum, flags, float, double, string, <a href="https://developer.gnome.org/gdk3/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a>, <a href="https://developer.gnome.org/gdk3/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> and
|
||||
<a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a> type values. Support for <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> type values is
|
||||
still to come.</p>
|
||||
<p>Upon errors <code class="literal">FALSE</code> will be returned and <em class="parameter"><code>error</code></em>
|
||||
<p>Upon errors <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> will be returned and <em class="parameter"><code>error</code></em>
|
||||
will be assigned a
|
||||
<span class="type">GError</span> from the <a class="link" href="GtkBuilder.html#GTK-BUILDER-ERROR:CAPS" title="GTK_BUILDER_ERROR"><span class="type">GTK_BUILDER_ERROR</span></a> domain.</p>
|
||||
<a href="https://developer.gnome.org/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> from the <a class="link" href="GtkBuilder.html#GTK-BUILDER-ERROR:CAPS" title="GTK_BUILDER_ERROR"><span class="type">GTK_BUILDER_ERROR</span></a> domain.</p>
|
||||
<div class="refsect3">
|
||||
<a name="gtk-builder-value-from-string.parameters"></a><h4>Parameters</h4>
|
||||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||||
@ -1656,7 +1656,7 @@ still to come.</p>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="parameter_name"><p>pspec</p></td>
|
||||
<td class="parameter_description"><p>the <span class="type">GParamSpec</span> for the property</p></td>
|
||||
<td class="parameter_description"><p>the <a href="https://developer.gnome.org/gobject/unstable/gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> for the property</p></td>
|
||||
<td class="parameter_annotations"> </td>
|
||||
</tr>
|
||||
<tr>
|
||||
@ -1666,12 +1666,12 @@ still to come.</p>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="parameter_name"><p>value</p></td>
|
||||
<td class="parameter_description"><p>the <span class="type">GValue</span> to store the result in. </p></td>
|
||||
<td class="parameter_description"><p>the <a href="https://developer.gnome.org/gobject/unstable/gobject-Generic-values.html#GValue-struct"><span class="type">GValue</span></a> to store the result in. </p></td>
|
||||
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="parameter_name"><p>error</p></td>
|
||||
<td class="parameter_description"><p>return location for an error, or <code class="literal">NULL</code>. </p></td>
|
||||
<td class="parameter_description"><p>return location for an error, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
|
||||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
@ -1679,27 +1679,27 @@ still to come.</p>
|
||||
</div>
|
||||
<div class="refsect3">
|
||||
<a name="gtk-builder-value-from-string.returns"></a><h4>Returns</h4>
|
||||
<p> <code class="literal">TRUE</code> on success</p>
|
||||
<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on success</p>
|
||||
</div>
|
||||
<p class="since">Since: 2.12</p>
|
||||
</div>
|
||||
<hr>
|
||||
<div class="refsect2">
|
||||
<a name="gtk-builder-value-from-string-type"></a><h3>gtk_builder_value_from_string_type ()</h3>
|
||||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||||
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
||||
gtk_builder_value_from_string_type (<em class="parameter"><code><a class="link" href="GtkBuilder.html" title="GtkBuilder"><span class="type">GtkBuilder</span></a> *builder</code></em>,
|
||||
<em class="parameter"><code><span class="type">GType</span> type</code></em>,
|
||||
<em class="parameter"><code>const <span class="type">gchar</span> *string</code></em>,
|
||||
<em class="parameter"><code><span class="type">GValue</span> *value</code></em>,
|
||||
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
|
||||
<em class="parameter"><code><a href="https://developer.gnome.org/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> type</code></em>,
|
||||
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *string</code></em>,
|
||||
<em class="parameter"><code><a href="https://developer.gnome.org/gobject/unstable/gobject-Generic-values.html#GValue-struct"><span class="type">GValue</span></a> *value</code></em>,
|
||||
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
||||
<p>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
|
||||
a value from a string, but takes a <span class="type">GType</span> instead of <span class="type">GParamSpec</span>.
|
||||
This function calls <code class="function">g_value_init()</code> on the <em class="parameter"><code>value</code></em>
|
||||
a value from a string, but takes a <a href="https://developer.gnome.org/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> instead of <a href="https://developer.gnome.org/gobject/unstable/gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a>.
|
||||
This function calls <a href="https://developer.gnome.org/gobject/unstable/gobject-Generic-values.html#g-value-init"><code class="function">g_value_init()</code></a> on the <em class="parameter"><code>value</code></em>
|
||||
argument, so it
|
||||
need not be initialised beforehand.</p>
|
||||
<p>Upon errors <code class="literal">FALSE</code> will be returned and <em class="parameter"><code>error</code></em>
|
||||
<p>Upon errors <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> will be returned and <em class="parameter"><code>error</code></em>
|
||||
will be assigned a
|
||||
<span class="type">GError</span> from the <a class="link" href="GtkBuilder.html#GTK-BUILDER-ERROR:CAPS" title="GTK_BUILDER_ERROR"><span class="type">GTK_BUILDER_ERROR</span></a> domain.</p>
|
||||
<a href="https://developer.gnome.org/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> from the <a class="link" href="GtkBuilder.html#GTK-BUILDER-ERROR:CAPS" title="GTK_BUILDER_ERROR"><span class="type">GTK_BUILDER_ERROR</span></a> domain.</p>
|
||||
<div class="refsect3">
|
||||
<a name="gtk-builder-value-from-string-type.parameters"></a><h4>Parameters</h4>
|
||||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||||
@ -1716,7 +1716,7 @@ need not be initialised beforehand.</p>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="parameter_name"><p>type</p></td>
|
||||
<td class="parameter_description"><p>the <span class="type">GType</span> of the value</p></td>
|
||||
<td class="parameter_description"><p>the <a href="https://developer.gnome.org/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> of the value</p></td>
|
||||
<td class="parameter_annotations"> </td>
|
||||
</tr>
|
||||
<tr>
|
||||
@ -1726,12 +1726,12 @@ need not be initialised beforehand.</p>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="parameter_name"><p>value</p></td>
|
||||
<td class="parameter_description"><p>the <span class="type">GValue</span> to store the result in. </p></td>
|
||||
<td class="parameter_description"><p>the <a href="https://developer.gnome.org/gobject/unstable/gobject-Generic-values.html#GValue-struct"><span class="type">GValue</span></a> to store the result in. </p></td>
|
||||
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="parameter_name"><p>error</p></td>
|
||||
<td class="parameter_description"><p>return location for an error, or <code class="literal">NULL</code>. </p></td>
|
||||
<td class="parameter_description"><p>return location for an error, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
|
||||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
@ -1739,7 +1739,7 @@ need not be initialised beforehand.</p>
|
||||
</div>
|
||||
<div class="refsect3">
|
||||
<a name="gtk-builder-value-from-string-type.returns"></a><h4>Returns</h4>
|
||||
<p> <code class="literal">TRUE</code> on success</p>
|
||||
<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on success</p>
|
||||
</div>
|
||||
<p class="since">Since: 2.12</p>
|
||||
</div>
|
||||
@ -1798,7 +1798,7 @@ in a <a class="link" href="GtkBuildable.html" title="GtkBuildable"><span class="
|
||||
<td class="enum_member_name"><p><a name="GTK-BUILDER-ERROR-INVALID-TYPE-FUNCTION:CAPS"></a>GTK_BUILDER_ERROR_INVALID_TYPE_FUNCTION</p></td>
|
||||
<td class="enum_member_description">
|
||||
<p>A type-func attribute didn’t name
|
||||
a function that returns a <span class="type">GType</span>.</p>
|
||||
a function that returns a <a href="https://developer.gnome.org/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a>.</p>
|
||||
</td>
|
||||
<td class="enum_member_annotations"> </td>
|
||||
</tr>
|
||||
@ -1916,11 +1916,11 @@ in a <a class="link" href="GtkBuildable.html" title="GtkBuildable"><span class="
|
||||
<a name="GtkBuilder.property-details"></a><h2>Property Details</h2>
|
||||
<div class="refsect2">
|
||||
<a name="GtkBuilder--translation-domain"></a><h3>The <code class="literal">“translation-domain”</code> property</h3>
|
||||
<pre class="programlisting"> “translation-domain” <span class="type">gchar</span> *</pre>
|
||||
<pre class="programlisting"> “translation-domain” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
|
||||
<p>The translation domain used when translating property values that
|
||||
have been marked as translatable in interface descriptions.
|
||||
If the translation domain is <code class="literal">NULL</code>, <a class="link" href="GtkBuilder.html" title="GtkBuilder"><span class="type">GtkBuilder</span></a> uses <code class="function">gettext()</code>,
|
||||
otherwise <code class="function">g_dgettext()</code>.</p>
|
||||
If the translation domain is <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, <a class="link" href="GtkBuilder.html" title="GtkBuilder"><span class="type">GtkBuilder</span></a> uses <code class="function">gettext()</code>,
|
||||
otherwise <a href="https://developer.gnome.org/glib/unstable/glib-I18N.html#g-dgettext"><code class="function">g_dgettext()</code></a>.</p>
|
||||
<p>Flags: Read / Write</p>
|
||||
<p>Default value: NULL</p>
|
||||
<p class="since">Since: 2.12</p>
|
||||
|
||||
Reference in New Issue
Block a user