Event-Handler Routines 

Manipulating and Controlling Groups

 

Event handling in NOMADS often requires manipulating groups of panel controls in order to hide/show, disable/enable or lock/unlock them. The *wingrp utility can be used to manipulate groups of controls from within your PxPlus application.

Note:
Similar functionality to *wingrp may also be handled within NOMADS using Dependency Definitions.

Controls that are grouped via NOMADS Group Assignment can be handled as if they were a single unit using the following CALL syntax:

CALL "* wingrp;action", group_name.grp$

Where:

group_name.grp$

Group name with a .grp$ extension. The dollar sign is required.

;action

Label entry point in the *wingrp program indicating which action is to be applied to the specified group:

Hide | Show

Controls visibility of the group of controls

Enable | Disable

Controls access to the (visible) group of controls

Lock | Unlock

Controls access to the group of multi-line fields

UnlockOrEnable | LockOrDisable

Controls access to a group of mixed control types by locking or disabling

If no group_name.grp$ is passed with the CALL statement, the utility returns Error #36: ENTER parameters don't match those of the CALL.

To manipulate all the groups in a NOMADS panel, use the following syntax:

PERFORM "* wingrp;action"

Where:

;action

Label entry point in the *wingrp program indicating which action is to be applied to all groups in the panel:

Hide_All | Show_All

Controls visibility

Enable_All | Disable_All

Controls access