Grid Control 

Grid Properties

 

When creating or editing a Grid control, the Grid Properties dialogue (pictured below using the Folder Style version of the NOMADS designer) is displayed:

This dialogue is divided into the following tabbed panels for viewing and/or changing Grid properties: Display, Font/Color, Attributes, Logic, User Aids, Presets, Cell Logic and Query.

Name

Unique name of the Grid control (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.)

Class

Used with NOMADS Object-Oriented Programming. Click the Query button (binoculars) to select a predefined class.

Preview

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

Display

Position

Column

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

Line

Starting line for the 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.)

Attributes

Optional attributes for Tab Stop, Initially Hidden and Initially Disabled. See Attributes.

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.

Fill Color

Defines the color to be used to fill in the empty regions of a Grid (blank space to the right and below the Grid). Click the Query button to access color selections.

Line Color

Color of the lines drawn between rows and columns of a Grid. Click the Query button to access color selections.

(The Line Color property, the Color Selections Query button and Color Selections dialog were added in PxPlus 2020.)

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.

Attributes

Attributes

Tab Stop

Adds the control to the tab order list. Allows use of the Tab key for moving to the control.

Auto Tab Skip

Control is skipped when tabbing forward but is still accessible via Shift - Tab or the mouse.

Initially Disabled

Control region is grayed out and is not accessible to the user for input. The control is accessible programmatically.

Initially Hidden

Control is not displayed but is accessible programmatically.

Borderless

The control is drawn with no border or frame.

Strip Trailing Spaces

Strip trailing spaces when reading/writing data.

Signal On Exit

A signal is generated when focus leaves the control whether the selection or value has changed or not. NOMADS will execute the On Change logic.

Enable Scrolling

Allows control to scroll in a resizable/scrollable dialogue box. See Panel Resizing.

Grid Lines

Excel type grid: Off = No grid lines, On = Lines.

Resizable

The user is able to resize grid columns or rows.

Automatic (Signal All Changes)

A signal is returned on any changes in the control.

Row Refresh

NOMADS will read and update the contents of a row using column names (via 'RowData$ and 'LoadIOList$ properties).

Note:
Turning on this property will disable the No Cell Refresh property.

No Cell Refresh

NOMADS will not update a cell using the value in the control name; i.e. it will not issue a GRID WRITE.

Ignore Change Flag

Select this check box when you do not want the NOMADS CHANGE_FLG variable to be updated when the control value is changed.

Format

Button that launches the Grid Format Definition dialogue for defining Grid columns, including title, width, alignment, cell type, column name and column separator. See Formatting a Grid.

(The Ignore Change Flag property was added in PxPlus 2017.)

Load Options

Smart Load
(formerly Auto Load)

Select this button to set up a Smart control that will self-load based on a query definition. See Smart Controls.

Background Loading

Load logic to execute while there is no user input. Select Background Loading and then click the Logic button to add/edit logic. See Background Loading.

Note:
Smart controls are not compatible with Background Loading logic.

(Support for enhanced Smart Load capability was added in PxPlus 2018.)

Other

Alt-Key

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

User-Defined Tag Field

For controls, data/tag field which can be used to pass information on such things as formatting, error messages or validation rules. Field contents are placed in a variable using the control name with a .TAG$ extension.

Object Persistence

Sets Object Persistence. Object size, location and format information (if applicable) is saved on termination of a panel and restored the next time the control is drawn. Click the drop-down arrow for a list of selections:

Default

Set via global variable

Always

On, overriding global activation

Never

Off, overriding global activation

Logic

Default Program

Displays the name of the Default Program used in the Panel Header definition.

(The Default Program was added for display in PxPlus 2019.)

Post Create

Logic to be processed after the control is drawn. Click the drop-down arrow for a list of selections. See Events Logic.

Click the Program Logic button beside the Perform or Call action to launch the default program editor, which is typically the *IT - Integrated Toolkit. To make Ed+ the default program editor, change the setting for the %NOMADS'Program_Editor property to Ed+.

(The ability to set Ed+ as the default program editor was added in PxPlus 2023.)

When Receiving Focus

Logic to execute when the control receives focus. Click the drop-down arrow for a list of selections. See Events Logic.

Click the Program Logic button beside the Perform or Call action to launch the default program editor, which is typically the *IT - Integrated Toolkit. To make Ed+ the default program editor, change the setting for the %NOMADS'Program_Editor property to Ed+.

(The ability to set Ed+ as the default program editor was added in PxPlus 2023.)

On Change

Logic to be executed when focus leaves the control or the state of the control has changed. Click the drop-down arrow for a list of selections. See Events Logic.

Click the Program Logic button beside the Perform or Call action to launch the default program editor, which is typically the *IT - Integrated Toolkit. To make Ed+ the default program editor, change the setting for the %NOMADS'Program_Editor property to Ed+.

(The ability to set Ed+ as the default program editor was added in PxPlus 2023.)

User Aids

Help Reference

Help text to be invoked at run time by pressing Shift - F1 while focus is on a control.

Type

Select from External or Internal help types:

External

(Default) Standard Windows help system consisting of a help File Name (.html, .hlp, .doc, etc.) and an optional Keyword or Reference number (Fixed value or string Expression).

Internal

Application supplied message text (Fixed value, string Expression or Message Library Reference).

File Name

Name of the help file.

Keyword

Indicates that the text in the adjacent field is the index entry for the topic in the indicated help file.

Reference

Indicates that the adjacent field contains the reference number for a specific topic in the context sensitive help.

Popup

Select this check box to display the help topic as a popup rather than as an independent window.

Test

Tests the current help settings.

Floating Tip

Mouse pointer message for the control (Fixed value, string Expression or Message Library Reference).

You can customize the floating tip by adding a tip title, descriptive tip text and a hyperlink. These features enhance the visual display and functionality of the tip by providing users with much needed information at their fingertips. You can define either a Standard tip or an HTML tip that provides a simplified HTML Editor for customizing the tip text. To do this, click the button to the right of the Floating Tip multi-line input to invoke the Define Info Tip dialogue. See Defining an Info Tip.

Note:
The Floating Tip drop box and multi-line input cannot be changed once an HTML tip has been defined.

NOMADS Wiki Help

The floating tip text can be used when displaying the Wiki Help. Info tips, however, are not supported and will be ignored.

(Support for customizing Floating Tips was added in PxPlus 2016.)
(Support for the use of Floating Tip text in the Wiki Help was added in PxPlus 2023.)

Message Bar

Text to be displayed in the panel's status bar when focus is on the control (Fixed value, string Expression or Message Library Reference).

Presets

 

Set up attributes that will be assigned to columns, rows or individual cells. See Presets Definition.

For a list of available properties that can be applied to the entire grid, a cell, column or row, see Grid Properties.

  

(New Grid preset functionality and usability enhancements were added in PxPlus 2019.)

Cell Logic

 

Assign logic that is specific to a particular cell, column, or row. Logic events - On Focus, On Change, Formatting and Validation. See Independent Cell or Row Logic.

Query

Query Type

Type of query to associate to the control: Panel, Query Program, Non-Query Logic. Valid formats include a NOMADS query object or query list, a custom query panel, or user-supplied query program.

Depending on the Query Type selected, different information is entered. For an explanation of each type and the information to enter, see Query Type

If setting up the Grid as a Smart control (see Smart Load attribute above), you can define a query for the Smart control. See Defining Smart Controls.

 

Security

Assign security classifications and access levels. See Restricting Access for information on Object Security Definition.

Groups

Assign the control to a group. See Group Assignment.

Popup Menu

Associate a popup menu that will appear when you right-click the mouse over the selected control.

To define a popup menu, see Popup Menu.

To add a system popup menu to any Grid, see List Box and Grid System Popup Menu.

Notes

Add notes/comments for the control. Maximum 1024 characters. These notes also display in the Wiki Help documentation for the panel. See NOMADS Wiki Help.

(The Notes button was added in PxPlus 2023.)

See Also

GRID Properties
GRID Directive