New upstream version 3.24.2

This commit is contained in:
Jeremy Bicha
2018-12-12 16:07:25 -05:00
572 changed files with 819858 additions and 710881 deletions

View File

@ -8,7 +8,7 @@
<link rel="up" href="LayoutContainers.html" title="Layout Containers">
<link rel="prev" href="LayoutContainers.html" title="Layout Containers">
<link rel="next" href="GtkGrid.html" title="GtkGrid">
<meta name="generator" content="GTK-Doc V1.28 (XML mode)">
<meta name="generator" content="GTK-Doc V1.29 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@ -31,7 +31,7 @@
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="GtkBox.top_of_page"></a>GtkBox</span></h2>
<p>GtkBox — A container box</p>
<p>GtkBox — A container for packing widgets in a single row or column</p>
</td>
<td class="gallery_image" valign="top" align="right"></td>
</tr></table></div>
@ -69,7 +69,7 @@
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/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="GtkBox.html#gtk-box-get-homogeneous" title="gtk_box_get_homogeneous ()">gtk_box_get_homogeneous</a> <span class="c_punctuation">()</span>
@ -85,7 +85,7 @@
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
<span class="returnvalue">gint</span>
</td>
<td class="function_name">
<a class="link" href="GtkBox.html#gtk-box-get-spacing" title="gtk_box_get_spacing ()">gtk_box_get_spacing</a> <span class="c_punctuation">()</span>
@ -173,12 +173,12 @@
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td>
<td class="property_type"><span class="type">gboolean</span></td>
<td class="property_name"><a class="link" href="GtkBox.html#GtkBox--homogeneous" title="The “homogeneous” property">homogeneous</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a></td>
<td class="property_type"><span class="type">gint</span></td>
<td class="property_name"><a class="link" href="GtkBox.html#GtkBox--spacing" title="The “spacing” property">spacing</a></td>
<td class="property_flags">Read / Write</td>
</tr>
@ -195,12 +195,12 @@
</colgroup>
<tbody>
<tr>
<td class="property_type"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td>
<td class="property_type"><span class="type">gboolean</span></td>
<td class="property_name"><a class="link" href="GtkBox.html#GtkBox--c-expand" title="The “expand” child property">expand</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td>
<td class="property_type"><span class="type">gboolean</span></td>
<td class="property_name"><a class="link" href="GtkBox.html#GtkBox--c-fill" title="The “fill” child property">fill</a></td>
<td class="property_flags">Read / Write</td>
</tr>
@ -210,12 +210,12 @@
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><a href="https://developer.gnome.org/glib/unstable/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="GtkBox.html#GtkBox--c-padding" title="The “padding” child property">padding</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a></td>
<td class="property_type"><span class="type">gint</span></td>
<td class="property_name"><a class="link" href="GtkBox.html#GtkBox--c-position" title="The “position” child property">position</a></td>
<td class="property_flags">Read / Write</td>
</tr>
@ -243,8 +243,8 @@
</div>
<div class="refsect1">
<a name="GtkBox.object-hierarchy"></a><h2>Object Hierarchy</h2>
<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> <a href="https://developer.gnome.org/gobject/unstable/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> <a class="link" href="GtkContainer.html" title="GtkContainer">GtkContainer</a>
<span class="lineart">╰──</span> GtkBox
@ -280,11 +280,11 @@ GtkBox implements
</div>
<div class="refsect1">
<a name="GtkBox.description"></a><h2>Description</h2>
<p>The GtkBox widget organizes child widgets into a rectangular area.</p>
<p>The rectangular area of a GtkBox is organized into either a single row
or a single column of child widgets depending upon the orientation.
Thus, all children of a GtkBox are allocated one dimension in common,
which is the height of a row, or the width of a column.</p>
<p>The GtkBox widget arranges child widgets into a single row or column,
depending upon the value of its <a class="link" href="gtk3-Orientable.html#GtkOrientable--orientation" title="The “orientation” property"><span class="type">“orientation”</span></a> property. Within
the other dimension, all children are allocated the same size. Of course,
the <a class="link" href="GtkWidget.html#GtkWidget--halign" title="The “halign” property"><span class="type">“halign”</span></a> and <a class="link" href="GtkWidget.html#GtkWidget--valign" title="The “valign” property"><span class="type">“valign”</span></a> properties can be used on
the children to influence their allocation.</p>
<p>GtkBox uses a notion of packing. Packing refers
to adding widgets with reference to a particular position in a
<a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a>. For a GtkBox, there are two reference positions: the
@ -312,10 +312,8 @@ place in the box.</p>
<p>Use <a class="link" href="GtkBox.html#gtk-box-set-child-packing" title="gtk_box_set_child_packing ()"><code class="function">gtk_box_set_child_packing()</code></a> to reset the expand,
fill and padding child properties.
Use <a class="link" href="GtkBox.html#gtk-box-query-child-packing" title="gtk_box_query_child_packing ()"><code class="function">gtk_box_query_child_packing()</code></a> to query these fields.</p>
<p>Note that a single-row or single-column <a class="link" href="GtkGrid.html" title="GtkGrid"><span class="type">GtkGrid</span></a> provides exactly
the same functionality as <a class="link" href="GtkBox.html" title="GtkBox"><span class="type">GtkBox</span></a>.</p>
<div class="refsect2">
<a name="id-1.3.7.2.10.12"></a><h3>CSS nodes</h3>
<a name="id-1.3.7.2.10.10"></a><h3>CSS nodes</h3>
<p>GtkBox uses a single CSS node with name box.</p>
<p>In horizontal orientation, the nodes of the children are always arranged
from left to right. So :first-child will always select the leftmost child,
@ -328,7 +326,7 @@ regardless of text direction.</p>
<a name="gtk-box-new"></a><h3>gtk_box_new ()</h3>
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
gtk_box_new (<em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkOrientation" title="enum GtkOrientation"><span class="type">GtkOrientation</span></a> orientation</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> spacing</code></em>);</pre>
<em class="parameter"><code><span class="type">gint</span> spacing</code></em>);</pre>
<p>Creates a new <a class="link" href="GtkBox.html" title="GtkBox"><span class="type">GtkBox</span></a>.</p>
<div class="refsect3">
<a name="gtk-box-new.parameters"></a><h4>Parameters</h4>
@ -364,9 +362,9 @@ gtk_box_new (<em class="parameter"><code><a class="link" href="gtk3-Standard-Enu
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_box_pack_start (<em class="parameter"><code><a class="link" href="GtkBox.html" title="GtkBox"><span class="type">GtkBox</span></a> *box</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="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> expand</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> fill</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> padding</code></em>);</pre>
<em class="parameter"><code><span class="type">gboolean</span> expand</code></em>,
<em class="parameter"><code><span class="type">gboolean</span> fill</code></em>,
<em class="parameter"><code><span class="type">guint</span> padding</code></em>);</pre>
<p>Adds <em class="parameter"><code>child</code></em>
to <em class="parameter"><code>box</code></em>
, packed with reference to the start of <em class="parameter"><code>box</code></em>
@ -397,7 +395,7 @@ to the start of <em class="parameter"><code>box</code></em>
</tr>
<tr>
<td class="parameter_name"><p>expand</p></td>
<td class="parameter_description"><p><a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the new child is to be given extra space allocated
<td class="parameter_description"><p><code class="literal">TRUE</code> if the new child is to be given extra space allocated
to <em class="parameter"><code>box</code></em>
. The extra space will be divided evenly between all children
that use this option</p></td>
@ -405,13 +403,13 @@ that use this option</p></td>
</tr>
<tr>
<td class="parameter_name"><p>fill</p></td>
<td class="parameter_description"><p><a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if space given to <em class="parameter"><code>child</code></em>
<td class="parameter_description"><p><code class="literal">TRUE</code> if space given to <em class="parameter"><code>child</code></em>
by the <em class="parameter"><code>expand</code></em>
option is
actually allocated to <em class="parameter"><code>child</code></em>
, rather than just padding it. This
parameter has no effect if <em class="parameter"><code>expand</code></em>
is set to <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>. A child is
is set to <code class="literal">FALSE</code>. A child is
always allocated the full height of a horizontal <a class="link" href="GtkBox.html" title="GtkBox"><span class="type">GtkBox</span></a> and the full width
of a vertical <a class="link" href="GtkBox.html" title="GtkBox"><span class="type">GtkBox</span></a>. This option affects the other dimension</p></td>
<td class="parameter_annotations"> </td>
@ -440,9 +438,9 @@ and the reference edge of <em class="parameter"><code>box</code></em>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_box_pack_end (<em class="parameter"><code><a class="link" href="GtkBox.html" title="GtkBox"><span class="type">GtkBox</span></a> *box</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="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> expand</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> fill</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> padding</code></em>);</pre>
<em class="parameter"><code><span class="type">gboolean</span> expand</code></em>,
<em class="parameter"><code><span class="type">gboolean</span> fill</code></em>,
<em class="parameter"><code><span class="type">guint</span> padding</code></em>);</pre>
<p>Adds <em class="parameter"><code>child</code></em>
to <em class="parameter"><code>box</code></em>
, packed with reference to the end of <em class="parameter"><code>box</code></em>
@ -473,7 +471,7 @@ packed with reference to the end of <em class="parameter"><code>box</code></em>
</tr>
<tr>
<td class="parameter_name"><p>expand</p></td>
<td class="parameter_description"><p><a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the new child is to be given extra space allocated
<td class="parameter_description"><p><code class="literal">TRUE</code> if the new child is to be given extra space allocated
to <em class="parameter"><code>box</code></em>
. The extra space will be divided evenly between all children
of <em class="parameter"><code>box</code></em>
@ -482,13 +480,13 @@ that use this option</p></td>
</tr>
<tr>
<td class="parameter_name"><p>fill</p></td>
<td class="parameter_description"><p><a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if space given to <em class="parameter"><code>child</code></em>
<td class="parameter_description"><p><code class="literal">TRUE</code> if space given to <em class="parameter"><code>child</code></em>
by the <em class="parameter"><code>expand</code></em>
option is
actually allocated to <em class="parameter"><code>child</code></em>
, rather than just padding it. This
parameter has no effect if <em class="parameter"><code>expand</code></em>
is set to <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>. A child is
is set to <code class="literal">FALSE</code>. A child is
always allocated the full height of a horizontal <a class="link" href="GtkBox.html" title="GtkBox"><span class="type">GtkBox</span></a> and the full width
of a vertical <a class="link" href="GtkBox.html" title="GtkBox"><span class="type">GtkBox</span></a>. This option affects the other dimension</p></td>
<td class="parameter_annotations"> </td>
@ -514,7 +512,7 @@ and the reference edge of <em class="parameter"><code>box</code></em>
<hr>
<div class="refsect2">
<a name="gtk-box-get-homogeneous"></a><h3>gtk_box_get_homogeneous ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_box_get_homogeneous (<em class="parameter"><code><a class="link" href="GtkBox.html" title="GtkBox"><span class="type">GtkBox</span></a> *box</code></em>);</pre>
<p>Returns whether the box is homogeneous (all children are the
same size). See <a class="link" href="GtkBox.html#gtk-box-set-homogeneous" title="gtk_box_set_homogeneous ()"><code class="function">gtk_box_set_homogeneous()</code></a>.</p>
@ -535,7 +533,7 @@ same size). See <a class="link" href="GtkBox.html#gtk-box-set-homogeneous" title
</div>
<div class="refsect3">
<a name="gtk-box-get-homogeneous.returns"></a><h4>Returns</h4>
<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the box is homogeneous.</p>
<p> <code class="literal">TRUE</code> if the box is homogeneous.</p>
</div>
</div>
<hr>
@ -543,7 +541,7 @@ same size). See <a class="link" href="GtkBox.html#gtk-box-set-homogeneous" title
<a name="gtk-box-set-homogeneous"></a><h3>gtk_box_set_homogeneous ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_box_set_homogeneous (<em class="parameter"><code><a class="link" href="GtkBox.html" title="GtkBox"><span class="type">GtkBox</span></a> *box</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> homogeneous</code></em>);</pre>
<em class="parameter"><code><span class="type">gboolean</span> homogeneous</code></em>);</pre>
<p>Sets the <a class="link" href="GtkBox.html#GtkBox--homogeneous" title="The “homogeneous” property"><span class="type">“homogeneous”</span></a> property of <em class="parameter"><code>box</code></em>
, controlling
whether or not all children of <em class="parameter"><code>box</code></em>
@ -565,8 +563,8 @@ in the box.</p>
</tr>
<tr>
<td class="parameter_name"><p>homogeneous</p></td>
<td class="parameter_description"><p>a boolean value, <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to create equal allotments,
<a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> for variable allotments</p></td>
<td class="parameter_description"><p>a boolean value, <code class="literal">TRUE</code> to create equal allotments,
<code class="literal">FALSE</code> for variable allotments</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@ -576,7 +574,7 @@ in the box.</p>
<hr>
<div class="refsect2">
<a name="gtk-box-get-spacing"></a><h3>gtk_box_get_spacing ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
<pre class="programlisting"><span class="returnvalue">gint</span>
gtk_box_get_spacing (<em class="parameter"><code><a class="link" href="GtkBox.html" title="GtkBox"><span class="type">GtkBox</span></a> *box</code></em>);</pre>
<p>Gets the value set by <a class="link" href="GtkBox.html#gtk-box-set-spacing" title="gtk_box_set_spacing ()"><code class="function">gtk_box_set_spacing()</code></a>.</p>
<div class="refsect3">
@ -604,7 +602,7 @@ gtk_box_get_spacing (<em class="parameter"><code><a class="link" href="GtkBox.ht
<a name="gtk-box-set-spacing"></a><h3>gtk_box_set_spacing ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_box_set_spacing (<em class="parameter"><code><a class="link" href="GtkBox.html" title="GtkBox"><span class="type">GtkBox</span></a> *box</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> spacing</code></em>);</pre>
<em class="parameter"><code><span class="type">gint</span> spacing</code></em>);</pre>
<p>Sets the <a class="link" href="GtkBox.html#GtkBox--spacing" title="The “spacing” property"><span class="type">“spacing”</span></a> property of <em class="parameter"><code>box</code></em>
, which is the
number of pixels to place between children of <em class="parameter"><code>box</code></em>
@ -638,7 +636,7 @@ number of pixels to place between children of <em class="parameter"><code>box</c
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_box_reorder_child (<em class="parameter"><code><a class="link" href="GtkBox.html" title="GtkBox"><span class="type">GtkBox</span></a> *box</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="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> position</code></em>);</pre>
<em class="parameter"><code><span class="type">gint</span> position</code></em>);</pre>
<p>Moves <em class="parameter"><code>child</code></em>
to a new <em class="parameter"><code>position</code></em>
in the list of <em class="parameter"><code>box</code></em>
@ -691,9 +689,9 @@ the list</p></td>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_box_query_child_packing (<em class="parameter"><code><a class="link" href="GtkBox.html" title="GtkBox"><span class="type">GtkBox</span></a> *box</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="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> *expand</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> *fill</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *padding</code></em>,
<em class="parameter"><code><span class="type">gboolean</span> *expand</code></em>,
<em class="parameter"><code><span class="type">gboolean</span> *fill</code></em>,
<em class="parameter"><code><span class="type">guint</span> *padding</code></em>,
<em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkPackType" title="enum GtkPackType"><span class="type">GtkPackType</span></a> *pack_type</code></em>);</pre>
<p>Obtains information about how <em class="parameter"><code>child</code></em>
is packed into <em class="parameter"><code>box</code></em>
@ -751,9 +749,9 @@ child property. </p></td>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_box_set_child_packing (<em class="parameter"><code><a class="link" href="GtkBox.html" title="GtkBox"><span class="type">GtkBox</span></a> *box</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="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> expand</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> fill</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> padding</code></em>,
<em class="parameter"><code><span class="type">gboolean</span> expand</code></em>,
<em class="parameter"><code><span class="type">gboolean</span> fill</code></em>,
<em class="parameter"><code><span class="type">guint</span> padding</code></em>,
<em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkPackType" title="enum GtkPackType"><span class="type">GtkPackType</span></a> pack_type</code></em>);</pre>
<p>Sets the way <em class="parameter"><code>child</code></em>
is packed into <em class="parameter"><code>box</code></em>
@ -889,7 +887,7 @@ gtk_box_get_center_widget (<em class="parameter"><code><a class="link" href="Gtk
<div class="refsect3">
<a name="gtk-box-get-center-widget.returns"></a><h4>Returns</h4>
<p>the center widget
or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> in case no center widget is set. </p>
or <code class="literal">NULL</code> in case no center widget is set. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<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-12.html#api-index-3.12">3.12</a></p>
@ -967,7 +965,7 @@ of space.</p>
<hr>
<div class="refsect2">
<a name="GtkBox--homogeneous"></a><h3>The <code class="literal">“homogeneous”</code> property</h3>
<pre class="programlisting"> “homogeneous” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre>
<pre class="programlisting"> “homogeneous” <span class="type">gboolean</span></pre>
<p>Whether the children should all be the same size.</p>
<p>Flags: Read / Write</p>
<p>Default value: FALSE</p>
@ -975,7 +973,7 @@ of space.</p>
<hr>
<div class="refsect2">
<a name="GtkBox--spacing"></a><h3>The <code class="literal">“spacing”</code> property</h3>
<pre class="programlisting"> “spacing” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a></pre>
<pre class="programlisting"> “spacing” <span class="type">gint</span></pre>
<p>The amount of space between children.</p>
<p>Flags: Read / Write</p>
<p>Allowed values: &gt;= 0</p>
@ -986,14 +984,14 @@ of space.</p>
<a name="GtkBox.child-property-details"></a><h2>Child Property Details</h2>
<div class="refsect2">
<a name="GtkBox--c-expand"></a><h3>The <code class="literal">“expand”</code> child property</h3>
<pre class="programlisting"> “expand” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre>
<pre class="programlisting"> “expand” <span class="type">gboolean</span></pre>
<p>Whether the child should receive extra space when the parent grows.</p>
<p>Note that the default value for this property is <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> for GtkBox,
<p>Note that the default value for this property is <code class="literal">FALSE</code> for GtkBox,
but <a class="link" href="GtkHBox.html" title="GtkHBox"><span class="type">GtkHBox</span></a>, <a class="link" href="GtkVBox.html" title="GtkVBox"><span class="type">GtkVBox</span></a> and other subclasses use the old default
of <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>.</p>
<p>Note that the <a class="link" href="GtkWidget.html#GtkWidget--halign" title="The “halign” property"><span class="type">“halign</span></a>, <a class="link" href="GtkWidget.html#GtkWidget--valign" title="The “valign” property"><span class="type">“valign</span></a>, <a class="link" href="GtkWidget.html#GtkWidget--hexpand" title="The “hexpand” property"><span class="type">“hexpand”</span></a>
and <a class="link" href="GtkWidget.html#GtkWidget--vexpand" title="The “vexpand” property"><span class="type">“vexpand”</span></a> properties are the preferred way to influence
child size allocation in containers.</p>
of <code class="literal">TRUE</code>.</p>
<p>Note: The <a class="link" href="GtkWidget.html#GtkWidget--hexpand" title="The “hexpand” property"><span class="type">“hexpand</span></a> or <a class="link" href="GtkWidget.html#GtkWidget--vexpand" title="The “vexpand” property"><span class="type">“vexpand</span></a> properties are the
preferred way to influence whether the child receives extra space, by
setting the childs expand property corresponding to the boxs orientation.</p>
<p>In contrast to <a class="link" href="GtkWidget.html#GtkWidget--hexpand" title="The “hexpand” property"><span class="type">“hexpand”</span></a>, the expand child property does
not cause the box to expand itself.</p>
<p>Flags: Read / Write</p>
@ -1002,11 +1000,12 @@ not cause the box to expand itself.</p>
<hr>
<div class="refsect2">
<a name="GtkBox--c-fill"></a><h3>The <code class="literal">“fill”</code> child property</h3>
<pre class="programlisting"> “fill” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre>
<p>Whether the child should receive extra space when the parent grows.</p>
<p>Note that the <a class="link" href="GtkWidget.html#GtkWidget--halign" title="The “halign” property"><span class="type">“halign”</span></a>, <a class="link" href="GtkWidget.html#GtkWidget--valign" title="The “valign” property"><span class="type">“valign”</span></a>, <a class="link" href="GtkWidget.html#GtkWidget--hexpand" title="The “hexpand” property"><span class="type">“hexpand”</span></a>
and <a class="link" href="GtkWidget.html#GtkWidget--vexpand" title="The “vexpand” property"><span class="type">“vexpand”</span></a> properties are the preferred way to influence
child size allocation in containers.</p>
<pre class="programlisting"> “fill” <span class="type">gboolean</span></pre>
<p>Whether the child should fill extra space or use it as padding.</p>
<p>Note: The <a class="link" href="GtkWidget.html#GtkWidget--halign" title="The “halign” property"><span class="type">“halign”</span></a> or <a class="link" href="GtkWidget.html#GtkWidget--valign" title="The “valign” property"><span class="type">“valign”</span></a> properties are the
preferred way to influence whether the child fills available space, by
setting the childs align property corresponding to the boxs orientation
to <a class="link" href="GtkWidget.html#GTK-ALIGN-FILL:CAPS"><code class="literal">GTK_ALIGN_FILL</code></a> to fill, or to something else to refrain from filling.</p>
<p>Flags: Read / Write</p>
<p>Default value: TRUE</p>
</div>
@ -1021,8 +1020,10 @@ child size allocation in containers.</p>
<hr>
<div class="refsect2">
<a name="GtkBox--c-padding"></a><h3>The <code class="literal">“padding”</code> child property</h3>
<pre class="programlisting"> “padding” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a></pre>
<pre class="programlisting"> “padding” <span class="type">guint</span></pre>
<p>Extra space to put between the child and its neighbors, in pixels.</p>
<p>Note: The CSS padding properties are the preferred way to add space among
widgets, by setting the paddings corresponding to the boxs orientation.</p>
<p>Flags: Read / Write</p>
<p>Allowed values: &lt;= G_MAXINT</p>
<p>Default value: 0</p>
@ -1030,7 +1031,7 @@ child size allocation in containers.</p>
<hr>
<div class="refsect2">
<a name="GtkBox--c-position"></a><h3>The <code class="literal">“position”</code> child property</h3>
<pre class="programlisting"> “position” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a></pre>
<pre class="programlisting"> “position” <span class="type">gint</span></pre>
<p>The index of the child in the parent.</p>
<p>Flags: Read / Write</p>
<p>Allowed values: &gt;= -1</p>
@ -1039,10 +1040,10 @@ child size allocation in containers.</p>
</div>
<div class="refsect1">
<a name="GtkBox.see-also"></a><h2>See Also</h2>
<p><a class="link" href="GtkFrame.html" title="GtkFrame"><span class="type">GtkFrame</span></a>, <a class="link" href="GtkGrid.html" title="GtkGrid"><span class="type">GtkGrid</span></a>, <a class="link" href="GtkLayout.html" title="GtkLayout"><span class="type">GtkLayout</span></a></p>
<p><a class="link" href="GtkGrid.html" title="GtkGrid"><span class="type">GtkGrid</span></a></p>
</div>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.28</div>
<hr>Generated by GTK-Doc V1.29</div>
</body>
</html>