GTK+ Reference Manual | ||||
---|---|---|---|---|
GtkMenuBarGtkMenuBar — A subclass widget for GtkMenuShell which holds GtkMenuItem widgets |
#include <gtk/gtk.h> 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) enum GtkPackDirection; void gtk_menu_bar_set_pack_direction (GtkMenuBar *menubar, GtkPackDirection pack_dir); GtkPackDirection gtk_menu_bar_get_pack_direction (GtkMenuBar *menubar); void gtk_menu_bar_set_child_pack_direction (GtkMenuBar *menubar, GtkPackDirection child_pack_dir); GtkPackDirection gtk_menu_bar_get_child_pack_direction (GtkMenuBar *menubar);
GObject +----GInitiallyUnowned +----GtkObject +----GtkWidget +----GtkContainer +----GtkMenuShell +----GtkMenuBar
"child-pack-direction" GtkPackDirection : Read / Write "pack-direction" GtkPackDirection : Read / Write
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.
typedef struct _GtkMenuBar GtkMenuBar;
The GtkMenuBar struct contains the following fields. (These fields should be considered read-only. They should never be set by an application.)
GtkWidget* gtk_menu_bar_new (void);
Creates the new GtkMenuBar
Returns : | the GtkMenuBar |
#define gtk_menu_bar_append(menu,child) gtk_menu_shell_append ((GtkMenuShell *)(menu),(child))
gtk_menu_bar_append
is deprecated and should not be used in newly-written code. Use gtk_menu_shell_append()
instead.
Adds a new GtkMenuItem to the end of the GtkMenuBar
menu : |
a GtkMenuBar |
child : |
the GtkMenuItem to add |
#define gtk_menu_bar_prepend(menu,child) gtk_menu_shell_prepend ((GtkMenuShell *)(menu),(child))
gtk_menu_bar_prepend
is deprecated and should not be used in newly-written code. Use gtk_menu_shell_prepend()
instead.
Adds a new GtkMenuItem to the beginning of the GtkMenuBar
menu : |
a GtkMenuBar |
child : |
the GtkMenuItem to add |
#define gtk_menu_bar_insert(menu,child,pos) gtk_menu_shell_insert ((GtkMenuShell *)(menu),(child),(pos))
gtk_menu_bar_insert
is deprecated and should not be used in newly-written code. Use gtk_menu_shell_insert()
instead.
Adds a new GtkMenuItem to the GtkMenuBar at the position defined by position
menu : |
a GtkMenuBar |
child : |
the GtkMenuItem to add |
pos : |
the position in the item list where the child is added.
|
typedef enum { GTK_PACK_DIRECTION_LTR, GTK_PACK_DIRECTION_RTL, GTK_PACK_DIRECTION_TTB, GTK_PACK_DIRECTION_BTT } GtkPackDirection;
void gtk_menu_bar_set_pack_direction (GtkMenuBar *menubar, GtkPackDirection pack_dir);
Sets how items should be packed inside a menubar.
menubar : |
a GtkMenuBar. |
pack_dir : |
a new GtkPackDirection. |
Since 2.8
GtkPackDirection gtk_menu_bar_get_pack_direction (GtkMenuBar *menubar);
Retrieves the current pack direction of the menubar. See
gtk_menu_bar_set_pack_direction()
.
menubar : |
a GtkMenuBar |
Returns : | the pack direction |
Since 2.8
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.
menubar : |
a GtkMenuBar. |
child_pack_dir : |
a new GtkPackDirection. |
Since 2.8
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()
.
menubar : |
a GtkMenuBar |
Returns : | the child pack direction |
Since 2.8
child-pack-direction
" property"child-pack-direction" GtkPackDirection : Read / Write
The pack direction of the menubar. It determines how the widgets contained in child menuitems are arranged.
Default value: GTK_PACK_DIRECTION_LTR
Since 2.8
pack-direction
" property"pack-direction" GtkPackDirection : Read / Write
The pack direction of the menubar. It determines how menuitems are arranged in the menubar.
Default value: GTK_PACK_DIRECTION_LTR
Since 2.8
internal-padding
" style property"internal-padding" gint : Read
Amount of border space between the menubar shadow and the menu items.
Allowed values: >= 0
Default value: 1
shadow-type
" style property"shadow-type" GtkShadowType : Read
Style of bevel around the menubar.
Default value: GTK_SHADOW_OUT