ActionScript for Flash MX: The Definitive Guide, Second Edition

Button.onKillFocus() Event Handler

This is the Title of the Book, eMatter Edition

Copyright © 2007 O’Reilly & Associates, Inc. All rights reserved.

Alphabetical Language Reference

|

465

Button.onDragOver() Event Handler

occurs when the depressed mouse rolls off and back onto a Flash button

Flash 6; on (dragOver) supported since Flash 2

theButton.onDragOver()

on (dragOver) {

statements

}

Description

The onDragOver() event handler is a seldom-seen woodland creature. It is conjured up

when the following sequence is performed:

1. The mouse pointer moves into the hit area of a button (onRollOver() event occurs).

2. The primary mouse button is pressed and held (onPress() event occurs).

3. The mouse pointer moves out of the button’s hit area (onDragOut() event occurs).

4. The mouse pointer moves back into the button’s hit area (onDragOver() event occurs).

Thus, the dragOver event indicates that the user has moved the mouse pointer out of and

back into the hit area, all the while holding down the mouse button. Note that dragOver,

instead of the rollOver event, is generated if the mouse button is still down when the

pointer reenters the button’s hit area.

Example

cancel_btn.onDragOver = function () {

// Handle event...

trace("dragOver detected");

};

See Also

Button.onDragOut(), Button.onRollOver(), MovieClip.onDragOver(); Chapter 10

Button.onKillFocus() Event Handler

callback invoked when the button loses focus

Flash ...