The Toolbar (

) contains the specifications of a toolbar placed as any other form object in a form. It shows a bar of menu buttons below the title of the window. Clicking a menu button runs a sequence of commands. It works like any other menu, except that it does not support submenus. Right-click the toolbar object in the form window and choose
Item to add an action item to the toolbar (see
The Item Node) or choose
Separator to add a separator between groups of toolbar buttons (see
The Separator Node). You can also add and edit the toolbar’s contents in the
Toolbar Items section. Enter the name of the toolbar object in the
Name field.
The Settings window contains the following sections.
The table in this section lists the current toolbar items and separators with their names, icons, and text. You can edit the text directly in the Text column. Right-click an item to move it; delete it; or, for custom buttons, edit it in the
Edit Custom Toolbar Item window that opens. You can also use the
Move Up (

),
Move Down (

),
Delete (

), and
Edit (

) buttons underneath the table. Click the
Item button (

) to add an item to the toolbar. Click the
Separator button (

) to add a separator.
The table contains a row for each added item, showing its name, icon, text, and tooltip in the Name,
Icon,
Text, and
Tooltip columns, respectively. In the leftmost column, an error symbol (

) or a warning symbol (

) appears to indicate a warning or error in the added item. For example, an error symbol appears for a toggle item that is missing a source.
The need to specify the alignment is most obvious when working in the grid mode, as it controls how the form object is aligned in its grid cell. Aligning the form object can be useful in the sketch mode too, and you can then use the alignment tools on the Arrange menu in the
Form toolbar’s
Sketch section. When running the application in any client other than the Windows client, the form objects may not be positioned exactly as seen in the form windows. This is because the form objects may have a different size in other clients, giving them a slightly different positioning. Specifying the alignment ensures that the form objects are aligned as you want them to be in all clients.
The Width and
Height fields are unavailable because the dimensions of the toolbar are determined by the software.
Additionally, in the sketch mode, you can specify the absolute position of the toolbar using the Position x and
Position y fields. In the grid mode, you can position the object in the grid and see the grid position as the
Row,
Column,
Row span, and
Column span values.
Under Cell margin (in grid mode only), you can control the margins around the form object. By default, the margins are taken from the parent form. From the
Cell margin list, choose:
From the Text color list, select a color to use for the text:
Inherit (the default; the form object then uses the setting from the Form it is located in), any of the predefined basic colors, or
Custom, which makes it possible to select a custom color from a color palette.
From the Background color list, select a color to use as the background for the toolbar text:
Transparent (the default), any of the predefined basic colors, or
Custom, which makes it possible to select a custom color from a color palette.
The font and the font size for the text use the font settings from the Forms node by default. Select a font from the
Font list:
Default font or any of the available fonts. If needed, choose or enter a font size (in points) in the
Font size combo box. The default font size is
Default size.
You can also select the Bold check box to use a boldface font or the
Italic check box to use italics (an italic font).
Under State, you can control the initial state of the toolbar when users run the application. By default, the toolbar is visible and enabled. Clear the
Visible or
Enabled check box if you want to make the initial state so that the toolbar is hidden or unavailable. You can then make it visible or enable it using a method. In the Form Editor, the state of the form object is indicated by a change in its appearance. Objects that are hidden become visible when selected in the Form Editor.