~ubuntu-branches/ubuntu/precise/gtk+2.0/precise-updates

« back to all changes in this revision

Viewing changes to docs/reference/gtk/html/GtkBox.html

  • Committer: Package Import Robot
  • Author(s): Ken VanDine
  • Date: 2011-12-01 11:40:06 UTC
  • mfrom: (1.14.11)
  • Revision ID: package-import@ubuntu.com-20111201114006-nrmf6qu3pg512veo
Tags: 2.24.8-0ubuntu1
* New upstream release 
  - gtkfilechooser should be more robust to malformed URIs
    in .gtk-bookmarks (LP: #189494)
* debian/patches/010_make_bg_changes_queue_repaint.patch
  - dropped it introduces performance regressions in some gtk2 
    apps (LP: #889019)
* 101_filechooser.patch, 000git_file_chooser.patch: dropped, upstream

Show diffs side-by-side

added added

removed removed

Lines of Context:
8
8
<link rel="up" href="AbstractObjects.html" title="Abstract Base Classes">
9
9
<link rel="prev" href="GtkBin.html" title="GtkBin">
10
10
<link rel="next" href="GtkButtonBox.html" title="GtkButtonBox">
11
 
<meta name="generator" content="GTK-Doc V1.17.1 (XML mode)">
 
11
<meta name="generator" content="GTK-Doc V1.17 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
13
</head>
14
14
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
52
52
struct              <a class="link" href="GtkBox.html#GtkBoxChild" title="struct GtkBoxChild">GtkBoxChild</a>;
53
53
<span class="returnvalue">void</span>                <a class="link" href="GtkBox.html#gtk-box-pack-start" title="gtk_box_pack_start ()">gtk_box_pack_start</a>                  (<em class="parameter"><code><a class="link" href="GtkBox.html" title="GtkBox"><span class="type">GtkBox</span></a> *box</code></em>,
54
54
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
55
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> expand</code></em>,
56
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> fill</code></em>,
57
 
                                                         <em class="parameter"><code><span class="type">guint</span> padding</code></em>);
 
55
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> expand</code></em>,
 
56
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> fill</code></em>,
 
57
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> padding</code></em>);
58
58
<span class="returnvalue">void</span>                <a class="link" href="GtkBox.html#gtk-box-pack-end" title="gtk_box_pack_end ()">gtk_box_pack_end</a>                    (<em class="parameter"><code><a class="link" href="GtkBox.html" title="GtkBox"><span class="type">GtkBox</span></a> *box</code></em>,
59
59
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
60
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> expand</code></em>,
61
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> fill</code></em>,
62
 
                                                         <em class="parameter"><code><span class="type">guint</span> padding</code></em>);
 
60
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> expand</code></em>,
 
61
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> fill</code></em>,
 
62
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> padding</code></em>);
63
63
<span class="returnvalue">void</span>                <a class="link" href="GtkBox.html#gtk-box-pack-start-defaults" title="gtk_box_pack_start_defaults ()">gtk_box_pack_start_defaults</a>         (<em class="parameter"><code><a class="link" href="GtkBox.html" title="GtkBox"><span class="type">GtkBox</span></a> *box</code></em>,
64
64
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>);
65
65
<span class="returnvalue">void</span>                <a class="link" href="GtkBox.html#gtk-box-pack-end-defaults" title="gtk_box_pack_end_defaults ()">gtk_box_pack_end_defaults</a>           (<em class="parameter"><code><a class="link" href="GtkBox.html" title="GtkBox"><span class="type">GtkBox</span></a> *box</code></em>,
66
66
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>);
67
 
<span class="returnvalue">gboolean</span>            <a class="link" href="GtkBox.html#gtk-box-get-homogeneous" title="gtk_box_get_homogeneous ()">gtk_box_get_homogeneous</a>             (<em class="parameter"><code><a class="link" href="GtkBox.html" title="GtkBox"><span class="type">GtkBox</span></a> *box</code></em>);
 
67
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GtkBox.html#gtk-box-get-homogeneous" title="gtk_box_get_homogeneous ()">gtk_box_get_homogeneous</a>             (<em class="parameter"><code><a class="link" href="GtkBox.html" title="GtkBox"><span class="type">GtkBox</span></a> *box</code></em>);
68
68
<span class="returnvalue">void</span>                <a class="link" href="GtkBox.html#gtk-box-set-homogeneous" title="gtk_box_set_homogeneous ()">gtk_box_set_homogeneous</a>             (<em class="parameter"><code><a class="link" href="GtkBox.html" title="GtkBox"><span class="type">GtkBox</span></a> *box</code></em>,
69
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> homogeneous</code></em>);
70
 
<span class="returnvalue">gint</span>                <a class="link" href="GtkBox.html#gtk-box-get-spacing" title="gtk_box_get_spacing ()">gtk_box_get_spacing</a>                 (<em class="parameter"><code><a class="link" href="GtkBox.html" title="GtkBox"><span class="type">GtkBox</span></a> *box</code></em>);
 
69
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> homogeneous</code></em>);
 
70
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                <a class="link" href="GtkBox.html#gtk-box-get-spacing" title="gtk_box_get_spacing ()">gtk_box_get_spacing</a>                 (<em class="parameter"><code><a class="link" href="GtkBox.html" title="GtkBox"><span class="type">GtkBox</span></a> *box</code></em>);
71
71
<span class="returnvalue">void</span>                <a class="link" href="GtkBox.html#gtk-box-set-spacing" title="gtk_box_set_spacing ()">gtk_box_set_spacing</a>                 (<em class="parameter"><code><a class="link" href="GtkBox.html" title="GtkBox"><span class="type">GtkBox</span></a> *box</code></em>,
72
 
                                                         <em class="parameter"><code><span class="type">gint</span> spacing</code></em>);
 
72
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> spacing</code></em>);
73
73
<span class="returnvalue">void</span>                <a class="link" href="GtkBox.html#gtk-box-reorder-child" title="gtk_box_reorder_child ()">gtk_box_reorder_child</a>               (<em class="parameter"><code><a class="link" href="GtkBox.html" title="GtkBox"><span class="type">GtkBox</span></a> *box</code></em>,
74
74
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
75
 
                                                         <em class="parameter"><code><span class="type">gint</span> position</code></em>);
 
75
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> position</code></em>);
76
76
<span class="returnvalue">void</span>                <a class="link" href="GtkBox.html#gtk-box-query-child-packing" title="gtk_box_query_child_packing ()">gtk_box_query_child_packing</a>         (<em class="parameter"><code><a class="link" href="GtkBox.html" title="GtkBox"><span class="type">GtkBox</span></a> *box</code></em>,
77
77
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
78
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> *expand</code></em>,
79
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> *fill</code></em>,
80
 
                                                         <em class="parameter"><code><span class="type">guint</span> *padding</code></em>,
 
78
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> *expand</code></em>,
 
79
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> *fill</code></em>,
 
80
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *padding</code></em>,
81
81
                                                         <em class="parameter"><code><a class="link" href="gtk-Standard-Enumerations.html#GtkPackType" title="enum GtkPackType"><span class="type">GtkPackType</span></a> *pack_type</code></em>);
82
82
<span class="returnvalue">void</span>                <a class="link" href="GtkBox.html#gtk-box-set-child-packing" title="gtk_box_set_child_packing ()">gtk_box_set_child_packing</a>           (<em class="parameter"><code><a class="link" href="GtkBox.html" title="GtkBox"><span class="type">GtkBox</span></a> *box</code></em>,
83
83
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
84
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> expand</code></em>,
85
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> fill</code></em>,
86
 
                                                         <em class="parameter"><code><span class="type">guint</span> padding</code></em>,
 
84
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> expand</code></em>,
 
85
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> fill</code></em>,
 
86
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> padding</code></em>,
87
87
                                                         <em class="parameter"><code><a class="link" href="gtk-Standard-Enumerations.html#GtkPackType" title="enum GtkPackType"><span class="type">GtkPackType</span></a> pack_type</code></em>);
88
88
</pre>
89
89
</div>
90
90
<div class="refsect1">
91
91
<a name="GtkBox.object-hierarchy"></a><h2>Object Hierarchy</h2>
92
92
<pre class="synopsis">
93
 
  GObject
94
 
   +----GInitiallyUnowned
 
93
  <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
 
94
   +----<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a>
95
95
         +----<a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a>
96
96
               +----<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
97
97
                     +----<a class="link" href="GtkContainer.html" title="GtkContainer">GtkContainer</a>
110
110
<div class="refsect1">
111
111
<a name="GtkBox.properties"></a><h2>Properties</h2>
112
112
<pre class="synopsis">
113
 
  "<a class="link" href="GtkBox.html#GtkBox--homogeneous" title='The "homogeneous" property'>homogeneous</a>"              <span class="type">gboolean</span>              : Read / Write
114
 
  "<a class="link" href="GtkBox.html#GtkBox--spacing" title='The "spacing" property'>spacing</a>"                  <span class="type">gint</span>                  : Read / Write
 
113
  "<a class="link" href="GtkBox.html#GtkBox--homogeneous" title='The "homogeneous" property'>homogeneous</a>"              <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
 
114
  "<a class="link" href="GtkBox.html#GtkBox--spacing" title='The "spacing" property'>spacing</a>"                  <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write
115
115
</pre>
116
116
</div>
117
117
<div class="refsect1">
118
118
<a name="GtkBox.child-properties"></a><h2>Child Properties</h2>
119
119
<pre class="synopsis">
120
 
  "<a class="link" href="GtkBox.html#GtkBox--c-expand" title='The "expand" child property'>expand</a>"                   <span class="type">gboolean</span>              : Read / Write
121
 
  "<a class="link" href="GtkBox.html#GtkBox--c-fill" title='The "fill" child property'>fill</a>"                     <span class="type">gboolean</span>              : Read / Write
 
120
  "<a class="link" href="GtkBox.html#GtkBox--c-expand" title='The "expand" child property'>expand</a>"                   <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
 
121
  "<a class="link" href="GtkBox.html#GtkBox--c-fill" title='The "fill" child property'>fill</a>"                     <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
122
122
  "<a class="link" href="GtkBox.html#GtkBox--c-pack-type" title='The "pack-type" child property'>pack-type</a>"                <a class="link" href="gtk-Standard-Enumerations.html#GtkPackType" title="enum GtkPackType"><span class="type">GtkPackType</span></a>           : Read / Write
123
 
  "<a class="link" href="GtkBox.html#GtkBox--c-padding" title='The "padding" child property'>padding</a>"                  <span class="type">guint</span>                 : Read / Write
124
 
  "<a class="link" href="GtkBox.html#GtkBox--c-position" title='The "position" child property'>position</a>"                 <span class="type">gint</span>                  : Read / Write
 
123
  "<a class="link" href="GtkBox.html#GtkBox--c-padding" title='The "padding" child property'>padding</a>"                  <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>                 : Read / Write
 
124
  "<a class="link" href="GtkBox.html#GtkBox--c-position" title='The "position" child property'>position</a>"                 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write
125
125
</pre>
126
126
</div>
127
127
<div class="refsect1">
245
245
<td>the child widget, packed into the GtkBox.</td>
246
246
</tr>
247
247
<tr>
248
 
<td><p><span class="term"><span class="type">guint16</span> <em class="structfield"><code><a name="GtkBoxChild.padding"></a>padding</code></em>;</span></p></td>
 
248
<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint16"><span class="type">guint16</span></a> <em class="structfield"><code><a name="GtkBoxChild.padding"></a>padding</code></em>;</span></p></td>
249
249
<td>the number of extra pixels to put between this child and its
250
250
neighbors, set when packed, zero by default.</td>
251
251
</tr>
252
252
<tr>
253
 
<td><p><span class="term"><span class="type">guint</span> <em class="structfield"><code><a name="GtkBoxChild.expand"></a>expand</code></em> : 1;</span></p></td>
 
253
<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> <em class="structfield"><code><a name="GtkBoxChild.expand"></a>expand</code></em> : 1;</span></p></td>
254
254
<td>flag indicates whether extra space should be given to this child.
255
255
Any extra space given to the parent GtkBox is divided up among all children
256
 
with this attribute set to <code class="literal">TRUE</code>; set when packed, <code class="literal">TRUE</code> by default.</td>
 
256
with this attribute set to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>; set when packed, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> by default.</td>
257
257
</tr>
258
258
<tr>
259
 
<td><p><span class="term"><span class="type">guint</span> <em class="structfield"><code><a name="GtkBoxChild.fill"></a>fill</code></em> : 1;</span></p></td>
 
259
<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> <em class="structfield"><code><a name="GtkBoxChild.fill"></a>fill</code></em> : 1;</span></p></td>
260
260
<td>flag indicates whether any extra space given to this child due to its
261
261
<em class="parameter"><code>expand</code></em> attribute being set is actually allocated to the child, rather than
262
 
being used as padding around the widget; set when packed, <code class="literal">TRUE</code> by default.</td>
 
262
being used as padding around the widget; set when packed, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> by default.</td>
263
263
</tr>
264
264
<tr>
265
 
<td><p><span class="term"><span class="type">guint</span> <em class="structfield"><code><a name="GtkBoxChild.pack"></a>pack</code></em> : 1;</span></p></td>
 
265
<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> <em class="structfield"><code><a name="GtkBoxChild.pack"></a>pack</code></em> : 1;</span></p></td>
266
266
<td>one of <a class="link" href="gtk-Standard-Enumerations.html#GtkPackType" title="enum GtkPackType"><span class="type">GtkPackType</span></a> indicating whether the child is packed with
267
267
reference to the start (top/left) or end (bottom/right) of the GtkBox.</td>
268
268
</tr>
269
269
<tr>
270
 
<td><p><span class="term"><span class="type">guint</span> <em class="structfield"><code><a name="GtkBoxChild.is-secondary"></a>is_secondary</code></em> : 1;</span></p></td>
 
270
<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> <em class="structfield"><code><a name="GtkBoxChild.is-secondary"></a>is_secondary</code></em> : 1;</span></p></td>
271
271
<td>
272
 
<code class="literal">TRUE</code> if the child is secondary</td>
 
272
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the child is secondary</td>
273
273
</tr>
274
274
</tbody>
275
275
</table></div>
279
279
<a name="gtk-box-pack-start"></a><h3>gtk_box_pack_start ()</h3>
280
280
<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>,
281
281
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
282
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> expand</code></em>,
283
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> fill</code></em>,
284
 
                                                         <em class="parameter"><code><span class="type">guint</span> padding</code></em>);</pre>
 
282
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> expand</code></em>,
 
283
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> fill</code></em>,
 
284
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> padding</code></em>);</pre>
285
285
<p>
286
286
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>.
287
287
The <em class="parameter"><code>child</code></em> is packed after any other child packed with reference 
303
303
<tr>
304
304
<td><p><span class="term"><em class="parameter"><code>expand</code></em> :</span></p></td>
305
305
<td>
306
 
<code class="literal">TRUE</code> if the new child is to be given extra space allocated to
 
306
<a href="http://library.gnome.org/devel/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 to
307
307
<em class="parameter"><code>box</code></em>.  The extra space will be divided evenly between all children of
308
308
<em class="parameter"><code>box</code></em> that use this option</td>
309
309
</tr>
310
310
<tr>
311
311
<td><p><span class="term"><em class="parameter"><code>fill</code></em> :</span></p></td>
312
312
<td>
313
 
<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
 
313
<a href="http://library.gnome.org/devel/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> by the <em class="parameter"><code>expand</code></em> option is
314
314
actually allocated to <em class="parameter"><code>child</code></em>, rather than just padding it.  This
315
 
parameter has no effect if <em class="parameter"><code>expand</code></em> is set to <code class="literal">FALSE</code>.  A child is
 
315
parameter has no effect if <em class="parameter"><code>expand</code></em> is set to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.  A child is
316
316
always allocated the full height of a <a class="link" href="GtkHBox.html" title="GtkHBox"><span class="type">GtkHBox</span></a> and the full width
317
317
of a <a class="link" href="GtkVBox.html" title="GtkVBox"><span class="type">GtkVBox</span></a>. This option affects the other dimension</td>
318
318
</tr>
333
333
<a name="gtk-box-pack-end"></a><h3>gtk_box_pack_end ()</h3>
334
334
<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>,
335
335
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
336
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> expand</code></em>,
337
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> fill</code></em>,
338
 
                                                         <em class="parameter"><code><span class="type">guint</span> padding</code></em>);</pre>
 
336
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> expand</code></em>,
 
337
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> fill</code></em>,
 
338
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> padding</code></em>);</pre>
339
339
<p>
340
340
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>.  
341
341
The <em class="parameter"><code>child</code></em> is packed after (away from end of) any other child 
357
357
<tr>
358
358
<td><p><span class="term"><em class="parameter"><code>expand</code></em> :</span></p></td>
359
359
<td>
360
 
<code class="literal">TRUE</code> if the new child is to be given extra space allocated
 
360
<a href="http://library.gnome.org/devel/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
361
361
to <em class="parameter"><code>box</code></em>. The extra space will be divided evenly between all children
362
362
of <em class="parameter"><code>box</code></em> that use this option</td>
363
363
</tr>
364
364
<tr>
365
365
<td><p><span class="term"><em class="parameter"><code>fill</code></em> :</span></p></td>
366
366
<td>
367
 
<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
 
367
<a href="http://library.gnome.org/devel/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> by the <em class="parameter"><code>expand</code></em> option is
368
368
actually allocated to <em class="parameter"><code>child</code></em>, rather than just padding it.  This
369
 
parameter has no effect if <em class="parameter"><code>expand</code></em> is set to <code class="literal">FALSE</code>.  A child is
 
369
parameter has no effect if <em class="parameter"><code>expand</code></em> is set to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.  A child is
370
370
always allocated the full height of a <a class="link" href="GtkHBox.html" title="GtkHBox"><span class="type">GtkHBox</span></a> and the full width
371
371
of a <a class="link" href="GtkVBox.html" title="GtkVBox"><span class="type">GtkVBox</span></a>.  This option affects the other dimension</td>
372
372
</tr>
399
399
<p>
400
400
Parameters for how to pack the child <em class="parameter"><code>widget</code></em>, <span class="type">"expand"</span>, 
401
401
<span class="type">"fill"</span> and <span class="type">"padding"</span>, are given their default
402
 
values, <code class="literal">TRUE</code>, <code class="literal">TRUE</code>, and 0, respectively.
 
402
values, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, and 0, respectively.
403
403
</p>
404
404
<div class="variablelist"><table border="0">
405
405
<col align="left" valign="top">
434
434
<p>
435
435
Parameters for how to pack the child <em class="parameter"><code>widget</code></em>, <span class="type">"expand"</span>, 
436
436
<span class="type">"fill"</span> and <span class="type">"padding"</span>, are given their default
437
 
values, <code class="literal">TRUE</code>, <code class="literal">TRUE</code>, and 0, respectively.
 
437
values, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, and 0, respectively.
438
438
</p>
439
439
<div class="variablelist"><table border="0">
440
440
<col align="left" valign="top">
455
455
<hr>
456
456
<div class="refsect2">
457
457
<a name="gtk-box-get-homogeneous"></a><h3>gtk_box_get_homogeneous ()</h3>
458
 
<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>
 
458
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            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>
459
459
<p>
460
460
Returns whether the box is homogeneous (all children are the
461
461
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>.
471
471
<tr>
472
472
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
473
473
<td>
474
 
<code class="literal">TRUE</code> if the box is homogeneous.</td>
 
474
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the box is homogeneous.</td>
475
475
</tr>
476
476
</tbody>
477
477
</table></div>
480
480
<div class="refsect2">
481
481
<a name="gtk-box-set-homogeneous"></a><h3>gtk_box_set_homogeneous ()</h3>
482
482
<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>,
483
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> homogeneous</code></em>);</pre>
 
483
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> homogeneous</code></em>);</pre>
484
484
<p>
485
485
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 
486
486
whether or not all children of <em class="parameter"><code>box</code></em> are given equal space 
496
496
</tr>
497
497
<tr>
498
498
<td><p><span class="term"><em class="parameter"><code>homogeneous</code></em> :</span></p></td>
499
 
<td>a boolean value, <code class="literal">TRUE</code> to create equal allotments,
500
 
<code class="literal">FALSE</code> for variable allotments</td>
 
499
<td>a boolean value, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to create equal allotments,
 
500
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> for variable allotments</td>
501
501
</tr>
502
502
</tbody>
503
503
</table></div>
505
505
<hr>
506
506
<div class="refsect2">
507
507
<a name="gtk-box-get-spacing"></a><h3>gtk_box_get_spacing ()</h3>
508
 
<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>
 
508
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                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>
509
509
<p>
510
510
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>.
511
511
</p>
528
528
<div class="refsect2">
529
529
<a name="gtk-box-set-spacing"></a><h3>gtk_box_set_spacing ()</h3>
530
530
<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>,
531
 
                                                         <em class="parameter"><code><span class="type">gint</span> spacing</code></em>);</pre>
 
531
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> spacing</code></em>);</pre>
532
532
<p>
533
533
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 
534
534
number of pixels to place between children of <em class="parameter"><code>box</code></em>.
553
553
<a name="gtk-box-reorder-child"></a><h3>gtk_box_reorder_child ()</h3>
554
554
<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>,
555
555
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
556
 
                                                         <em class="parameter"><code><span class="type">gint</span> position</code></em>);</pre>
 
556
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> position</code></em>);</pre>
557
557
<p>
558
558
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> children.  
559
559
The list is the <em class="structfield"><code>children</code></em> field of
593
593
<a name="gtk-box-query-child-packing"></a><h3>gtk_box_query_child_packing ()</h3>
594
594
<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>,
595
595
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
596
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> *expand</code></em>,
597
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> *fill</code></em>,
598
 
                                                         <em class="parameter"><code><span class="type">guint</span> *padding</code></em>,
 
596
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> *expand</code></em>,
 
597
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> *fill</code></em>,
 
598
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *padding</code></em>,
599
599
                                                         <em class="parameter"><code><a class="link" href="gtk-Standard-Enumerations.html#GtkPackType" title="enum GtkPackType"><span class="type">GtkPackType</span></a> *pack_type</code></em>);</pre>
600
600
<p>
601
601
Obtains information about how <em class="parameter"><code>child</code></em> is packed into <em class="parameter"><code>box</code></em>.
636
636
<a name="gtk-box-set-child-packing"></a><h3>gtk_box_set_child_packing ()</h3>
637
637
<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>,
638
638
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
639
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> expand</code></em>,
640
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> fill</code></em>,
641
 
                                                         <em class="parameter"><code><span class="type">guint</span> padding</code></em>,
 
639
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> expand</code></em>,
 
640
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> fill</code></em>,
 
641
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> padding</code></em>,
642
642
                                                         <em class="parameter"><code><a class="link" href="gtk-Standard-Enumerations.html#GtkPackType" title="enum GtkPackType"><span class="type">GtkPackType</span></a> pack_type</code></em>);</pre>
643
643
<p>
644
644
Sets the way <em class="parameter"><code>child</code></em> is packed into <em class="parameter"><code>box</code></em>.
679
679
<a name="GtkBox.property-details"></a><h2>Property Details</h2>
680
680
<div class="refsect2">
681
681
<a name="GtkBox--homogeneous"></a><h3>The <code class="literal">"homogeneous"</code> property</h3>
682
 
<pre class="programlisting">  "homogeneous"              <span class="type">gboolean</span>              : Read / Write</pre>
 
682
<pre class="programlisting">  "homogeneous"              <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
683
683
<p>Whether the children should all be the same size.</p>
684
684
<p>Default value: FALSE</p>
685
685
</div>
686
686
<hr>
687
687
<div class="refsect2">
688
688
<a name="GtkBox--spacing"></a><h3>The <code class="literal">"spacing"</code> property</h3>
689
 
<pre class="programlisting">  "spacing"                  <span class="type">gint</span>                  : Read / Write</pre>
 
689
<pre class="programlisting">  "spacing"                  <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write</pre>
690
690
<p>The amount of space between children.</p>
691
691
<p>Allowed values: &gt;= 0</p>
692
692
<p>Default value: 0</p>
696
696
<a name="GtkBox.child-property-details"></a><h2>Child Property Details</h2>
697
697
<div class="refsect2">
698
698
<a name="GtkBox--c-expand"></a><h3>The <code class="literal">"expand"</code> child property</h3>
699
 
<pre class="programlisting">  "expand"                   <span class="type">gboolean</span>              : Read / Write</pre>
 
699
<pre class="programlisting">  "expand"                   <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
700
700
<p>Whether the child should receive extra space when the parent grows.</p>
701
701
<p>Default value: TRUE</p>
702
702
</div>
703
703
<hr>
704
704
<div class="refsect2">
705
705
<a name="GtkBox--c-fill"></a><h3>The <code class="literal">"fill"</code> child property</h3>
706
 
<pre class="programlisting">  "fill"                     <span class="type">gboolean</span>              : Read / Write</pre>
 
706
<pre class="programlisting">  "fill"                     <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
707
707
<p>Whether extra space given to the child should be allocated to the child or used as padding.</p>
708
708
<p>Default value: TRUE</p>
709
709
</div>
717
717
<hr>
718
718
<div class="refsect2">
719
719
<a name="GtkBox--c-padding"></a><h3>The <code class="literal">"padding"</code> child property</h3>
720
 
<pre class="programlisting">  "padding"                  <span class="type">guint</span>                 : Read / Write</pre>
 
720
<pre class="programlisting">  "padding"                  <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>                 : Read / Write</pre>
721
721
<p>Extra space to put between the child and its neighbors, in pixels.</p>
722
722
<p>Allowed values: &lt;= G_MAXINT</p>
723
723
<p>Default value: 0</p>
725
725
<hr>
726
726
<div class="refsect2">
727
727
<a name="GtkBox--c-position"></a><h3>The <code class="literal">"position"</code> child property</h3>
728
 
<pre class="programlisting">  "position"                 <span class="type">gint</span>                  : Read / Write</pre>
 
728
<pre class="programlisting">  "position"                 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write</pre>
729
729
<p>The index of the child in the parent.</p>
730
730
<p>Allowed values: &gt;= G_MAXULONG</p>
731
731
<p>Default value: 0</p>
768
768
</div>
769
769
<div class="footer">
770
770
<hr>
771
 
          Generated by GTK-Doc V1.17.1</div>
 
771
          Generated by GTK-Doc V1.17</div>
772
772
</body>
773
773
</html>
 
 
b'\\ No newline at end of file'