Quit event handler

Command group Flag affected Reversible Execute on client Platform(s)

Events NO NO YES All

Syntax

Quit event handler

([

Discard event

][,

Pass to next handler

])

Options

Discard event	If specified,Omnis discards the active event (meaning that no further processing will occur for that event)
Pass to next handler	If specified,Omnis will pass the event to the next level of handler (the window or task $control() method)

Description

This command is used to quit out of the currently executing event handling method and is only used to terminate an On clause. It is not reversible and does not affect the flag.

If the Discard event option is checked, the event is thrown away and Omnis quits the event handling method.

If the Pass to next handler option is checked, the event is passed to the next level of handler such as the window $control() method or task $control() method.

Example

On 
evAfter

  
If 
iName
=
''

    
OK message 
{
You must enter a name
}

    
Queue set current field 
myField

    
Quit event handler
 (
Discard event
)

  
End If
  

  
# $event for a window field, to pass all events to the window $control() method

On default
  
Quit event handler
 (
Pass to next handler
)

Command group	Flag affected	Reversible	Execute on client	Platform(s)
Events	NO	NO	YES	All