1
<refentry id="GtkHSeparator">
3
<refentrytitle role="top_of_page">GtkHSeparator</refentrytitle>
4
<manvolnum>3</manvolnum>
5
<refmiscinfo>GTK Library</refmiscinfo>
9
<refname>GtkHSeparator</refname>
10
<refpurpose>A horizontal separator</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="GtkHSeparator-struct">GtkHSeparator</link>;
23
<link linkend="GtkWidget">GtkWidget</link>* <link linkend="gtk-hseparator-new">gtk_hseparator_new</link> (void);
29
<refsect1 role="object_hierarchy">
30
<title role="object_hierarchy.title">Object Hierarchy</title>
33
<link linkend="GObject">GObject</link>
34
+----<link linkend="GInitiallyUnowned">GInitiallyUnowned</link>
35
+----<link linkend="GtkObject">GtkObject</link>
36
+----<link linkend="GtkWidget">GtkWidget</link>
37
+----<link linkend="GtkSeparator">GtkSeparator</link>
45
<refsect1 role="impl_interfaces">
46
<title role="impl_interfaces.title">Implemented Interfaces</title>
48
GtkHSeparator implements
49
<link linkend="AtkImplementorIface">AtkImplementorIface</link>.</para>
57
<refsect1 role="desc">
58
<title role="desc.title">Description</title>
60
The <link linkend="GtkHSeparator"><type>GtkHSeparator</type></link> widget is a horizontal separator, used to group the
61
widgets within a window. It displays a horizontal line with a shadow to
62
make it appear sunken into the interface.
66
The <link linkend="GtkHSeparator"><type>GtkHSeparator</type></link> widget is not used as a separator within menus.
67
To create a separator in a menu create an empty <link linkend="GtkSeparatorMenuItem"><type>GtkSeparatorMenuItem</type></link>
68
widget using <link linkend="gtk-separator-menu-item-new"><function>gtk_separator_menu_item_new()</function></link> and add it to the menu with
69
<link linkend="gtk-menu-shell-append"><function>gtk_menu_shell_append()</function></link>.
74
<refsect1 role="details">
75
<title role="details.title">Details</title>
77
<title><anchor id="GtkHSeparator-struct" role="struct"/>GtkHSeparator</title>
78
<indexterm><primary>GtkHSeparator</primary></indexterm><programlisting>typedef struct _GtkHSeparator GtkHSeparator;</programlisting>
80
The <link linkend="GtkHSeparator-struct"><type>GtkHSeparator</type></link> struct contains private data only, and
81
should be accessed using the functions below.
84
<title><anchor id="gtk-hseparator-new" role="function"/>gtk_hseparator_new ()</title>
85
<indexterm><primary>gtk_hseparator_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>* gtk_hseparator_new (void);</programlisting>
87
Creates a new <link linkend="GtkHSeparator"><type>GtkHSeparator</type></link>.
88
</para><variablelist role="params">
89
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>a new <link linkend="GtkHSeparator"><type>GtkHSeparator</type></link>.
92
</simpara></listitem></varlistentry>
93
</variablelist></refsect2>
100
<title>See Also</title>
104
<term><link linkend="GtkVSeparator"><type>GtkVSeparator</type></link></term>
105
<listitem><para>a vertical separator.</para></listitem>