4
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
<title>GtkSizeGroup</title>
6
<meta name="generator" content="DocBook XSL Stylesheets V1.77.1">
6
<meta name="generator" content="DocBook XSL Stylesheets V1.78.0">
7
7
<link rel="home" href="index.html" title="GTK+ 2 Reference Manual">
8
8
<link rel="up" href="MiscObjects.html" title="Miscellaneous">
9
9
<link rel="prev" href="GtkIMMulticontext.html" title="GtkIMMulticontext">
53
53
<em class="parameter"><code><a class="link" href="GtkSizeGroup.html#GtkSizeGroupMode" title="enum GtkSizeGroupMode"><span class="type">GtkSizeGroupMode</span></a> mode</code></em>);
54
54
<a class="link" href="GtkSizeGroup.html#GtkSizeGroupMode" title="enum GtkSizeGroupMode"><span class="returnvalue">GtkSizeGroupMode</span></a> <a class="link" href="GtkSizeGroup.html#gtk-size-group-get-mode" title="gtk_size_group_get_mode ()">gtk_size_group_get_mode</a> (<em class="parameter"><code><a class="link" href="GtkSizeGroup.html" title="GtkSizeGroup"><span class="type">GtkSizeGroup</span></a> *size_group</code></em>);
55
55
<span class="returnvalue">void</span> <a class="link" href="GtkSizeGroup.html#gtk-size-group-set-ignore-hidden" title="gtk_size_group_set_ignore_hidden ()">gtk_size_group_set_ignore_hidden</a> (<em class="parameter"><code><a class="link" href="GtkSizeGroup.html" title="GtkSizeGroup"><span class="type">GtkSizeGroup</span></a> *size_group</code></em>,
56
<em class="parameter"><code><span class="type">gboolean</span> ignore_hidden</code></em>);
57
<span class="returnvalue">gboolean</span> <a class="link" href="GtkSizeGroup.html#gtk-size-group-get-ignore-hidden" title="gtk_size_group_get_ignore_hidden ()">gtk_size_group_get_ignore_hidden</a> (<em class="parameter"><code><a class="link" href="GtkSizeGroup.html" title="GtkSizeGroup"><span class="type">GtkSizeGroup</span></a> *size_group</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> ignore_hidden</code></em>);
57
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GtkSizeGroup.html#gtk-size-group-get-ignore-hidden" title="gtk_size_group_get_ignore_hidden ()">gtk_size_group_get_ignore_hidden</a> (<em class="parameter"><code><a class="link" href="GtkSizeGroup.html" title="GtkSizeGroup"><span class="type">GtkSizeGroup</span></a> *size_group</code></em>);
58
58
<span class="returnvalue">void</span> <a class="link" href="GtkSizeGroup.html#gtk-size-group-add-widget" title="gtk_size_group_add_widget ()">gtk_size_group_add_widget</a> (<em class="parameter"><code><a class="link" href="GtkSizeGroup.html" title="GtkSizeGroup"><span class="type">GtkSizeGroup</span></a> *size_group</code></em>,
59
59
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>);
60
60
<span class="returnvalue">void</span> <a class="link" href="GtkSizeGroup.html#gtk-size-group-remove-widget" title="gtk_size_group_remove_widget ()">gtk_size_group_remove_widget</a> (<em class="parameter"><code><a class="link" href="GtkSizeGroup.html" title="GtkSizeGroup"><span class="type">GtkSizeGroup</span></a> *size_group</code></em>,
61
61
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>);
62
<span class="returnvalue">GSList</span> * <a class="link" href="GtkSizeGroup.html#gtk-size-group-get-widgets" title="gtk_size_group_get_widgets ()">gtk_size_group_get_widgets</a> (<em class="parameter"><code><a class="link" href="GtkSizeGroup.html" title="GtkSizeGroup"><span class="type">GtkSizeGroup</span></a> *size_group</code></em>);
62
<a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="returnvalue">GSList</span></a> * <a class="link" href="GtkSizeGroup.html#gtk-size-group-get-widgets" title="gtk_size_group_get_widgets ()">gtk_size_group_get_widgets</a> (<em class="parameter"><code><a class="link" href="GtkSizeGroup.html" title="GtkSizeGroup"><span class="type">GtkSizeGroup</span></a> *size_group</code></em>);
65
65
<div class="refsect1">
66
66
<a name="GtkSizeGroup.object-hierarchy"></a><h2>Object Hierarchy</h2>
67
67
<pre class="synopsis">
68
<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
78
78
<div class="refsect1">
79
79
<a name="GtkSizeGroup.properties"></a><h2>Properties</h2>
80
80
<pre class="synopsis">
81
"<a class="link" href="GtkSizeGroup.html#GtkSizeGroup--ignore-hidden" title='The "ignore-hidden" property'>ignore-hidden</a>" <span class="type">gboolean</span> : Read / Write
81
"<a class="link" href="GtkSizeGroup.html#GtkSizeGroup--ignore-hidden" title='The "ignore-hidden" property'>ignore-hidden</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write
82
82
"<a class="link" href="GtkSizeGroup.html#GtkSizeGroup--mode" title='The "mode" property'>mode</a>" <a class="link" href="GtkSizeGroup.html#GtkSizeGroupMode" title="enum GtkSizeGroupMode"><span class="type">GtkSizeGroupMode</span></a> : Read / Write
109
109
<a class="link" href="GtkSizeGroup.html" title="GtkSizeGroup"><span class="type">GtkSizeGroup</span></a> objects are referenced by each widget in the size group,
110
110
so once you have added all widgets to a <a class="link" href="GtkSizeGroup.html" title="GtkSizeGroup"><span class="type">GtkSizeGroup</span></a>, you can drop
111
the initial reference to the size group with <code class="function">g_object_unref()</code>. If the
111
the initial reference to the size group with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. If the
112
112
widgets in the size group are subsequently destroyed, then they will
113
113
be removed from the size group and drop their references on the size
114
114
group; when all widgets have been removed, the size group will be
134
134
of the size group. The name attribute gives the id of the widget.
136
136
<div class="example">
137
<a name="idp98913040"></a><p class="title"><b>Example 54. A UI definition fragment with GtkSizeGroup</b></p>
137
<a name="idm266981734256"></a><p class="title"><b>Example 54. A UI definition fragment with GtkSizeGroup</b></p>
138
138
<div class="example-contents">
139
139
<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
298
298
<div class="refsect2">
299
299
<a name="gtk-size-group-set-ignore-hidden"></a><h3>gtk_size_group_set_ignore_hidden ()</h3>
300
300
<pre class="programlisting"><span class="returnvalue">void</span> gtk_size_group_set_ignore_hidden (<em class="parameter"><code><a class="link" href="GtkSizeGroup.html" title="GtkSizeGroup"><span class="type">GtkSizeGroup</span></a> *size_group</code></em>,
301
<em class="parameter"><code><span class="type">gboolean</span> ignore_hidden</code></em>);</pre>
301
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> ignore_hidden</code></em>);</pre>
303
303
Sets whether unmapped widgets should be ignored when
304
304
calculating the size.
327
327
<div class="refsect2">
328
328
<a name="gtk-size-group-get-ignore-hidden"></a><h3>gtk_size_group_get_ignore_hidden ()</h3>
329
<pre class="programlisting"><span class="returnvalue">gboolean</span> gtk_size_group_get_ignore_hidden (<em class="parameter"><code><a class="link" href="GtkSizeGroup.html" title="GtkSizeGroup"><span class="type">GtkSizeGroup</span></a> *size_group</code></em>);</pre>
329
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gtk_size_group_get_ignore_hidden (<em class="parameter"><code><a class="link" href="GtkSizeGroup.html" title="GtkSizeGroup"><span class="type">GtkSizeGroup</span></a> *size_group</code></em>);</pre>
331
331
Returns if invisible widgets are ignored when calculating the size.
414
414
<div class="refsect2">
415
415
<a name="gtk-size-group-get-widgets"></a><h3>gtk_size_group_get_widgets ()</h3>
416
<pre class="programlisting"><span class="returnvalue">GSList</span> * gtk_size_group_get_widgets (<em class="parameter"><code><a class="link" href="GtkSizeGroup.html" title="GtkSizeGroup"><span class="type">GtkSizeGroup</span></a> *size_group</code></em>);</pre>
416
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="returnvalue">GSList</span></a> * gtk_size_group_get_widgets (<em class="parameter"><code><a class="link" href="GtkSizeGroup.html" title="GtkSizeGroup"><span class="type">GtkSizeGroup</span></a> *size_group</code></em>);</pre>
418
418
Returns the list of widgets associated with <em class="parameter"><code>size_group</code></em>.
432
432
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
433
<td>a <span class="type">GSList</span> of
433
<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> of
434
434
widgets. The list is owned by GTK+ and should not be modified. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GtkWidget][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
443
443
<a name="GtkSizeGroup.property-details"></a><h2>Property Details</h2>
444
444
<div class="refsect2">
445
445
<a name="GtkSizeGroup--ignore-hidden"></a><h3>The <code class="literal">"ignore-hidden"</code> property</h3>
446
<pre class="programlisting"> "ignore-hidden" <span class="type">gboolean</span> : Read / Write</pre>
446
<pre class="programlisting"> "ignore-hidden" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write</pre>
448
If <code class="literal">TRUE</code>, unmapped widgets are ignored when determining
448
If <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, unmapped widgets are ignored when determining
449
449
the size of the group.
451
451
<p>Default value: FALSE</p>