MovieClip

MovieClip
Object
    |
    +-MovieClip

public dynamic class MovieClip
extends Object
MovieClip 类的方法提供的功能与定位影片剪辑的动作所提供的功能相同。还有一些其它方法在"动作"面板中的"动作"工具箱中没有等效动作。

请不要使用构造函数方法来创建影片剪辑。要创建新的影片剪辑实例，您可以从以下三种方法中选择：

通过 attachMovie() 方法，可以基于库中存在的影片剪辑元件创建影片剪辑实例。
通过 createEmptyMovieClip() 方法，可以基于其它影片剪辑创建新的空影片剪辑实例以作为子级。
通过 duplicateMovieClip() 方法，可以基于其它影片剪辑创建影片剪辑实例。
若要调用 MovieClip 类的方法，请使用以下语法按名称引用影片剪辑实例，其中 my_mc 是影片剪辑实例：

my_mc.play();
my_mc.gotoAndPlay(3);

您可以通过创建子类来扩展 MovieClip 类的方法和事件处理函数。

可用性：ActionScript 1.0；Flash Player 3

属性摘要
修饰符
属性
说明


_alpha:Number
影片剪辑的 Alpha 透明度值。


blendMode:Object
此影片剪辑的混合模式。


cacheAsBitmap:Boolean
如果设置为 true，则 Flash Player 将缓存影片剪辑的内部位图表示。


_currentframe:Number [只读]
返回指定帧的编号，该帧中的播放头位于影片剪辑的时间轴中。


_droptarget:String [只读]
返回在其上放置此影片剪辑的影片剪辑实例的绝对路径，以斜杠语法记号表示。


enabled:Boolean
一个布尔值，指示影片剪辑是否处于活动状态。


filters:Array
一个索引数组，包含当前与影片剪辑相关联的每个过滤器对象。


focusEnabled:Boolean
如果值为 undefined 或 false，则除非影片剪辑是一个按钮，否则它无法获得输入焦点。


_focusrect:Boolean
一个布尔值，指定当影片剪辑具有键盘焦点时其周围是否有黄色矩形。


_framesloaded:Number [只读]
从流式 SWF 文件加载的帧数。


_height:Number
影片剪辑的高度，以像素为单位。


_highquality:Number
自 Flash Player 7 后不推荐使用。不推荐使用此属性，而推荐使用 MovieClip._quality。

指定当前 SWF 文件所应用的消除锯齿的级别。


hitArea:Object
将另一个影片剪辑指定为影片剪辑的点击区域。


_lockroot:Boolean
一个布尔值，指定将 SWF 文件加载到影片剪辑中时 _root 引用的内容。


menu:ContextMenu
将指定的 ContextMenu 对象与影片剪辑相关联。


_name:String
影片剪辑的实例名称。


opaqueBackground:Number
由数字（RGB 十六进制值）指定的颜色的影片剪辑的不透明背景颜色。


_parent:MovieClip
对包含当前影片剪辑或对象的影片剪辑或对象的引用。


_quality:String
设置或检索用于 SWF 文件的呈现品质。


_rotation:Number
指定影片剪辑相对于其原始方向的旋转程度，以度为单位。


scale9Grid:Rectangle
矩形区域，它定义影片剪辑的九个缩放区域。


scrollRect:Object
通过 scrollRect 属性，可以快速滚动影片剪辑内容，并具有一个用来查看较大内容的窗口。


_soundbuftime:Number
指定在声音开始进入流之前，预先缓冲的秒数。


tabChildren:Boolean
确定影片剪辑的子级是否包括在 Tab 键的自动排序中。


tabEnabled:Boolean
指定影片剪辑是否包括在 Tab 键的自动排序中。


tabIndex:Number
可用于自定义影片中对象的 Tab 键排序。


_target:String [只读]
返回影片剪辑实例的目标路径，以斜杠记号表示。


_totalframes:Number [只读]
返回由 MovieClip 参数指定的影片剪辑实例中的总帧数。


trackAsMenu:Boolean
布尔值，指示其它按钮或影片剪辑是否可接收鼠标释放事件。


transform:Transform
一个对象，具有与影片剪辑的矩阵、颜色转换和像素范围有关的属性。


_url:String [只读]
检索从其下载影片剪辑的 SWF、JPEG、GIF 或 PNG 文件的 URL。


useHandCursor:Boolean
一个布尔值，指示当鼠标滑过影片剪辑时是否显示手指形（手形光标）。


_visible:Boolean
一个布尔值，指示影片剪辑是否处于可见状态。


_width:Number
影片剪辑的宽度，以像素为单位。


_x:Number
一个整数，它设置影片剪辑相对于父级影片剪辑的本地坐标的 x 坐标。


_xmouse:Number [只读]
返回鼠标位置的 x 坐标。


_xscale:Number
确定从影片剪辑注册点开始应用的影片剪辑水平缩放比例 (percentage)。


_y:Number
设置影片剪辑相对于父级影片剪辑的本地坐标的 y 坐标。


_ymouse:Number [只读]
指示鼠标位置的 y 坐标。


_yscale:Number
设置从影片剪辑注册点开始应用的影片剪辑垂直缩放比例 (percentage)。


继承自 Object 类的属性constructor（Object.constructor 属性），__proto__（Object.__proto__ 属性），prototype（Object.prototype 属性），__resolve（Object.__resolve 属性）





事件摘要
事件
说明

onData = function() {}
在影片剪辑从 MovieClip.loadVariables() 调用或 MovieClip.loadMovie() 调用获得数据时调用。

onDragOut = function() {}
当按下鼠标按钮并且指针滑出对象时调用。

onDragOver = function() {}
当鼠标指针在影片剪辑外拖动并且随后拖过该影片剪辑时调用。

onEnterFrame = function() {}
以 SWF 文件的帧频重复调用。

onKeyDown = function() {}
当影片剪辑具有输入焦点并且用户按下某个键时调用。

onKeyUp = function() {}
当释放按键时调用。

onKillFocus = function(newFocus:Object) {}
当影片剪辑失去键盘焦点时调用。

onLoad = function() {}
当影片剪辑被实例化并显示在时间轴上时调用。

onMouseDown = function() {}
当按下鼠标按钮时调用。

onMouseMove = function() {}
当鼠标移动时调用。

onMouseUp = function() {}
释放鼠标按钮时调用。

onPress = function() {}
当鼠标指针处于影片剪辑之上而用户单击鼠标时调用。

onRelease = function() {}
当用户在影片剪辑上释放鼠标按钮时调用。

onReleaseOutside = function() {}
用户在影片剪辑区域中按下鼠标按钮并且在影片剪辑区域之外释放它后调用。

onRollOut = function() {}
当鼠标指针移到影片剪辑区域的外面时调用。

onRollOver = function() {}
当鼠标指针滑过影片剪辑区域时调用。

onSetFocus = function(oldFocus:Object) {}
当影片剪辑获得键盘焦点时调用。

onUnload = function() {}
从时间轴删除影片剪辑后，在第 1 帧中调用。


方法摘要
修饰符
签名
说明


attachAudio(id:Object) : Void
指定要播放的音频源。


attachBitmap(bmp:BitmapData, depth:Number, [pixelSnapping:String], [smoothing:Boolean]) : Void
将位图图像附加到影片剪辑。


attachMovie(id:String, name:String, depth:Number, [initObject:Object]) : MovieClip
从库中取得一个元件并将其附加到影片剪辑中。


beginBitmapFill(bmp:BitmapData, [matrix:Matrix], [repeat:Boolean], [smoothing:Boolean]) : Void
用位图图像填充绘画区域。


beginFill(rgb:Number, [alpha:Number]) : Void
指示新的绘画路径的开始。


beginGradientFill(fillType:String, colors:Array, alphas:Array, ratios:Array, matrix:Object, [spreadMethod:String], [interpolationMethod:String], [focalPointRatio:Number]) : Void
指示新的绘画路径的开始。


clear() : Void
删除使用影片剪辑绘画方法（包括用 MovieClip.lineStyle() 指定的线条样式）在运行时创建的所有图形。


createEmptyMovieClip(name:String, depth:Number) : MovieClip
创建一个空影片剪辑作为现有影片剪辑的子级。


createTextField(instanceName:String, depth:Number, x:Number, y:Number, width:Number, height:Number) : TextField
创建一个新的空文本字段作为在其上调用此方法的影片剪辑的子级。


curveTo(controlX:Number, controlY:Number, anchorX:Number, anchorY:Number) : Void
通过由 ((controlX, controlY) 指定的控制点，使用当前线条样式绘制一条曲线，该曲线从当前绘画位置到 (anchorX, anchorY)。


duplicateMovieClip(name:String, depth:Number, [initObject:Object]) : MovieClip
在 SWF 文件正在播放时，创建指定影片剪辑的实例。


endFill() : Void
对从上一次调用 beginFill() 或 beginGradientFill() 之后存在的直线或曲线应用填充。


getBounds(bounds:Object) : Object
基于 bounds 参数，返回作为影片剪辑的最小和最大 x 和 y 坐标值的属性。


getBytesLoaded() : Number
返回已加载（流处理）的影片剪辑的字节数。


getBytesTotal() : Number
以字节为单位返回影片剪辑的大小。


getDepth() : Number
返回影片剪辑实例的深度。


getInstanceAtDepth(depth:Number) : MovieClip
确定特定深度是否已被影片剪辑占用。


getNextHighestDepth() : Number
确定可传递给 MovieClip.attachMovie()、MovieClip.duplicateMovieClip() 或 MovieClip.createEmptyMovieClip() 的深度值，以确保 Flash 将该影片剪辑呈现在当前影片剪辑中同一级和同一层上所有其它对象的前面。


getRect(bounds:Object) : Object
基于 bounds 参数，返回作为影片剪辑的最小和最大 x 和 y 坐标值的属性，不包括形状上的任何笔触。


getSWFVersion() : Number
返回一个整数，该整数指示所发布的影片剪辑的 Flash Player 版本。


getTextSnapshot() : TextSnapshot
返回一个 TextSnapshot 对象，该对象包含指定影片剪辑的所有静态文本字段中的文本；不包括子级影片剪辑中的文本。


getURL(url:String, [window:String], [method:String]) : Void
从指定 URL 将文档加载到指定窗口。


globalToLocal(pt:Object) : Void
将 pt 对象从舞台（全局）坐标转换为影片剪辑（本地）坐标。


gotoAndPlay(frame:Object) : Void
从指定帧开始播放 SWF 文件。


gotoAndStop(frame:Object) : Void
将播放头移到影片剪辑的指定帧并停在那里。


hitTest() : Boolean
计算影片剪辑，以确认其是否与由 target 或 x 和 y 坐标参数标识的点击区域发生重叠或相交。


lineGradientStyle(fillType:String, colors:Array, alphas:Array, ratios:Array, matrix:Object, [spreadMethod:String], [interpolationMethod:String], [focalPointRatio:Number]) : Void
指定 Flash 用于后续 lineTo() 和 curveTo() 方法调用的线条样式，在以不同参数调用 lineStyle() 方法或 lineGradientStyle() 方法之前，线条样式不会改变。


lineStyle(thickness:Number, rgb:Number, alpha:Number, pixelHinting:Boolean, noScale:String, capsStyle:String, jointStyle:String, miterLimit:Number) : Void
指定 Flash 用于后续 lineTo() 和 curveTo() 方法调用的线条样式，在以不同参数调用 lineStyle() 方法之前，线条样式不会改变。


lineTo(x:Number, y:Number) : Void
使用当前线条样式绘制一条从当前绘画位置到 (x, y) 的线条；当前绘画位置随后会设置为 (x, y)。


loadMovie(url:String, [method:String]) : Void
在播放原始 SWF 文件时，将 SWF、JPEG、GIF 或 PNG 文件加载到 Flash Player 中的影片剪辑中。


loadVariables(url:String, [method:String]) : Void
从外部文件读取数据并设置影片剪辑中变量的值。


localToGlobal(pt:Object) : Void
将 pt 对象从影片剪辑（本地）坐标转换为舞台（全局）坐标。


moveTo(x:Number, y:Number) : Void
将当前绘画位置移动到 (x, y)。


nextFrame() : Void
将播放头转到下一帧并停止。


play() : Void
在影片剪辑的时间轴中移动播放头。


prevFrame() : Void
将播放头转到前一帧并停止。


removeMovieClip() : Void
删除用 duplicateMovieClip()、MovieClip.duplicateMovieClip()、MovieClip.createEmptyMovieClip() 或 MovieClip.attachMovie() 创建的影片剪辑实例。


setMask(mc:Object) : Void
使参数 mc 中的影片剪辑成为展示调用影片剪辑的遮罩层。


startDrag([lockCenter:Boolean], [left:Number], [top:Number], [right:Number], [bottom:Number]) : Void
允许用户拖动指定的影片剪辑。


stop() : Void
停止当前正在播放的影片剪辑。


stopDrag() : Void
结束 MovieClip.startDrag() 方法。


swapDepths(target:Object) : Void
交换此影片剪辑与另一影片剪辑的堆栈或深度级别（z-顺序），另一影片剪辑由 target 参数指定，或指定为当前占用由 target 参数指定的深度级别的影片剪辑。


unloadMovie() : Void
删除影片剪辑实例的内容。


继承自 Object 类的方法