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 影片剪辑事件关联的动作之前,不将任何动作附加到受影响的帧。