Painting Boxes or Lines

After selecting the region in which you want your box or line to appear, as described in Painting Buttons, Labels, Pictures, and Boxes, the Box Properties overlay shown in Figure 3-15-13A appears. This example defines the "History Options" box shown in Figure 3-15-13B.

Control Options

Label

To define any text to appear as a box title.

Text Position

Indicates where the text should appear inside the box border. Click the list button for a drop-down list of selections that include CENTER, TOP, RIGHT, BOTTOM, LEFT, UPPER RIGHT, UPPER LEFT, LOWER RIGHT and LOWER LEFT.

Tooltip

Defines one line of help text that is displayed after the mouse pointer has been positioned over the box for a few seconds. Tooltip does not apply to boxes on output and inquiry images.

Font Options

Font

Selects the font (Arial, Courier, etc.) the box’s label is to be displayed with. Click the list button to make your choice. If left blank, the default font determined by your system administrator will be used.

Style

Selects the label’s font style (bold, italic, etc.). Click the list button to make your choice. If left blank, the regular font style is used.

Scale

Defines the size of the label’s font as a percentage of the runtime font size. Click the list button to make your choice.

Text Color

Defines the label’s font color. Click the color icon to begin and see the Making Color Selections section for further instructions.

Fill Color

Defines the region’s fill color. Click the color icon to begin and see the Making Color Selections section for further instructions.

Transparent?

Indicates whether or not the background of the region should be opaque or transparent.

Border Options

Type

Defines the type of border for the box. Click the list button to make your choice.

Color defines

The color of the border. Click the color icon to begin and see the Making Color Selections section for further instructions.

Tab Order Options

Tab Level

Is not a valid option when defining a box and is disabled.

Tab Group

Is not a valid option when defining a box and is disabled.

Other Options

Enabled

Is not a valid option when defining a box and is disabled.

Invisible

Indicates whether or not the box is initially invisible when this image is first presented to the user. If "yes" then the box must be made visible via ILF code in order for the user to see it. Click the checkbox to toggle between "yes" and "no" values.

Sep. Before?

Is not a valid option when defining a box and is disabled.

Sep. After?

Is not a valid option when defining a box and is disabled.

Micro Adjustments

Row, Col, Height, and Width

Make slight adjustments to the size and position of the box. They are entered as a percentage of an image cell (1 row x 1 column) and must be less than or equal to 100.

Finally,

Name

Allows you to “name” the box so it can be controlled (enabled, disabled, etc.) via ILF statements.

Access to the GUI attributes at runtime with ILF code is done via the --- WIDGET file. The WIDGET records from the process are copied into this file and are available in the Pre-Display event point. WIDGET NAME is a key to this file. You can read and rewrite records in this file to affect the GUI attributes at runtime.

When you have finished defining the box you have two options available to you:

• Select the save option on the bottom right corner of the screen to save the definition and return to the Image Editor.
• Or, you can select the cancel option to discard the new definition or changes to an existing definition, and then return to the Image Editor.