GTK+ Reference Manual
<<< Previous Page | Home | Up | Next Page >>>

# GtkMenuBar

## Name

GtkMenuBar -- A subclass widget for GtkMenuShell which holds GtkMenuItem widgets

## Synopsis

    #include <gtk/gtk.h>

    struct      GtkMenuBar;
    GtkWidget*  gtk_menu_bar_new                (void);
    #define     gtk_menu_bar_append             (menu,child)
    #define     gtk_menu_bar_prepend            (menu,child)
    #define     gtk_menu_bar_insert             (menu,child,pos)

## Object Hierarchy

      GObject
       +----GtkObject
             +----GtkWidget
                   +----GtkContainer
                         +----GtkMenuShell
                               +----GtkMenuBar

## Style Properties

      "shadow-type"          GtkShadowType        : Read
      "internal-padding"     gint                 : Read

## Description

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.

## Details

### struct GtkMenuBar

    struct GtkMenuBar;

The GtkMenuBar struct contains the following fields. (These fields should be considered read-only. They should never be set by an application.)

### gtk_menu_bar_new ()

    GtkWidget*  gtk_menu_bar_new                (void);

Creates the new GtkMenuBar

Returns : | the GtkMenuBar

### gtk_menu_bar_append()

    #define gtk_menu_bar_append(menu,child)	    gtk_menu_shell_append  ((GtkMenuShell *)(menu),(child))

Warning
`gtk_menu_bar_append` is deprecated and should not be used in newly-written code.

Adds a new GtkMenuItem to the end of the GtkMenuBar

`menu` : |
`child` : | the GtkMenuItem to add

### gtk_menu_bar_prepend()

    #define gtk_menu_bar_prepend(menu,child)    gtk_menu_shell_prepend ((GtkMenuShell *)(menu),(child))

Warning
`gtk_menu_bar_prepend` is deprecated and should not be used in newly-written code.

Adds a new GtkMenuItem to the beginning of the GtkMenuBar

`menu` : |
`child` : | the GtkMenuItem to add

### gtk_menu_bar_insert()

    #define gtk_menu_bar_insert(menu,child,pos) gtk_menu_shell_insert ((GtkMenuShell *)(menu),(child),(pos))

Warning
`gtk_menu_bar_insert` is deprecated and should not be used in newly-written code.

Adds a new GtkMenuItem to the GtkMenuBar at the position defined by `position`

`menu` : |
`child` : | the GtkMenuItem to add
`pos` : |

## Style Properties

"`shadow-type`" (GtkShadowType : Read)

  Style of bevel around the menubar

"`internal-padding`" (gint : Read)

  Amount of border space between the menubar shadow and the menu items

## See Also

GtkMenuShell, GtkMenu, GtkMenuItem

<<< Previous Page | Home | Up | Next Page >>>
GtkMenu | GtkMenuItem