Creating Panel Controls

Fonted/Fixed Text Control

 

You may need to add labels or titles to describe how controls are to be used in your panel. This object type is for display purposes only and does not respond to events.

Two text creation tools are available in NOMADS:

Fonted Text

Provides several style options for displaying panel labels in a graphical user interface application, including bold, italics, the "&" accelerator, and color settings.

Fixed Text

(Not Recommended for Graphical User Interface Development)

Limited to the default system font only. For information on text creation in a graphical application, see 'TEXT' mnemonic.

Adding Text

To enter/edit Fonted Text on a panel, select the Fonted Text control tool from the Controls Toolbar, then hold down the left mouse button and drag the mouse to create a rectangle to the desired size. Release the mouse button to create a new text box.

For other adjustments, see Modifying Objects.

To define text attributes, see Text Properties.

To show and hide a Fonted Text control, first assign the control to a group by using the Group Assignment utility. Then, show and hide the group either by using the Dependency Definition utility or by using the following CALL syntax:

call "*wingrp;SHOW",GroupName.grp$
call "*wingrp;HIDE",GroupName.grp$

For more information on *wingrp, see Manipulating and Controlling Groups.

Text Properties

When creating or editing a Fonted Text control, the Fonted Text 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 text properties: Display and Font/Color. Different property descriptions for Fonted and Fixed text are specified where applicable.

Name

Unique name of the text 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 the text. Click the drop-down arrow for a list of selections: Fixed, Expression, Message Library Reference.

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 the control in number of columns - numeric expression. Format mask is #0.00. Valid entries are 0 to 620.

Height

Height of the 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

(Fonted Text Only) Control is not displayed but is accessible programmatically.

Font/Color

Font Specification

Font
Size

(Fonted Text Only) Click the drop-down arrow for a list of selections.

Alignment

Align

(Fonted Text Only) Click the drop-down arrow for a list of selections: Left Justify, Center, Right Justify, Left Top, Left Middle, Left Bottom, Center Top, Center Middle, Center Bottom, Right Top, Right Middle, Right Bottom.

Word Wrap

(Fonted Text Only) Wraps the text.

(Align selections for Left Top, Left Middle, Left Bottom, Center Top, Center Middle, Center Bottom, Right Top, Right Middle and Right Bottom were added in PxPlus 2017.)

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.

(The Color Selections Query button and dialog were added in PxPlus 2020.)

Mnemonics

(Fixed Text Only) Character-based attributes.

Attributes

(Fonted Text Only) Optional attributes.

Visual Class

(Fonted Text Only) 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

(Fonted and Fixed Text) 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.

(The iNomads Class property was added to Fixed Text in PxPlus 2019.)

 

Security

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

Groups

(Fonted Text Only) 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.)