| 附录 | 约定 | 帧
| 包 | flash.display |
| 类 | public dynamic class MovieClip |
| 继承 | MovieClip  Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
| 子类 | LivePreviewParent |
| 语言版本 : | ActionScript 3.0 |
| Player 版本 : | Flash Player 9 |
不同于 Sprite 对象，MovieClip 对象拥有一个时间轴。
MovieClip 类的方法提供的功能与定位影片剪辑的动作所提供的功能相同。 还有一些其它方法在 Flash 创作工具的“动作”面板中的“动作”工具箱中没有等效动作。
如果修改包含补间动画的 MovieClip 对象的下列任一属性，Flash Player 便会停止该 MovieClip 对象中的播放头：alpha、blendMode、filters、height、opaqueBackground、rotation、scaleX、scaleY、scale9Grid、scrollRect、transform、visible、width、x 或 y。 但是，它不会停止在该 MovieClip 对象的任何子 MovieClip 对象中的播放头。
另请参见
| 属性 | 定义方 | ||
|---|---|---|---|
 | accessibilityProperties : AccessibilityProperties
此显示对象的当前辅助功能选项。
| DisplayObject | |
| alpha : Number
指示指定对象的 Alpha 透明度值。
| DisplayObject | |
| blendMode : String
BlendMode 类中的一个值，用于指定要使用的混合模式。
| DisplayObject | |
| buttonMode : Boolean
指定此 sprite 的按钮模式。
| Sprite | |
| cacheAsBitmap : Boolean
如果设置为 true，则 Flash Player 将缓存显示对象的内部位图表示形式。
| DisplayObject | |
| constructor : Object
对类对象或给定对象实例的构造函数的引用。
| Object | |
| contextMenu : ContextMenu
指定与此对象相关联的上下文菜单。
| InteractiveObject | |
| currentFrame : int
[read-only]
指定播放头在 MovieClip 实例的时间轴中所处的帧的编号。
| MovieClip | ||
| currentLabel : String
[read-only]
在 MovieClip 实例的时间轴中播放头所在的当前标签。
| MovieClip | ||
| currentLabels : Array
[read-only]
返回由当前场景的 FrameLabel 对象组成的数组。
| MovieClip | ||
| currentScene : Scene
[read-only]
在 MovieClip 实例的时间轴中播放头所在的当前场景。
| MovieClip | ||
| doubleClickEnabled : Boolean
指定此对象是否接收 doubleClick 事件。
| InteractiveObject | |
| dropTarget : DisplayObject
[read-only]
指定拖动 sprite 时经过的显示对象，或放置 sprite 的显示对象。
| Sprite | |
| enabled : Boolean
一个布尔值，指示影片剪辑是否处于活动状态。
| MovieClip | ||
| filters : Array
包含当前与显示对象关联的每个滤镜对象的索引数组。
| DisplayObject | |
| focusRect : Object
指定此对象是否显示焦点矩形。
| InteractiveObject | |
| framesLoaded : int
[read-only]
从流式 SWF 文件加载的帧数。
| MovieClip | ||
| graphics : Graphics
[read-only]
指定属于此 sprite 的 Graphics 对象，在此 sprite 中可执行矢量绘画命令。
| Sprite | |
| height : Number
指示显示对象的高度，以像素为单位。
| DisplayObject | |
| hitArea : Sprite
指定一个 sprite 用作另一个 sprite 的点击区域。
| Sprite | |
| loaderInfo : LoaderInfo
[read-only]
返回一个 LoaderInfo 对象，其中包含加载此显示对象所属的文件的相关信息。
| DisplayObject | |
| mask : DisplayObject
调用显示对象被指定的 mask 对象遮罩。
| DisplayObject | |
| mouseChildren : Boolean
确定对象的子项是否支持鼠标。
| DisplayObjectContainer | |
| mouseEnabled : Boolean
指定此对象是否接收鼠标消息。
| InteractiveObject | |
| mouseX : Number
[read-only]
指示鼠标位置的 x 坐标，以像素为单位。
| DisplayObject | |
| mouseY : Number
[read-only]
指示鼠标位置的 y 坐标，以像素为单位。
| DisplayObject | |
| name : String
指示 DisplayObject 的实例名称。
| DisplayObject | |
| numChildren : int
[read-only]
返回此对象的子项数目。
| DisplayObjectContainer | |
| opaqueBackground : Object
指定显示对象是否由于具有某种背景颜色而不透明。
| DisplayObject | |
| parent : DisplayObjectContainer
[read-only]
指示包含此显示对象的 DisplayObjectContainer 对象。
| DisplayObject | |
| prototype : Object
[static]
对类或函数对象的原型对象的引用。
| Object | |
| root : DisplayObject
[read-only]
对于加载的 SWF 文件中的显示对象，root 属性是此 SWF 文件所表示的显示列表树结构部分中的顶级显示对象。
| DisplayObject | |
| rotation : Number
指示 DisplayObject 实例距其原始方向的旋转程度，以度为单位。
| DisplayObject | |
| scale9Grid : Rectangle
当前有效的缩放网格。
| DisplayObject | |
| scaleX : Number
指示从注册点开始应用的对象的水平缩放比例（百分比）。
| DisplayObject | |
| scaleY : Number
指示从对象注册点开始应用的对象的垂直缩放比例（百分比）。
| DisplayObject | |
| scenes : Array
[read-only]
一个由 Scene 对象组成的数组，每个对象都列出了 MovieClip 实例中场景的名称、帧数和帧标签。
| MovieClip | ||
| scrollRect : Rectangle
显示对象的滚动矩形范围。
| DisplayObject | |
| soundTransform : SoundTransform
控制此 sprite 中的声音。
| Sprite | |
| stage : Stage
[read-only]
显示对象的舞台。
| DisplayObject | |
| tabChildren : Boolean
确定对象的子项是否支持 Tab 键。
| DisplayObjectContainer | |
| tabEnabled : Boolean
指定此对象是否遵循 Tab 键顺序。
| InteractiveObject | |
| tabIndex : int
指定 SWF 文件中的对象按 Tab 键顺序排列。
| InteractiveObject | |
| textSnapshot : TextSnapshot
[read-only]
返回此 DisplayObjectContainer 实例的 TextSnapshot 对象。
| DisplayObjectContainer | |
| totalFrames : int
[read-only]
MovieClip 实例中帧的总数。
| MovieClip | ||
| trackAsMenu : Boolean
指示属于 SimpleButton 或 MovieClip 对象的其它显示对象是否可以接收鼠标释放事件。
| MovieClip | ||
| transform : Transform
一个对象，具有与显示对象的矩阵、颜色转换和像素范围有关的属性。
| DisplayObject | |
| useHandCursor : Boolean
布尔值，指示当鼠标滑过其 buttonMode 属性设置为 true 的 sprite 时是否显示手指形（手形光标）。
| Sprite | |
| visible : Boolean
显示对象是否可见。
| DisplayObject | |
| width : Number
指示显示对象的宽度，以像素为单位。
| DisplayObject | |
| x : Number
指示 DisplayObject 实例相对于父级 DisplayObjectContainer 本地坐标的 x 坐标。
| DisplayObject | |
| y : Number
指示 DisplayObject 实例相对于父级 DisplayObjectContainer 本地坐标的 y 坐标。
| DisplayObject | |
| 方法 | 定义方 | ||
|---|---|---|---|
|
创建新的 MovieClip 实例。
| MovieClip | ||
|
将一个 DisplayObject 子实例添加到该 DisplayObjectContainer 实例中。
| DisplayObjectContainer | |
|
将一个 DisplayObject 子实例添加到该 DisplayObjectContainer 实例中。
| DisplayObjectContainer | |
|
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。
| EventDispatcher | |
|
指示安全限制是否会导致出现以下情况：在列表中忽略了使用指定 point 点调用 DisplayObjectContainer.getObjectsUnderPoint() 方法时返回的所有显示对象。
| DisplayObjectContainer | |
|
确定指定显示对象是 DisplayObjectContainer 实例的子项还是该实例本身。
| DisplayObjectContainer | |
|
将事件调度到事件流中。
| EventDispatcher | |
|
返回一个矩形，该矩形定义相对于 targetCoordinateSpace 对象坐标系的显示对象区域。
| DisplayObject | |
|
返回位于指定索引处的子显示对象实例。
| DisplayObjectContainer | |
|
返回具有指定名称的子显示对象。
| DisplayObjectContainer | |
|
返回 DisplayObject 的 child 实例的索引位置。
| DisplayObjectContainer | |
|
返回对象的数组，这些对象位于指定点下，并且是该 DisplayObjectContainer 实例的子项（或孙子项，依此类推）。
| DisplayObjectContainer | |
|
返回一个矩形，该矩形根据 targetCoordinateSpace 参数定义的坐标系定义显示对象的边界，但不包括形状上的任何笔触。
| DisplayObject | |
|
将 point 对象从舞台（全局）坐标转换为显示对象的（本地）坐标。
| DisplayObject | |
|
从指定帧开始播放 SWF 文件。
| MovieClip | ||
|
将播放头移到影片剪辑的指定帧并停在那里。
| MovieClip | ||
|
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。
| EventDispatcher | |
|
指示对象是否已经定义了指定的属性。
| Object | |
|
计算显示对象，以确定它是否与 obj 显示对象重叠或相交。
| DisplayObject | |
|
计算显示对象，以确定它是否与 x 和 y 参数指定的点重叠或相交。
| DisplayObject | |
|
指示 Object 类的实例是否在指定为参数的对象的原型链中。
| Object | |
|
将 point 对象从显示对象的（本地）坐标转换为舞台（全局）坐标。
| DisplayObject | |
|
将播放头转到下一帧并停止。
| MovieClip | ||
|
将播放头移动到 MovieClip 实例的下一场景。
| MovieClip | ||
|
在影片剪辑的时间轴中移动播放头。
| MovieClip | ||
|
将播放头转到前一帧并停止。
| MovieClip | ||
|
将播放头移动到 MovieClip 实例的前一场景。
| MovieClip | ||
|
指示指定的属性是否存在、是否可枚举。
| Object | |
|
从 DisplayObjectContainer 实例的子列表中删除指定的 child DisplayObject 实例。
| DisplayObjectContainer | |
|
从 DisplayObjectContainer 的子列表中指定的 index 位置删除子 DisplayObject。
| DisplayObjectContainer | |
|
从 EventDispatcher 对象中删除侦听器。
| EventDispatcher | |
|
更改现有子项在显示对象容器中的位置。
| DisplayObjectContainer | |
|
设置循环操作动态属性的可用性。
| Object | |
|
允许用户拖动指定的 Sprite。
| Sprite | |
|
停止影片剪辑中的播放头。
| MovieClip | ||
|
结束 startDrag() 方法。
| Sprite | |
|
交换两个指定子对象的 Z 轴顺序（从前到后顺序）。
| DisplayObjectContainer | |
|
在子级列表中两个指定的索引位置，交换子对象的 Z 轴顺序（前后顺序）。
| DisplayObjectContainer | |
|
返回指定对象的字符串表示形式。
| Object | |
|
返回指定对象的原始值。
| Object | |
|
检查是否用此 EventDispatcher 对象或其任何始祖为指定事件类型注册了事件侦听器。
| EventDispatcher | |
| currentFrame | 属性 |
隐藏继承的公共属性
显示继承的公共属性currentFrame:int [read-only]
| 语言版本 : | ActionScript 3.0 |
| Player 版本 : | Flash Player 9 |
指定播放头在 MovieClip 实例的时间轴中所处的帧的编号。 如果影片剪辑有多个场景，该值是当前场景中的帧编号。
public function get currentFrame():int
gotoAndStop() 方法和 currentFrame 属性指示 mc1 影片剪辑的播放头从其当前位置前进 5 帧并停止：
mc1.gotoAndStop(mc1.currentFrame + 5);
| currentLabel | 属性 |
currentLabel:String [read-only]
| 语言版本 : | ActionScript 3.0 |
| Player 版本 : | Flash Player 9 |
在 MovieClip 实例的时间轴中播放头所在的当前标签。 如果当前帧没有标签，currentLabel 将被设置为包含标签的先前帧的名称。 如果当前帧和先前帧都不包含标签，currentLabel 返回 null。
public function get currentLabel():String
mc1 的 MovieClip 对象的 currentLabel 属性：
trace(mc1.currentLabel);
| currentLabels | 属性 |
currentLabels:Array [read-only]
| 语言版本 : | ActionScript 3.0 |
| Player 版本 : | Flash Player 9 |
返回由当前场景的 FrameLabel 对象组成的数组。 如果 MovieClip 实例不使用场景，数组会包括整个 MovieClip 实例的所有帧标签。
public function get currentLabels():Array
另请参见
mc1 的 MovieClip 对象的 currentLabels 属性：
import flash.display.FrameLabel;
var labels:Array = mc1.currentLabels;
for (var i:uint = 0; i < labels.length; i++) {
var label:FrameLabel = labels[i];
trace("frame " + label.frame + ": " + label.name);
}| currentScene | 属性 |
currentScene:Scene [read-only]
| 语言版本 : | ActionScript 3.0 |
| Player 版本 : | Flash Player 9 |
在 MovieClip 实例的时间轴中播放头所在的当前场景。
public function get currentScene():Scene
另请参见
mc1 的 MovieClip 对象的 currentScene 属性：
import flash.display.Scene; var scene:Scene = mc1.currentScene; trace(scene.name + ": " + scene.numFrames + " frames");
| enabled | 属性 |
enabled:Boolean [read-write]
| 语言版本 : | ActionScript 3.0 |
| Player 版本 : | Flash Player 9 |
一个布尔值，指示影片剪辑是否处于活动状态。 enabled 的默认值是 true。 如果将 enabled 设置为 false，则会禁用影片剪辑的 Over、Down 和 Up 帧。 影片剪辑会继续接收事件（例如 mouseDown、mouseUp、keyDown 和 keyUp）。
enabled 属性仅控制影片剪辑的按钮式属性。 可以随时更改 enabled 属性；修改后的影片剪辑将被立即启用或禁用。 如果将 enabled 属性设置为 false，则该对象将不包含在 Tab 键的自动排序中。
public function get enabled():Boolean
public function set enabled(value:Boolean):void
enabled 属性来禁用名为 mc1 的 MovieClip 对象的按钮式属性：
mc1.enabled = false;
| framesLoaded | 属性 |
framesLoaded:int [read-only]
| 语言版本 : | ActionScript 3.0 |
| Player 版本 : | Flash Player 9 |
从流式 SWF 文件加载的帧数。 可以使用 frameLoaded 属性来确定特定帧及其前面所有帧的内容是否已经加载，并且是否可在浏览器本地使用。 可以使用它监视大 SWF 文件的下载。 例如，可能需要向用户显示一条消息以表明在完成 SWF 文件中指定帧的加载前，SWF 文件将会一直进行加载。
如果影片剪辑包含多个场景，framesLoaded 属性会返回为影片剪辑中所有 场景加载的帧数。
public function get framesLoaded():int
另请参见
framesLoaded 属性和 totalFrames 属性来确定名为 mc1 的流式 MovieClip 对象是否已完全加载：
if (mc1.framesLoaded == mc1.totalFrames) {
trace("OK.");
}| scenes | 属性 |
scenes:Array [read-only]
| 语言版本 : | ActionScript 3.0 |
| Player 版本 : | Flash Player 9 |
一个由 Scene 对象组成的数组，每个对象都列出了 MovieClip 实例中场景的名称、帧数和帧标签。
public function get scenes():Array
另请参见
mc1 的 MovieClip 对象的 scenes 属性：
import flash.display.Scene;
for (var i:uint = 0; i < mc1.scenes.length; i++) {
var scene:Scene = mc1.scenes[i];
trace("scene " + scene.name + ": " + scene.numFrames + " frames");
}| totalFrames | 属性 |
totalFrames:int [read-only]
| 语言版本 : | ActionScript 3.0 |
| Player 版本 : | Flash Player 9 |
MovieClip 实例中帧的总数。
如果影片剪辑包含多个帧，totalFrames 属性会返回影片剪辑中的所有 场景中的帧的总数。
public function get totalFrames():int
mc1 的 MovieClip 对象的 totalFrames 属性：
trace(mc1.totalFrames);
| trackAsMenu | 属性 |
trackAsMenu:Boolean [read-write]
| 语言版本 : | ActionScript 3.0 |
| Player 版本 : | Flash Player 9 |
指示属于 SimpleButton 或 MovieClip 对象的其它显示对象是否可以接收鼠标释放事件。 trackAsMenu 属性允许您创建菜单。 可以对任何 SimpleButton 或 MovieClip 对象设置 trackAsMenu 属性。 trackAsMenu 属性的默认值是 false。
可以随时更改 trackAsMenu 属性；修改后的影片剪辑会立即使用新的行为。
public function get trackAsMenu():Boolean
public function set trackAsMenu(value:Boolean):void
trackAsMenu 属性来启用名为 mc1 的 MovieClip 对象的鼠标释放事件：
mc1.trackAsMenu = true;
| MovieClip | () | 构造函数 |
public function MovieClip()
| 语言版本 : | ActionScript 3.0 |
| Player 版本 : | Flash Player 9 |
创建新的 MovieClip 实例。 创建 MovieClip 之后，调用舞台上的显示对象容器的 addChild() 或 addChildAt() 方法。
| gotoAndPlay | () | 方法 |
public function gotoAndPlay(frame:Object, scene:String = null):void
| 语言版本 : | ActionScript 3.0 |
| Player 版本 : | Flash Player 9 |
从指定帧开始播放 SWF 文件。 这会在帧中的所有剩余动作执行完毕后发生。 要指定场景以及帧，请指定 scene 参数的值。
参数
frame:Object — 表示播放头转到的帧编号的数字，或者表示播放头转到的帧标签的字符串。 如果您指定了一个数字，则该数字是相对于您指定的场景的。 如果不指定场景，Flash Player 使用当前场景来确定要播放的全局帧编号。 如果指定场景，播放头会跳到指定场景的帧编号。
|
|
scene:String (default = null) |
gotoAndPlay() 方法指示 mc1 影片剪辑的播放头从其当前位置前进 5 帧：
mc1.gotoAndPlay(mc1.currentFrame + 5);
gotoAndPlay() 方法指示 mc1 影片剪辑的播放头移到名为 "Scene 12" 的场景中标记为 "intro" 的帧：
mc1.gotoAndPlay("intro", "Scene 12");| gotoAndStop | () | 方法 |
public function gotoAndStop(frame:Object, scene:String = null):void
| 语言版本 : | ActionScript 3.0 |
| Player 版本 : | Flash Player 9 |
将播放头移到影片剪辑的指定帧并停在那里。 这会在帧中的所有剩余动作执行完毕后发生。 如果除了指定帧以外，您还希望指定场景，那么请指定 scene 参数。
参数
frame:Object — 表示播放头转到的帧编号的数字，或者表示播放头转到的帧标签的字符串。 如果您指定了一个数字，则该数字是相对于您指定的场景的。 如果不指定场景，Flash Player 使用当前场景来确定转到其处并停止的全局帧编号。 如果指定了场景，播放头会转到指定场景中的帧编号并停止。
|
|
scene:String (default = null) |
ArgumentError — 如果未在该影片剪辑中找到指定的 scene 或 frame。
|
gotoAndStop() 方法和 currentFrame 属性指示 mc1 影片剪辑的播放头从其当前位置前进 5 帧并停止：
mc1.gotoAndStop(mc1.currentFrame + 5);
gotoAndStop() 指示 mc1 影片剪辑的播放头移到名为 "Scene 12" 的场景中标记为 "finale" 的帧并停止播放头：
mc1.gotoAndStop("finale", "Scene 12");| nextFrame | () | 方法 |
public function nextFrame():void
| 语言版本 : | ActionScript 3.0 |
| Player 版本 : | Flash Player 9 |
将播放头转到下一帧并停止。 这会在帧中的所有剩余动作执行完毕后发生。
另请参见
prev 按钮将播放头移动到前一帧，nextBtn 按钮将播放头移动到下一帧：
import flash.events.MouseEvent;
mc1.stop();
prevBtn.addEventListener(MouseEvent.CLICK, goBack);
nextBtn.addEventListener(MouseEvent.CLICK, goForward);
function goBack(event:MouseEvent):void {
mc1.prevFrame();
}
function goForward(event:MouseEvent):void {
mc1.nextFrame();
}| nextScene | () | 方法 |
public function nextScene():void
| 语言版本 : | ActionScript 3.0 |
| Player 版本 : | Flash Player 9 |
将播放头移动到 MovieClip 实例的下一场景。 这会在帧中的所有剩余动作执行完毕后发生。
prevBtn 按钮将播放头移动到前一场景，nextBtn 按钮将播放头移动到下一场景：
import flash.events.MouseEvent;
mc1.stop();
prevBtn.addEventListener(MouseEvent.CLICK, goBack);
nextBtn.addEventListener(MouseEvent.CLICK, goForward);
function goBack(event:MouseEvent):void {
mc1.prevScene();
}
function goForward(event:MouseEvent):void {
mc1.nextScene();
}| play | () | 方法 |
public function play():void
| 语言版本 : | ActionScript 3.0 |
| Player 版本 : | Flash Player 9 |
在影片剪辑的时间轴中移动播放头。
另请参见
stop() 方法来停止名为 mc1 的影片剪辑，并在用户单击名为 continueText 的文本字段时恢复播放：
import flash.text.TextField;
import flash.events.MouseEvent;
var continueText:TextField = new TextField();
continueText.text = "Play movie...";
addChild(continueText);
mc1.stop();
continueText.addEventListener(MouseEvent.CLICK, resumeMovie);
function resumeMovie(event:MouseEvent):void {
mc1.play();
}| prevFrame | () | 方法 |
public function prevFrame():void
| 语言版本 : | ActionScript 3.0 |
| Player 版本 : | Flash Player 9 |
将播放头转到前一帧并停止。 这会在帧中的所有剩余动作执行完毕后发生。
prev 按钮将播放头移动到前一帧，nextBtn 按钮将播放头移动到下一帧：
import flash.events.MouseEvent;
mc1.stop();
prevBtn.addEventListener(MouseEvent.CLICK, goBack);
nextBtn.addEventListener(MouseEvent.CLICK, goForward);
function goBack(event:MouseEvent):void {
mc1.prevFrame();
}
function goForward(event:MouseEvent):void {
mc1.nextFrame();
}| prevScene | () | 方法 |
public function prevScene():void
| 语言版本 : | ActionScript 3.0 |
| Player 版本 : | Flash Player 9 |
将播放头移动到 MovieClip 实例的前一场景。 这会在帧中的所有剩余动作执行完毕后发生。
prevBtn 按钮将播放头移动到前一场景，nextBtn 按钮将播放头移动到下一场景：
import flash.events.MouseEvent;
mc1.stop();
prevBtn.addEventListener(MouseEvent.CLICK, goBack);
nextBtn.addEventListener(MouseEvent.CLICK, goForward);
function goBack(event:MouseEvent):void {
mc1.prevScene();
}
function goForward(event:MouseEvent):void {
mc1.nextScene();
}| stop | () | 方法 |
getPropertiesString() 方法的返回值用作 outputText 文本字段的文本。 getPropertiesString() 方法返回一个使用影片剪辑的以下属性值填充的字符串：currentFrame、currentLabel、currentScene、framesLoaded、totalFrames 和 trackAsMenu。outputText 文本字段的 width 和 height 属性。outputText 文本字段添加到显示列表。
package {
import flash.display.MovieClip;
import flash.text.TextField;
public class MovieClipExample extends MovieClip {
public function MovieClipExample() {
var outputText:TextField = new TextField();
outputText.text = getPropertiesString();
outputText.width = stage.stageWidth;
outputText.height = outputText.textHeight;
addChild(outputText);
}
private function getPropertiesString():String {
var str:String = ""
+ "currentFrame: " + currentFrame + "\n"
+ "currentLabel: " + currentLabel + "\n"
+ "currentScene: " + currentScene + "\n"
+ "framesLoaded: " + framesLoaded + "\n"
+ "totalFrames: " + totalFrames + "\n"
+ "trackAsMenu: " + trackAsMenu + "\n";
return str;
}
}
}
当前页: http://livedocs.adobe.com/flash/9.0_cn/ActionScriptLangRefV3/flash/display/MovieClip.html