Lingo Dictionary > L-N > on mouseEnter |  |

on mouseEnter

Syntax

    on mouseEnter
    	statement(s)
    end

Description

System message and event handler; contains statements that run when the mouse pointer first contacts the active area of the sprite. The mouse button does not have to be pressed.

If the sprite is a bitmap cast member with matte ink applied, the active area is the portion of the image that is displayed; otherwise, the active area is the sprite's bounding rectangle.

If used in a behavior, this event is passed the sprite script or frame script reference `me`.

Example

This statement is a simple button behavior that switches the bitmap of the button when the mouse rolls over and then off the button:

    property spriteNum
    on mouseEnter me
    	-- Determine current cast member and switch to next in cast
    	currentMember = sprite(spritenum).member.number
    	sprite(spritenum).member = currentMember + 1
    end
    on mouseLeave me
    	-- Determine current cast member and switch to previous in cast
    	currentMember = sprite(spritenum).member.number
    	sprite(spritenum).member = currentMember - 1
    end

See also

`on mouseLeave`, `on mouseWithin`