当前消息！ANH5 影片剪辑（MovieClip）API 1.0

2022-08-07 16:39:45|

来源：哔哩哔哩作者：

打印

影片剪辑类

扩展容器

定义在：MovieClip:41

模块：画架JS

(资料图)

MovieClip 类将 TweenJS 时间轴与 EaselJS Container相关联。它允许您创建封装时间线动画、状态更改和同步动作的对象。自 0.7.0 以来，MovieClip 类已包含在 EaselJS 缩小文件中。

目前，MovieClip 仅在基于刻度（而不是基于时间）的情况下才能正常工作，尽管已做出一些让步以支持未来基于时间的时间线。

例子

此示例来回设置两个形状的动画。灰色形状从左侧开始，但我们使用gotoAndPlay跳转到动画的中点。

建议使用tween.to()动画和设置属性（不使用持续时间立即设置），以及tween.wait()在动画之间创建延迟的方法。请注意，使用该 tween.set()方法影响属性可能不会提供所需的结果。

构造函数MovieClip

(

[props]

)

定义于 MovieClip:41

参数：

[props]对象可选

应用于此实例的配置属性（例如{mode:MovieClip.SYNCHED}）。下面列出了 MovieClip 支持的道具。这些道具是在相应的实例属性上设置的，除非另有说明。

此对象也将被传递到与此 MovieClip 关联的 Timeline 实例中。paused有关支持的道具列表（例如、labels、loop、reversed等），请参阅 Timeline 的文档

mode

startPosition

frameBounds

方法

addChild

addChildAt

addEventListener

advance

cache

clone

contains

dispatchEvent

draw

getBounds

getCacheDataURL

getChildAt

getChildByName

getChildIndex

getConcatenatedDisplayProps

getConcatenatedMatrix

getMatrix

getObjectsUnderPoint

getObjectUnderPoint

getTransformedBounds

globalToLocal

gotoAndPlay

gotoAndStop

hasEventListener

hitTest

isVisible

localToGlobal

localToLocal

off

play

removeAllChildren

removeAllEventListeners

removeChild

removeChildAt

removeEventListener

set

setBounds

setChildIndex

setTransform

sortChildren

stop

swapChildren

swapChildrenAt

toString

uncache

updateCache

updateContext

willTrigger

属性

actionsEnabled

alpha

autoReset

bitmapCache

cacheCanvas

children

compositeOperation

currentFrame

currentLabel

cursor

duration

filters

frameBounds

framerate

hitArea

INDEPENDENT static

labels

loop

mask

mode

mouseChildren

mouseEnabled

name

numChildren

parent

paused

regX

regY

rotation

scale

scaleX

scaleY

shadow

SINGLE_FRAME static

skewX

skewY

snapToPixel

stage

startPosition

SYNCHED static

tickChildren

tickEnabled

timeline

totalFrames

transformMatrix

visible

事件

added

click

dblclick

mousedown

mouseout

mouseover

pressmove

pressup

removed

rollout

rollover

tick

container.addChild(bitmapInstance);container.addChild(bitmapInstance, shapeInstance, textInstance);addChildAt(child1, index);addChildAt(child1, child2, ..., index);container.addChildAt(myShape, container.getChildIndex(otherShape));displayObject.addEventListener("click", handleClick); function handleClick(event) { // Click happened. }var shape = new createjs.Shape(); shape.graphics.beginFill("#ff0000").drawCircle(0, 0, 25); shape.cache(-25, -25, 50, 50);// Use a string event this.dispatchEvent("complete"); // Use an Event instance var event = new createjs.Event("progress"); this.dispatchEvent(event);var bounds = obj.getBounds();obj.setBounds(bounds.x, bounds.y, bounds.width, bounds.height);// getBounds will now use the set values, instead of recalculatingvar myBounds = obj.getBounds().clone();// OR:myRect.copy(obj.getBounds());container.getChildAt(2);var index = container.getChildIndex(child);displayObject.x = 300; displayObject.y = 200; stage.addChild(displayObject); var point = displayObject.globalToLocal(100, 100); // Results in x=-200, y=-100displayObject.x = 300; displayObject.y = 200; stage.addChild(displayObject); var point = displayObject.localToGlobal(100, 100); // Results in x=400, y=300var pt = this.localToGlobal(x, y); pt = target.globalToLocal(pt.x, pt.y);var listener = myBtn.on("click", handleClick, null, false, {count:3}); function handleClick(evt, data) { data.count -= 1; console.log(this == myBtn); // true - scope defaults to the dispatcher if (data.count == 0) { alert("clicked 3 times!"); myBtn.off("click", listener); // alternately: evt.remove(); } }container.removeAllChildren();// Remove all listeners displayObject.removeAllEventListeners(); // Remove all click listeners displayObject.removeAllEventListeners("click");container.removeChild(child);removeChild(child1, child2, ...);container.removeChildAt(2);container.removeChild(2, 7, ...)displayObject.removeEventListener("click", handleClick);var myGraphics = new createjs.Graphics().beginFill("#ff0000").drawCircle(0, 0, 25); var shape = stage.addChild(new Shape()).set({graphics:myGraphics, x:100, y:100, alpha:0.5});displayObject.setTransform(100, 100, 2, 2);var sortFunction = function(obj1, obj2, options) { if (obj1.y > obj2.y) { return 1; } if (obj1.y < obj2.y) { return -1; } return 0; } container.sortChildren(sortFunction);// Not shown: Creating the shape, and caching it. shapeInstance.clear(); shapeInstance.setStrokeStyle(3).beginStroke("#ff0000").moveTo(100, 100).lineTo(200,200); shapeInstance.updateCache();

方法addChild

(

child

)

显示对象

继承自 Container： addChild:178

将子项添加到显示列表的顶部。

例子

您还可以一次添加多个孩子：

参数：

child显示对象

要添加的显示对象。

回报：

显示对象：

添加的孩子，或者如果添加了多个孩子，则为最后一个孩子。

addChildAt

(

child

index

)

显示对象

继承自 Container： addChildAt:209

将一个子元素添加到指定索引处的显示列表中，将相等或更大索引处的子元素提升一个，并将其父元素设置为此 Container。

例子

您还可以添加多个孩子，例如：

索引必须介于 0 和 numChildren 之间。例如，要将 myShape 添加到显示列表中的 otherShape 下，您可以使用：

这也会将 otherShape 的索引提高 1 个。如果索引超出范围，则静默失败。

参数：

child显示对象

要添加的显示对象。

index数字

添加孩子的索引。

回报：

显示对象：

返回添加的最后一个孩子，或者如果添加了多个孩子，则返回最后一个孩子。

addEventListener

(

type

listener

[useCapture]

)

功能| 目的

继承自 EventDispatcher： addEventListener:140

添加指定的事件侦听器。请注意，将多个侦听器添加到同一个函数将导致多个回调被触发。

例子参数：

type细绳

事件的字符串类型。

listener功能| 目的

一个具有handleEvent 方法的对象，或者一个在事件被调度时将被调用的函数。

[useCapture]布尔可选

对于冒泡的事件，指示是否在捕获或冒泡/目标阶段侦听事件。

回报：

功能| 对象：

返回用于链接或分配的侦听器。

advance

(

[time]

)

定义于 advance:498

前进播放头。默认情况下，这会在每个刻度上自动发生。

参数：

[time]号码可选

以毫秒为单位前进的时间量。仅在设置帧率时适用。

cache

(

x

y

width

height

[scale=1]

[options=undefined]

)

继承自 DisplayObject： cache:803

将显示对象绘制到一个新元素中，然后用于后续绘制。适用于不经常更改的复杂内容（例如，具有许多不移动的子项的容器，或复杂的矢量形状），这可以提供更快的渲染速度，因为不需要在每个刻度上重新渲染内容。缓存的显示对象可以自由移动、旋转、淡化等，但如果其内容发生变化，则必须updateCache()再次调用手动更新缓存。您必须通过 x、y、w 和 h 参数指定缓存区域。这定义了将使用此显示对象的坐标进行渲染和缓存的矩形。

例子

例如，如果您定义了一个在 0、0 处绘制一个半径为 25 的圆的 Shape：

请注意，需要在应用缓存之前定义过滤器，否则您必须在应用之后调用 updateCache。查看过滤器类以获取更多信息。某些过滤器（例如 BlurFilter）可能无法与比例参数一起按预期工作。

通常，生成的 cacheCanvas 将具有尺寸宽度比例、高度比例，但是一些过滤器（例如 BlurFilter）会为画布尺寸添加填充。

在以前的版本中，缓存是在 DisplayObject 上处理的，但后来被移到了BitmapCache中。这允许更轻松的交互和备用缓存方法，例如 WebGL 和StageGL。有关选项对象的更多信息，请参阅 BitmapCache定义。

参数：

x数字

缓存区域的 x 坐标原点。

y数字

缓存区域的 y 坐标原点。

width数字

缓存区域的宽度。

height数字

缓存区域的高度。

[scale=1]号码可选

创建缓存的比例。例如，如果您使用 myShape.cache(0,0,100,100,2) 缓存矢量形状，则生成的 cacheCanvas 将为 200x200 像素。这使您可以更保真地缩放和旋转缓存的元素。默认值为 1。

[options=undefined]对象可选

为缓存逻辑指定附加参数

clone

()

继承自 DisplayObject 但被覆盖 clone:522

无法克隆 MovieClip 实例。

contains

(

child

)

布尔值

继承自 Container： contains:435

如果指定的显示对象是此容器或者是此容器的后代（子、孙等），则返回 true。

参数：

child显示对象

要检查的 DisplayObject。

回报：

布尔值：

如果指定的显示对象是此容器或后代，则为 true。

dispatchEvent

(

eventObj

[bubbles]

[cancelable]

)

布尔值

继承自 EventDispatcher： dispatchEvent:285

将指定的事件分派给所有侦听器。

例子参数：

eventObj对象| 字符串| 事件

具有“类型”属性或字符串类型的对象。虽然通用对象可以工作，但建议使用 CreateJS 事件实例。如果使用字符串，dispatchEvent 将在必要时构造一个具有指定类型的 Event 实例。后一种方法可用于避免为可能没有任何侦听器的非冒泡事件实例化事件对象。

[bubbles]布尔可选

指定将bubbles字符串传递给 eventObj 时的值。

[cancelable]布尔可选

指定将cancelable字符串传递给 eventObj 时的值。

回报：

布尔值：

preventDefault()如果在可取消事件上调用，则返回 false ，否则返回 true。

draw

(

ctx

ignoreCache

)

继承自 DisplayObject 但被覆盖 draw:444

将显示对象绘制到指定的上下文中，忽略其可见、alpha、阴影和变换。如果绘制已处理，则返回 true（用于覆盖功能）。注意：此方法主要供内部使用，但它可能对高级用途有用。

参数：

ctxCanvasRenderingContext2D

要绘制的画布 2D 上下文对象。

ignoreCache布尔值

指示绘制操作是否应忽略任何当前缓存。例如，用于绘制缓存（以防止它简单地将现有缓存绘制回自身）。

getBounds

() 矩形

继承自 DisplayObject： getBounds:1100

返回一个矩形，表示该对象在其局部坐标系中的边界（即没有变换）。已缓存的对象将返回缓存的边界。

并非所有显示对象都可以计算自己的边界（例如形状）。对于这些对象，您可以使用 setBounds以便在计算容器边界时将它们包括在内。

全部所有显示对象都支持使用 setBounds() 手动设置边界。同样，已使用 cache() 缓存的显示对象将返回其缓存的边界。手动和缓存边界将覆盖下面列出的自动计算。位图返回从 (x=0,y=0) 扩展的位图/源矩形（如果指定）或图像的宽度和高度。雪碧返回当前帧的边界。如果在 spritesheet 数据中指定了帧注册点，则可能具有非零 x/y。另请参阅getFrameBounds容器返回从中返回非空值的所有子项的聚合（组合）边界getBounds()。形状当前不支持自动边界计算。用于setBounds()手动定义边界。文本返回近似边界。水平值 (x/width) 非常准确，但垂直值 (y/height) 不准确，尤其是在使用textBaseline值而不是 "top" 时。位图文本返回近似边界。如果 spritesheet 帧注册点接近 (x=0,y=0)，值会更准确。

计算某些对象（例如文本或具有许多子对象的容器）的边界可能很昂贵，并且每次调用 getBounds() 时都会重新计算。您可以通过显式设置边界来防止重新计算静态对象：

为了减少内存影响，返回的 Rectangle 实例可以在内部重用；如果需要保留它，请克隆实例或复制其值。

回报：

矩形：

表示边界的 Rectangle 实例，如果边界不适用于此对象，则为 null。

getCacheDataURL

() 字符串

继承自 DisplayObject： getCacheDataURL:886

返回缓存的数据 URL，如果未缓存此显示对象，则返回 null。仅在缓存已更改时生成，否则返回最后一个结果。

回报：

字符串：

缓存的图像数据 url。

getChildAt

(

index

)

显示对象

继承自 Container： getChildAt:319

返回指定索引处的子级。

例子参数：

index数字

要返回的孩子的索引。

回报：

显示对象：

指定索引处的子项。如果索引处没有子元素，则返回 null。

getChildByName

(

name

)

显示对象

继承自 Container： getChildByName:334

返回具有指定名称的孩子。

参数：

name细绳

要返回的孩子的姓名。

回报：

显示对象：

具有指定名称的孩子。

getChildIndex

(

child

)

数字

继承自 Container： getChildIndex:368

返回显示列表中指定子项的索引，如果不在显示列表中，则返回 -1。

例子参数：

child显示对象

要返回其索引的子项。

回报：

号码：

指定子节点的索引。-1 如果没有找到孩子。

getConcatenatedDisplayProps

(

[props]

)

展示道具

继承自 DisplayObject： getConcatenatedDisplayProps:1032

生成一个 DisplayProps 对象，该对象表示对象及其所有父 Container 的组合显示属性，直到最高级别的祖先（通常是Stage）。

参数：

[props]DisplayProps 可选

使用计算值填充的DisplayProps对象。如果为 null，则返回一个新的 DisplayProps 对象。

回报：

显示道具：

组合显示属性。

getConcatenatedMatrix

(

[matrix]

)

Matrix2D

继承自 DisplayObject： getConcatenatedMatrix:1014

生成一个 Matrix2D 对象，该对象表示显示对象及其所有父 Container 的组合变换，直到最高级别的祖先（通常是Stage）。这可用于在坐标空间之间转换位置，例如使用localToGlobal 和globalToLocal。

参数：

[matrix]Matrix2D 可选

使用计算值填充的Matrix2D对象。如果为 null，则返回一个新的 Matrix2D 对象。

回报：

矩阵2D：

组合矩阵。

getCurrentLabel

() 已弃用

定义于 getCurrentLabel:358

请改用currentLabel属性。

getDuration

() 已弃用

定义于 getDuration:376

请改用持续时间属性。

getLabels

() 已弃用

定义于 getLabels:340

请改用标签属性。

getMatrix

(

matrix

)

Matrix2D

继承自 DisplayObject： getMatrix:1002

根据此对象的当前变换返回一个矩阵。

参数：

matrixMatrix2D

可选的。使用计算值填充的 Matrix2D 对象。如果为 null，则返回一个新的 Matrix 对象。

回报：

矩阵2D：

表示此显示对象变换的矩阵。

getNumChildren

() 已弃用

继承自 Container： getNumChildren:106

请改用numChildren属性。

getObjectsUnderPoint

(

x

y

[mode=0]

)

大批

继承自 Container： getObjectsUnderPoint:465

返回此容器的显示列表中指定坐标下的所有显示对象的数组。此例程忽略mouseEnabled 设置为的任何显示对象false。数组将按视觉深度排序，最顶部的显示对象位于索引 0。这使用基于形状的命中检测，运行起来可能是一项昂贵的操作，因此最好谨慎使用。例如，如果在鼠标下测试对象，则在刻度上进行测试（而不是在stagemousemove上），并且仅在鼠标位置发生变化时进行测试。

默认情况下 (mode=0)，此方法评估所有显示对象。

通过将mode参数设置为1，将尊重mouseEnabled 和 MouseChildren:property 属性。

将设置mode为2另外排除没有活动鼠标事件侦听器或 DisplayObject:cursor:property 属性的显示对象。也就是说，只会包含通常会拦截鼠标交互的对象。在某些情况下，这可以通过减少需要测试的显示对象的数量来显着提高性能。

此方法同时考虑了hitArea和mask。

参数：

x数字

要测试的容器中的 x 位置。

y数字

要测试的容器中的 y 位置。

[mode=0]号码可选

用于确定要包括哪些显示对象的模式。0-全部，1-尊重 mouseEnabled/mouseChildren，2-仅鼠标不透明对象。

回报：

数组：

指定坐标下的 DisplayObject 数组。

getObjectUnderPoint

(

x

y

mode

)

显示对象

继承自 Container： getObjectUnderPoint:497

类似于getObjectsUnderPoint，但只返回最顶层的显示对象。它的运行速度明显快于getObjectsUnderPoint()，但仍然可能是一项昂贵的操作。有关详细信息，请参阅getObjectsUnderPoint。

参数：

x数字

要测试的容器中的 x 位置。

y数字

要测试的容器中的 y 位置。

mode数字

用于确定要包括哪些显示对象的模式。0-全部，1-尊重 mouseEnabled/mouseChildren，2-仅鼠标不透明对象。

回报：

显示对象：

指定坐标下最顶层的显示对象。

getStage

() 已弃用

继承自 DisplayObject： getStage:691

请改用舞台属性。

getTransformedBounds

() 矩形

继承自 DisplayObject： getTransformedBounds:1166

返回一个矩形，表示该对象在其父坐标系中的边界（即应用了变换）。已缓存的对象将返回缓存的转换边界。

并非所有显示对象都可以计算自己的边界（例如形状）。对于这些对象，您可以使用 setBounds以便在计算容器边界时将它们包括在内。

为了减少内存影响，返回的 Rectangle 实例可以在内部重用；如果需要保留它，请克隆实例或复制其值。

容器实例为所有通过 getBounds 返回边界的子节点计算聚合边界。

回报：

矩形：

表示边界的 Rectangle 实例，如果边界不适用于此对象，则为 null。

globalToLocal

(

x

y

[pt]

)

观点

继承自 DisplayObject： globalToLocal:921

将指定的 x 和 y 位置从全局（舞台）坐标空间转换到显示对象的坐标空间。例如，这可用于确定显示对象内的当前鼠标位置。返回一个 Point 实例，其 x 和 y 属性与显示对象坐标空间中的变换位置相关。

例子参数：

x数字

舞台上要变换的 x 位置。

y数字

舞台上要变换的 y 位置。

[pt]点| 对象可选

将结果复制到的对象。如果省略，将返回具有 x/y 属性的新 Point 对象。

回报：

点：

具有与显示对象坐标空间中的变换位置相关的 x 和 y 属性的 Point 实例。

gotoAndPlay

(

positionOrLabel

)

定义于 gotoAndPlay:478

将此影片剪辑前进到指定的位置或标签，并将 paused 设置为 false。

参数：

positionOrLabel字符串| 数字

要转到的动画名称或帧号。

gotoAndStop

(

positionOrLabel

)

定义于 gotoAndStop:488

将此影片剪辑前进到指定的位置或标签，并将 paused 设置为 true。

参数：

positionOrLabel字符串| 数字

要转到的动画或帧名称。

hasEventListener

(

type

)

布尔值

继承自 EventDispatcher： hasEventListener:339

指示是否至少有一个针对指定事件类型的侦听器。

参数：

type细绳

事件的字符串类型。

回报：

布尔值：

如果指定事件至少有一个侦听器，则返回 true。

hitTest

(

x

y

)

布尔值

继承自 DisplayObject 但被覆盖 hitTest:450

测试显示对象是否与指定的局部点相交（即在指定位置绘制一个 alpha > 0 的像素）。这会忽略显示对象的 alpha、阴影和复合操作，以及包括 regX/Y 在内的所有变换属性。

参数：

x数字

在显示对象的本地坐标中检查的 x 位置。

y数字

在显示对象的本地坐标中检查的 y 位置。

回报：

布尔值：

一个布尔值，指示是否存在与指定坐标重叠的 DisplayObject 的可见部分。

initialize

() 已弃用

继承自 Container 但被覆盖 initialize:423

用于向后兼容的构造函数别名。此方法将在以后的版本中删除。应该更新子类以使用extend和 promote。

isVisible

() 布尔值

继承自 DisplayObject 但被覆盖 isVisible:432

返回 true 或 false 指示如果将显示对象绘制到画布上是否可见。这不考虑它是否会在舞台边界内可见。注意：此方法主要供内部使用，但它可能对高级用途有用。

回报：

布尔值：

布尔值，指示显示对象在绘制到画布时是否可见

localToGlobal

(

x

y

[pt]

)

观点

继承自 DisplayObject： localToGlobal:896

将指定的 x 和 y 位置从显示对象的坐标空间转换到全局（舞台）坐标空间。例如，这可用于将 HTML 标签放置在嵌套显示对象上的特定点上。返回一个 Point 实例，其 x 和 y 属性与舞台上变换后的坐标相关。

例子参数：

x数字

要变换的源显示对象中的 x 位置。

y数字

要变换的源显示对象中的 y 位置。

[pt]点| 对象可选

将结果复制到的对象。如果省略，将返回具有 x/y 属性的新 Point 对象。

回报：

点：

具有与舞台上变换后的坐标相关的 x 和 y 属性的 Point 实例。

localToLocal

(

x

y

target

[pt]

)

观点

继承自 DisplayObject： localToLocal:946

将指定的 x 和 y 位置从此显示对象的坐标空间转换到目标显示对象的坐标空间。返回一个 Point 实例，其 x 和 y 属性与目标坐标空间中的变换位置相关。实际上与将以下代码与 localToGlobal和globalToLocal一起使用相同。

参数：

x数字

要变换的源显示对象中的 x 位置。

y数字

要变换的源显示对象上的 y 位置。

target显示对象

坐标将转换到的目标显示对象。

[pt]点| 对象可选

将结果复制到的对象。如果省略，将返回具有 x/y 属性的新 Point 对象。

回报：

点：

返回一个 Point 实例，其 x 和 y 属性与目标坐标空间中的变换位置相关。

off

(

type

listener

[useCapture]

)

继承自 EventDispatcher： off:249

removeEventListener 方法的快捷方式，具有相同的参数和返回值。这是 .on 方法的伴侣。

重要提示：要删除添加的侦听on器，您必须将返回的包装函数作为侦听器传入。请参阅示例。

参数：

type细绳

事件的字符串类型。

listener功能| 目的

侦听器函数或对象。

[useCapture]布尔可选

对于冒泡的事件，指示是否在捕获或冒泡/目标阶段侦听事件。

on

(

type

listener

[scope]

[once=false]

[data]

[useCapture=false]

)

功能

继承自 EventDispatcher： on:173

一种使用 addEventListener 的快捷方法，可以更轻松地指定执行范围，让侦听器只运行一次，将任意数据与侦听器关联，并删除侦听器。

此方法通过创建匿名包装函数并使用 addEventListener 订阅它来工作。返回包装函数以用于removeEventListener（或off）。

重要提示：要删除使用添加的侦听on器，您必须将返回的包装函数作为侦听器传入，或者使用 remove。同样，每次调用on新包装函数时都会订阅，因此on使用相同参数的多次调用将创建多个侦听器。

例子参数：

type细绳

事件的字符串类型。

listener功能| 目的

一个具有handleEvent 方法的对象，或者一个在事件被调度时将被调用的函数。

[scope]对象可选

执行侦听器的范围。函数侦听器默认为 dispatcher/currentTarget，对象侦听器默认为侦听器本身（即使用 handleEvent）。

[once=false]布尔可选

如果为 true，则侦听器将在第一次触发后自行移除。

[data]可选的

调用侦听器时将作为第二个参数包含的任意数据。

[useCapture=false]布尔可选

对于冒泡的事件，指示是否在捕获或冒泡/目标阶段侦听事件。

回报：

功能：

返回创建并分配为侦听器的匿名函数。稍后需要使用 .removeEventListener 删除侦听器。

play

()

定义于 play:462

设置暂停为假。

removeAllChildren

()

继承自 Container： removeAllChildren:305

从显示列表中删除所有子项。

例子removeAllEventListeners

(

[type]

)

继承自 EventDispatcher： removeAllEventListeners:263

删除指定类型的所有侦听器，或所有类型的所有侦听器。

例子参数：

[type]字符串可选

事件的字符串类型。如果省略，所有类型的所有侦听器都将被删除。

removeChild

(

child

)

布尔值

继承自 Container： removeChild:249

从显示列表中删除指定的子项。请注意，如果索引已知，则使用 removeChildAt() 会更快。

例子

您还可以删除多个孩子：

如果子项（或多个子项）已被删除，则返回 true；如果它不在显示列表中，则返回 false。

参数：

child显示对象

要删除的孩子。

回报：

布尔值：

如果子项（或多个子项）已被删除，则为 true；如果它不在显示列表中，则为 false。

removeChildAt

(

index

)

布尔值

继承自 Container 但被覆盖 removeChildAt:276

从显示列表中删除指定索引处的子项，并将其父项设置为 null。

例子

您还可以删除多个孩子：

如果子项（或多个子项）被删除，则返回 true；如果任何索引超出范围，则返回 false。

参数：

index数字

要删除的孩子的索引。

回报：

布尔值：

如果子项（或多个子项）被删除，则为 true，如果任何索引超出范围，则为 false。

removeEventListener

(

type

listener

[useCapture]

)

继承自 EventDispatcher： removeEventListener:219

删除指定的事件侦听器。

重要提示：您必须传递添加事件时使用的确切函数引用。如果使用代理函数或函数闭包作为回调，则必须使用代理/闭包引用 - 新的代理或闭包将不起作用。

例子参数：

type细绳

事件的字符串类型。

listener功能| 目的

侦听器函数或对象。

[useCapture]布尔可选

对于冒泡的事件，指示是否在捕获或冒泡/目标阶段侦听事件。

set

(

props

)

DisplayObject 可链接

继承自 DisplayObject： set:1082

提供一种可链接的快捷方式，用于在实例上设置多个属性。

例子参数：

props目的

包含要复制到 DisplayObject 实例的属性的通用对象。

回报：

显示对象：

返回调用该方法的实例（对于链接调用很有用。）

setBounds

(

x

y

width

height

)

继承自 DisplayObject： setBounds:1185

允许您手动指定无法计算自己的边界（例如形状和文本）以供将来参考的对象的边界，或者可以将对象包含在容器边界中。手动设置的界限将始终覆盖计算的界限。

边界应在对象的本地（未转换）坐标中指定。例如，一个以 0,0 为中心的半径为 25px 的圆的 Shape 实例的边界为 (-25, -25, 50, 50)。

参数：

x数字

边界的 x 原点。传递 null 以删除手动边界。

y数字

边界的 y 原点。

width数字

边界的宽度。

height数字

边界的高度。

setChildIndex

(

child

index

)

继承自 Container： setChildIndex:418

更改指定子项的深度。如果子项不是此容器的子项，或者索引超出范围，则静默失败。

参数：

child显示对象

index数字

setTransform

(

[x=0]

[y=0]

[scaleX=1]

[scaleY=1]

[rotation=0]

[skewX=0]

[skewY=0]

[regX=0]

[regY=0]

)

DisplayObject 可链接

继承自 DisplayObject： setTransform:968

在显示对象上快速设置变换属性的快捷方法。所有参数都是可选的。省略的参数将设置默认值。

例子参数：

[x=0]号码可选

以像素为单位的水平平移（x 位置）

[y=0]号码可选

以像素为单位的垂直平移（y 位置）

[scaleX=1]号码可选

水平刻度，以 1 的百分比表示

[scaleY=1]号码可选

垂直比例，以 1 的百分比表示

[rotation=0]号码可选

旋转，以度为单位

[skewX=0]号码可选

水平偏斜系数

[skewY=0]号码可选

垂直偏斜系数

[regX=0]号码可选

以像素为单位的水平注册点

[regY=0]号码可选

以像素为单位的垂直配准点

回报：

显示对象：

返回此实例。用于链接命令。

sortChildren

(

sortFunction

)

继承自 Container： sortChildren:348

对子列表执行数组排序操作。

示例：显示前面 y 较高的孩子。参数：

sortFunction功能

用于对子列表进行排序的函数。有关详细信息，请参阅 JavaScript 的Array.sort文档。

stop

()

定义于 stop:470

设置暂停为真。

swapChildren

(

child1

child2

)

继承自 Container： swapChildren:398

交换显示列表中指定子项的深度。如果任一子级不是此容器的子级，则静默失败。

参数：

child1显示对象

child2显示对象

swapChildrenAt

(

index1

index2

)

继承自 Container： swapChildrenAt:383

交换指定索引处的子代。如果任一索引超出范围，则静默失败。

参数：

index1数字

index2数字

toString

() 字符串

继承自 EventDispatcher 但被覆盖 toString:531

返回此对象的字符串表示形式。

回报：

字符串：

实例的字符串表示形式。

uncache

()

继承自 DisplayObject： uncache:875

清除当前缓存。有关详细信息，请参阅缓存。

updateCache

(

compositeOperation

)

继承自 DisplayObject： updateCache:846

将显示对象重绘到其缓存。在没有活动缓存的情况下调用 updateCache 将引发错误。如果compositeOperation 为null，则当前缓存将在绘制之前被清除。否则，将使用指定的compositeOperation 在现有缓存上绘制显示对象。

例子

清除缓存形状的当前图形，绘制一些新指令，然后更新缓存。新线将绘制在旧线之上。

在以前的版本中，缓存是在 DisplayObject 上处理的，但后来被移到了BitmapCache中。这允许更轻松的交互和替代缓存方法，如 WebGL 和StageGL。

参数：

compositeOperation细绳

要使用的compositeOperation，或null 以清除缓存并重绘它。 whatwg 合成规范。

updateContext

(

ctx

)

继承自 DisplayObject： updateContext:771

将此显示对象的变换、alpha、globalCompositeOperation、剪切路径（遮罩）和阴影应用到指定的上下文。这通常在draw之前调用。

参数：

ctxCanvasRenderingContext2D

要更新的 2D 画布。

willTrigger

(

type

)

布尔值

继承自 EventDispatcher： willTrigger:350

指示此对象或其任何祖先（父级、父级的父级等）上的指定事件类型是否至少有一个侦听器。返回值为 true 表示如果从该对象调度指定类型的冒泡事件，它将触发至少一个侦听器。

这类似于hasEventListener，但它在整个事件流中搜索侦听器，而不仅仅是这个对象。

参数：

type细绳

事件的字符串类型。

回报：

布尔值：

true如果指定事件至少有一个侦听器，则返回。

属性actionsEnabled

布尔值

定义于 actionsEnabled:162

如果为 true，则当播放头前进时，将运行此 MovieClip 补间中的动作。

默认值：真

alpha

数字

继承自 DisplayObject： alpha:147

此显示对象的 alpha（透明度）。0 是完全透明的，1 是完全不透明的。

默认值：1

autoReset

布尔值

定义于 autoReset:170

如果为 true，每当时间线将其添加回显示列表时，MovieClip 将自动重置为其第一帧。这仅适用于具有mode“独立”的 MovieClip 实例。

例如，如果您有一个角色动画，其中有一个“body”子 MovieClip 实例，每个帧上都有不同的服装，您可以设置body.autoReset = false，这样您就可以手动更改它所在的帧，而不必担心它会自动重置。

默认值：真

bitmapCache

BitmapCache 只读

继承自 DisplayObject： bitmapCache:165

如果已创建缓存，则返回管理 cacheCanvas 及其属性的类。有关详细信息，请参阅位图缓存。使用它来控制、检查和更改缓存。在特殊情况下，这可能是经过修改或子类化的 BitmapCache。

默认值：空

cacheCanvas

HTMLCanvasElement | 对象只读

继承自 DisplayObject： cacheCanvas:155

如果缓存处于活动状态，则返回包含此显示对象图像的画布。有关详细信息，请参阅缓存。使用它来显示缓存的结果。这将是一个 HTMLCanvasElement，除非特意为此缓存启用了特殊的缓存规则。

默认值：空

cacheID

数量已弃用

继承自 DisplayObject： cacheID:706

返回唯一标识此显示对象的当前缓存的 ID 号。这可用于确定自上次检查以来缓存是否已更改。移至位图缓存

默认值：0

children

大批

继承自 Container： children:61

显示列表中的子元素数组。您通常应该使用子管理方法，例如 addChild、removeChild、 swapChildren等，而不是直接访问它，但它包含在高级用途中。

默认值：空

compositeOperation

细绳

继承自 DisplayObject： compositeOperation:333

合成操作指示此显示对象的像素将如何与其后面的元素合成。如果null，则此属性是从父容器继承的。有关更多信息，请阅读关于合成的 whatwg 规范。有关受支持的compositeOperation 值的列表，请访问关于合成和混合的W3C 草案。

默认值：空

currentFrame

数字只读

定义于 currentFrame:145

影片剪辑的当前帧。

默认值：0

currentLabel

字符串只读

定义于 currentLabel:391

返回当前帧上或之前的标签名称。

cursor

细绳

继承自 DisplayObject： cursor:391

当用户将鼠标悬停在此显示对象上时将显示的 CSS 光标（例如“指针”、“帮助”、“文本”等）。您必须使用enableMouseOver方法启用鼠标悬停事件才能使用此属性。在 Container 上设置非空游标将覆盖在其后代上设置的游标。

默认值：空

duration

数字只读

定义于 duration:405

返回此 MovieClip 的持续时间（以秒或节拍为单位）。

filters

大批

继承自 DisplayObject： filters:355

要应用于此显示对象的过滤器对象数组。过滤器仅在显示对象上调用 Cache 或 UpdateCache 时应用/更新，并且仅适用于缓存的区域。

默认值：空

frameBounds

大批

定义于 frameBounds:183

MovieClip 中每一帧的边界数组。这主要用于工具输出。

默认值：空

framerate

数字

定义于 framerate:191

默认情况下，MovieClip 实例每刻前进一帧。为 MovieClip 指定帧速率将使其根据滴答之间经过的时间适当地保持目标帧速率。

例如，如果将帧率为 10 的 MovieClip 放置在以 40fps 更新的 Stage 上，则 MovieClip 将大约每 4 tick 前进一帧。这并不准确，因为每个刻度之间的时间在帧之间会略有不同。

此功能取决于传递给update的滴答事件对象（或具有适当“delta”属性的对象）。

默认值：空

hitArea

显示对象

继承自 DisplayObject： hitArea:374

在检查鼠标交互或测试getObjectsUnderPoint时将测试的显示对象。命中区域将相对于该显示对象的坐标空间应用其变换（就好像命中测试对象是该显示对象的子对象并相对于其 regX/Y）。alpha无论目标显示对象或目标的祖先（父母）上的 alpha 值如何，都将仅使用其自己的值测试 hitArea 。

如果在 Container 上设置，则Container的子级将不会接收鼠标事件。这类似于将 MouseChildren 设置为 false。

请注意，该方法当前不使用 hitArea ， StagehitTest()也不支持它。

默认值：空

id

数字

继承自 DisplayObject： id:175

此显示对象的唯一 ID。使显示对象更容易用于某些用途。

默认值：-1

INDEPENDENT

字符串静态只读

定义于 INDEPENDENT:283

MovieClip 将独立于其父级前进，即使其父级已暂停。这是默认模式。

默认值：“独立”

labels

数组只读

定义于 labels:384

返回具有标签和位置（又名框架）属性的对象数组，按位置排序。

loop

数字

定义于 loop:136

指定此 MovieClip 应循环多少次。值 -1 表示它应该无限循环。值为 1 将导致它循环一次（即总共播放两次）。

默认值：-1

mask

形状

继承自 DisplayObject： mask:365

定义此显示对象的矢量蒙版（剪切路径）的 Shape 实例。形状的变换将相对于显示对象的父坐标应用（就好像它是父对象的子对象一样）。

默认值：空

mode

细绳

定义于 mode:119

控制此 MovieClip 如何推进其时间。必须是 0 (INDEPENDENT)、1 (SINGLE_FRAME) 或 2 (SYNCHED) 之一。有关行为的描述，请参见每个常量。

默认值：空

mouseChildren

布尔值

继承自 Container： mouseChildren:72

指示此容器的子项是否独立启用鼠标/指针交互。如果为 false，则子元素将聚合在容器下 - 例如，单击子形状将触发容器上的单击事件。

默认值：真

mouseEnabled

布尔值

继承自 DisplayObject： mouseEnabled:183

指示在运行鼠标交互时是否包含此对象。将此项设置false为Container的子项将导致 Container 上的事件在单击该子项时不会触发。将此属性设置为false不会阻止getObjectsUnderPoint 方法返回子项。

注意：在 EaselJS 0.7.0 中，mouseEnabled 属性将无法与嵌套容器一起正常工作。请查看GitHub中最新的 NEXT 版本以获取已解决此问题的更新版本。该修复将在 EaselJS 的下一个版本中提供。

默认值：真

name

细绳

继承自 DisplayObject： name:208

此显示对象的可选名称。包含在toString中。对调试很有用。

默认值：空

numChildren

数字只读

继承自 Container： numChildren:114

返回容器中的子节点数。

parent

容器最终只读

继承自 DisplayObject： parent:217

对包含此显示对象的Container或Stage对象的引用，如果尚未添加到其中，则为 null。

默认值：空

paused

布尔值

定义于 paused:154

如果为 true，则选中时，MovieClip 的位置不会前进。

默认值：假

regX

数字

继承自 DisplayObject： regX:229

此显示对象注册点的左偏移量。例如，要使 100x100px 位图围绕其中心旋转，您可以将 regX 和regY设置为 50。缓存对象的注册点应根据预缓存条件设置，而不是缓存大小。

默认值：0

regY

数字

继承自 DisplayObject： regY:239

此显示对象的注册点的 y 偏移量。例如，要使 100x100px 位图围绕其中心旋转，您可以将regX和 regY 设置为 50。缓存对象的注册点应根据预缓存条件设置，而不是缓存大小。

默认值：0

rotation

数字

继承自 DisplayObject： rotation:249

此显示对象的旋转度数。

默认值：0

scale

数字

继承自 DisplayObject： scale:716

将scaleX和scaleY 属性设置为相同的值。请注意，当您获取值时，如果scaleX和scaleY是不同的值，它将仅返回scaleX.

默认值：1

scaleX

数字

继承自 DisplayObject： scaleX:257

水平拉伸此显示对象的因子。例如，将 scaleX 设置为 2 会将显示对象拉伸为其标称宽度的两倍。要水平翻转对象，请将比例设置为负数。

默认值：1

scaleY

数字

继承自 DisplayObject： scaleY:266

垂直拉伸此显示对象的因子。例如，将 scaleY 设置为 0.5 会将显示对象拉伸到其标称高度的一半。要垂直翻转对象，请将比例设置为负数。

默认值：1

shadow

阴影

继承自 DisplayObject： shadow:291

定义要在此显示对象上呈现的阴影的阴影对象。设置为null删除阴影。如果为 null，则从父容器继承此属性。

默认值：空

SINGLE_FRAME

字符串静态只读

定义于 SINGLE_FRAME:294

MovieClip 将仅显示单个帧（由 startPosition 属性确定）。

默认值：“单”

skewX

数字

继承自 DisplayObject： skewX:275

水平倾斜此显示对象的因素。

默认值：0

skewY

数字

继承自 DisplayObject： skewY:283

垂直倾斜此显示对象的因素。

默认值：0

snapToPixel

布尔值

继承自 DisplayObject： snapToPixel:345

指示当snapToPixelEnabled为 true时是否应将显示对象绘制到整个像素。要在整个显示对象类别上启用/禁用捕捉，请在原型上设置此值（例如 Text.prototype.snapToPixel = true）。

默认值：真

stage

阶段只读

继承自 DisplayObject： stage:699

返回此显示对象将在其上呈现的 Stage 实例，如果尚未添加，则返回 null。

startPosition

数字

定义于 startPosition:128

指定要在此影片剪辑中播放的第一帧，或者如果模式为 SINGLE_FRAME 时要显示的唯一帧。

默认值：0

SYNCHED

字符串静态只读

定义于 SYNCHED:304

MovieClip 仅在其父级前进时才会前进，并将同步到父级 MovieClip 的位置。

默认值：“同步”

tickChildren

布尔值

继承自 Container： tickChildren:82

如果为 false，则刻度不会传播到此 Container 的子级。这可以提供一些性能优势。除了阻止“tick”事件被调度外，它还将阻止某些显示对象上的与滴答相关的更新（例如 Sprite 和 MovieClip 帧推进、DOMElement 可见性处理）。

默认值：真

tickEnabled

布尔值

继承自 DisplayObject： tickEnabled:198

如果为 false，则刻度不会在此显示对象（或其子对象）上运行。这可以提供一些性能优势。除了阻止“tick”事件被调度外，它还将阻止某些显示对象（例如 Sprite 和 MovieClip 帧推进和 DOMElement 显示属性）上的与滴答相关的更新。

默认值：真

timeline

时间线

定义于 timeline:211

与此 MovieClip 关联的 TweenJS 时间轴。这是在初始化 MovieClip 实例时自动创建的。通过将TweenJS Tween 实例添加到时间轴来创建动画。

例子

var tween = createjs.Tween.get(target).to({x:0}).to({x:100}, 30); var mc = new createjs.MovieClip(); mc.timeline.addTween(tween);

tweenInstance.to()通过使用该方法切换“_off”属性，可以从时间轴中添加和删除元素。请注意，Tween.set不建议使用创建 MovieClip 动画。下面的示例将在第 0 帧关闭目标，然后在第 1 帧重新打开。您可以使用“可见”属性来实现相同的效果。

var tween = createjs.Tween.get(target).to({_off:false}) .wait(1).to({_off:true}) .wait(1).to({_off:false});

默认值：空

totalFrames

数字只读

定义于 totalFrames:398

返回此 MovieClip 的持续时间（以秒或节拍为单位）。

transformMatrix

Matrix2D

继承自 DisplayObject： transformMatrix:324

如果设置，则定义此显示对象的变换，覆盖所有其他变换属性（x、y、旋转、缩放、倾斜）。

默认值：空

visible

布尔值

继承自 DisplayObject： visible:300

指示在运行 Stage getObjectsUnderPoint方法时是否应将此显示对象呈现到画布并包含在内。

默认值：真

x

数字

继承自 DisplayObject： x:309

显示对象相对于其父对象的 x（水平）位置。

默认值：0

y

数字

继承自 DisplayObject： y:317

默认值：0

事件added

继承自 DisplayObject： added:651

当显示对象添加到父容器时调度。

click

继承自 DisplayObject： click:549

自 0.6.0 起可用

当用户按下鼠标左键然后在显示对象上方释放它时调度。有关事件属性的列表，请参见MouseEvent类。

dblclick

继承自 DisplayObject： dblclick:556

自 0.6.0 起可用

当用户在此显示对象上双击鼠标左键时调度。有关事件属性的列表，请参见MouseEvent类。

mousedown

继承自 DisplayObject： mousedown:542

自 0.6.0 起可用

当用户在显示对象上按下鼠标左键时调度。有关事件属性的列表，请参见 MouseEvent类。

mouseout

继承自 DisplayObject： mouseout:571

自 0.6.0 起可用

当用户的鼠标离开此显示对象时调度。必须使用 enableMouseOver启用此事件。另请参阅推出。有关事件属性的列表，请参见MouseEvent类。

mouseover

继承自 DisplayObject： mouseover:563

自 0.6.0 起可用

当用户的鼠标进入此显示对象时调度。必须使用 enableMouseOver启用此事件。另请参阅翻转。有关事件属性的列表，请参见MouseEvent类。

pressmove

继承自 DisplayObject： pressmove:621

自 0.7.0 起可用

在显示对象上发生mousedown后，只要鼠标移动，就会在该对象上生成一个 pressmove 事件，直到释放鼠标按下为止。这对于拖动和类似操作很有用。

请注意，如果事件的初始鼠标目标mousedown在被按下后（例如在pressmove事件期间）从舞台上移除，pressmove仍然会生成事件。但是，由于它不再在显示列表中，因此该事件不能冒泡。这意味着以前的祖先（父容器）将不会收到该事件，因此无法重新调度它。如果您打算侦听动态对象（例如MovieClippressup或Container ），请确保将mouseChildren设置为.pressmovefalse

pressup

继承自 DisplayObject： pressup:636

自 0.7.0 起可用

在显示对象上发生mousedown后，释放鼠标按下时将在该对象上生成 pressup 事件。这对于拖动和类似操作很有用。

请注意，如果事件的初始鼠标目标mousedown在被按下后（例如在pressmove事件期间）从舞台上移除，pressup仍然会生成事件。但是，由于它不再在显示列表中，因此该事件不能冒泡。这意味着以前的祖先（父容器）将不会收到该事件，因此无法重新调度它。如果您打算侦听动态对象（例如MovieClippressmove或Container ），请确保将mouseChildren设置为.pressupfalse

removed

继承自 DisplayObject： removed:656

当显示对象从其父容器中移除时调度。

rollout

继承自 DisplayObject： rollout:600

自 0.7.0 起可用

此事件类似于mouseout，但有以下区别：它不会冒泡，并将Container实例视为其内容的聚合。

例如，myContainer 包含两个重叠的孩子：shapeA 和 shapeB。用户将鼠标移到 shapeA 上，然后直接移到 shapeB 上，然后两者都关闭。使用 myContainer 上的 Mouseout:event 侦听器，将收到两个事件，每个事件都针对一个子元素：

当鼠标离开 shapeA (target=shapeA)

当鼠标离开 shapeB (target=shapeB)

但是，如果使用“rollout”侦听器，当鼠标离开聚合 myContainer 内容 (target=myContainer) 时，只会收到一个事件。

必须使用enableMouseOver启用此事件。有关事件属性的列表，请参见MouseEvent类。