Lingo Dictionary > O-R > pass |  |

pass

Syntax

    pass

Description

Command; passes an event message to the next location in the message hierarchy and enables execution of more than one handler for a given event.

The Director player for Java supports this command only within `on keyDown` and `on keyUp` handlers attached to editable sprites.

The `pass` command branches to the next location as soon as the command runs. Any Lingo that follows the `pass` command in the handler does not run.

By default, an event message stops at the first location containing a handler for the event, usually at the sprite level.

If you include the `pass` command in a handler, the event is passed to other objects in the hierarchy even though the handler would otherwise intercept the event.

Example

This handler checks the keypresses being entered, and allows them to pass through to the editable text sprite if they are valid characters:

    on keyDown me
    	legalCharacters = "1234567890"
    	if legalCharacters contains the key then
    		pass
    	else
    		beep
    	end if
    end

See also

`stopEvent`