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);
    void        gtk_menu_bar_append             (GtkMenuBar *menu_bar,
                                                 GtkWidget *child);
    void        gtk_menu_bar_prepend            (GtkMenuBar *menu_bar,
                                                 GtkWidget *child);
    void        gtk_menu_bar_insert             (GtkMenuBar *menu_bar,
                                                 GtkWidget *child,
                                                 gint position);
    void        gtk_menu_bar_set_shadow_type    (GtkMenuBar *menu_bar,
                                                 GtkShadowType type);

## Object Hierarchy

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

## Args

      "shadow"               GtkShadowType        : Read / Write

## 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 ()

    void        gtk_menu_bar_append             (GtkMenuBar *menu_bar,
                                                 GtkWidget *child);

Adds a new GtkMenuItem to the end of the GtkMenuBar

`menu_bar` : | a GtkMenuBar
`child` : | the GtkMenuItem to add

### gtk_menu_bar_prepend ()

    void        gtk_menu_bar_prepend            (GtkMenuBar *menu_bar,
                                                 GtkWidget *child);

Adds a new GtkMenuItem to the beginning of the GtkMenuBar

`menu_bar` : | a GtkMenuBar
`child` : | the GtkMenuItem to add

### gtk_menu_bar_insert ()

    void        gtk_menu_bar_insert             (GtkMenuBar *menu_bar,
                                                 GtkWidget *child,
                                                 gint position);

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

`menu_bar` : | a GtkMenuBar
`child` : | the GtkMenuItem to add
`position` : | the position in the item list where the `child` is added.

### gtk_menu_bar_set_shadow_type ()

    void        gtk_menu_bar_set_shadow_type    (GtkMenuBar *menu_bar,
                                                 GtkShadowType type);

Sets the shadow type to use on the GtkMenuBar. The shadow types to use are: GTK_SHADOW_NONE, GTK_SHADOW_IN, GTK_SHADOW_OUT, GTK_SHADOW_ETCHED_IN, and GTK_SHADOW_ETCHED_OUT

`menu_bar` : | a GtkMenuBar
`type` : | the GtkShadowtype

## Args

"`shadow`" (GtkShadowType : Read / Write)

  Used by GtkMenuBar to determine the shadow type.

## See Also

GtkMenuShell, GtkMenu, GtkMenuItem

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