7.32.1 DEFINE_EVT Parameters

NAME

DESC

OPTIONS

ACCESS

HELP

NAME

NAME is the unique name of an event. The name can be up to 20 characters long.

DESC

Use the DESC parameter to write a brief description for the event. It can be 40 characters long.

OPTIONS

The options parameter can have two values:

*CLEARERRORS or

*NOCLEARERRORS

*CLEARERRORS clears the ShowError states on member forms

 

*NOCLEARERRORS stops the clearing of ShowError states on member forms

 

*CLEARMESSAGES or

*NOCLEARMESSAGES

*CLEARMESSAGES clears messages on the form that is handling the event

 

*NOCLEARMESSAGES stops the clearing of messages on the form that is handling the event

 

The setting of the OPTIONS parameter in the DEFINE_EVT command automatically set the value of the OPTIONS parameters for the EVTROUTINE command handling the event.

ACCESS

This parameter supports one of the options from the list *PUBLIC, *PROTECT and *PRIVATE.

HELP

Use the HELP parameter to write a longer description for an event. The help text can be viewed using the Features option of the Help menu. It can be 250 characters long.