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 and 3.0 Applications
- Chapter 11, "Working with Movie Clips," in Learning ActionScript 2.0 in Flash
- Chapter 2, "ActionScript Classes," in Flash Lite 2.x and 3.0 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 and later.
|
Method |
Description |
Support |
|---|---|---|
| attachAudio() |
Captures and plays local audio from the device's 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 is 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 is 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 and later.
|
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 is 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 is 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 or System.capabilities.hasStylus is set to true. |
Partially supported |
| _ymouse |
Returns the y coordinate of the mouse position. Limitations: Supported if System.capabilities.hasMouse or System.capabilities.hasStylus is 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 and later.
|
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 is 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 is set to true. |
| onMouseDown |
Invoked when the left mouse button is pressed. Limitations: Supported if System.capabilities.hasMouse or System.capabilities.hasStylus is 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 is 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 is set to true. |
Send me an e-mail when comments are added to this page | Comment Report