Form Toolbar
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.
You can choose from two icon sizes: From the Icon size list, choose Small (the default) or Large.
The Settings window contains the following sections.
Toolbar Items
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.
Appearance
In this section, you can control the appearance of the background and the text in the form toolbar.
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.