Initial packaging to sync OBS with git/gerrit
[profile/ivi/gtk3.git] / docs / reference / gtk / html / GtkAlignment.html
1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2 <html>
3 <head>
4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5 <title>GtkAlignment</title>
6 <meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
7 <link rel="home" href="index.html" title="GTK+ 3 Reference Manual">
8 <link rel="up" href="LayoutContainers.html" title="Layout Containers">
9 <link rel="prev" href="GtkGrid.html" title="GtkGrid">
10 <link rel="next" href="GtkAspectFrame.html" title="GtkAspectFrame">
11 <meta name="generator" content="GTK-Doc V1.18 (XML mode)">
12 <link rel="stylesheet" href="style.css" type="text/css">
13 </head>
14 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
16 <tr valign="middle">
17 <td><a accesskey="p" href="GtkGrid.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18 <td><a accesskey="u" href="LayoutContainers.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
19 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
20 <th width="100%" align="center">GTK+ 3 Reference Manual</th>
21 <td><a accesskey="n" href="GtkAspectFrame.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
22 </tr>
23 <tr><td colspan="5" class="shortcuts">
24 <a href="#GtkAlignment.synopsis" class="shortcut">Top</a>
25                    | 
26                   <a href="#GtkAlignment.description" class="shortcut">Description</a>
27                    | 
28                   <a href="#GtkAlignment.object-hierarchy" class="shortcut">Object Hierarchy</a>
29                    | 
30                   <a href="#GtkAlignment.implemented-interfaces" class="shortcut">Implemented Interfaces</a>
31                    | 
32                   <a href="#GtkAlignment.properties" class="shortcut">Properties</a>
33 </td></tr>
34 </table>
35 <div class="refentry">
36 <a name="GtkAlignment"></a><div class="titlepage"></div>
37 <div class="refnamediv"><table width="100%"><tr>
38 <td valign="top">
39 <h2><span class="refentrytitle"><a name="GtkAlignment.top_of_page"></a>GtkAlignment</span></h2>
40 <p>GtkAlignment — A widget which controls the alignment and size of its child</p>
41 </td>
42 <td valign="top" align="right"></td>
43 </tr></table></div>
44 <div class="refsynopsisdiv">
45 <a name="GtkAlignment.synopsis"></a><h2>Synopsis</h2>
46 <pre class="synopsis">
47 #include &lt;gtk/gtk.h&gt;
48
49 struct              <a class="link" href="GtkAlignment.html#GtkAlignment-struct" title="struct GtkAlignment">GtkAlignment</a>;
50 <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkAlignment.html#gtk-alignment-new" title="gtk_alignment_new ()">gtk_alignment_new</a>                   (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a> xalign</code></em>,
51                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a> yalign</code></em>,
52                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a> xscale</code></em>,
53                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a> yscale</code></em>);
54 <span class="returnvalue">void</span>                <a class="link" href="GtkAlignment.html#gtk-alignment-set" title="gtk_alignment_set ()">gtk_alignment_set</a>                   (<em class="parameter"><code><a class="link" href="GtkAlignment.html" title="GtkAlignment"><span class="type">GtkAlignment</span></a> *alignment</code></em>,
55                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a> xalign</code></em>,
56                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a> yalign</code></em>,
57                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a> xscale</code></em>,
58                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a> yscale</code></em>);
59 <span class="returnvalue">void</span>                <a class="link" href="GtkAlignment.html#gtk-alignment-get-padding" title="gtk_alignment_get_padding ()">gtk_alignment_get_padding</a>           (<em class="parameter"><code><a class="link" href="GtkAlignment.html" title="GtkAlignment"><span class="type">GtkAlignment</span></a> *alignment</code></em>,
60                                                          <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_top</code></em>,
61                                                          <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_bottom</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_left</code></em>,
63                                                          <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_right</code></em>);
64 <span class="returnvalue">void</span>                <a class="link" href="GtkAlignment.html#gtk-alignment-set-padding" title="gtk_alignment_set_padding ()">gtk_alignment_set_padding</a>           (<em class="parameter"><code><a class="link" href="GtkAlignment.html" title="GtkAlignment"><span class="type">GtkAlignment</span></a> *alignment</code></em>,
65                                                          <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_top</code></em>,
66                                                          <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_bottom</code></em>,
67                                                          <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_left</code></em>,
68                                                          <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_right</code></em>);
69 </pre>
70 </div>
71 <div class="refsect1">
72 <a name="GtkAlignment.object-hierarchy"></a><h2>Object Hierarchy</h2>
73 <pre class="synopsis">
74   <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
75    +----<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a>
76          +----<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
77                +----<a class="link" href="GtkContainer.html" title="GtkContainer">GtkContainer</a>
78                      +----<a class="link" href="GtkBin.html" title="GtkBin">GtkBin</a>
79                            +----GtkAlignment
80 </pre>
81 </div>
82 <div class="refsect1">
83 <a name="GtkAlignment.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
84 <p>
85 GtkAlignment implements
86  AtkImplementorIface and  <a class="link" href="GtkBuildable.html" title="GtkBuildable">GtkBuildable</a>.</p>
87 </div>
88 <div class="refsect1">
89 <a name="GtkAlignment.properties"></a><h2>Properties</h2>
90 <pre class="synopsis">
91   "<a class="link" href="GtkAlignment.html#GtkAlignment--bottom-padding" title='The "bottom-padding" property'>bottom-padding</a>"           <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>                 : Read / Write
92   "<a class="link" href="GtkAlignment.html#GtkAlignment--left-padding" title='The "left-padding" property'>left-padding</a>"             <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>                 : Read / Write
93   "<a class="link" href="GtkAlignment.html#GtkAlignment--right-padding" title='The "right-padding" property'>right-padding</a>"            <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>                 : Read / Write
94   "<a class="link" href="GtkAlignment.html#GtkAlignment--top-padding" title='The "top-padding" property'>top-padding</a>"              <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>                 : Read / Write
95   "<a class="link" href="GtkAlignment.html#GtkAlignment--xalign" title='The "xalign" property'>xalign</a>"                   <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a>                : Read / Write
96   "<a class="link" href="GtkAlignment.html#GtkAlignment--xscale" title='The "xscale" property'>xscale</a>"                   <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a>                : Read / Write
97   "<a class="link" href="GtkAlignment.html#GtkAlignment--yalign" title='The "yalign" property'>yalign</a>"                   <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a>                : Read / Write
98   "<a class="link" href="GtkAlignment.html#GtkAlignment--yscale" title='The "yscale" property'>yscale</a>"                   <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a>                : Read / Write
99 </pre>
100 </div>
101 <div class="refsect1">
102 <a name="GtkAlignment.description"></a><h2>Description</h2>
103 <p>
104 The <a class="link" href="GtkAlignment.html" title="GtkAlignment"><span class="type">GtkAlignment</span></a> widget controls the alignment and size of its child widget.
105 It has four settings: xscale, yscale, xalign, and yalign.
106 </p>
107 <p>
108 The scale settings are used to specify how much the child widget should
109 expand to fill the space allocated to the <a class="link" href="GtkAlignment.html" title="GtkAlignment"><span class="type">GtkAlignment</span></a>.
110 The values can range from 0 (meaning the child doesn't expand at all) to
111 1 (meaning the child expands to fill all of the available space).
112 </p>
113 <p>
114 The align settings are used to place the child widget within the available
115 area. The values range from 0 (top or left) to 1 (bottom or right).
116 Of course, if the scale settings are both set to 1, the alignment settings
117 have no effect.
118 </p>
119 <p>
120 </p>
121 <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
122 <h3 class="title">Note</h3>
123 <p>
124 Note that the desired effect can in most cases be achieved by using the
125 <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> and <a class="link" href="GtkWidget.html#GtkWidget--margin" title='The "margin" property'><span class="type">"margin"</span></a> properties
126 on the child widget, so <a class="link" href="GtkAlignment.html" title="GtkAlignment"><span class="type">GtkAlignment</span></a> should not be used in new code.
127 </p>
128 </div>
129 <p>
130 </p>
131 </div>
132 <div class="refsect1">
133 <a name="GtkAlignment.details"></a><h2>Details</h2>
134 <div class="refsect2">
135 <a name="GtkAlignment-struct"></a><h3>struct GtkAlignment</h3>
136 <pre class="programlisting">struct GtkAlignment;</pre>
137 </div>
138 <hr>
139 <div class="refsect2">
140 <a name="gtk-alignment-new"></a><h3>gtk_alignment_new ()</h3>
141 <pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_alignment_new                   (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a> xalign</code></em>,
142                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a> yalign</code></em>,
143                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a> xscale</code></em>,
144                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a> yscale</code></em>);</pre>
145 <p>
146 Creates a new <a class="link" href="GtkAlignment.html" title="GtkAlignment"><span class="type">GtkAlignment</span></a>.
147 </p>
148 <div class="variablelist"><table border="0">
149 <col align="left" valign="top">
150 <tbody>
151 <tr>
152 <td><p><span class="term"><em class="parameter"><code>xalign</code></em> :</span></p></td>
153 <td>the horizontal alignment of the child widget, from 0 (left) to 1
154 (right).</td>
155 </tr>
156 <tr>
157 <td><p><span class="term"><em class="parameter"><code>yalign</code></em> :</span></p></td>
158 <td>the vertical alignment of the child widget, from 0 (top) to 1
159 (bottom).</td>
160 </tr>
161 <tr>
162 <td><p><span class="term"><em class="parameter"><code>xscale</code></em> :</span></p></td>
163 <td>the amount that the child widget expands horizontally to fill up
164 unused space, from 0 to 1.
165 A value of 0 indicates that the child widget should never expand.
166 A value of 1 indicates that the child widget will expand to fill all of the
167 space allocated for the <a class="link" href="GtkAlignment.html" title="GtkAlignment"><span class="type">GtkAlignment</span></a>.</td>
168 </tr>
169 <tr>
170 <td><p><span class="term"><em class="parameter"><code>yscale</code></em> :</span></p></td>
171 <td>the amount that the child widget expands vertically to fill up
172 unused space, from 0 to 1. The values are similar to <em class="parameter"><code>xscale</code></em>.</td>
173 </tr>
174 <tr>
175 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
176 <td>the new <a class="link" href="GtkAlignment.html" title="GtkAlignment"><span class="type">GtkAlignment</span></a>.</td>
177 </tr>
178 </tbody>
179 </table></div>
180 </div>
181 <hr>
182 <div class="refsect2">
183 <a name="gtk-alignment-set"></a><h3>gtk_alignment_set ()</h3>
184 <pre class="programlisting"><span class="returnvalue">void</span>                gtk_alignment_set                   (<em class="parameter"><code><a class="link" href="GtkAlignment.html" title="GtkAlignment"><span class="type">GtkAlignment</span></a> *alignment</code></em>,
185                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a> xalign</code></em>,
186                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a> yalign</code></em>,
187                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a> xscale</code></em>,
188                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a> yscale</code></em>);</pre>
189 <p>
190 Sets the <a class="link" href="GtkAlignment.html" title="GtkAlignment"><span class="type">GtkAlignment</span></a> values.
191 </p>
192 <div class="variablelist"><table border="0">
193 <col align="left" valign="top">
194 <tbody>
195 <tr>
196 <td><p><span class="term"><em class="parameter"><code>alignment</code></em> :</span></p></td>
197 <td>a <a class="link" href="GtkAlignment.html" title="GtkAlignment"><span class="type">GtkAlignment</span></a>.</td>
198 </tr>
199 <tr>
200 <td><p><span class="term"><em class="parameter"><code>xalign</code></em> :</span></p></td>
201 <td>the horizontal alignment of the child widget, from 0 (left) to 1
202 (right).</td>
203 </tr>
204 <tr>
205 <td><p><span class="term"><em class="parameter"><code>yalign</code></em> :</span></p></td>
206 <td>the vertical alignment of the child widget, from 0 (top) to 1
207 (bottom).</td>
208 </tr>
209 <tr>
210 <td><p><span class="term"><em class="parameter"><code>xscale</code></em> :</span></p></td>
211 <td>the amount that the child widget expands horizontally to fill up
212 unused space, from 0 to 1.
213 A value of 0 indicates that the child widget should never expand.
214 A value of 1 indicates that the child widget will expand to fill all of the
215 space allocated for the <a class="link" href="GtkAlignment.html" title="GtkAlignment"><span class="type">GtkAlignment</span></a>.</td>
216 </tr>
217 <tr>
218 <td><p><span class="term"><em class="parameter"><code>yscale</code></em> :</span></p></td>
219 <td>the amount that the child widget expands vertically to fill up
220 unused space, from 0 to 1. The values are similar to <em class="parameter"><code>xscale</code></em>.</td>
221 </tr>
222 </tbody>
223 </table></div>
224 </div>
225 <hr>
226 <div class="refsect2">
227 <a name="gtk-alignment-get-padding"></a><h3>gtk_alignment_get_padding ()</h3>
228 <pre class="programlisting"><span class="returnvalue">void</span>                gtk_alignment_get_padding           (<em class="parameter"><code><a class="link" href="GtkAlignment.html" title="GtkAlignment"><span class="type">GtkAlignment</span></a> *alignment</code></em>,
229                                                          <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_top</code></em>,
230                                                          <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_bottom</code></em>,
231                                                          <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_left</code></em>,
232                                                          <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_right</code></em>);</pre>
233 <p>
234 Gets the padding on the different sides of the widget.
235 See <a class="link" href="GtkAlignment.html#gtk-alignment-set-padding" title="gtk_alignment_set_padding ()"><code class="function">gtk_alignment_set_padding()</code></a>.
236 </p>
237 <div class="variablelist"><table border="0">
238 <col align="left" valign="top">
239 <tbody>
240 <tr>
241 <td><p><span class="term"><em class="parameter"><code>alignment</code></em> :</span></p></td>
242 <td>a <a class="link" href="GtkAlignment.html" title="GtkAlignment"><span class="type">GtkAlignment</span></a>
243 </td>
244 </tr>
245 <tr>
246 <td><p><span class="term"><em class="parameter"><code>padding_top</code></em> :</span></p></td>
247 <td>location to store the padding for
248 the top of the widget, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
249 </td>
250 </tr>
251 <tr>
252 <td><p><span class="term"><em class="parameter"><code>padding_bottom</code></em> :</span></p></td>
253 <td>location to store the padding
254 for the bottom of the widget, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
255 </td>
256 </tr>
257 <tr>
258 <td><p><span class="term"><em class="parameter"><code>padding_left</code></em> :</span></p></td>
259 <td>location to store the padding
260 for the left of the widget, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
261 </td>
262 </tr>
263 <tr>
264 <td><p><span class="term"><em class="parameter"><code>padding_right</code></em> :</span></p></td>
265 <td>location to store the padding
266 for the right of the widget, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
267 </td>
268 </tr>
269 </tbody>
270 </table></div>
271 <p class="since">Since 2.4</p>
272 </div>
273 <hr>
274 <div class="refsect2">
275 <a name="gtk-alignment-set-padding"></a><h3>gtk_alignment_set_padding ()</h3>
276 <pre class="programlisting"><span class="returnvalue">void</span>                gtk_alignment_set_padding           (<em class="parameter"><code><a class="link" href="GtkAlignment.html" title="GtkAlignment"><span class="type">GtkAlignment</span></a> *alignment</code></em>,
277                                                          <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_top</code></em>,
278                                                          <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_bottom</code></em>,
279                                                          <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_left</code></em>,
280                                                          <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_right</code></em>);</pre>
281 <p>
282 Sets the padding on the different sides of the widget.
283 The padding adds blank space to the sides of the widget. For instance,
284 this can be used to indent the child widget towards the right by adding
285 padding on the left.
286 </p>
287 <div class="variablelist"><table border="0">
288 <col align="left" valign="top">
289 <tbody>
290 <tr>
291 <td><p><span class="term"><em class="parameter"><code>alignment</code></em> :</span></p></td>
292 <td>a <a class="link" href="GtkAlignment.html" title="GtkAlignment"><span class="type">GtkAlignment</span></a>
293 </td>
294 </tr>
295 <tr>
296 <td><p><span class="term"><em class="parameter"><code>padding_top</code></em> :</span></p></td>
297 <td>the padding at the top of the widget</td>
298 </tr>
299 <tr>
300 <td><p><span class="term"><em class="parameter"><code>padding_bottom</code></em> :</span></p></td>
301 <td>the padding at the bottom of the widget</td>
302 </tr>
303 <tr>
304 <td><p><span class="term"><em class="parameter"><code>padding_left</code></em> :</span></p></td>
305 <td>the padding at the left of the widget</td>
306 </tr>
307 <tr>
308 <td><p><span class="term"><em class="parameter"><code>padding_right</code></em> :</span></p></td>
309 <td>the padding at the right of the widget.</td>
310 </tr>
311 </tbody>
312 </table></div>
313 <p class="since">Since 2.4</p>
314 </div>
315 </div>
316 <div class="refsect1">
317 <a name="GtkAlignment.property-details"></a><h2>Property Details</h2>
318 <div class="refsect2">
319 <a name="GtkAlignment--bottom-padding"></a><h3>The <code class="literal">"bottom-padding"</code> property</h3>
320 <pre class="programlisting">  "bottom-padding"           <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>                 : Read / Write</pre>
321 <p>
322 The padding to insert at the bottom of the widget.
323 </p>
324 <p>Allowed values: &lt;= G_MAXINT</p>
325 <p>Default value: 0</p>
326 <p class="since">Since 2.4</p>
327 </div>
328 <hr>
329 <div class="refsect2">
330 <a name="GtkAlignment--left-padding"></a><h3>The <code class="literal">"left-padding"</code> property</h3>
331 <pre class="programlisting">  "left-padding"             <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>                 : Read / Write</pre>
332 <p>
333 The padding to insert at the left of the widget.
334 </p>
335 <p>Allowed values: &lt;= G_MAXINT</p>
336 <p>Default value: 0</p>
337 <p class="since">Since 2.4</p>
338 </div>
339 <hr>
340 <div class="refsect2">
341 <a name="GtkAlignment--right-padding"></a><h3>The <code class="literal">"right-padding"</code> property</h3>
342 <pre class="programlisting">  "right-padding"            <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>                 : Read / Write</pre>
343 <p>
344 The padding to insert at the right of the widget.
345 </p>
346 <p>Allowed values: &lt;= G_MAXINT</p>
347 <p>Default value: 0</p>
348 <p class="since">Since 2.4</p>
349 </div>
350 <hr>
351 <div class="refsect2">
352 <a name="GtkAlignment--top-padding"></a><h3>The <code class="literal">"top-padding"</code> property</h3>
353 <pre class="programlisting">  "top-padding"              <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>                 : Read / Write</pre>
354 <p>
355 The padding to insert at the top of the widget.
356 </p>
357 <p>Allowed values: &lt;= G_MAXINT</p>
358 <p>Default value: 0</p>
359 <p class="since">Since 2.4</p>
360 </div>
361 <hr>
362 <div class="refsect2">
363 <a name="GtkAlignment--xalign"></a><h3>The <code class="literal">"xalign"</code> property</h3>
364 <pre class="programlisting">  "xalign"                   <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a>                : Read / Write</pre>
365 <p>Horizontal position of child in available space. 0.0 is left aligned, 1.0 is right aligned.</p>
366 <p>Allowed values: [0,1]</p>
367 <p>Default value: 0.5</p>
368 </div>
369 <hr>
370 <div class="refsect2">
371 <a name="GtkAlignment--xscale"></a><h3>The <code class="literal">"xscale"</code> property</h3>
372 <pre class="programlisting">  "xscale"                   <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a>                : Read / Write</pre>
373 <p>If available horizontal space is bigger than needed for the child, how much of it to use for the child. 0.0 means none, 1.0 means all.</p>
374 <p>Allowed values: [0,1]</p>
375 <p>Default value: 1</p>
376 </div>
377 <hr>
378 <div class="refsect2">
379 <a name="GtkAlignment--yalign"></a><h3>The <code class="literal">"yalign"</code> property</h3>
380 <pre class="programlisting">  "yalign"                   <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a>                : Read / Write</pre>
381 <p>Vertical position of child in available space. 0.0 is top aligned, 1.0 is bottom aligned.</p>
382 <p>Allowed values: [0,1]</p>
383 <p>Default value: 0.5</p>
384 </div>
385 <hr>
386 <div class="refsect2">
387 <a name="GtkAlignment--yscale"></a><h3>The <code class="literal">"yscale"</code> property</h3>
388 <pre class="programlisting">  "yscale"                   <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a>                : Read / Write</pre>
389 <p>If available vertical space is bigger than needed for the child, how much of it to use for the child. 0.0 means none, 1.0 means all.</p>
390 <p>Allowed values: [0,1]</p>
391 <p>Default value: 1</p>
392 </div>
393 </div>
394 </div>
395 <div class="footer">
396 <hr>
397           Generated by GTK-Doc V1.18</div>
398 </body>
399 </html>