MovieClip class

The MovieClip class lets you use listener callback functions that provide status information while SWF or JPEG files load (download) into movie clips. To use MovieClip features, use MovieClipLoader.loadClip() instead of loadMovie() or MovieClip.loadMovie() to load SWF files.

For more information about the MovieClip class, see the following:

Developing Flash Lite 2.x Applications
Chapter 11, "Working with Movie Clips" in Learning ActionScript 2.0 in Flash
Chapter 2, "ActionScript Classes," in Flash Lite 2.x ActionScript Language Reference

Method summary

The following table lists the methods that are either partially or not supported by the MovieClip class when using ActionScript for Flash Lite 2.x.

Method	Description	Support
`attachAudio()`	Captures and plays local audio from the devices microphone hardware.	Not supported
`getTextSnapshot()`	Returns a TextSnapshot object that contains the text in the static text fields in the specified movie clip.	Not supported
`startDrag()`	Specifies a movie clip as draggable and begins dragging the movie clip. Limitations: Supported if `System.capabilities.hasMouse` or `System.capabilities.hasStylus` are set to `true`.	Partially supported
`stopDrag()`	Stops a `MovieClip.startDrag()` method. A movie clip that was made draggable with `startDrag()` remains draggable until a `stopDrag()` method is added, or until another movie clip becomes draggable. Only one movie clip is draggable at a time. Limitations: Supported if `System.capabilities.hasMouse` or `System.capabilities.hasStylus` are set to `true`.	Partially supported

Property summary

The following table lists the properties that are either partially or not supported by the MovieClip class when using ActionScript for Flash Lite 2.x.

Property	Description	Support
`_droptarget`	Returns the absolute path in slash-syntax notation of the movie clip instance on which this movie clip was dropped. The `_droptarget` property always returns a path that starts with a slash (/). To compare the `_droptarget` property of an instance to a reference, use the `eval()` function to convert the returned value from slash syntax to a dot-syntax reference. Limitations: Supported if `System.capabilities.hasMouse` or `System.capabilities.hasStylus` are set to `true`.	Partially supported
`menu`	Associates the specified ContextMenu object with the movie clip.	Not supported
`_quality`	Sets or retrieves the rendering quality used for a SWF file. Device fonts are always aliased and therefore are unaffected by the `_quality` property.	Partially supported
`trackAsMenu`	A Boolean value that indicates whether other buttons or movie clips can receive mouse release events. The `trackAsMenu` property lets you create menus. You can set the `trackAsMenu` property on any button or movie clip object. If the `trackAsMenu` property does not exist, the default behavior is `false`. Limitations: Supported if `System.capabilities.hasMouse` or `System.capabilities.hasStylus` are set to `true`.	Partially supported
`useHandCursor`	A Boolean value that determines whether the hand icon appears when the mouse rolls over a movie clip.	Not supported
`_xmouse`	Returns the x coordinate of the mouse position. Limitations: Supported if `System.capabilities.hasMouse=true` or `System.capabilities.hasStylus=true`.	Partially supported
`_ymouse`	Returns the y coordinate of the mouse position. Limitations: Supported if `System.capabilities.hasMouse` or `System.capabilities.hasStylus` are set to `true`.	Partially supported

Event summary

The following table lists the event handlers that are partially supported by the MovieClip class when using ActionScript for Flash Lite 2.x.

Event Handler	Description
`onDragOut`	Invoked when the mouse button is pressed and the pointer rolls outside the object. You must define a function that executes when the event handler is invoked. You can define the function on the timeline or in a class file that extends the MovieClip class or is linked to a symbol in the library. Limitations: Supported if `System.capabilities.hasMouse` or `System.capabilities.hasStylus` are set to `true`.
`onDragOver`	Invoked when the pointer is dragged outside and then over the movie clip. You must define a function that executes when the event handler is invoked. You can define the function on the timeline or in a class file that extends the MovieClip class or is linked to a symbol in the library. Limitations: Supported if `System.capabilities.hasMouse` or `System.capabilities.hasStylus` are set to `true`.
`onMouseDown`	Invoked when the left mouse button is pressed. Limitations: Supported if `System.capabilities.hasMouse` or `System.capabilities.hasStylus` are set to `true`.
`onMouseMove`	Invoked every time the mouse moves. Limitations: Supported if `System.capabilities.hasMouse` is set to `true`.
`onMouseUp`	Invoked every time the left mouse button is pressed. Limitations: Supported if `System.capabilities.hasMouse` or `System.capabilities.hasStylus` are set to `true`.
`onReleaseOutside`	Invoked when the mouse button is pressed over a movie clip and released while the pointer is outside the movie clip's area. Limitations: Supported if `System.capabilities.hasMouse` or `System.capabilities.hasStylus` are set to `true`.

View comments on LiveDocs