Flash 8 Cookbook

9.7. Making Buttons Respond to Dragging and Releasing Off the Instance

Problem

You want your button to respond when a user clicks on the button and drags off of it and/or when the user releases the button after having dragged off of the button.

Solution

Use the onDragOff( ) and/or onReleaseOutside( ) event handler methods.

Discussion

Although the most common button events are click-and rollover-related events, you can also handle several other kinds of user actions. Among these events are the user actions of clicking on a button and dragging off of it, and clicking on a button, dragging off of it, and then releasing.

In order to understand how and when to use these additional events, consider first that the typical behavior of a button the responds to click releases is as follows: the user clicks on the button, and when they release, the actions are triggered. As long as the user has not yet released the button, they can change their mind by dragging the mouse pointer off the button before releasing it. At that point, when they release, the button actions are not triggered. Normally this is the behavior that you would want from a button. However, in some situations you want to make sure that the actions are also triggered when the user releases the button outside the button instance. For example, if the button is moving on the stage while the user clicks it, it may move out from under the mouse pointer before the user has the opportunity to release. Another good example is when creating ...