Lingo Dictionary > L-N > mouseDownScript

 

mouseDownScript

Syntax

the mouseDownScript

Description

System property; specifies the Lingo that is executed when the mouse button is pressed. The Lingo is written as a string, surrounded by quotation marks and can be a simple statement or a calling script for a handler. The default value is EMPTY, which means that the mouseDownScript property has no Lingo assigned to it.

When the mouse button is pressed and the mouseDownScript property is defined, Lingo executes the instructions specified for the mouseDownScript property first. No other on mouseDown handlers are executed, unless the instructions include the pass command so that the mouseDown message can be passed to other objects in the movie.

Setting the mouseDownScript property performs the same function as the when keyDown then command in earlier versions of Director.

To turn off the instructions you've specified for the mouseDownScript property, use the statement set the mouseDownScript to empty.

This property can be tested and set.

Example

In this statement, when the user clicks the mouse button, the playback head always branches to the next marker in the movie:

the mouseDownScript = "go next"

Example

In this statement, when the user clicks anywhere on the Stage, the computer beeps:

the mouseDownScript = "if the clickOn = 0 then beep"

Example

This statement sets mouseDownScript to the custom handler myCustomHandler. A Lingo custom handler must be enclosed in quotation marks when used with the mouseDownScript property.

the mouseDownScript = "myCustomHandler"

See also

stopEvent, mouseUpScript, on mouseDown (event handler), on mouseUp (event handler)