class fltk::MenuBar


Class Hierarchy

fltk::Menu
   |
   +----fltk::MenuBar

Include Files

#include <fltk/MenuBar.h>

Description

This widget provides a standard menubar interface. Usually you will put this widget along the top edge of your window. The height of the widget should be 30 for the menu titles to draw correctly with the default font.

Each child widget (typically an fltk::ItemGroup puts a single item into the menu bar. If the child is a group, the pressing on it will bring up a pull-down menu of the children of it. Sub-sub menus and lower pop up to the right of the submenus.

If a child is not a group (for instance if it is a plain fltk::Item) then clicking on it will pick it as though it was a menu item. This allows you to put "buttons" into the menubar and thus the menubar can act like a "toolbar" in other toolkits, or you can mix the "tools" with "menus" into the same bar.

When the user picks an item off the menu, the item's callback is done with the menubar as the fltk::Widget* argument. If the item does not have a callback the menubar's callback is done instead.

Submenus will also pop up in response to shortcuts indicated by putting a '&' character in the name field of the menu item. If you put a '&' character in a top-level "button" then the shortcut picks it. The '&' character in submenus is ignored until the menu is popped up.

Typing the shortcut() of any of the menu items will cause callbacks exactly the same as when you pick the item with the mouse.

Methods

fltk::MenuBar::MenuBar(int x, int y, int w, int h, const char *label = 0)

Creates a new fltk::MenuBar widget using the given position, size, and label string. The default boxtype is fltk::UP_BOX.

The constructor sets menu() to NULL. See fltk::Menu for the methods to set or change the menu.

labelsize(), labelfont(), and labelcolor() are used to control how the menubar items are drawn. They are initialized from the fltk::Menu static variables, but you can change them if desired.

label() is ignored unless you change align() to put it outside the menubar.

virtual fltk::MenuBar::~MenuBar()

The destructor removes the fltk::MenuBar widget and all of its menu items.