1
<refentry id="GtkVBox">
3
<refentrytitle role="top_of_page">GtkVBox</refentrytitle>
4
<manvolnum>3</manvolnum>
5
<refmiscinfo>GTK Library</refmiscinfo>
9
<refname>GtkVBox</refname>
10
<refpurpose>A vertical container box</refpurpose>
11
<!--[<xref linkend="desc" endterm="desc.title"/>]-->
14
<refsynopsisdiv role="synopsis">
15
<title role="synopsis.title">Synopsis</title>
19
#include <gtk/gtk.h>
22
<link linkend="GtkVBox-struct">GtkVBox</link>;
23
<link linkend="GtkWidget">GtkWidget</link>* <link linkend="gtk-vbox-new">gtk_vbox_new</link> (<link linkend="gboolean">gboolean</link> homogeneous,
24
<link linkend="gint">gint</link> spacing);
30
<refsect1 role="object_hierarchy">
31
<title role="object_hierarchy.title">Object Hierarchy</title>
34
<link linkend="GObject">GObject</link>
35
+----<link linkend="GInitiallyUnowned">GInitiallyUnowned</link>
36
+----<link linkend="GtkObject">GtkObject</link>
37
+----<link linkend="GtkWidget">GtkWidget</link>
38
+----<link linkend="GtkContainer">GtkContainer</link>
39
+----<link linkend="GtkBox">GtkBox</link>
41
+----<link linkend="GtkColorSelection">GtkColorSelection</link>
42
+----<link linkend="GtkFileChooserWidget">GtkFileChooserWidget</link>
43
+----<link linkend="GtkFontSelection">GtkFontSelection</link>
44
+----<link linkend="GtkGammaCurve">GtkGammaCurve</link>
45
+----<link linkend="GtkRecentChooserWidget">GtkRecentChooserWidget</link>
52
<refsect1 role="impl_interfaces">
53
<title role="impl_interfaces.title">Implemented Interfaces</title>
56
<link linkend="AtkImplementorIface">AtkImplementorIface</link>.</para>
64
<refsect1 role="desc">
65
<title role="desc.title">Description</title>
67
GtkVBox is a container that organizes child widgets into a single column.
71
Use the <link linkend="GtkBox"><type>GtkBox</type></link> packing interface to determine the arrangement,
72
spacing, height, and alignment of GtkVBox children.
76
All children are allocated the same width.
80
<refsect1 role="details">
81
<title role="details.title">Details</title>
83
<title><anchor id="GtkVBox-struct" role="struct"/>GtkVBox</title>
84
<indexterm><primary>GtkVBox</primary></indexterm><programlisting>typedef struct _GtkVBox GtkVBox;</programlisting>
87
<title><anchor id="gtk-vbox-new" role="function"/>gtk_vbox_new ()</title>
88
<indexterm><primary>gtk_vbox_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>* gtk_vbox_new (<link linkend="gboolean">gboolean</link> homogeneous,
89
<link linkend="gint">gint</link> spacing);</programlisting>
91
Creates a new GtkVBox.
92
</para><variablelist role="params">
93
<varlistentry><term><parameter>homogeneous</parameter> :</term>
94
<listitem><simpara><link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if all children are to be given equal space allotments.
95
</simpara></listitem></varlistentry>
96
<varlistentry><term><parameter>spacing</parameter> :</term>
97
<listitem><simpara>the number of pixels to place by default between children.
98
</simpara></listitem></varlistentry>
99
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>a new GtkVBox.
102
</simpara></listitem></varlistentry>
103
</variablelist></refsect2>
110
<title>See Also</title>
115
<term><link linkend="GtkHBox"><type>GtkHBox</type></link></term>
116
<listitem><para>a sister class that organizes widgets into a row.</para></listitem>