描述

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形状或影片剪辑要移动的子对象
newIndexNumber子显示对象的新索引
var stage = player.getStage();
var n = stage.getNumChildren();
var child = stage.getChildAt(n - 1);
stage.setChildIndex(child, 0);

setLocalColorTransform(colorTransform)

说明

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

参数

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

setLocalTransform(transform)

说明

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

参数

名称类型描述
transformflwebgl.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()

说明

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

本产品经 Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License 许可  Twitter™ 与 Facebook 中的内容不在 Creative Commons 的条款约束之下。

法律声明   |   在线隐私策略