Creating Panel Controls

Box/Frame Control

 

This tool is used to visually group sections of a panel using a Box or Frame object. For example, you can draw a Frame around all the controls used for shipping data, and another Frame around all the controls used for invoicing.

Note:
Frames objects are used for visual cues only. No functionality is associated with them.

For information on defining Frame objects, see 'FRAME' mnemonic.

Drawing a Frame

To draw a Frame around objects on your panel, select the Frame control tool from the Controls Toolbar. Hold down the left mouse button and drag the mouse to create a rectangle to the desired size. Release the mouse button to create the new object.

For making other adjustments, see Modifying Objects.

To define the specific attributes for the new control, see Frame Properties.

Frame Properties

When creating or editing a Frame control, the Box and Frame Properties dialogue (pictured below using the Folder Style version of the NOMADS Panel Designer) is displayed:

This dialogue is divided into the following tabbed panels for viewing and/or changing Box and Frame properties: Display and Font/Color.

Name

Unique name of the Frame object (NOMADS provides a default). Naming conventions for variables apply. Click the Browse Library button to copy parameters from an existing object (via the Library Browse dialogue).

Note:
When a new control name is entered, it will be checked against the Reserved Words list to determine if it is restricted for use as a NOMADS control name. If it is found, a warning message will display.

(User Reserved Words Maintenance was added in PxPlus 2020.)

Preview

Displays how the visible properties of the control will appear at run time.

Display

Text

Set a title/heading for a Frame. Click the drop-down arrow for a list of selections: Fixed, Expression, Message Library Reference.

Note:
If you are running PxPlus version 11 or higher and are using 4D mode to draw controls, the 'FRAME' text color can be changed by setting the FrameTextClr option using either the 'OPTION' mnemonic or the SETDEV directive, as in SETDEV (0) SET "FrameTextClr" TO "xxx" (where xxx is the new value).

Style

Determines beveling style (Fixed value, string Expression). Click the drop-down arrow for a list of selections: 3D Frame, Recessed Frame, Raised Frame, Text Mode.

Position

Column

Starting column for top left corner of the control - numeric expression. Format mask is #0.00. Valid entries are 0 to 620.

Line

Starting line for top left corner of the control - numeric expression. Format mask is #0.00. Valid entries are 0 to 255.

(Support for increased Column and Line maximums was added in PxPlus 2021.)

Size

Width

Width of control in number of columns - numeric expression. Format mask is #0.00. Valid entries are 0 to 620.

Height

Height of control in number of lines - numeric expression. Format mask is #0.00. Valid entries are 0 to 255.

(Support for increased Width and Height maximums was added in PxPlus 2021.)

General Attributes

Initially Hidden

Control is not displayed but is accessible programmatically.

Font/Color

Font Specification

Font
Size

Click the drop-down arrow for a list of selections.

Color

Foreground
Background

Click the Query button to access Color Selections. Valid formats for color selections include predefined system colors (e.g. Light Red), Custom (RGB codes), HTML Hex Color Codes, User Defined colors (e.g. Color17) and string Expressions.

If no text color is set for the frame text color, the default color in '4D' display mode will be Blue, or any other color using SETDEV/'OPTION' and setting "FrameTextClr".

(The Color Selections Query button and dialog were added in PxPlus 2020.)
(Support for '4D' frame text color was added in PxPlus 2021.)

Attributes

Optional attributes.

Visual Class

Assign a visual class to the control.

Click the Visual Class Maintenance button to launch the Visual Classes Maintenance utility for creating or editing visual classes.

To assign visual classes to controls at the library level, see Visual Class Assignment.

Note:
Visual class names that begin with an "*" (asterisk) are pre-defined visual classes used by PVX Plus and may be subject to change without notice.

(The Visual Class Maintenance button was added in PxPlus 2019.)

iNomads Class

Assign an iNomads class to the control. The iNomads class contains class attribute references used when defining the control in the HTML code generated in iNomads. An iNomads class reference must start with an alpha character (A-Z or a-z), followed by any combination of A-Z, a-z, 0-9, underscore or dash. Multiple references may be entered, separated by a space.

For a list of pre-defined classes, see iNomads Classes.

 

Security

Security restrictions. See Restricting Access for information on Object Security Definition.

Groups

Assign the control to a group. See Group Assignment.

Notes

Add notes/comments for the control. Maximum 1024 characters.

(The Notes button was added in PxPlus 2023.)