# 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