New upstream version 3.22.28

This commit is contained in:
Jeremy Bicha
2018-02-15 04:41:25 -05:00
652 changed files with 498643 additions and 49781 deletions

View File

@ -8,7 +8,7 @@
<link rel="up" href="AbstractObjects.html" title="Abstract Base Classes">
<link rel="prev" href="GtkWidget.html" title="GtkWidget">
<link rel="next" href="GtkBin.html" title="GtkBin">
<meta name="generator" content="GTK-Doc V1.25.1 (XML mode)">
<meta name="generator" content="GTK-Doc V1.27 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@ -113,7 +113,7 @@
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
<span class="returnvalue">GList</span> *
</td>
<td class="function_name">
<a class="link" href="GtkContainer.html#gtk-container-get-children" title="gtk_container_get_children ()">gtk_container_get_children</a> <span class="c_punctuation">()</span>
@ -193,7 +193,7 @@
</tr>
<tr>
<td class="function_type">
<a href="../gobject/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a>
<span class="returnvalue">GType</span>
</td>
<td class="function_name">
<a class="link" href="GtkContainer.html#gtk-container-child-type" title="gtk_container_child_type ()">gtk_container_child_type</a> <span class="c_punctuation">()</span>
@ -273,7 +273,7 @@
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>
<span class="returnvalue">guint</span>
</td>
<td class="function_name">
<a class="link" href="GtkContainer.html#gtk-container-get-border-width" title="gtk_container_get_border_width ()">gtk_container_get_border_width</a> <span class="c_punctuation">()</span>
@ -297,7 +297,7 @@
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GtkContainer.html#gtk-container-get-focus-chain" title="gtk_container_get_focus_chain ()">gtk_container_get_focus_chain</a> <span class="c_punctuation">()</span>
@ -321,7 +321,7 @@
</tr>
<tr>
<td class="function_type">
<a href="../gobject/gobject-GParamSpec.html#GParamSpec"><span class="returnvalue">GParamSpec</span></a> *
<span class="returnvalue">GParamSpec</span> *
</td>
<td class="function_name">
<a class="link" href="GtkContainer.html#gtk-container-class-find-child-property" title="gtk_container_class_find_child_property ()">gtk_container_class_find_child_property</a> <span class="c_punctuation">()</span>
@ -345,7 +345,7 @@
</tr>
<tr>
<td class="function_type">
<a href="../gobject/gobject-GParamSpec.html#GParamSpec"><span class="returnvalue">GParamSpec</span></a> **
<span class="returnvalue">GParamSpec</span> **
</td>
<td class="function_name">
<a class="link" href="GtkContainer.html#gtk-container-class-list-child-properties" title="gtk_container_class_list_child_properties ()">gtk_container_class_list_child_properties</a> <span class="c_punctuation">()</span>
@ -372,7 +372,7 @@
</colgroup>
<tbody>
<tr>
<td class="property_type"><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a></td>
<td class="property_type"><span class="type">guint</span></td>
<td class="property_name"><a class="link" href="GtkContainer.html#GtkContainer--border-width" title="The “border-width” property">border-width</a></td>
<td class="property_flags">Read / Write</td>
</tr>
@ -402,22 +402,22 @@
<tr>
<td class="signal_type"><span class="returnvalue">void</span></td>
<td class="signal_name"><a class="link" href="GtkContainer.html#GtkContainer-add" title="The “add” signal">add</a></td>
<td class="signal_flags"><a href="../gobject/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS">Run First</a></td>
<td class="signal_flags">Run First</td>
</tr>
<tr>
<td class="signal_type"><span class="returnvalue">void</span></td>
<td class="signal_name"><a class="link" href="GtkContainer.html#GtkContainer-check-resize" title="The “check-resize” signal">check-resize</a></td>
<td class="signal_flags"><a href="../gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></td>
<td class="signal_flags">Run Last</td>
</tr>
<tr>
<td class="signal_type"><span class="returnvalue">void</span></td>
<td class="signal_name"><a class="link" href="GtkContainer.html#GtkContainer-remove" title="The “remove” signal">remove</a></td>
<td class="signal_flags"><a href="../gobject/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS">Run First</a></td>
<td class="signal_flags">Run First</td>
</tr>
<tr>
<td class="signal_type"><span class="returnvalue">void</span></td>
<td class="signal_name"><a class="link" href="GtkContainer.html#GtkContainer-set-focus-child" title="The “set-focus-child” signal">set-focus-child</a></td>
<td class="signal_flags"><a href="../gobject/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS">Run First</a></td>
<td class="signal_flags">Run First</td>
</tr>
</tbody>
</table></div>
@ -447,8 +447,8 @@
</div>
<div class="refsect1">
<a name="GtkContainer.object-hierarchy"></a><h2>Object Hierarchy</h2>
<pre class="screen"> <a href="../gobject/gobject-The-Base-Object-Type.html#GObject-struct">GObject</a>
<span class="lineart">╰──</span> <a href="../gobject/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a>
<pre class="screen"> GObject
<span class="lineart">╰──</span> GInitiallyUnowned
<span class="lineart">╰──</span> <a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
<span class="lineart">╰──</span> GtkContainer
<span class="lineart">├──</span> <a class="link" href="GtkBin.html" title="GtkBin">GtkBin</a>
@ -568,33 +568,33 @@ simply calling the reverse apis implemented for itself as follows:</p>
25
26
27</pre></td>
<td class="listing_code"><pre class="programlisting"><span class="gtkdoc kwb">static void</span>
<span class="function">foo_container_get_preferred_height</span> <span class="gtkdoc opt">(</span>GtkWidget <span class="gtkdoc opt">*</span>widget<span class="gtkdoc opt">,</span>
gint <span class="gtkdoc opt">*</span>min_height<span class="gtkdoc opt">,</span>
gint <span class="gtkdoc opt">*</span>nat_height<span class="gtkdoc opt">)</span>
<span class="gtkdoc opt">{</span>
<span class="keyword">if</span> <span class="gtkdoc opt">(</span>i_am_in_height_for_width_mode<span class="gtkdoc opt">)</span>
<span class="gtkdoc opt">{</span>
gint min_width<span class="gtkdoc opt">;</span>
<td class="listing_code"><pre class="programlisting"><span class="keyword">static</span><span class="normal"> </span><span class="type">void</span>
<span class="function">foo_container_get_preferred_height</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GtkWidget</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">widget</span><span class="symbol">,</span>
<span class="normal"> </span><span class="usertype">gint</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">min_height</span><span class="symbol">,</span>
<span class="normal"> </span><span class="usertype">gint</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">nat_height</span><span class="symbol">)</span>
<span class="cbracket">{</span>
<span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">i_am_in_height_for_width_mode</span><span class="symbol">)</span>
<span class="normal"> </span><span class="cbracket">{</span>
<span class="normal"> </span><span class="usertype">gint</span><span class="normal"> min_width</span><span class="symbol">;</span>
<span class="function">GTK_WIDGET_GET_CLASS</span> <span class="gtkdoc opt">(</span>widget<span class="gtkdoc opt">)-&gt;</span><span class="function">get_preferred_width</span> <span class="gtkdoc opt">(</span>widget<span class="gtkdoc opt">,</span>
<span class="gtkdoc opt">&amp;</span>min_width<span class="gtkdoc opt">,</span>
NULL<span class="gtkdoc opt">);</span>
<span class="function">GTK_WIDGET_GET_CLASS</span> <span class="gtkdoc opt">(</span>widget<span class="gtkdoc opt">)-&gt;</span>get_preferred_height_for_width
<span class="gtkdoc opt">(</span>widget<span class="gtkdoc opt">,</span>
min_width<span class="gtkdoc opt">,</span>
min_height<span class="gtkdoc opt">,</span>
nat_height<span class="gtkdoc opt">);</span>
<span class="gtkdoc opt">}</span>
<span class="keyword">else</span>
<span class="gtkdoc opt">{</span>
<span class="gtkdoc opt">...</span> many containers support both request modes<span class="gtkdoc opt">,</span> execute the
real width<span class="gtkdoc opt">-</span><span class="keyword">for</span><span class="gtkdoc opt">-</span>height request here by returning the
collective heights of all widgets that are stacked
<span class="function">vertically</span> <span class="gtkdoc opt">(</span><span class="keyword">or</span> whatever is appropriate <span class="keyword">for this</span> container<span class="gtkdoc opt">)</span>
<span class="gtkdoc opt">...</span>
<span class="gtkdoc opt">}</span>
<span class="gtkdoc opt">}</span></pre></td>
<span class="normal"> </span><span class="function">GTK_WIDGET_GET_CLASS</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">widget</span><span class="symbol">)-&gt;</span><span class="function">get_preferred_width</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">widget</span><span class="symbol">,</span>
<span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">min_width</span><span class="symbol">,</span>
<span class="normal"> NULL</span><span class="symbol">);</span>
<span class="normal"> </span><span class="function">GTK_WIDGET_GET_CLASS</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">widget</span><span class="symbol">)-&gt;</span><span class="normal">get_preferred_height_for_width</span>
<span class="normal"> </span><span class="symbol">(</span><span class="normal">widget</span><span class="symbol">,</span>
<span class="normal"> min_width</span><span class="symbol">,</span>
<span class="normal"> min_height</span><span class="symbol">,</span>
<span class="normal"> nat_height</span><span class="symbol">);</span>
<span class="normal"> </span><span class="cbracket">}</span>
<span class="normal"> </span><span class="keyword">else</span>
<span class="normal"> </span><span class="cbracket">{</span>
<span class="normal"> </span><span class="symbol">...</span><span class="normal"> many containers support both </span><span class="usertype">request</span><span class="normal"> modes</span><span class="symbol">,</span><span class="normal"> execute the</span>
<span class="normal"> </span><span class="usertype">real</span><span class="normal"> width</span><span class="symbol">-</span><span class="keyword">for</span><span class="symbol">-</span><span class="normal">height request here by returning the</span>
<span class="normal"> collective heights of all widgets that are stacked</span>
<span class="normal"> </span><span class="function">vertically</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">or whatever is appropriate </span><span class="keyword">for</span><span class="normal"> </span><span class="usertype">this</span><span class="normal"> container</span><span class="symbol">)</span>
<span class="normal"> </span><span class="symbol">...</span>
<span class="normal"> </span><span class="cbracket">}</span>
<span class="cbracket">}</span></pre></td>
</tr>
</tbody>
</table>
@ -626,25 +626,25 @@ that is height-for-width, it then only needs to return the base minimum width li
17
18
19</pre></td>
<td class="listing_code"><pre class="programlisting"><span class="gtkdoc kwb">static void</span>
<span class="function">foo_container_get_preferred_width_for_height</span> <span class="gtkdoc opt">(</span>GtkWidget <span class="gtkdoc opt">*</span>widget<span class="gtkdoc opt">,</span>
gint for_height<span class="gtkdoc opt">,</span>
gint <span class="gtkdoc opt">*</span>min_width<span class="gtkdoc opt">,</span>
gint <span class="gtkdoc opt">*</span>nat_width<span class="gtkdoc opt">)</span>
<span class="gtkdoc opt">{</span>
<span class="keyword">if</span> <span class="gtkdoc opt">(</span>i_am_in_height_for_width_mode<span class="gtkdoc opt">)</span>
<span class="gtkdoc opt">{</span>
<span class="function">GTK_WIDGET_GET_CLASS</span> <span class="gtkdoc opt">(</span>widget<span class="gtkdoc opt">)-&gt;</span><span class="function">get_preferred_width</span> <span class="gtkdoc opt">(</span>widget<span class="gtkdoc opt">,</span>
min_width<span class="gtkdoc opt">,</span>
nat_width<span class="gtkdoc opt">);</span>
<span class="gtkdoc opt">}</span>
<span class="keyword">else</span>
<span class="gtkdoc opt">{</span>
<span class="gtkdoc opt">...</span> execute the real width<span class="gtkdoc opt">-</span><span class="keyword">for</span><span class="gtkdoc opt">-</span>height request here based on
the required width of the children collectively <span class="keyword">if</span> the
container were to be allocated the said height <span class="gtkdoc opt">...</span>
<span class="gtkdoc opt">}</span>
<span class="gtkdoc opt">}</span></pre></td>
<td class="listing_code"><pre class="programlisting"><span class="keyword">static</span><span class="normal"> </span><span class="type">void</span>
<span class="function">foo_container_get_preferred_width_for_height</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GtkWidget</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">widget</span><span class="symbol">,</span>
<span class="normal"> </span><span class="usertype">gint</span><span class="normal"> for_height</span><span class="symbol">,</span>
<span class="normal"> </span><span class="usertype">gint</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">min_width</span><span class="symbol">,</span>
<span class="normal"> </span><span class="usertype">gint</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">nat_width</span><span class="symbol">)</span>
<span class="cbracket">{</span>
<span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">i_am_in_height_for_width_mode</span><span class="symbol">)</span>
<span class="normal"> </span><span class="cbracket">{</span>
<span class="normal"> </span><span class="function">GTK_WIDGET_GET_CLASS</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">widget</span><span class="symbol">)-&gt;</span><span class="function">get_preferred_width</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">widget</span><span class="symbol">,</span>
<span class="normal"> min_width</span><span class="symbol">,</span>
<span class="normal"> nat_width</span><span class="symbol">);</span>
<span class="normal"> </span><span class="cbracket">}</span>
<span class="normal"> </span><span class="keyword">else</span>
<span class="normal"> </span><span class="cbracket">{</span>
<span class="normal"> </span><span class="symbol">...</span><span class="normal"> execute the </span><span class="usertype">real</span><span class="normal"> width</span><span class="symbol">-</span><span class="keyword">for</span><span class="symbol">-</span><span class="normal">height request here based on</span>
<span class="normal"> the required width of the children collectively </span><span class="keyword">if</span><span class="normal"> the</span>
<span class="normal"> container were to be allocated the </span><span class="usertype">said</span><span class="normal"> height </span><span class="symbol">...</span>
<span class="normal"> </span><span class="cbracket">}</span>
<span class="cbracket">}</span></pre></td>
</tr>
</tbody>
</table>
@ -730,21 +730,21 @@ chain. The ”name” attribute gives the id of the widget.</p>
13
14
15</pre></td>
<td class="listing_code"><pre class="programlisting"><span class="gtkdoc opt">&lt;</span>object <span class="gtkdoc kwc">class</span><span class="gtkdoc opt">=</span><span class="string">&quot;GtkBox&quot;</span><span class="gtkdoc opt">&gt;</span>
<span class="gtkdoc opt">&lt;</span>child<span class="gtkdoc opt">&gt;</span>
<span class="gtkdoc opt">&lt;</span>object <span class="gtkdoc kwc">class</span><span class="gtkdoc opt">=</span><span class="string">&quot;GtkEntry&quot;</span> id<span class="gtkdoc opt">=</span><span class="string">&quot;entry1&quot;</span><span class="gtkdoc opt">/&gt;</span>
<span class="gtkdoc opt">&lt;</span>packing<span class="gtkdoc opt">&gt;</span>
<span class="gtkdoc opt">&lt;</span>property name<span class="gtkdoc opt">=</span><span class="string">&quot;pack-type&quot;</span><span class="gtkdoc opt">&gt;</span>start<span class="gtkdoc opt">&lt;/</span>property<span class="gtkdoc opt">&gt;</span>
<span class="gtkdoc opt">&lt;/</span>packing<span class="gtkdoc opt">&gt;</span>
<span class="gtkdoc opt">&lt;/</span>child<span class="gtkdoc opt">&gt;</span>
<span class="gtkdoc opt">&lt;</span>child<span class="gtkdoc opt">&gt;</span>
<span class="gtkdoc opt">&lt;</span>object <span class="gtkdoc kwc">class</span><span class="gtkdoc opt">=</span><span class="string">&quot;GtkEntry&quot;</span> id<span class="gtkdoc opt">=</span><span class="string">&quot;entry2&quot;</span><span class="gtkdoc opt">/&gt;</span>
<span class="gtkdoc opt">&lt;/</span>child<span class="gtkdoc opt">&gt;</span>
<span class="gtkdoc opt">&lt;</span>focus<span class="gtkdoc opt">-</span>chain<span class="gtkdoc opt">&gt;</span>
<span class="gtkdoc opt">&lt;</span>widget name<span class="gtkdoc opt">=</span><span class="string">&quot;entry1&quot;</span><span class="gtkdoc opt">/&gt;</span>
<span class="gtkdoc opt">&lt;</span>widget name<span class="gtkdoc opt">=</span><span class="string">&quot;entry2&quot;</span><span class="gtkdoc opt">/&gt;</span>
<span class="gtkdoc opt">&lt;/</span>focus<span class="gtkdoc opt">-</span>chain<span class="gtkdoc opt">&gt;</span>
<span class="gtkdoc opt">&lt;/</span>object<span class="gtkdoc opt">&gt;</span></pre></td>
<td class="listing_code"><pre class="programlisting"><span class="symbol">&lt;</span><span class="usertype">object</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"GtkBox"</span><span class="symbol">&gt;</span>
<span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">child</span><span class="symbol">&gt;</span>
<span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">object</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"GtkEntry"</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"entry1"</span><span class="symbol">/&gt;</span>
<span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">packing</span><span class="symbol">&gt;</span>
<span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"pack-type"</span><span class="symbol">&gt;</span><span class="normal">start</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
<span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">packing</span><span class="symbol">&gt;</span>
<span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">child</span><span class="symbol">&gt;</span>
<span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">child</span><span class="symbol">&gt;</span>
<span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">object</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"GtkEntry"</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"entry2"</span><span class="symbol">/&gt;</span>
<span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">child</span><span class="symbol">&gt;</span>
<span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">focus</span><span class="symbol">-</span><span class="normal">chain</span><span class="symbol">&gt;</span>
<span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">widget</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"entry1"</span><span class="symbol">/&gt;</span>
<span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">widget</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"entry2"</span><span class="symbol">/&gt;</span>
<span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">focus</span><span class="symbol">-</span><span class="normal">chain</span><span class="symbol">&gt;</span>
<span class="symbol">&lt;/</span><span class="normal">object</span><span class="symbol">&gt;</span></pre></td>
</tr>
</tbody>
</table>
@ -776,7 +776,7 @@ properties in <code class="function">set_child_property()</code> and <code class
<tbody>
<tr>
<td class="parameter_name"><p>object</p></td>
<td class="parameter_description"><p>the <a href="../gobject/gobject-The-Base-Object-Type.html#GObject-struct"><span class="type">GObject</span></a> on which <code class="function">set_child_property()</code> or <code class="function">get_child_property()</code>
<td class="parameter_description"><p>the <span class="type">GObject</span> on which <code class="function">set_child_property()</code> or <code class="function">get_child_property()</code>
was called</p></td>
<td class="parameter_annotations"> </td>
</tr>
@ -787,7 +787,7 @@ was called</p></td>
</tr>
<tr>
<td class="parameter_name"><p>pspec</p></td>
<td class="parameter_description"><p>the <a href="../gobject/gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> of the property</p></td>
<td class="parameter_description"><p>the <span class="type">GParamSpec</span> of the property</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@ -855,7 +855,7 @@ may be the last reference held; so removing a widget from its
container can destroy that widget. If you want to use <em class="parameter"><code>widget</code></em>
again, you need to add a reference to it before removing it from
a container, using <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-ref"><code class="function">g_object_ref()</code></a>. If you dont want to use <em class="parameter"><code>widget</code></em>
a container, using <code class="function">g_object_ref()</code>. If you dont want to use <em class="parameter"><code>widget</code></em>
again its usually more efficient to simply destroy it directly
using <a class="link" href="GtkWidget.html#gtk-widget-destroy" title="gtk_widget_destroy ()"><code class="function">gtk_widget_destroy()</code></a> since this will remove it from the
@ -890,7 +890,7 @@ container and help break any circular reference count cycles.</p>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_container_add_with_properties (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</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>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_prop_name</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> *first_prop_name</code></em>,
<em class="parameter"><code>...</code></em>);</pre>
<p>Adds <em class="parameter"><code>widget</code></em>
to <em class="parameter"><code>container</code></em>
@ -923,7 +923,7 @@ See <a class="link" href="GtkContainer.html#gtk-container-add" title="gtk_contai
</tr>
<tr>
<td class="parameter_name"><p>...</p></td>
<td class="parameter_description"><p>a <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated list of property names and values, starting
<td class="parameter_description"><p>a <code class="literal">NULL</code>-terminated list of property names and values, starting
with <em class="parameter"><code>first_prop_name</code></em>
</p></td>
<td class="parameter_annotations"> </td>
@ -1016,7 +1016,7 @@ gtk_container_check_resize (<em class="parameter"><code><a class="link" href="Gt
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_container_foreach (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
<em class="parameter"><code><a class="link" href="GtkWidget.html#GtkCallback" title="GtkCallback ()"><span class="type">GtkCallback</span></a> callback</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> callback_data</code></em>);</pre>
<em class="parameter"><code><span class="type">gpointer</span> callback_data</code></em>);</pre>
<p>Invokes <em class="parameter"><code>callback</code></em>
on each non-internal child of <em class="parameter"><code>container</code></em>
.
@ -1043,7 +1043,7 @@ rather than <a class="link" href="GtkContainer.html#gtk-container-forall" title=
</tr>
<tr>
<td class="parameter_name"><p>callback</p></td>
<td class="parameter_description"><p> a callback. </p></td>
<td class="parameter_description"><p>a callback. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid only during the call to the method."><span class="acronym">scope call</span></acronym>]</span></td>
</tr>
<tr>
@ -1058,7 +1058,7 @@ rather than <a class="link" href="GtkContainer.html#gtk-container-forall" title=
<hr>
<div class="refsect2">
<a name="gtk-container-get-children"></a><h3>gtk_container_get_children ()</h3>
<pre class="programlisting"><a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
<pre class="programlisting"><span class="returnvalue">GList</span> *
gtk_container_get_children (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>);</pre>
<p>Returns the containers non-internal children. See
<a class="link" href="GtkContainer.html#gtk-container-forall" title="gtk_container_forall ()"><code class="function">gtk_container_forall()</code></a> for details on what constitutes an "internal" child.</p>
@ -1079,7 +1079,7 @@ gtk_container_get_children (<em class="parameter"><code><a class="link" href="Gt
</div>
<div class="refsect3">
<a name="gtk-container-get-children.returns"></a><h4>Returns</h4>
<p> a newly-allocated list of the containers non-internal children. </p>
<p>a newly-allocated list of the containers non-internal children. </p>
<p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GtkWidget][<acronym title="Free data container after the code is done."><span class="acronym">transfer container</span></acronym>]</span></p>
</div>
</div>
@ -1125,7 +1125,7 @@ from the toplevel down to and including <em class="parameter"><code>child</code>
<a name="gtk-container-set-reallocate-redraws"></a><h3>gtk_container_set_reallocate_redraws ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_container_set_reallocate_redraws (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> needs_redraws</code></em>);</pre>
<em class="parameter"><code><span class="type">gboolean</span> needs_redraws</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_container_set_reallocate_redraws</code> has been deprecated since version 3.14 and should not be used in newly-written code.</p>
<p>Call <a class="link" href="GtkWidget.html#gtk-widget-queue-draw" title="gtk_widget_queue_draw ()"><code class="function">gtk_widget_queue_draw()</code></a> in your size_allocate handler.</p>
@ -1184,11 +1184,11 @@ currently focused widget. That can be obtained by calling
</div>
<div class="refsect3">
<a name="gtk-container-get-focus-child.returns"></a><h4>Returns</h4>
<p> The child widget which will receive the
<p>The child widget which will receive the
focus inside <em class="parameter"><code>container</code></em>
when the <em class="parameter"><code>container</code></em>
is focused,
or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if none is set. </p>
or <code class="literal">NULL</code> if none is set. </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: 2.14</p>
@ -1200,7 +1200,7 @@ or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">N
gtk_container_set_focus_child (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>);</pre>
<p>Sets, or unsets if <em class="parameter"><code>child</code></em>
is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the focused child of <em class="parameter"><code>container</code></em>
is <code class="literal">NULL</code>, the focused child of <em class="parameter"><code>container</code></em>
.</p>
<p>This function emits the GtkContainer::set_focus_child signal of
<em class="parameter"><code>container</code></em>
@ -1224,7 +1224,7 @@ default behaviour by overriding the class closure of this signal.</p>
</tr>
<tr>
<td class="parameter_name"><p>child</p></td>
<td class="parameter_description"><p> a <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>, or <code class="literal">NULL</code>. </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>
@ -1255,8 +1255,8 @@ gtk_container_get_focus_vadjustment (<em class="parameter"><code><a class="link"
</div>
<div class="refsect3">
<a name="gtk-container-get-focus-vadjustment.returns"></a><h4>Returns</h4>
<p> the vertical focus adjustment, or
<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if none has been set. </p>
<p>the vertical focus adjustment, or
<code class="literal">NULL</code> if none has been set. </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>
</div>
@ -1323,7 +1323,7 @@ gtk_container_get_focus_hadjustment (<em class="parameter"><code><a class="link"
</div>
<div class="refsect3">
<a name="gtk-container-get-focus-hadjustment.returns"></a><h4>Returns</h4>
<p> the horizontal focus adjustment, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if
<p>the horizontal focus adjustment, or <code class="literal">NULL</code> if
none has been set. </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>
@ -1392,10 +1392,10 @@ gtk_container_resize_children (<em class="parameter"><code><a class="link" href=
<hr>
<div class="refsect2">
<a name="gtk-container-child-type"></a><h3>gtk_container_child_type ()</h3>
<pre class="programlisting"><a href="../gobject/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a>
<pre class="programlisting"><span class="returnvalue">GType</span>
gtk_container_child_type (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>);</pre>
<p>Returns the type of the children supported by the container.</p>
<p>Note that this may return <a href="../gobject/gobject-Type-Information.html#G-TYPE-NONE:CAPS"><code class="literal">G_TYPE_NONE</code></a> to indicate that no more
<p>Note that this may return <code class="literal">G_TYPE_NONE</code> to indicate that no more
children can be added, e.g. for a <a class="link" href="GtkPaned.html" title="GtkPaned"><span class="type">GtkPaned</span></a> which already has two
children.</p>
<div class="refsect3">
@ -1415,7 +1415,7 @@ children.</p>
</div>
<div class="refsect3">
<a name="gtk-container-child-type.returns"></a><h4>Returns</h4>
<p> a <a href="../gobject/gobject-Type-Information.html#GType"><span class="type">GType</span></a>.</p>
<p> a <span class="type">GType</span>.</p>
</div>
</div>
<hr>
@ -1424,7 +1424,7 @@ children.</p>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_container_child_get (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_prop_name</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> *first_prop_name</code></em>,
<em class="parameter"><code>...</code></em>);</pre>
<p>Gets the values of one or more child properties for <em class="parameter"><code>child</code></em>
and <em class="parameter"><code>container</code></em>
@ -1457,7 +1457,7 @@ gtk_container_child_get (<em class="parameter"><code><a class="link" href="GtkCo
<tr>
<td class="parameter_name"><p>...</p></td>
<td class="parameter_description"><p>return location for the first property, followed
optionally by more name/return location pairs, followed by <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
optionally by more name/return location pairs, followed by <code class="literal">NULL</code></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@ -1470,7 +1470,7 @@ optionally by more name/return location pairs, followed by <a href="../glib/glib
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_container_child_set (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_prop_name</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> *first_prop_name</code></em>,
<em class="parameter"><code>...</code></em>);</pre>
<p>Sets one or more child properties for <em class="parameter"><code>child</code></em>
and <em class="parameter"><code>container</code></em>
@ -1502,7 +1502,7 @@ gtk_container_child_set (<em class="parameter"><code><a class="link" href="GtkCo
</tr>
<tr>
<td class="parameter_name"><p>...</p></td>
<td class="parameter_description"><p>a <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated list of property names and values, starting
<td class="parameter_description"><p>a <code class="literal">NULL</code>-terminated list of property names and values, starting
with <em class="parameter"><code>first_prop_name</code></em>
</p></td>
<td class="parameter_annotations"> </td>
@ -1517,8 +1517,8 @@ with <em class="parameter"><code>first_prop_name</code></em>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_container_child_get_property (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *property_name</code></em>,
<em class="parameter"><code><a href="../gobject/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);</pre>
<em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>,
<em class="parameter"><code><span class="type">GValue</span> *value</code></em>);</pre>
<p>Gets the value of a child property for <em class="parameter"><code>child</code></em>
and <em class="parameter"><code>container</code></em>
.</p>
@ -1562,8 +1562,8 @@ gtk_container_child_get_property (<em class="parameter"><code><a class="link" hr
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_container_child_set_property (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *property_name</code></em>,
<em class="parameter"><code>const <a href="../gobject/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);</pre>
<em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>,
<em class="parameter"><code>const <span class="type">GValue</span> *value</code></em>);</pre>
<p>Sets a child property for <em class="parameter"><code>child</code></em>
and <em class="parameter"><code>container</code></em>
.</p>
@ -1607,7 +1607,7 @@ gtk_container_child_set_property (<em class="parameter"><code><a class="link" hr
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_container_child_get_valist (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_property_name</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> *first_property_name</code></em>,
<em class="parameter"><code><span class="type">va_list</span> var_args</code></em>);</pre>
<p>Gets the values of one or more child properties for <em class="parameter"><code>child</code></em>
and <em class="parameter"><code>container</code></em>
@ -1640,7 +1640,7 @@ gtk_container_child_get_valist (<em class="parameter"><code><a class="link" href
<tr>
<td class="parameter_name"><p>var_args</p></td>
<td class="parameter_description"><p>return location for the first property, followed
optionally by more name/return location pairs, followed by <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
optionally by more name/return location pairs, followed by <code class="literal">NULL</code></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@ -1653,7 +1653,7 @@ optionally by more name/return location pairs, followed by <a href="../glib/glib
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_container_child_set_valist (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_property_name</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> *first_property_name</code></em>,
<em class="parameter"><code><span class="type">va_list</span> var_args</code></em>);</pre>
<p>Sets one or more child properties for <em class="parameter"><code>child</code></em>
and <em class="parameter"><code>container</code></em>
@ -1685,7 +1685,7 @@ gtk_container_child_set_valist (<em class="parameter"><code><a class="link" href
</tr>
<tr>
<td class="parameter_name"><p>var_args</p></td>
<td class="parameter_description"><p>a <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated list of property names and values, starting
<td class="parameter_description"><p>a <code class="literal">NULL</code>-terminated list of property names and values, starting
with <em class="parameter"><code>first_prop_name</code></em>
</p></td>
<td class="parameter_annotations"> </td>
@ -1700,12 +1700,12 @@ with <em class="parameter"><code>first_prop_name</code></em>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_container_child_notify (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *child_property</code></em>);</pre>
<em class="parameter"><code>const <span class="type">gchar</span> *child_property</code></em>);</pre>
<p>Emits a <a class="link" href="GtkWidget.html#GtkWidget-child-notify" title="The “child-notify” signal"><span class="type">“child-notify”</span></a> signal for the
child property
<em class="parameter"><code>child_property</code></em>
on the child.</p>
<p>This is an analogue of <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-notify"><code class="function">g_object_notify()</code></a> for child properties.</p>
<p>This is an analogue of <code class="function">g_object_notify()</code> for child properties.</p>
<p>Also see <a class="link" href="GtkWidget.html#gtk-widget-child-notify" title="gtk_widget_child_notify ()"><code class="function">gtk_widget_child_notify()</code></a>.</p>
<div class="refsect3">
<a name="gtk-container-child-notify.parameters"></a><h4>Parameters</h4>
@ -1744,12 +1744,12 @@ the class of <em class="parameter"><code>container</code></em>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_container_child_notify_by_pspec (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
<em class="parameter"><code><a href="../gobject/gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> *pspec</code></em>);</pre>
<em class="parameter"><code><span class="type">GParamSpec</span> *pspec</code></em>);</pre>
<p>Emits a <a class="link" href="GtkWidget.html#GtkWidget-child-notify" title="The “child-notify” signal"><span class="type">“child-notify”</span></a> signal for the
child property specified by
<em class="parameter"><code>pspec</code></em>
on the child.</p>
<p>This is an analogue of <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-notify-by-pspec"><code class="function">g_object_notify_by_pspec()</code></a> for child properties.</p>
<p>This is an analogue of <code class="function">g_object_notify_by_pspec()</code> for child properties.</p>
<div class="refsect3">
<a name="gtk-container-child-notify-by-pspec.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
@ -1771,7 +1771,7 @@ child property specified by
</tr>
<tr>
<td class="parameter_name"><p>pspec</p></td>
<td class="parameter_description"><p>the <a href="../gobject/gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> of a child property instealled on
<td class="parameter_description"><p>the <span class="type">GParamSpec</span> of a child property instealled on
the class of <em class="parameter"><code>container</code></em>
</p></td>
<td class="parameter_annotations"> </td>
@ -1787,7 +1787,7 @@ the class of <em class="parameter"><code>container</code></em>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_container_forall (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
<em class="parameter"><code><a class="link" href="GtkWidget.html#GtkCallback" title="GtkCallback ()"><span class="type">GtkCallback</span></a> callback</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> callback_data</code></em>);</pre>
<em class="parameter"><code><span class="type">gpointer</span> callback_data</code></em>);</pre>
<p>Invokes <em class="parameter"><code>callback</code></em>
on each direct child of <em class="parameter"><code>container</code></em>
, including
@ -1814,7 +1814,7 @@ than <a class="link" href="GtkContainer.html#gtk-container-forall" title="gtk_co
</tr>
<tr>
<td class="parameter_name"><p>callback</p></td>
<td class="parameter_description"><p> a callback. </p></td>
<td class="parameter_description"><p>a callback. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid only during the call to the method."><span class="acronym">scope call</span></acronym>][<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym> callback_data]</span></td>
</tr>
<tr>
@ -1829,7 +1829,7 @@ than <a class="link" href="GtkContainer.html#gtk-container-forall" title="gtk_co
<hr>
<div class="refsect2">
<a name="gtk-container-get-border-width"></a><h3>gtk_container_get_border_width ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>
<pre class="programlisting"><span class="returnvalue">guint</span>
gtk_container_get_border_width (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>);</pre>
<p>Retrieves the border width of the container. See
<a class="link" href="GtkContainer.html#gtk-container-set-border-width" title="gtk_container_set_border_width ()"><code class="function">gtk_container_set_border_width()</code></a>.</p>
@ -1858,7 +1858,7 @@ gtk_container_get_border_width (<em class="parameter"><code><a class="link" href
<a name="gtk-container-set-border-width"></a><h3>gtk_container_set_border_width ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_container_set_border_width (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> border_width</code></em>);</pre>
<em class="parameter"><code><span class="type">guint</span> border_width</code></em>);</pre>
<p>Sets the border width of the container.</p>
<p>The border width of a container is the amount of space to leave
around the outside of the container. The only exception to this is
@ -1900,7 +1900,7 @@ gtk_container_propagate_draw (<em class="parameter"><code><a class="link" href="
<em class="parameter"><code><span class="type">cairo_t</span> *cr</code></em>);</pre>
<p>When a container receives a call to the draw function, it must send
synthetic <a class="link" href="GtkWidget.html#GtkWidget-draw" title="The “draw” signal"><span class="type">“draw”</span></a> calls to all children that dont have their
own <a href="../gdk4/gdk4-Windows.html#GdkWindow-struct"><span class="type">GdkWindows</span></a>. This function provides a convenient way of doing this.
own <span class="type">GdkWindows</span>. This function provides a convenient way of doing this.
A container, when it receives a call to its <a class="link" href="GtkWidget.html#GtkWidget-draw" title="The “draw” signal"><span class="type">“draw”</span></a> function,
calls <a class="link" href="GtkContainer.html#gtk-container-propagate-draw" title="gtk_container_propagate_draw ()"><code class="function">gtk_container_propagate_draw()</code></a> once for each child, passing in
the <em class="parameter"><code>cr</code></em>
@ -1947,15 +1947,15 @@ in containers draw function, consider using <code class="function">cairo_save
<hr>
<div class="refsect2">
<a name="gtk-container-get-focus-chain"></a><h3>gtk_container_get_focus_chain ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_container_get_focus_chain (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
<em class="parameter"><code><a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> **focusable_widgets</code></em>);</pre>
<em class="parameter"><code><span class="type">GList</span> **focusable_widgets</code></em>);</pre>
<p>Retrieves the focus chain of the container, if one has been
set explicitly. If no focus chain has been explicitly
set, GTK+ computes the focus chain based on the positions
of the children. In that case, GTK+ stores <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> in
of the children. In that case, GTK+ stores <code class="literal">NULL</code> in
<em class="parameter"><code>focusable_widgets</code></em>
and returns <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.</p>
and returns <code class="literal">FALSE</code>.</p>
<div class="refsect3">
<a name="gtk-container-get-focus-chain.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
@ -1972,10 +1972,10 @@ of the children. In that case, GTK+ stores <a href="../glib/glib-Standard-Macros
</tr>
<tr>
<td class="parameter_name"><p>focusable_widgets</p></td>
<td class="parameter_description"><p> location
<td class="parameter_description"><p>location
to store the focus chain of the
container, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. You should free this list
using <a href="../glib/glib-Doubly-Linked-Lists.html#g-list-free"><code class="function">g_list_free()</code></a> when you are done with it, however
container, or <code class="literal">NULL</code>. You should free this list
using <code class="function">g_list_free()</code> when you are done with it, however
no additional reference count is added to the
individual widgets in the focus chain. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GtkWidget][<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Free data container after the code is done."><span class="acronym">transfer container</span></acronym>]</span></td>
@ -1985,7 +1985,7 @@ individual widgets in the focus chain. </p></td>
</div>
<div class="refsect3">
<a name="gtk-container-get-focus-chain.returns"></a><h4>Returns</h4>
<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the focus chain of the container
<p> <code class="literal">TRUE</code> if the focus chain of the container
has been set explicitly.</p>
</div>
</div>
@ -1994,7 +1994,7 @@ has been set explicitly.</p>
<a name="gtk-container-set-focus-chain"></a><h3>gtk_container_set_focus_chain ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_container_set_focus_chain (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
<em class="parameter"><code><a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *focusable_widgets</code></em>);</pre>
<em class="parameter"><code><span class="type">GList</span> *focusable_widgets</code></em>);</pre>
<p>Sets a focus chain, overriding the one computed automatically by GTK+.</p>
<p>In principle each widget in the chain should be a descendant of the
container, but this is not enforced by this method, since its allowed
@ -2017,7 +2017,7 @@ when the focus chain is actually traversed.</p>
</tr>
<tr>
<td class="parameter_name"><p>focusable_widgets</p></td>
<td class="parameter_description"><p> the new focus chain. </p></td>
<td class="parameter_description"><p>the new focus chain. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GtkWidget]</span></td>
</tr>
</tbody>
@ -2049,10 +2049,10 @@ gtk_container_unset_focus_chain (<em class="parameter"><code><a class="link" hre
<hr>
<div class="refsect2">
<a name="gtk-container-class-find-child-property"></a><h3>gtk_container_class_find_child_property ()</h3>
<pre class="programlisting"><a href="../gobject/gobject-GParamSpec.html#GParamSpec"><span class="returnvalue">GParamSpec</span></a> *
<pre class="programlisting"><span class="returnvalue">GParamSpec</span> *
gtk_container_class_find_child_property
(<em class="parameter"><code><a href="../gobject/gobject-The-Base-Object-Type.html#GObjectClass"><span class="type">GObjectClass</span></a> *cclass</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *property_name</code></em>);</pre>
(<em class="parameter"><code><span class="type">GObjectClass</span> *cclass</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>);</pre>
<p>Finds a child property of a container class by name.</p>
<div class="refsect3">
<a name="gtk-container-class-find-child-property.parameters"></a><h4>Parameters</h4>
@ -2065,7 +2065,7 @@ gtk_container_class_find_child_property
<tbody>
<tr>
<td class="parameter_name"><p>cclass</p></td>
<td class="parameter_description"><p> a <a class="link" href="GtkContainer.html#GtkContainerClass" title="struct GtkContainerClass"><span class="type">GtkContainerClass</span></a>. </p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkContainer.html#GtkContainerClass" title="struct GtkContainerClass"><span class="type">GtkContainerClass</span></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GtkContainerClass]</span></td>
</tr>
<tr>
@ -2078,8 +2078,8 @@ gtk_container_class_find_child_property
</div>
<div class="refsect3">
<a name="gtk-container-class-find-child-property.returns"></a><h4>Returns</h4>
<p> the <a href="../gobject/gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> of the child
property or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>class</code></em>
<p>the <span class="type">GParamSpec</span> of the child
property or <code class="literal">NULL</code> if <em class="parameter"><code>class</code></em>
has no child property with that
name. </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>
@ -2091,8 +2091,8 @@ name. </p>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_container_class_install_child_property
(<em class="parameter"><code><a class="link" href="GtkContainer.html#GtkContainerClass" title="struct GtkContainerClass"><span class="type">GtkContainerClass</span></a> *cclass</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> property_id</code></em>,
<em class="parameter"><code><a href="../gobject/gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> *pspec</code></em>);</pre>
<em class="parameter"><code><span class="type">guint</span> property_id</code></em>,
<em class="parameter"><code><span class="type">GParamSpec</span> *pspec</code></em>);</pre>
<p>Installs a child property on a container class.</p>
<div class="refsect3">
<a name="gtk-container-class-install-child-property.parameters"></a><h4>Parameters</h4>
@ -2115,7 +2115,7 @@ gtk_container_class_install_child_property
</tr>
<tr>
<td class="parameter_name"><p>pspec</p></td>
<td class="parameter_description"><p>the <a href="../gobject/gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> for the property</p></td>
<td class="parameter_description"><p>the <span class="type">GParamSpec</span> for the property</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@ -2128,8 +2128,8 @@ gtk_container_class_install_child_property
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_container_class_install_child_properties
(<em class="parameter"><code><a class="link" href="GtkContainer.html#GtkContainerClass" title="struct GtkContainerClass"><span class="type">GtkContainerClass</span></a> *cclass</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> n_pspecs</code></em>,
<em class="parameter"><code><a href="../gobject/gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> **pspecs</code></em>);</pre>
<em class="parameter"><code><span class="type">guint</span> n_pspecs</code></em>,
<em class="parameter"><code><span class="type">GParamSpec</span> **pspecs</code></em>);</pre>
<p>Installs child properties on a container class.</p>
<div class="refsect3">
<a name="gtk-container-class-install-child-properties.parameters"></a><h4>Parameters</h4>
@ -2147,12 +2147,12 @@ gtk_container_class_install_child_properties
</tr>
<tr>
<td class="parameter_name"><p>n_pspecs</p></td>
<td class="parameter_description"><p>the length of the <a href="../gobject/gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> array</p></td>
<td class="parameter_description"><p>the length of the <span class="type">GParamSpec</span> array</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>pspecs</p></td>
<td class="parameter_description"><p> the <a href="../gobject/gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> array defining the new
<td class="parameter_description"><p>the <span class="type">GParamSpec</span> array defining the new
child properties. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_pspecs]</span></td>
</tr>
@ -2164,10 +2164,10 @@ child properties. </p></td>
<hr>
<div class="refsect2">
<a name="gtk-container-class-list-child-properties"></a><h3>gtk_container_class_list_child_properties ()</h3>
<pre class="programlisting"><a href="../gobject/gobject-GParamSpec.html#GParamSpec"><span class="returnvalue">GParamSpec</span></a> **
<pre class="programlisting"><span class="returnvalue">GParamSpec</span> **
gtk_container_class_list_child_properties
(<em class="parameter"><code><a href="../gobject/gobject-The-Base-Object-Type.html#GObjectClass"><span class="type">GObjectClass</span></a> *cclass</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *n_properties</code></em>);</pre>
(<em class="parameter"><code><span class="type">GObjectClass</span> *cclass</code></em>,
<em class="parameter"><code><span class="type">guint</span> *n_properties</code></em>);</pre>
<p>Returns all child properties of a container class.</p>
<div class="refsect3">
<a name="gtk-container-class-list-child-properties.parameters"></a><h4>Parameters</h4>
@ -2180,7 +2180,7 @@ gtk_container_class_list_child_properties
<tbody>
<tr>
<td class="parameter_name"><p>cclass</p></td>
<td class="parameter_description"><p> a <a class="link" href="GtkContainer.html#GtkContainerClass" title="struct GtkContainerClass"><span class="type">GtkContainerClass</span></a>. </p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkContainer.html#GtkContainerClass" title="struct GtkContainerClass"><span class="type">GtkContainerClass</span></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GtkContainerClass]</span></td>
</tr>
<tr>
@ -2193,8 +2193,8 @@ gtk_container_class_list_child_properties
</div>
<div class="refsect3">
<a name="gtk-container-class-list-child-properties.returns"></a><h4>Returns</h4>
<p> a newly allocated <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated array of <a href="../gobject/gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a>*.
The array must be freed with <a href="../glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. </p>
<p>a newly allocated <code class="literal">NULL</code>-terminated array of <span class="type">GParamSpec</span>*.
The array must be freed with <code class="function">g_free()</code>. </p>
<p><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_properties][<acronym title="Free data container after the code is done."><span class="acronym">transfer container</span></acronym>]</span></p>
</div>
</div>
@ -2379,7 +2379,7 @@ from the toplevel down to and including <em class="parameter"><code>child</code>
<a name="GtkContainer.property-details"></a><h2>Property Details</h2>
<div class="refsect2">
<a name="GtkContainer--border-width"></a><h3>The <code class="literal">“border-width”</code> property</h3>
<pre class="programlisting"> “border-width” <a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a></pre>
<pre class="programlisting"> “border-width” <span class="type">guint</span></pre>
<p>The width of the empty border outside the containers children.</p>
<p>Flags: Read / Write</p>
<p>Allowed values: &lt;= 65535</p>
@ -2408,16 +2408,16 @@ from the toplevel down to and including <em class="parameter"><code>child</code>
<pre class="programlisting"><span class="returnvalue">void</span>
user_function (<a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container,
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget,
<a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
<p>Flags: <a href="../gobject/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS">Run First</a></p>
<span class="type">gpointer</span> user_data)</pre>
<p>Flags: Run First</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkContainer-check-resize"></a><h3>The <code class="literal">“check-resize”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
user_function (<a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container,
<a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
<p>Flags: <a href="../gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></p>
<span class="type">gpointer</span> user_data)</pre>
<p>Flags: Run Last</p>
</div>
<hr>
<div class="refsect2">
@ -2425,8 +2425,8 @@ user_function (<a class="link" href="GtkContainer.html" title="GtkContainer"><sp
<pre class="programlisting"><span class="returnvalue">void</span>
user_function (<a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container,
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget,
<a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
<p>Flags: <a href="../gobject/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS">Run First</a></p>
<span class="type">gpointer</span> user_data)</pre>
<p>Flags: Run First</p>
</div>
<hr>
<div class="refsect2">
@ -2434,12 +2434,12 @@ user_function (<a class="link" href="GtkContainer.html" title="GtkContainer"><sp
<pre class="programlisting"><span class="returnvalue">void</span>
user_function (<a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container,
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget,
<a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
<p>Flags: <a href="../gobject/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS">Run First</a></p>
<span class="type">gpointer</span> user_data)</pre>
<p>Flags: Run First</p>
</div>
</div>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.25.1</div>
<hr>Generated by GTK-Doc V1.27</div>
</body>
</html>