]> Pileus Git - ~andy/gtk/blob - docs/reference/gtk/tmpl/gtkmenubar.sgml
ba992c0cc3d62bb158f1f3060d0fc1a3891065ac
[~andy/gtk] / docs / reference / gtk / tmpl / gtkmenubar.sgml
1 <!-- ##### SECTION Title ##### -->
2 GtkMenuBar
3
4 <!-- ##### SECTION Short_Description ##### -->
5 A subclass widget for #GtkMenuShell which holds #GtkMenuItem widgets
6
7 <!-- ##### SECTION Long_Description ##### -->
8 <para>
9 The #GtkMenuBar is a subclass of #GtkMenuShell which contains one to many #GtkMenuItem. The result is a standard menu bar which can hold many menu items. #GtkMenuBar allows for a shadow type to be set for aesthetic purposes. The shadow types are defined in the #gtk_menu_bar_set_shadow_type function.
10 </para>
11
12 <!-- ##### SECTION See_Also ##### -->
13 <para>
14 #GtkMenuShell, #GtkMenu, #GtkMenuItem
15 </para>
16
17 <!-- ##### STRUCT GtkMenuBar ##### -->
18 <para>
19 The #GtkMenuBar struct contains the following fields. (These fields should be considered read-only.  They should never be set by an application.)
20 </para>
21
22
23 <!-- ##### FUNCTION gtk_menu_bar_new ##### -->
24 <para>
25 Creates the new #GtkMenuBar
26 </para>
27
28 @Returns: the #GtkMenuBar
29
30
31 <!-- ##### FUNCTION gtk_menu_bar_append ##### -->
32 <para>
33 Adds a new #GtkMenuItem to the end of the GtkMenuBar
34 </para>
35
36 @menu_bar: a #GtkMenuBar
37 @child: the #GtkMenuItem to add
38
39
40 <!-- ##### FUNCTION gtk_menu_bar_prepend ##### -->
41 <para>
42 Adds a new #GtkMenuItem to the beginning of the GtkMenuBar
43 </para>
44
45 @menu_bar: a #GtkMenuBa
46 @child: the #GtkMenuItem to add
47
48
49 <!-- ##### FUNCTION gtk_menu_bar_insert ##### -->
50 <para>
51 Adds a new #GtkMenuItem to the GtkMenuBar at the position defined by @position
52 </para>
53
54 @menu_bar: a #GtkMenuBar
55 @child: the #GtkMenuItem to add
56 @position: the position in the item list where the <em>child</em> is added.
57
58
59 <!-- ##### FUNCTION gtk_menu_bar_set_shadow_type ##### -->
60 <para>
61 Sets the shadow type to use on the GtkMenuBar. The shadow types to use are:
62 GTK_SHADOW_NONE, GTK_SHADOW_IN, GTK_SHADOW_OUT, GTK_SHADOW_ETCHED_IN, and GTK_SHADOW_ETCHED_OUT
63 </para>
64
65 @menu_bar: a #GtkMenuBa
66 @type: the GtkShadowtype
67
68
69 <!-- ##### ARG GtkMenuBar:shadow ##### -->
70 <para>
71 Used by #GtkMenuBar to determine the shadow type.
72 </para>
73