包flash.display
类public dynamic class MovieClip
继承MovieClip Inheritance Sprite Inheritance DisplayObjectContainer Inheritance InteractiveObject Inheritance DisplayObject Inheritance EventDispatcher Inheritance Object
子类 FlexMovieClip, SystemManager, UIMovieClip, WindowedSystemManager

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9

MovieClip 类从以下类继承而来：Sprite、DisplayObjectContainer、InteractiveObject、DisplayObject 和 EventDispatcher。

不同于 Sprite 对象，MovieClip 对象拥有一个时间轴。

在 Flash 创作工具中放到舞台上的子实例无法由父实例构造函数中的代码进行访问，因为在执行代码时尚未在该位置创建这些实例。 在访问子实例之前，父实例必须通过代码创建子实例，或者延迟访问用于侦听子实例以调度其 Event.ADDED_TO_STAGE 事件的回调函数。

如果修改包含补间动画的 MovieClip 对象的下列任一属性，该 MovieClip 对象中的播放头便会停止：alpha、blendMode、filters、height、opaqueBackground、rotation、scaleX、scaleY、scale9Grid、scrollRect、transform、visible、width、x 或 y。但是，它不会停止在该 MovieClip 对象的任何子 MovieClip 对象中的播放头。

查看示例

另请参见

Core display classes
Basics of movie clips

公共属性
 属性定义方
 InheritedaccessibilityProperties : AccessibilityProperties
此显示对象的当前辅助功能选项。
DisplayObject
 Inheritedalpha : Number
指示指定对象的 Alpha 透明度值。
DisplayObject
 InheritedblendMode : String
BlendMode 类中的一个值，用于指定要使用的混合模式。
DisplayObject
 InheritedblendShader : Shader
[只写] 设置用于混合前景和背景的着色器。
DisplayObject
 InheritedbuttonMode : Boolean
指定此 sprite 的按钮模式。
Sprite
 InheritedcacheAsBitmap : Boolean
如果设置为 true，则 Flash Player 或 Adobe AIR 将缓存显示对象的内部位图表示形式。
DisplayObject
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
 InheritedcontextMenu : NativeMenu
指定与此对象相关联的上下文菜单。
InteractiveObject
  currentFrame : int
[只读 (read-only)] 指定播放头在 MovieClip 实例的时间轴中所处的帧的编号。
MovieClip
  currentFrameLabel : String
[只读 (read-only)] MovieClip 实例的时间轴中当前帧上的标签。
MovieClip
  currentLabel : String
[只读 (read-only)] 在 MovieClip 实例的时间轴中播放头所在的当前标签。
MovieClip
  currentLabels : Array
[只读 (read-only)] 返回由当前场景的 FrameLabel 对象组成的数组。
MovieClip
  currentScene : Scene
[只读 (read-only)] 在 MovieClip 实例的时间轴中播放头所在的当前场景。
MovieClip
 InheriteddoubleClickEnabled : Boolean
指定此对象是否接收 doubleClick 事件。
InteractiveObject
 InheriteddropTarget : DisplayObject
[只读 (read-only)] 指定拖动 sprite 时经过的显示对象，或放置 sprite 的显示对象。
Sprite
  enabled : Boolean
一个布尔值，指示影片剪辑是否处于活动状态。
MovieClip
 Inheritedfilters : Array
包含当前与显示对象关联的每个滤镜对象的索引数组。
DisplayObject
 InheritedfocusRect : Object
指定此对象是否显示焦点矩形。
InteractiveObject
  framesLoaded : int
[只读 (read-only)] 从流式 SWF 文件加载的帧数。
MovieClip
 Inheritedgraphics : Graphics
[只读 (read-only)] 指定属于此 sprite 的 Graphics 对象，在此 sprite 中可执行矢量绘画命令。
Sprite
 Inheritedheight : Number
指示显示对象的高度，以像素为单位。
DisplayObject
 InheritedhitArea : Sprite
指定一个 sprite 用作另一个 sprite 的点击区域。
Sprite
 InheritedloaderInfo : LoaderInfo
[只读 (read-only)] 返回一个 LoaderInfo 对象，其中包含加载此显示对象所属的文件的相关信息。
DisplayObject
 Inheritedmask : DisplayObject
调用显示对象被指定的 mask 对象遮罩。
DisplayObject
 InheritedmouseChildren : Boolean
确定对象的子项是否支持鼠标。
DisplayObjectContainer
 InheritedmouseEnabled : Boolean
指定此对象是否接收鼠标消息。
InteractiveObject
 InheritedmouseX : Number
[只读 (read-only)] 指示鼠标位置的 x 坐标，以像素为单位。
DisplayObject
 InheritedmouseY : Number
[只读 (read-only)] 指示鼠标位置的 y 坐标，以像素为单位。
DisplayObject
 Inheritedname : String
指示 DisplayObject 的实例名称。
DisplayObject
 InheritednumChildren : int
[只读 (read-only)] 返回此对象的子项数目。
DisplayObjectContainer
 InheritedopaqueBackground : Object
指定显示对象是否由于具有某种背景颜色而不透明。
DisplayObject
 Inheritedparent : DisplayObjectContainer
[只读 (read-only)] 指示包含此显示对象的 DisplayObjectContainer 对象。
DisplayObject
 Inheritedprototype : Object
[静态] 对类或函数对象的原型对象的引用。
Object
 Inheritedroot : DisplayObject
[只读 (read-only)] 对于加载的 SWF 文件中的显示对象，root 属性是此 SWF 文件所表示的显示列表树结构部分中的顶级显示对象。
DisplayObject
 Inheritedrotation : Number
指示 DisplayObject 实例距其原始方向的旋转程度，以度为单位。
DisplayObject
 InheritedrotationX : Number
指示 DisplayObject 实例相对于 3D 父容器距离其原始方向的 x 轴旋转（以度为单位）。
DisplayObject
 InheritedrotationY : Number
指示 DisplayObject 实例相对于 3D 父容器距离其原始方向的 y 轴旋转（以度为单位）。
DisplayObject
 InheritedrotationZ : Number
指示 DisplayObject 实例相对于 3D 父容器距离其原始方向的 z 轴旋转（以度为单位）。
DisplayObject
 Inheritedscale9Grid : Rectangle
当前有效的缩放网格。
DisplayObject
 InheritedscaleX : Number
指示从注册点开始应用的对象的水平缩放比例（百分比）。
DisplayObject
 InheritedscaleY : Number
指示从对象注册点开始应用的对象的垂直缩放比例（百分比）。
DisplayObject
 InheritedscaleZ : Number
指示从对象的注册点开始应用的对象的深度缩放比例（百分比）。
DisplayObject
  scenes : Array
[只读 (read-only)] 一个由 Scene 对象组成的数组，每个对象都列出了 MovieClip 实例中场景的名称、帧数和帧标签。
MovieClip
 InheritedscrollRect : Rectangle
显示对象的滚动矩形范围。
DisplayObject
 InheritedsoundTransform : SoundTransform
控制此 sprite 中的声音。
Sprite
 Inheritedstage : Stage
[只读 (read-only)] 显示对象的舞台。
DisplayObject
 InheritedtabChildren : Boolean
确定对象的子项是否支持 Tab 键。
DisplayObjectContainer
 InheritedtabEnabled : Boolean
指定此对象是否遵循 Tab 键顺序。
InteractiveObject
 InheritedtabIndex : int
指定 SWF 文件中的对象按 Tab 键顺序排列。
InteractiveObject
 InheritedtextSnapshot : TextSnapshot
[只读 (read-only)] 返回此 DisplayObjectContainer 实例的 TextSnapshot 对象。
DisplayObjectContainer
  totalFrames : int
[只读 (read-only)] MovieClip 实例中帧的总数。
MovieClip
  trackAsMenu : Boolean
指示属于 SimpleButton 或 MovieClip 对象的其它显示对象是否可以接收鼠标释放事件。
MovieClip
 Inheritedtransform : Transform
一个对象，具有与显示对象的矩阵、颜色转换和像素范围有关的属性。
DisplayObject
 InheriteduseHandCursor : Boolean
布尔值，指示当鼠标滑过其 buttonMode 属性设置为 true 的 sprite 时是否显示手指形（手形光标）。
Sprite
 Inheritedvisible : Boolean
显示对象是否可见。
DisplayObject
 Inheritedwidth : Number
指示显示对象的宽度，以像素为单位。
DisplayObject
 Inheritedx : Number
指示 DisplayObject 实例相对于父级 DisplayObjectContainer 本地坐标的 x 坐标。
DisplayObject
 Inheritedy : Number
指示 DisplayObject 实例相对于父级 DisplayObjectContainer 本地坐标的 y 坐标。
DisplayObject
 Inheritedz : Number
指示 DisplayObject 实例相对于 3D 父容器沿 z 轴的 z 坐标位置。
DisplayObject
公共方法
 方法定义方
  
MovieClip()
创建新的 MovieClip 实例。
MovieClip
 Inherited
addChild(child:DisplayObject):DisplayObject
将一个 DisplayObject 子实例添加到该 DisplayObjectContainer 实例中。
DisplayObjectContainer
 Inherited
addChildAt(child:DisplayObject, index:int):DisplayObject
将一个 DisplayObject 子实例添加到该 DisplayObjectContainer 实例中。
DisplayObjectContainer
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。
EventDispatcher
 Inherited
areInaccessibleObjectsUnderPoint(point:Point):Boolean
指示安全限制是否会导致出现以下情况：在列表中忽略了使用指定 point 点调用 DisplayObjectContainer.getObjectsUnderPoint() 方法时返回的所有显示对象。
DisplayObjectContainer
 Inherited
contains(child:DisplayObject):Boolean
确定指定显示对象是 DisplayObjectContainer 实例的子项还是该实例本身。
DisplayObjectContainer
 Inherited
dispatchEvent(event:Event):Boolean
将事件调度到事件流中。
EventDispatcher
 Inherited
getBounds(targetCoordinateSpace:DisplayObject):Rectangle
返回一个矩形，该矩形定义相对于 targetCoordinateSpace 对象坐标系的显示对象区域。
DisplayObject
 Inherited
getChildAt(index:int):DisplayObject
返回位于指定索引处的子显示对象实例。
DisplayObjectContainer
 Inherited
getChildByName(name:String):DisplayObject
返回具有指定名称的子显示对象。
DisplayObjectContainer
 Inherited
getChildIndex(child:DisplayObject):int
返回 DisplayObject 的 child 实例的索引位置。
DisplayObjectContainer
 Inherited
getObjectsUnderPoint(point:Point):Array
返回对象的数组，这些对象位于指定点下，并且是该 DisplayObjectContainer 实例的子项（或孙子项，依此类推）。
DisplayObjectContainer
 Inherited
getRect(targetCoordinateSpace:DisplayObject):Rectangle
返回一个矩形，该矩形根据 targetCoordinateSpace 参数定义的坐标系定义显示对象的边界，但不包括形状上的任何笔触。
DisplayObject
 Inherited
globalToLocal(point:Point):Point
将 point 对象从舞台（全局）坐标转换为显示对象的（本地）坐标。
DisplayObject
 Inherited
globalToLocal3D(point:Point):Vector3D
将二维点从舞台（全局）坐标转换为三维显示对象的（本地）坐标。
DisplayObject
  
gotoAndPlay(frame:Object, scene:String = null):void
从指定帧开始播放 SWF 文件。
MovieClip
  
gotoAndStop(frame:Object, scene:String = null):void
将播放头移到影片剪辑的指定帧并停在那里。
MovieClip
 Inherited
hasEventListener(type:String):Boolean
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。
EventDispatcher
 Inherited
hasOwnProperty(name:String):Boolean
指示对象是否已经定义了指定的属性。
Object
 Inherited
hitTestObject(obj:DisplayObject):Boolean
计算显示对象，以确定它是否与 obj 显示对象重叠或相交。
DisplayObject
 Inherited
hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean
计算显示对象，以确定它是否与 x 和 y 参数指定的点重叠或相交。
DisplayObject
 Inherited
isPrototypeOf(theClass:Object):Boolean
指示 Object 类的实例是否在指定为参数的对象的原型链中。
Object
 Inherited
local3DToGlobal(point3d:Vector3D):Point
将三维显示对象的（本地）坐标的三维点转换为舞台（全局）坐标中的二维点。
DisplayObject
 Inherited
localToGlobal(point:Point):Point
将 point 对象从显示对象的（本地）坐标转换为舞台（全局）坐标。
DisplayObject
  
nextFrame():void
将播放头转到下一帧并停止。
MovieClip
  
nextScene():void
将播放头移动到 MovieClip 实例的下一场景。
MovieClip
  
play():void
在影片剪辑的时间轴中移动播放头。
MovieClip
  
prevFrame():void
将播放头转到前一帧并停止。
MovieClip
  
prevScene():void
将播放头移动到 MovieClip 实例的前一场景。
MovieClip
 Inherited
propertyIsEnumerable(name:String):Boolean
指示指定的属性是否存在、是否可枚举。
Object
 Inherited
removeChild(child:DisplayObject):DisplayObject
从 DisplayObjectContainer 实例的子列表中删除指定的 child DisplayObject 实例。
DisplayObjectContainer
 Inherited
removeChildAt(index:int):DisplayObject
从 DisplayObjectContainer 的子列表中指定的 index 位置删除子 DisplayObject。
DisplayObjectContainer
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
从 EventDispatcher 对象中删除侦听器。
EventDispatcher
 Inherited
setChildIndex(child:DisplayObject, index:int):void
更改现有子项在显示对象容器中的位置。
DisplayObjectContainer
 Inherited
setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
设置循环操作动态属性的可用性。
Object
 Inherited
startDrag(lockCenter:Boolean = false, bounds:Rectangle = null):void
允许用户拖动指定的 Sprite。
Sprite
  
stop():void
停止影片剪辑中的播放头。
MovieClip
 Inherited
stopDrag():void
结束 startDrag() 方法。
Sprite
 Inherited
swapChildren(child1:DisplayObject, child2:DisplayObject):void
交换两个指定子对象的 Z 轴顺序（从前到后顺序）。
DisplayObjectContainer
 Inherited
swapChildrenAt(index1:int, index2:int):void
在子级列表中两个指定的索引位置，交换子对象的 Z 轴顺序（前后顺序）。
DisplayObjectContainer
 Inherited
toString():String
返回指定对象的字符串表示形式。
Object
 Inherited
valueOf():Object
返回指定对象的原始值。
Object
 Inherited
willTrigger(type:String):Boolean
检查是否用此 EventDispatcher 对象或其任何始祖为指定事件类型注册了事件侦听器。
EventDispatcher
事件
 事件 摘要 定义方
 Inherited
activate
[广播事件] Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。EventDispatcher
 Inherited
added
将显示对象添加到显示列表中时调度。DisplayObject
 Inherited
addedToStage
在将显示对象直接添加到舞台显示列表或将包含显示对象的子树添加至舞台显示列表中时调度。DisplayObject
 Inherited
clear
当用户从文本上下文菜单中选择“清除”（或“删除”）时调度。InteractiveObject
 Inherited
click
用户在同一 InteractiveObject 上按下并释放用户指针设备的主按钮时调度。InteractiveObject
 Inherited
AIR-only contextMenu
当用户在 AIR 应用程序中选择与此交互式对象相关联的上下文菜单时调度。InteractiveObject
 Inherited
copy
当用户激活特定于平台的复制操作的快捷键组合或从文本上下文菜单中选择“复制”时调度。InteractiveObject
 Inherited
cut
当用户激活特定于平台的剪切操作的快捷键组合或从文本上下文菜单中选择“剪切”时调度。InteractiveObject
 Inherited
deactivate
[广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。EventDispatcher
 Inherited
doubleClick
如果 InteractiveObject 的 doubleClickEnabled 标志设置为 true，当用户在该对象上快速连续按下两次并释放指针设备的主按钮时调度。InteractiveObject
 Inherited
enterFrame
[播放事件] 播放头进入新帧时调度。DisplayObject
 Inherited
exitFrame
[广播事件] 播放头退出当前帧时调度。DisplayObject
 Inherited
focusIn
显示对象获得焦点后调度。InteractiveObject
 Inherited
focusOut
显示对象失去焦点后调度。InteractiveObject
 Inherited
frameConstructed
[广播事件] 在帧显示对象的构造函数运行之后但在帧脚本运行之前调度。DisplayObject
 Inherited
keyDown
用户按下某个键时调度。InteractiveObject
 Inherited
keyFocusChange
用户尝试使用键盘导航更改焦点时调度。InteractiveObject
 Inherited
keyUp
用户释放某个键时调度。InteractiveObject
 Inherited
AIR-only middleClick
当用户在同一 InteractiveObject 上按下并释放用户指针设备的中间按钮时调度。InteractiveObject
 Inherited
AIR-only middleMouseDown
当用户在 InteractiveObject 实例上按下指针设备的中间按钮时调度。InteractiveObject
 Inherited
AIR-only middleMouseUp
当用户在 InteractiveObject 实例上释放指针设备按钮时调度。InteractiveObject
 Inherited
mouseDown
当用户在 InteractiveObject 实例上按下指针设备按钮时调度。InteractiveObject
 Inherited
mouseFocusChange
用户尝试使用指针设备更改焦点时调度。InteractiveObject
 Inherited
mouseMove
用户移动 InteractiveObject 上的指针设备时调度。InteractiveObject
 Inherited
mouseOut
用户将指针设备从 InteractiveObject 实例上移开时调度。InteractiveObject
 Inherited
mouseOver
用户将指针设备移动到 InteractiveObject 实例上时调度。InteractiveObject
 Inherited
mouseUp
当用户在 InteractiveObject 实例上释放指针设备按钮时调度。InteractiveObject
 Inherited
mouseWheel
当鼠标滚轮滚动到 InteractiveObject 实例上时调度。InteractiveObject
 Inherited
AIR-only nativeDragComplete
当用户释放拖动动作时由拖动启动器 InteractiveObject 调度。InteractiveObject
 Inherited
AIR-only nativeDragDrop
在将拖动对象放置到目标上且已通过对 DragManager.acceptDragDrop() 的调用接受该放置操作时，由目标 InteractiveObject 调度。InteractiveObject
 Inherited
AIR-only nativeDragEnter
当拖动动作进入其边界时由 InteractiveObject 调度。InteractiveObject
 Inherited
AIR-only nativeDragExit
当拖动动作离开其边界时由 InteractiveObject 调度。InteractiveObject
 Inherited
AIR-only nativeDragOver
当拖动动作保持在其边界内时，由 InteractiveObject 持续调度。InteractiveObject
 Inherited
AIR-only nativeDragStart
在拖动操作开始时由在 DragManager.doDrag() 调用中指定为拖动启动器的 InteractiveObject 调度。InteractiveObject
 Inherited
AIR-only nativeDragUpdate
在拖动操作期间由在 DragManager.doDrag() 调用中指定为拖动启动器的 InteractiveObject 调度。InteractiveObject
 Inherited
paste
当用户激活特定于平台的粘贴操作的快捷键组合或从文本上下文菜单中选择“粘贴”时调度。InteractiveObject
 Inherited
removed
将要从显示列表中删除显示对象时调度。DisplayObject
 Inherited
removedFromStage
在从显示列表中直接删除显示对象或删除包含显示对象的子树时调度。DisplayObject
 Inherited
render
[广播事件] 将要更新和呈现显示列表时调度。DisplayObject
 Inherited
AIR-only rightClick
当用户在同一 InteractiveObject 上按下并释放用户指针设备的右按钮时调度。InteractiveObject
 Inherited
AIR-only rightMouseDown
当用户在 InteractiveObject 实例上按下指针设备按钮时调度。InteractiveObject
 Inherited
AIR-only rightMouseUp
当用户在 InteractiveObject 实例上释放指针设备按钮时调度。InteractiveObject
 Inherited
rollOut
用户将指针设备从 InteractiveObject 实例上移开时调度。InteractiveObject
 Inherited
rollOver
用户将指针设备移动到 InteractiveObject 实例上时调度。InteractiveObject
 Inherited
selectAll
当用户激活特定于平台的全选操作的快捷键组合或从文本上下文菜单中选择“全选”时调度。InteractiveObject
 Inherited
tabChildrenChange
对象的 tabChildren 标志值发生更改时调度。InteractiveObject
 Inherited
tabEnabledChange
对象的 tabEnabled 标志发生更改时调度。InteractiveObject
 Inherited
tabIndexChange
对象的 tabIndex 属性值发生更改时调度。InteractiveObject
属性详细信息
currentFrame属性
currentFrame:int  [只读 (read-only)]

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9

指定播放头在 MovieClip 实例的时间轴中所处的帧的编号。如果影片剪辑有多个场景，该值是当前场景中的帧编号。



实现
    public function get currentFrame():int

示例
下面的代码使用 gotoAndStop() 方法和 currentFrame 属性指示 mc1 影片剪辑的播放头从其当前位置前进 5 帧并停止： 
mc1.gotoAndStop(mc1.currentFrame + 5);
currentFrameLabel属性 
currentFrameLabel:String  [只读 (read-only)]

语言版本: ActionScript 3.0
运行时版本: Flash Player 10, AIR 1.5

MovieClip 实例的时间轴中当前帧上的标签。如果当前帧没有标签，则 currentLabel 为 null。



实现
    public function get currentFrameLabel():String
currentLabel属性 
currentLabel:String  [只读 (read-only)]

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 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
运行时版本: AIR 1.0 Flash Player 9

返回由当前场景的 FrameLabel 对象组成的数组。如果 MovieClip 实例不使用场景，数组会包括整个 MovieClip 实例的所有帧标签。



实现
    public function get currentLabels():Array

另请参见

flash.display.FrameLabel

示例
以下代码说明如何使用名为 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
运行时版本: AIR 1.0 Flash Player 9

在 MovieClip 实例的时间轴中播放头所在的当前场景。



实现
    public function get currentScene():Scene

另请参见

Scene

示例
以下代码说明如何使用名为 mc1 的 MovieClip 对象的 currentScene 属性： 
import flash.display.Scene;
 
var scene:Scene = mc1.currentScene;
trace(scene.name + ": " + scene.numFrames + " frames");
enabled属性 
enabled:Boolean  [读写]

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 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
运行时版本: AIR 1.0 Flash Player 9

从流式 SWF 文件加载的帧数。可以使用 framesLoaded 属性来确定特定帧及其前面所有帧的内容是否已经加载，并且是否可在浏览器中供本地使用。可以使用它监视大 SWF 文件的下载。例如，可能需要向用户显示一条消息以表明在完成 SWF 文件中指定帧的加载前，SWF 文件将会一直进行加载。

如果影片剪辑包含多个场景，framesLoaded 属性会返回为影片剪辑中所有 场景加载的帧数。



实现
    public function get framesLoaded():int

另请参见

Loader class

示例
以下代码说明如何使用 framesLoaded 属性和 totalFrames 属性来确定名为 mc1 的流式 MovieClip 对象是否已完全加载： 
if (mc1.framesLoaded == mc1.totalFrames) {
    trace("OK.");
}
scenes属性 
scenes:Array  [只读 (read-only)]

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9

一个由 Scene 对象组成的数组，每个对象都列出了 MovieClip 实例中场景的名称、帧数和帧标签。



实现
    public function get scenes():Array

另请参见

Scene

示例
以下代码说明如何使用名为 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
运行时版本: AIR 1.0 Flash Player 9

MovieClip 实例中帧的总数。

如果影片剪辑包含多个帧，totalFrames 属性会返回影片剪辑中的所有 场景中的帧的总数。



实现
    public function get totalFrames():int

示例
以下代码说明如何使用名为 mc1 的 MovieClip 对象的 totalFrames 属性： 
trace(mc1.totalFrames);
trackAsMenu属性 
trackAsMenu:Boolean  [读写]

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 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
运行时版本: AIR 1.0 Flash Player 9

创建新的 MovieClip 实例。创建 MovieClip 之后，调用舞台上的显示对象容器的 addChild() 或 addChildAt() 方法。

方法详细信息
gotoAndPlay()方法
public function gotoAndPlay(frame:Object, scene:String = null):void

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9

从指定帧开始播放 SWF 文件。这会在帧中的所有剩余动作执行完毕后发生。要指定场景以及帧，请指定 scene 参数的值。

参数

frame:Object — 表示播放头转到的帧编号的数字，或者表示播放头转到的帧标签的字符串。如果您指定了一个数字，则该数字是相对于您指定的场景的。如果不指定场景，当前场景将确定要播放的全局帧编号。如果指定场景，播放头会跳到指定场景的帧编号。
 
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
运行时版本: AIR 1.0 Flash Player 9

将播放头移到影片剪辑的指定帧并停在那里。这会在帧中的所有剩余动作执行完毕后发生。如果除了指定帧以外，您还希望指定场景，那么请指定 scene 参数。

参数

frame:Object — 表示播放头转到的帧编号的数字，或者表示播放头转到的帧标签的字符串。如果您指定了一个数字，则该数字是相对于您指定的场景的。如果不指定场景，当前场景将确定转到其中并停止的全局帧编号。如果指定了场景，播放头会转到指定场景中的帧编号并停止。
 
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
运行时版本: AIR 1.0 Flash Player 9

将播放头转到下一帧并停止。这会在帧中的所有剩余动作执行完毕后发生。

另请参见

prevFrame()

示例

在下例中，由两个 SimpleButton 对象控制时间轴。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
运行时版本: AIR 1.0 Flash Player 9

将播放头移动到 MovieClip 实例的下一场景。这会在帧中的所有剩余动作执行完毕后发生。


示例

在下例中，由两个 SimpleButton 对象控制时间轴。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
运行时版本: AIR 1.0 Flash Player 9

在影片剪辑的时间轴中移动播放头。

另请参见

gotoAndPlay()

示例

下面的代码使用 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
运行时版本: AIR 1.0 Flash Player 9

将播放头转到前一帧并停止。这会在帧中的所有剩余动作执行完毕后发生。


示例

在下例中，由两个 SimpleButton 对象控制时间轴。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
运行时版本: AIR 1.0 Flash Player 9

将播放头移动到 MovieClip 实例的前一场景。这会在帧中的所有剩余动作执行完毕后发生。


示例

在下例中，由两个 SimpleButton 对象控制时间轴。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()方法 
public function stop():void

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9

停止影片剪辑中的播放头。

示例 如何使用示例
MovieClipExample.as

下例用 MovieClipExample 类来说明如何监视 MovieClip 的各种属性。执行下列步骤可完成该任务：
  1. 构造函数定义一个文本字段，该文本字段用于显示 MovieClipExample 对象（扩展了 MovieClip）的属性值。
  2. 将 getPropertiesString() 方法的返回值用作 outputText 文本字段的文本。getPropertiesString() 方法返回一个使用影片剪辑的以下属性值填充的字符串：currentFrame、currentLabel、currentScene、framesLoaded、totalFrames 和 trackAsMenu。
  3. 构造函数中的两行代码调整 outputText 文本字段的 width 和 height 属性。
  4. 构造函数的最后一行将 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;
        }
    }
}



© 2004-2008 Adobe Systems Incorporated. All rights reserved.
Sun Dec 14 2008, 10:39 PM -08:00