The Form Toolbar (

) contains the specifications of a toolbar that will appear in a separate area above the regular editor area. The form toolbar is fixed to the top of the form and shows up in a manner that depends on how the form is being used, such as the main toolbar of a window, in a section header, or in a view header. The last case can be useful in settings forms, where it prevents the toolbar from scrolling out of view. You can only add one
Form Toolbar in each form. It shows a bar of menu buttons. 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 form toolbar object at the top of the form window and choose
Add Item to add an action button to the form toolbar (see
The Item Node), choose
Add Toggle Item to add a toggle button to the form toolbar (see
The Toggle Item Node), or choose
Add Separator to add a separator between groups of form 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 form 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
Add Item button (

) to add a custom item to the toolbar. Click the
Add Toggle Item button (

) to add a custom toggle item to the toolbar. Click the
Add 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.
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 form 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 Themes 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 checkbox to use a boldface font or the
Italic checkbox to use italics (an italic font).
Under State, you can control the initial state of the form toolbar when users run the application. By default, the form toolbar is visible and enabled. Clear the
Visible or
Enabled checkbox if you want to make the initial state so that the form 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.