OnClipEvent triggers actions defined for a specific instance of a movie clip.

onClipEvent(movieEvent){
// your statements here
}

Movie Event Parameters

A movieEvent is a trigger called an event. When the event takes place, the statements following it within curly braces are executed. Any of the following values can be specified for the movieEvent parameter:

load: The action is initiated as soon as the movie clip is instantiated and appears in the Timeline.

unload: The action is initiated in the first frame after the movie clip is removed from the Timeline. The actions associated with the Unload movie clip event are processed before any actions are attached to the affected frame.

enterFrame: The action is triggered continually at the frame rate of the movie clip. The actions associated with the enterFrame clip event are processed before any frame actions that are attached to the affected frames.

mouseMove: The action is initiated every time the mouse is moved. Use the _xmouse and _ymouse properties to determine the current mouse position.

mouseDown: The action is initiated when the left mouse button is pressed.

mouseUp: The action is initiated when the left mouse button is released.

keyDown: The action is initiated when a key is pressed. Use Key.getCode() to retrieve information about the last key pressed.

keyUp: The action is initiated when a key is released. Use the Key.getCode() method to retrieve information about the last key pressed.

data: The action is initiated when data is received in a loadVariables() or loadMovie() action. When specified with a loadVariables() action, the data event occurs only once, when the last variable is loaded. When specified with a loadMovie() action, the data event occurs repeatedly, as each section of data is retrieved.

OnClipEvent example: you could attach the following onClipEvent() handlers to the same movie clip instance. The first executes when the movie clip first loads (or appears on the Stage); the second executes when the movie clip is unloaded from the Stage.

onClipEvent(load) {
trace("I've loaded");
}
onClipEvent (unload) {
trace("I've unloaded");
}

note: you can attach onClipEvent() to movie clip instances that have been placed on the Stage during authoring. You cannot attach onClipEvent() to movie clip instances that are created at runtime (using the attachMovie() method, for example).

download the onclipevent tutorial (file name: 9onclipe.fla)
right click on the file (control-click for Mac) and select to download to your drive.