MovieClip 类

可用性

Flash Player 3。

说明

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

无需使用构造函数方法即可调用 MovieClip 类的方法；只需使用以下语法按名称引用影片剪辑实例即可：

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

MovieClip 类的方法概要

方法	说明
`MovieClip.attachAudio()`	从麦克风硬件中捕获并播放本地音频。
`MovieClip.attachMovie()`	附加库中的 SWF 文件。
`MovieClip.createEmptyMovieClip()`	创建一个空的影片剪辑。
`MovieClip.createTextField()`	创建一个空的文本字段。
`MovieClip.duplicateMovieClip()`	重制指定的影片剪辑。
`MovieClip.getBounds()`	返回 SWF 文件在指定坐标空间中的最小和最大的 x、y 坐标。
`MovieClip.getBytesLoaded()`	返回为指定影片剪辑加载的字节数。
`MovieClip.getBytesTotal()`	以字节为单位返回影片剪辑的大小。
`MovieClip.getDepth()`	返回影片剪辑的深度。
`MovieClip.getInstanceAtDepth()`	指定某特定深度是否已被影片剪辑所占用。
`MovieClip.getNextHighestDepth()`	指定一个深度值，您可以将该值传递给其它方法，以确保 Flash 将该影片剪辑呈现在当前影片剪辑中所有其它对象的前面。
`MovieClip.getSWFVersion()`	返回一个整数，该整数指示所发布的影片剪辑的 Flash Player 版本
`MovieClip.getTextSnapshot()`	返回包含指定影片剪辑的静态文本字段中的文本的 TextSnapshot 对象。
`MovieClip.getURL()`	从一个 URL 获取文档。
`MovieClip.globalToLocal()`	将 point 对象的坐标从舞台坐标转换为指定影片剪辑的本地坐标。
`MovieClip.gotoAndPlay()`	将播放头转到影片剪辑中的特定帧并播放 SWF 文件。
`MovieClip.gotoAndStop()`	将播放头转到影片剪辑中的特定帧并停止 SWF 文件。
`MovieClip.hitTest()`	如果指定影片剪辑的边框与目标影片剪辑的边框交叉，则返回 `true`。
`MovieClip.loadMovie()`	将指定的 SWF 文件加载到影片剪辑中。
`MovieClip.loadVariables()`	将来自 URL 或其它位置的变量加载到影片剪辑中。
`MovieClip.localToGlobal()`	将 Point 对象的坐标从影片剪辑的本地坐标转换为全局舞台坐标。
`MovieClip.nextFrame()`	将播放头转到影片剪辑的下一帧。
`MovieClip.play()`	播放指定的影片剪辑。
`MovieClip.prevFrame()`	将播放头转到影片剪辑的上一帧。
`MovieClip.removeMovieClip()`	如果影片剪辑是用 duplicateMovieClip()、MovieClip.duplicateMovieClip() 或 MovieClip.attachMovie() 创建的，则将其从时间轴中删除。
`MovieClip.setMask()`	将影片剪辑指定为另一个影片剪辑的遮罩。
`MovieClip.startDrag()`	将影片剪辑指定为可拖动的并开始拖动该影片剪辑。
`MovieClip.stop()`	停止当前播放的 SWF 文件。
`MovieClip.stopDrag()`	停止拖动任何正在拖动的影片剪辑。
`MovieClip.swapDepths()`	交换两个 SWF 文件的深度级别。
`MovieClip.unloadMovie()`	删除用 `loadMovie()` 加载的 SWF 文件。

MovieClip 类的绘制方法概要

方法	说明
`MovieClip.beginFill()`	开始在舞台上绘制填充。
`MovieClip.beginGradientFill()`	开始在舞台上绘制渐变填充。
`MovieClip.clear()`	删除与影片剪辑实例相关联的所有绘画命令。
`MovieClip.curveTo()`	使用最新的线条样式绘制曲线。
`MovieClip.endFill()`	终止由 `beginFill()` 或 `beginGradientFill()` 指定的填充。
`MovieClip.lineStyle()`	定义用 `lineTo()` 和 `curveTo()` 方法创建的线条的笔触。
`MovieClip.linSeTo()`	使用当前的线条样式绘制线条。
`MovieClip.moveTo()`	将当前的绘画位置移到指定的坐标。

MovieClip 类的属性概要

属性	说明
`MovieClip._alpha`	影片剪辑实例的透明度值。
`MovieClip._currentframe`	播放头当前所处的帧的编号。
`MovieClip._droptarget`	以斜杠语法记号表示的影片剪辑实例（放置可拖动影片剪辑的影片剪辑实例）的绝对路径。
`MovieClip.enabled`	指示按钮影片剪辑是否处于启用状态。
`MovieClip.focusEnabled`	使影片剪辑能够接收焦点。
`MovieClip._focusrect`	指示具有焦点的影片剪辑周围是否有黄色矩形。
`MovieClip._framesloaded`	从 SWF 文件流中已经加载的帧数。
`MovieClip._height`	影片剪辑实例的高度，以像素为单位。
`MovieClip.hitArea`	将另一个影片剪辑指定为按钮影片剪辑的点击区域。
`MovieClip._highquality`	设置 SWF 文件的呈现品质。
`MovieClip.menu`	将 ContextMenu 对象与影片剪辑关联。
`MovieClip._name`	影片剪辑实例的实例名称。
`MovieClip._parent`	对包含有该影片剪辑的影片剪辑的引用。
`MovieClip._rotation`	影片剪辑实例的旋转角度。
`MovieClip._soundbuftime`	声音开始进入流之前存储的秒数。
`MovieClip.tabChildren`	指示影片剪辑的子级是否包含在 Tab 键的自动排序中。
`MovieClip.tabEnabled`	指示某影片剪辑是否包含在 Tab 键排序中。
`MovieClip.tabIndex`	指示对象的 Tab 键顺序。
`MovieClip._target`	影片剪辑实例的目标路径。
`MovieClip._totalframes`	影片剪辑实例中的总帧数。
`MovieClip.trackAsMenu`	指示其它按钮是否可接收鼠标按钮释放事件。
`MovieClip._url`	从中下载影片剪辑的 SWF 文件的 URL。
`MovieClip.useHandCursor`	确定当用户滑过按钮影片剪辑时是否显示手形光标。
`MovieClip._visible`	一个布尔值，确定影片剪辑实例是隐藏的还是可见的。
`MovieClip._width`	影片剪辑实例的宽度，以像素为单位。
`MovieClip._x`	影片剪辑实例的 x 坐标。
`MovieClip._xmouse`	影片剪辑实例中鼠标指针的 x 坐标。
`MovieClip._xscale`	指定用于水平缩放影片剪辑的百分比的值。
`MovieClip._y`	影片剪辑实例的 y 坐标。
`MovieClip._ymouse`	影片剪辑实例中鼠标指针的 y 坐标。
`MovieClip._yscale`	指定用于垂直缩放影片剪辑的百分比的值。

MovieClip 类的事件处理函数概要

事件处理函数	说明
`MovieClip.onData`	当所有数据都加载到影片剪辑中时调用。
`MovieClip.onDragOut`	鼠标指针位于按钮内时按下鼠标按钮，然后滑出该按钮区域，在此条件下，当鼠标指针位于该按钮外时进行调用。
`MovieClip.onDragOver`	鼠标指针位于按钮内时按下鼠标按钮，然后滑出该按钮区域，接着滑回到该按钮上，在此条件下，当鼠标指针位于该按钮上时进行调用。
`MovieClip.onEnterFrame`	以 SWF 文件的帧频持续调用。首先处理与 enterFrame 剪辑事件关联的动作，然后才处理附加到受影响帧的所有帧动作脚本。
`MovieClip.onKeyDown`	当按下按键时调用。使用 Key.getCode() 和 `Key.getAscii()` 方法可获取关于最后所按键的信息。
`MovieClip.onKeyUp`	当释放按键时调用。
`MovieClip.onKillFocus`	当从按钮移除焦点时调用。
`MovieClip.onLoad`	当影片剪辑被实例化并显示在时间轴上时调用。
`MovieClip.onMouseDown`	当按下鼠标左键时调用。
`MovieClip.onMouseMove`	每次移动鼠标时调用。
`MovieClip.onMouseUp`	当释放鼠标左键时调用。
`MovieClip.onPress`	在鼠标指针位于按钮上方的情况下，按下鼠标按钮时调用。
`MovieClip.onRelease`	在鼠标指针位于按钮上方的情况下，释放鼠标按钮时调用。
`MovieClip.onReleaseOutside`	在这样的情况下调用：在鼠标指针位于按钮内部的情况下按下按钮，然后将鼠标指针移到该按钮外部并释放鼠标按钮。
`MovieClip.onRollOut`	当鼠标指针滚动到按钮区域之外时调用。
`MovieClip.onRollOver`	当鼠标指针滚过按钮时调用。
`MovieClip.onSetFocus`	当按钮具有输入焦点而且释放某按键时调用。
`MovieClip.onUnload`	从时间轴删除影片剪辑后，在第 1 帧中调用。处理与 Unload 影片剪辑事件关联的动作之前，不将任何动作附加到受影响的帧。