GtkMenuBar

GtkMenuBar — A subclass of GtkMenuShell which holds GtkMenuItem widgets

Functions

GtkWidget * gtk_menu_bar_new ()
GtkWidget * gtk_menu_bar_new_from_model ()
void gtk_menu_bar_set_pack_direction ()
GtkPackDirection gtk_menu_bar_get_pack_direction ()
void gtk_menu_bar_set_child_pack_direction ()
GtkPackDirection gtk_menu_bar_get_child_pack_direction ()

Properties

GtkPackDirection child-pack-direction Read / Write
GtkPackDirection pack-direction Read / Write

Style Properties

int internal-padding Read
GtkShadowType shadow-type Read

Types and Values

struct GtkMenuBar
enum GtkPackDirection

Object Hierarchy

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkWidget
            ╰── GtkContainer
                ╰── GtkMenuShell
                    ╰── GtkMenuBar

Implemented Interfaces

GtkMenuBar implements AtkImplementorIface and GtkBuildable.

Includes

#include <gtk/gtk.h>

Description

The GtkMenuBar is a subclass of GtkMenuShell which contains one or more GtkMenuItems. The result is a standard menu bar which can hold many menu items.

CSS nodes

GtkMenuBar has a single CSS node with name menubar.

Functions

gtk_menu_bar_new ()

GtkWidget *
gtk_menu_bar_new (void);

Creates a new GtkMenuBar

Returns

the new menu bar, as a GtkWidget

gtk_menu_bar_new_from_model ()

GtkWidget *
gtk_menu_bar_new_from_model (GMenuModel *model);

Creates a new GtkMenuBar and populates it with menu items and submenus according to model .

The created menu items are connected to actions found in the GtkApplicationWindow to which the menu bar belongs - typically by means of being contained within the GtkApplicationWindows widget hierarchy.

Parameters

model

a GMenuModel

Returns

a new GtkMenuBar

Since: 3.4

gtk_menu_bar_set_pack_direction ()

void
gtk_menu_bar_set_pack_direction (GtkMenuBar *menubar,
                                 GtkPackDirection pack_dir);

Sets how items should be packed inside a menubar.

Parameters

menubar

a GtkMenuBar

pack_dir

a new GtkPackDirection

Since: 2.8

gtk_menu_bar_get_pack_direction ()

GtkPackDirection
gtk_menu_bar_get_pack_direction (GtkMenuBar *menubar);

Retrieves the current pack direction of the menubar. See gtk_menu_bar_set_pack_direction().

Parameters

menubar

a GtkMenuBar

Returns

the pack direction

Since: 2.8

gtk_menu_bar_set_child_pack_direction ()

void
gtk_menu_bar_set_child_pack_direction (GtkMenuBar *menubar,
                                       GtkPackDirection child_pack_dir);

Sets how widgets should be packed inside the children of a menubar.

Parameters

menubar

a GtkMenuBar

child_pack_dir

a new GtkPackDirection

Since: 2.8

gtk_menu_bar_get_child_pack_direction ()

GtkPackDirection
gtk_menu_bar_get_child_pack_direction (GtkMenuBar *menubar);

Retrieves the current child pack direction of the menubar. See gtk_menu_bar_set_child_pack_direction().

Parameters

menubar

a GtkMenuBar

Returns

the child pack direction

Since: 2.8

Types and Values

struct GtkMenuBar

struct GtkMenuBar;

enum GtkPackDirection

Determines how widgets should be packed inside menubars and menuitems contained in menubars.

Members

GTK_PACK_DIRECTION_LTR

Widgets are packed left-to-right

GTK_PACK_DIRECTION_RTL

Widgets are packed right-to-left

GTK_PACK_DIRECTION_TTB

Widgets are packed top-to-bottom

GTK_PACK_DIRECTION_BTT

Widgets are packed bottom-to-top

Property Details

The “child-pack-direction” property

  “child-pack-direction”     GtkPackDirection

The child pack direction of the menubar. It determines how the widgets contained in child menuitems are arranged.

Owner: GtkMenuBar

Flags: Read / Write

Default value: GTK_PACK_DIRECTION_LTR

Since: 2.8

The “pack-direction” property

  “pack-direction”           GtkPackDirection

The pack direction of the menubar. It determines how menuitems are arranged in the menubar.

Owner: GtkMenuBar

Flags: Read / Write

Default value: GTK_PACK_DIRECTION_LTR

Since: 2.8

Style Property Details

The “internal-padding” style property

  “internal-padding”         int

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

GtkMenuBar:internal-padding has been deprecated since version 3.8 and should not be used in newly-written code.

use the standard padding CSS property (through objects like GtkStyleContext and GtkCssProvider); the value of this style property is ignored.

Owner: GtkMenuBar

Flags: Read

Allowed values: >= 0

Default value: 0

The “shadow-type” style property

  “shadow-type”              GtkShadowType

The style of the shadow around the menubar.

GtkMenuBar:shadow-type has been deprecated since version 3.20 and should not be used in newly-written code.

Use CSS to determine the shadow; the value of this style property is ignored.

Owner: GtkMenuBar

Flags: Read

Default value: GTK_SHADOW_OUT

See Also

GtkMenuShell, GtkMenu, GtkMenuItem

© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer.gnome.org/gtk3/3.24/GtkMenuBar.html