Workbench User Guide : 11. Creating Toolbars : Types of Toolbar Items
 
Share this page                  
Types of Toolbar Items
There are a variety of toolbar items that you can create in OpenROAD Workbench, each serving a different functional purpose. These toolbar items are the same as those available in the Frame Editor. For more information, see:
The corresponding classes in the Language Reference Guide
How You Can Create Various Toolbar Items)
Bar Field
Displays scaled data as two overlaid rectangles: a background rectangle and a foreground rectangle. The data value scales the foreground rectangle relative to the minimum and maximum values.
Specific properties are listed in Bar Field Properties.
Box Trim
Creates a box that you can fill with text. The text wraps automatically if it is longer than the length of the box.
Specific properties are listed in Box Trim Properties.
Button Field
Lets the user initiate an operation by clicking it. You can specify text or an image as the label for the button.
Specific properties are listed in Button Field Properties.
Control Button
Creates a button that you can use to provide menu operations. Most commonly used in table fields for the operations menu, control buttons can also be coded independently of table fields and populated with any menu items.
Specific properties are listed in Control Button Properties.
Ellipse Shape
Creates an ellipse that you can place on the shape layer of a form or composite field.
Properties are listed in Common Field Properties.
Entry Field – Single Line or Multiline
Specifies a field into which the user can enter data. Depending on the data type defined for the field, the data can be character, numeric, or a date.
Specific properties are listed in Single-line Entry Field Properties and Multiline Entry Field Properties.
Flexible Form
Combines a set of fields that you can move as a group or independently of each other. The bounding box for a flexible form conforms to the locations of the fields rather than constraining them.
Specific properties are listed in Flexible Form Properties.
Free Trim
Places text trim that you enter directly by typing. You can move FreeTrim but you cannot resize it.
Specific properties are listed in Free Trim Properties.
Image Field
Defines a field that displays a two-color or full-color bitmap. You must assign a named variable of the BitmapObject data type that you will reference in your 4GL to load a bitmap into the image field at runtime.
Specific properties are listed in Image Field Properties.
Image Trim
Specifies a bitmap used in image trim. It is a static version of an Image Field. Because you can specify the Click event for image trim, you can use it for icon buttons.
Specific properties are listed in Image Trim Properties.
List Field
Displays a list of text strings that the end user can scroll through to select a single value or multiple values, depending on how the SelectionType attribute is set.
Specific properties are listed in List Field Properties.
Listview Field
Displays a finite table of values from which end users can select a single value.
Specific properties are listed in List View Properties.
Matrix Field
Organizes a collection of component fields as a two-dimensional stack field. Matrix fields maintain the relative alignment of their component fields even when the component fields change size.
Specific properties are listed in Matrix Field Properties.
Option Field
Appears as a drop-down list of values from which the user can make one selection. Only the current value is displayed. In addition to selecting the current value, the user can click the down arrow to select another value from the drop‑down list.
Specific properties are listed in Option Field Properties.
Palette Field
Displays a list of values, represented as images, from which the user selects a single value. Because all choices are always displayed, the list should contain few choices.
Specific properties are listed in Palette Field Properties.
Popup Button
Creates a button that the users can click to initiate an action. When clicked, an option menu pops up.
Specific properties are listed in Pop-up Button Properties.
Radio Field
Displays a set of buttons that represent a few mutually exclusive choices.
Specific properties are listed in Radio Field Properties.
Rectangle Shape
Creates a rectangle that you can place on the shape layer of a form or a composite field.
Specific properties are listed in Rectangle Shape Properties.
Scrollbar
Creates a scrollbar.
Specific properties are listed in Scroll Bar Properties.
Segment Shape
Lets you draw a line segment, which will be displayed behind any fields.
Slider Field
Lets the user drag a slider box to set a value somewhere within a specified range.
Specific properties are listed in Slider Field Properties.
Space
Separates toolbar items for display purposes only.
Stack Field
Creates a collection of separate fields that are organized as a one-dimensional array, either horizontal or vertical. Stack fields maintain the alignment of their component fields.
Specific properties are listed in Stack Field Properties.
SubForm
Represents a group of fields, contained in a fixed bounding box, that you can move on the toolbar as a unit. The bounding box constrains the locations of the fields. You cannot move the fields outside the box.
Specific properties are listed in Subform Properties.
Tab Folder
Creates a TabPageArray with two pages in it. It also creates a TabBar with default attributes. The TabBar, in turn, creates an empty TabFieldArray for all of the TabFields.
Specific properties are listed in Tab Folder Properties.
Toggle Field
Appears as an option that the user can click on or off (enable or disable). The label for a toggle can be either text or an image. You can supply one text phrase for both states and use the toggle indicator, or you can turn off the toggle indicator and supply separate phrases or images for the on and off states.
Specific properties are listed in Toggle Properties.
Treeview Field
Displays a visual representation of the hierarchical structure of a tree view. The tree is initially empty.
Specific properties are listed in Tree View Properties.
Viewport Field
Defines a fixed area that acts as a window for another field. Viewports are useful if the field displayed in the viewport varies in size but you want to ensure that it always takes up the same space on the toolbar.
Specific properties are listed in Viewport Properties.