.section Widgets
.topic widget.toolbar
.title Toolbar
.toc 0 Container Widgets
.toc 0 Toolbar
.index Toolbar
.index wgtToolbar

.h2 Toolbar

A horizontal container for toolbar buttons and controls. Typically placed at the top of a window. Children (usually ImageButtons or Buttons) are laid out horizontally with toolbar-appropriate spacing.

Header: widgets/widgetToolbar.h

.h3 Creation

.code
WidgetT *tb = wgtToolbar(parent);
wgtImageButtonFromFile(tb, "icons/save.bmp");
wgtImageButtonFromFile(tb, "icons/open.bmp");
.endcode

.h3 Macro

.table
  Macro                Description
  -----                -----------
  wgtToolbar(parent)   Create a toolbar container.
.endtable

.h3 Properties

Uses common container properties. Add children (buttons, separators, etc.) to populate the toolbar.

.h3 Events

Toolbar itself has no widget-specific events. Events fire on the child widgets.

.hr