MovieClip

搜索
前往 Flash Professional 用户指南

描述

MovieClip 是一个包含形状及其他 MovieClip 实例的容器。每个 MovieClip 都播放其时间轴中的动画。您可以使用 SceneGraphFactory 来创建 MovieClip 实例。

扩展

  • flwebgl.event.EventDispatcher

方法

addChild(child)

说明

此方法将所传递的子对象作为此 MovieClip 最顶层的子对象添加。子对象可以是形状或影片剪辑。

参数

返回值

  • 操作是否成功
  • 类型 - 布尔值
名称 类型 描述
child 形状或影片剪辑 要作为子对象添加的对象。

addChildAt(child, index)

说明

此方法将所传递的子对象添加到此电影剪辑的指定索引处。子对象可以是形状或电影剪辑。

参数

返回值

  • 操作是否成功
  • 类型 - 布尔值
名称 类型 描述
child 形状或影片剪辑 要添加到索引位置的子对象。
index 数字 要添加子对象的索引位置。

getBounds(targetCoordinateSpace, bFastBounds)

说明

此方法返回边界矩形。

参数

返回值

  • 显示对象的边界
  • 类型 - flwebgl.geom.Rect
名称 类型 描述
targetCoordinateSpace
 形状或影片剪辑
 （可选，默认为 undefined）定义要使用的坐标系统的显示对象。如未指定，则返回局部边界。
bFastBounds
 布尔值
 （可选，默认为 true）指定是返回原边界即默认边界（快速计算）还是转换的局部边界（更为精确但相对较慢）。

getChildAt(index)

说明

此方法返回此电影剪辑指定索引处的子对象。如果指定索引处没有子对象，则返回“undefined”

参数

返回值

  • 类型 - 形状或影片剪辑

示例

在此例中，将一个节点从一个电影剪辑移动到了另一个电影剪辑。

名称 类型 描述
index 数字 请求子对象的索引位置。 
        var stage = player.getStage();
        var mc1 = stage.getChildAt(0);
        var mc2 = stage.getChildAt(1);
        
        var child = mc1.getChildAt(0);
        mc2.addChildAt(child, 0);

getChildByName(name)

说明

此方法返回以指定名称存在的子显示对象。如果不止一个子显示对象具有相同的指定名称，则此方法返回子对象列表中的第一个对象。

参数

返回值

  • 具有给定名称的子对象
  • 类型 - 数字
名称 类型 描述
name 字符串 要搜索的子对象的名称

getChildIndex(child)

说明

此方法返回子对象列表中子对象的索引。如果未找到这个子对象，则返回“1”。

参数

返回值

  • 类型 - 数字
名称 类型 描述
child 形状或影片剪辑 要搜索的子对象。

getChildren()

说明

此方法返回电影剪辑的子对象。

返回值

  • 类型 - 一个包含形状或影片剪辑的数组

getCurrentFrame()

说明

此方法返回当前帧的编号。帧编号从 1 开始计。

返回值

  • 类型 - 数字

getCurrentFrameLabel()

说明

此方法返回 MovieClip 实例时间轴中当前帧的标签。如果当前帧没有标签，则将 currentLabel 的值返回“undefined”。

返回值

  • 类型 - 字符串

示例

在此例中，当电影剪辑通过一个标签为“stop_anim”的帧时，动画将停止。

  
function exitHandler(e) {
 var m = e.getTarget();
 var curLabel = m.getCurrentFrameLabel();
 
 if (curLabel == "stop_anim")
  m.stop();
}

var stage = player.getStage();
stage.addEventListener(flwebgl.events.Event.EXIT_FRAME, exitHandler);

getCurrentLabel()

说明

此方法返回在 MovieClip 实例的时间轴中播放头所在的当前标签。如果当前帧没有标签，则 getCurrentLabel() 返回包含一个标签的前一帧的名称。如果当前帧和其前面的帧都没有标签，则 getCurrentLabel() 返回值“undefined”。

返回值

  • 类型 - 字符串

getFrameLabels()

说明

此方法返回电影剪辑或场景中所有标签的列表。您可以按其“name”和“frameNum”属性来访问每个标签。

返回值

  • Array of {frameNum: number, name: string}

getGlobalColorTransform()

说明

此方法返回显示对象的全局颜色转换。

返回值

  • 类型 - flwebgl.geom.ColorTransform

getGlobalTransform()

说明

此方法返回显示对象的全局转换。

返回值

  •     类型 - flwebgl.geom.Matrix

getLocalColorTransform()

说明

此方法返回显示对象的局部颜色转换。

返回值

  • 类型 - flwebgl.geom.ColorTransform

getLocalTransform()

说明

此方法返回显示对象的局部转换。

返回值

  • 类型 - flwebgl.geom.Matrix

getName()

说明

此方法返回此显示对象的名称。

返回值

  • 类型 - 字符串

getNumChildren()

说明

此方法返回子对象的编号。

返回值

  • 类型 - 数字

getTotalFrames()

说明

此方法返回相应时间轴中的总帧数。

返回值

  • 类型 - 数字

gotoAndPlay(frame)

说明

此方法在指定帧处开始播放电影剪辑。

参数

示例

此例对电影剪辑添加一个句柄，以便在通过帧 5 后可以直接跳到帧 15。

名称 类型 描述
frame 数字或字符串 请求的帧数或帧标签 
function exitHandler(e) {
    var m = e.getTarget();
    var curFrame = m.getCurrentFrame();

    if (curFrame == 5)
        m.gotoAndPlay(15);
}

var stage = player.getStage();
stage.addEventListener(flwebgl.events.Event.EXIT_FRAME, exitHandler);

gotoAndStop(frame)

说明

此方法将播放头移到电影剪辑的指定帧并停在那里。

参数

名称 类型 描述
frame 数字或字符串 请求的帧数或帧标签

isVisible()

说明

此方法返回显示对象的可见性标记。

返回值

  • 类型 - 布尔值

play()

说明

此方法在电影剪辑的时间轴中移动播放头。

removeChild(child)

说明

此方法从电影剪辑中删除提供的子对象。子对象可以是形状或电影剪辑。

参数

返回值

  • 操作是否成功
  • 类型 - 布尔值
名称 类型 描述
child 形状或影片剪辑 要删除的子对象

removeChildAt(index)

说明

此方法删除电影剪辑中指定索引处的子对象。子对象可以是形状或电影剪辑。

参数

返回值

  • 操作是否成功
  • 类型 - 布尔值
名称 类型 描述
index 数字 要删除的子对象的索引。

setChildIndex(child, newIndex)

说明

此方法可用于重新排列 MovieClip 各个子对象的顺序。如果使用 setChildIndex() 方法并指定已经占用的索引位置，则只会改变显示对象之前与新位置之间的那些位置。其他所有位置将保持不变。

参数

示例

此例获取舞台最底部的子对象，并将其置于所有其他子对象的顶层。

名称 类型 描述
child 形状或影片剪辑 要移动的子对象
newIndex Number 子显示对象的新索引 
var stage = player.getStage();
var n = stage.getNumChildren();
var child = stage.getChildAt(n - 1);
stage.setChildIndex(child, 0);

setLocalColorTransform(colorTransform)

说明

此方法设置显示对象的局部颜色转换。

参数

名称 类型 描述
colorTransform flwebgl.geom.ColorTransform 要设置的颜色转换

setLocalTransform(transform)

说明

此方法设置显示对象的局部转换。

参数

名称 类型 描述
transform flwebgl.geom.Matrix 要设置的转换

示例

此例对舞台上的电影剪辑实例进行了局部转换，方式是将实例沿水平和垂直方向转换了 20 个像素。

var stage = player.getStage();
var mc = stage.getChildAt(0);
var mat = mc.getLocalTransform();
mat.translate(20, 20);
mc.setLocalTransform(mat);

setName(name)

说明

此方法设置此显示对象的名称。

参数

名称 类型 描述
name 字符串 显示对象的名称

setVisible(flag)

说明

此方法设置此显示对象的可见性标记。

参数

名称 类型 描述
flag 布尔 可见性标记

示例

此例可以做到切换舞台上最顶层子对象的可见性标记。

var stage = player.getStage();
var mc = stage.getChildAt(0);
var visibiliity = mc.isVisible();
mc.setVisible(!visibiliity);

stop()

说明

此方法停止电影剪辑中的播放头。

Adobe 徽标

登录到您的帐户

快速链接

查看您的应用程序 管理您的计划

法律声明    |    在线隐私策略