annie.MovieClip Class

annie引擎核心类

Extends annie.Sprite
Defined in: libs/MovieClip.js:11
Module: annie

Available since 1.0.0

Methods

_updateSplitBounds

_updateSplitBounds () private

Inherited from annie.DisplayObject: libs/DisplayObject.js:813

更新boundsList矩阵

addChild

addChild
(
  • child
)
Void public

Inherited from annie.Sprite: libs/Sprite.js:78

Available since 1.0.0

添加一个显示对象到Sprite

Parameters:

nametypeflagdescription
child annie.DisplayObject

Returns:

Void:

addChildAt

addChildAt
(
  • child
  • index
)
Void public

Inherited from annie.Sprite: libs/Sprite.js:168

Available since 1.0.0

添加一个child到Sprite中并指定添加到哪个层级

Parameters:

nametypeflagdescription
child annie.DisplayObject
index Number

从0开始

Returns:

Void:

addEventListener

addEventListener
(
  • type
  • listener
  • useCapture
)
Void public

Inherited from annie.EventDispatcher: libs/EventDispatcher.js:100

Available since 1.0.0

给对象添加一个侦听

Parameters:

nametypeflagdescription
type String

侦听类型

listener Function

侦听后的回调方法,如果这个方法是类实例的方法,为了this引用的正确性,请在方法参数后加上.bind(this);

useCapture Boolean

true 捕获阶段 false 冒泡阶段 默认 true

Returns:

Void:

Example:

 this.addEventListener(annie.Event.ADD_TO_STAGE,function(e){console.log(this);}.bind(this));

addFrameScript

addFrameScript
(
  • frameIndex
  • frameScript
)
public

Defined in libs/MovieClip.js:145

Available since 1.0.0

给时间轴添加回调函数,当时间轴播放到当前帧时,此函数将被调用.注意,之前在此帧上添加的所有代码将被覆盖,包括Fla文件中当前帧的代码.

Parameters:

nametypeflagdescription
frameIndex Number

{number} 要将代码添加到哪一帧,从0开始.0就是第一帧,1是第二帧...

frameScript Function

{Function} 时间轴播放到当前帧时要执行回调方法

addSound

addSound
(
  • sound
)
Void public

Inherited from annie.DisplayObject: libs/DisplayObject.js:897

Available since 2.0.0

返回一个id，这个id你要留着作为删除他时使用。 这个声音会根据这个显示对象添加到舞台时播放，移出舞台而关闭

Parameters:

nametypeflagdescription
sound annie.Sound

Returns:

Void:

clearCustomTransform

clearCustomTransform
(
  • transId
)
public

Inherited from annie.DisplayObject: libs/DisplayObject.js:1026

Available since 3.1.0

如果你在mc更改了对象的x y scale rotation alpha，最后想还原，不再需要自我控制，可以调用这方法

Parameters:

nametypeflagdescription
transId Number

//0->x,1->y,2->scaleX,3->scaleY,4->rotation,5->alpha,-1->all

destroy

destroy () Void public

Inherited from annie.AObject: libs/EventDispatcher.js:55

Available since 2.0.0

销毁一个对象 销毁之前一定要做完其他善后工作，否则有可能会出错 特别注意不能在对象自身方法或事件里调用此方法。 比如，不要在显示对象自身的 annie.Event.ON_REMOVE_TO_STAGE 或者其他类似事件调用，一定会报错

Returns:

Void:

dispatchEvent

dispatchEvent
(
  • event
  • data
  • useCapture
)
Boolean public

Inherited from annie.EventDispatcher: libs/EventDispatcher.js:147

Available since 1.0.0

广播侦听

Parameters:

nametypeflagdescription
event annie.Event | String

广播所带的事件对象,如果传的是字符串则自动生成一个annie.Event对象,事件类型就是传入进来的字符串的值

data Object

广播后跟着事件一起传过去的其他任信息,默认值为null

useCapture Boolean

true 捕获阶段 false 冒泡阶段 默认 true

Returns:

[Boolean]

如果有收听者则返回true

Example:

 var mySprite=new annie.Sprite(),
 yourEvent=new annie.Event("yourCustomerEvent");
 yourEvent.data={a:1,b:2,c:"hello",d:{aa:1,bb:2}};
 mySprite.addEventListener("yourCustomerEvent",function(e){
     console.log(e.data);
 })
 mySprite.dispatchEvent(yourEvent);

DisplayObject

DisplayObject () public

Inherited from annie.DisplayObject: libs/DisplayObject.js:70

Available since 1.0.0

getChildAt

getChildAt
(
  • index
)
annie.DisplayObject public

Inherited from annie.Sprite: libs/Sprite.js:217

Available since 1.0.0

获取Sprite中指定层级一个child

Parameters:

nametypeflagdescription
index Number

从0开始

Returns:

annie.DisplayObject:

getChildByName

getChildByName
(
  • name
  • isOnlyOne
  • isRecursive
)
String | Array public

Inherited from annie.Sprite: libs/Sprite.js:132

Available since 1.0.0

通过给displayObject设置的名字来获取一个child,可以使用正则匹配查找

Parameters:

nametypeflagdescription
name String

对象的具体名字或是一个正则表达式

isOnlyOne Boolean

默认为true,如果为true,只返回最先找到的对象,如果为false则会找到所有匹配的对象数组

isRecursive Boolean

false,如果为true,则会递归查找下去,而不只是查找当前对象中的child,child里的child也会找,依此类推

Returns:

[String | Array]

返回一个对象,或者一个对象数组,没有找到则返回空

getChildIndex

getChildIndex
(
  • child
)
Number public

Inherited from annie.Sprite: libs/Sprite.js:233

Available since 1.0.2

获取Sprite中一个child所在的层级索引，找到则返回索引数，未找到则返回-1

Parameters:

nametypeflagdescription
child annie.DisplayObject

子对象

Returns:

Number:

getCurrentLabel

getCurrentLabel () Array public

Defined in libs/MovieClip.js:264

Available since 1.0.0

movieClip的当前帧的标签数组,没有则为null

Returns:

Array:

getDrawRect

getDrawRect () annie.Rectangle public

Inherited from annie.DisplayObject: libs/DisplayObject.js:661

Available since 1.0.0

获取对象形变后外切矩形 可以从这个方法中读取到此显示对象变形后x方向上的宽和y方向上的高

Returns:

annie.Rectangle:

getSound

getSound
(
  • id
)
Array

Inherited from annie.DisplayObject: libs/DisplayObject.js:872

Available since 2.0.0

Parameters:

nametypeflagdescription
id Number | String

Returns:

[Array]

这个对象里所有叫这个名字的声音引用数组

getWH

getWH () W: number; h: number

Inherited from annie.DisplayObject: libs/DisplayObject.js:757

Available since 1.1.0

获取宽高

Returns:

[W: number; h: number]

}

globalToLocal

globalToLocal
(
  • point
)
annie.Point public

Inherited from annie.DisplayObject: libs/DisplayObject.js:568

Available since 1.0.0

将全局坐标转换到本地坐标值

Parameters:

nametypeflagdescription
point annie.Point

Returns:

annie.Point:

gotoAndPlay

gotoAndPlay
(
  • frameIndex
  • isFront
)
Void public

Defined in libs/MovieClip.js:354

Available since 1.0.0

将播放头跳转到指定帧并从那一帧开始继续播放

Parameters:

nametypeflagdescription
frameIndex Number | String

批定帧的帧数或指定帧的标签名

isFront Boolean

跳到指定帧后是向前播放, 还是向后播放.不设置些参数将默认向前播放

Returns:

Void:

gotoAndStop

gotoAndStop
(
  • frameIndex
)
Void public

Defined in libs/MovieClip.js:310

Available since 1.0.0

将播放头跳转到指定帧并停在那一帧,如果本身在第一帧则不做任何反应

Parameters:

nametypeflagdescription
frameIndex Number | String

批定帧的帧数或指定帧的标签名

Returns:

Void:

hasEventListener

hasEventListener
(
  • type
  • useCapture
)
Boolean public

Inherited from annie.EventDispatcher: libs/EventDispatcher.js:206

Available since 1.0.0

是否有添加过此类型的侦听

Parameters:

nametypeflagdescription
type String

侦听类型

useCapture Boolean

true 捕获阶段 false 冒泡阶段 默认 true

Returns:

[Boolean]

如果有则返回true

hitTestPoint

hitTestPoint
(
  • hitPoint
  • isGlobalPoint
)
annie.DisplayObject public

Inherited from annie.DisplayObject: libs/DisplayObject.js:609

Available since 1.0.0

点击碰撞测试,就是舞台上的一个point是否在显示对象内,在则返回该对象，不在则返回null

Parameters:

nametypeflagdescription
hitPoint annie.Point

要检测碰撞的点

isGlobalPoint Boolean

是不是全局坐标的点,默认false是本地坐标

Returns:

annie.DisplayObject:

initButton

initButton () Void public

Defined in libs/MovieClip.js:186

Available since 1.0.0

将一个mc变成按钮来使用 如果mc在于2帧,那么点击此mc将自动有被按钮的状态,无需用户自己写代码. 此方法不可逆，设置后不再能设置回剪辑，一定要这么做的话，请联系作者，看作者答不答应

Returns:

Void:

localToGlobal

localToGlobal
(
  • point
)
annie.Point public

Inherited from annie.DisplayObject: libs/DisplayObject.js:580

Available since 1.0.0

将本地坐标转换到全局坐标值

Parameters:

nametypeflagdescription
point annie.Point

Returns:

annie.Point:

MovieClip

MovieClip () public

Defined in libs/MovieClip.js:20

Available since 1.0.0

构造函数

nextFrame

nextFrame () Void public

Defined in libs/MovieClip.js:278

Available since 1.0.0

将播放头向后移一帧并停在下一帧,如果本身在最后一帧则不做任何反应

Returns:

Void:

play

play
(
  • isFront
)
Void public

Defined in libs/MovieClip.js:340

Available since 1.0.0

如果当前时间轴停在某一帧,调用此方法将继续播放.

Parameters:

nametypeflagdescription
isFront Boolean

true向前播放，false 向后播放。默认向前

Returns:

Void:

prevFrame

prevFrame () Void public

Defined in libs/MovieClip.js:294

Available since 1.0.0

将播放头向前移一帧并停在下一帧,如果本身在第一帧则不做任何反应

Returns:

Void:

removeAllChildren

removeAllChildren () Void public

Inherited from annie.Sprite: libs/Sprite.js:325

Available since 1.0.0

移除Sprite上的所有child

Returns:

Void:

removeAllEventListener

removeAllEventListener () Void public

Inherited from annie.EventDispatcher: libs/EventDispatcher.js:259

Available since 1.0.0

移除对象中所有的侦听

Returns:

Void:

removeChild

removeChild
(
  • child
)
Void public

Inherited from annie.Sprite: libs/Sprite.js:89

Available since 1.0.0

从Sprite中移除一个child

Parameters:

nametypeflagdescription
child annie.DisplayObject

Returns:

Void:

removeChildAt

removeChildAt
(
  • index
)
Void public

Inherited from annie.Sprite: libs/Sprite.js:286

Available since 1.0.0

移除指定层级上的孩子

Parameters:

nametypeflagdescription
index Number

从0开始

Returns:

Void:

removeEventListener

removeEventListener
(
  • type
  • listener
  • useCapture
)
Void public

Inherited from annie.EventDispatcher: libs/EventDispatcher.js:230

Available since 1.0.0

移除对应类型的侦听

Parameters:

nametypeflagdescription
type String

要移除的侦听类型

listener Function

侦听时绑定的回调方法

useCapture Boolean

true 捕获阶段 false 冒泡阶段 默认 true

Returns:

Void:

removeFrameScript

removeFrameScript
(
  • frameIndex
)
public

Defined in libs/MovieClip.js:159

Available since 1.0.0

移除帧上的回调方法

Parameters:

nametypeflagdescription
frameIndex Number

removeSound

removeSound
(
  • id
)
Void public

Inherited from annie.DisplayObject: libs/DisplayObject.js:913

Available since 2.0.0

删除一个已经添加进来的声音

Parameters:

nametypeflagdescription
id Number | String

Returns:

Void:

Sprite

Sprite () public

Inherited from annie.Sprite: libs/Sprite.js:23

Available since 1.0.0

构造函数

startDrag

startDrag
(
  • isCenter
  • bounds
)
Void public

Inherited from annie.DisplayObject: libs/DisplayObject.js:989

Available since 1.1.2

启动鼠标或者触摸拖动

Parameters:

nametypeflagdescription
isCenter Boolean

指定将可拖动的对象锁定到指针位置中心 (true)，还是锁定到用户第一次单击该对象的位置 (false) 默认false

bounds annie.Rectangle

相对于显示对象父级的坐标的值，用于指定 Sprite 约束矩形

Returns:

Void:

stop

stop () Void public

Defined in libs/MovieClip.js:131

Available since 1.0.0

调用止方法将停止当前帧

Returns:

Void:

stopAllSounds

stopAllSounds () Void public

Inherited from annie.DisplayObject: libs/DisplayObject.js:798

Available since 2.0.0

停止这个显示对象上的所有声音

Returns:

Void:

stopDrag

stopDrag ()

Inherited from annie.DisplayObject: libs/DisplayObject.js:1019

停止鼠标跟随

swapChild

swapChild
(
  • child1
  • child2
)
Boolean

Inherited from annie.Sprite: libs/Sprite.js:251

Available since 2.0.0

交换两个显示对象的层级

Parameters:

nametypeflagdescription
child1 Object

显示对象，或者显示对象的索引

child2 Object

显示对象，或者显示对象的索引

Returns:

Boolean:

updateCache

updateCache () Void

Inherited from annie.Sprite: libs/Sprite.js:316

Available since 3.2.0

如果对容器缓存为位图过,则会更新缓存,没事别乱调用

Returns:

Void:

Properties

alpha

Number public

Inherited from annie.DisplayObject: libs/DisplayObject.js:328

Available since 1.0.0

显示对象透明度

Default:

1

anchorX

Number public

Inherited from annie.DisplayObject: libs/DisplayObject.js:399

Available since 1.0.0

显示对象上x方向的缩放或旋转点

Default:

0

anchorY

Number public

Inherited from annie.DisplayObject: libs/DisplayObject.js:421

Available since 1.0.0

显示对象上y方向的缩放或旋转点

Default:

0

blendMode

Number public

Inherited from annie.DisplayObject: libs/DisplayObject.js:465

Available since 1.0.0

显示对象的混合模式 支持的混合模式大概有23种，具体查看annie.BlendMode

Default:

0

cacheAsBitmap

Unknown

Inherited from annie.DisplayObject: libs/DisplayObject.js:190

Available since 3.2.0

是否将这个对象缓存为位图了

children

Array public

Inherited from annie.Sprite: libs/Sprite.js:52

Available since 1.0.0

显示对象的child列表

Default:

[]

clicked

Unknown public

Defined in libs/MovieClip.js:218

Available since 2.0.0

如果MovieClip设置成了按钮，则通过此属性可以让它定在按下后的状态上，哪怕再点击它并离开它的时候，他也不会变化状态

currentFrame

Number public

Defined in libs/MovieClip.js:66

Available since 1.0.0

mc的当前帧

Default:

1

filters

Array public

Inherited from annie.DisplayObject: libs/DisplayObject.js:534

Available since 1.0.0

小游戏不支持 小程序不支持

显示对象的滤镜数组

Default:

null

height

Unknown public

Inherited from annie.DisplayObject: libs/DisplayObject.js:769

Available since 1.0.3

获取或者设置显示对象在父级里的y方向的高,不到必要不要用此属性获取高 如果你要同时获取宽高，建议使用getWH()方法获取宽和高

hitArea

Unknown

Inherited from annie.DisplayObject: libs/DisplayObject.js:596

Available since 3.0.1

annie.Sprite显示容器的接受鼠标点击的区域。一但设置，容器里所有子级将不会触发任何鼠标相关的事件。 相当于 mouseChildren=false,但在有大量子级显示对象的情况下，此方法的性能搞出mouseChildren几个数量级，建议使用。

Sub-properties:

hitTestWithPixel

Boolean

Inherited from annie.DisplayObject: libs/DisplayObject.js:146

Available since 1.1.0

小游戏不支持 小程序不支持

是否对图片对象使用像素碰撞检测透明度，默认关闭

Default:

false

instanceId

Number public

Inherited from annie.AObject: libs/EventDispatcher.js:23

Available since 1.0.0

每一个annie引擎对象都会有一个唯一的id码。

Example:

 //获取 annie引擎类对象唯一码
 console.log(this.instanceId);

instanceType

String public

Inherited from annie.AObject: libs/EventDispatcher.js:41

Available since 1.0.3

每一个annie类都有一个实例类型字符串，通过这个字符串，你能知道这个实例是从哪个类实例而来

isButton

Boolean public

Defined in libs/MovieClip.js:172

Available since 2.0.0

确认是不是按钮形态

Default:

false

isCache

Boolean

Inherited from annie.DisplayObject: libs/DisplayObject.js:177

Available since 3.2.0

是否被缓存了

isFront

Boolean public

Defined in libs/MovieClip.js:100

Available since 1.0.0

动画的播放方向,是顺着播还是在倒着播

Default:

true

isPlaying

Boolean public

Defined in libs/MovieClip.js:83

Available since 1.0.0

当前动画是否处于播放状态

Default:

true

mask

annie.DisplayObject public

Inherited from annie.DisplayObject: libs/DisplayObject.js:505

Available since 1.0.0

显示对象的遮罩, 是一个Shape显示对象或是一个只包含shape显示对象的MovieClip

Default:

null

matrix

annie.Matrix public

Inherited from annie.DisplayObject: libs/DisplayObject.js:489

Available since 1.0.0

显示对象的变形矩阵

Default:

null

mcSpeed

Number public

Inherited from annie.Sprite: libs/Sprite.js:31

Available since 3.1.5

容器类所有动画的播放速度，默认是1.如果有嵌套的话，速度相乘；

Default:

1

mouseChildren

Boolean public

Inherited from annie.Sprite: libs/Sprite.js:42

Available since 1.0.0

是否可以让children接收鼠标事件 鼠标事件将不会往下冒泡

Default:

true

mouseEnable

Boolean public

Inherited from annie.DisplayObject: libs/DisplayObject.js:107

Available since 1.0.0

是否可以接受点击事件,如果设置为false,此显示对象将无法接收到点击事件

Default:

false

name

String public

Inherited from annie.DisplayObject: libs/DisplayObject.js:116

Available since 1.0.0

每一个显示对象都可以给他命一个名字,这样我们在查找子级的时候就可以直接用this.getChildrndByName("name")获取到这个对象的引用

Default:

""

parent

annie.Sprite public

Inherited from annie.DisplayObject: libs/DisplayObject.js:93

Available since 1.0.0

显示对象的父级

Default:

null

rotation

Number public

Inherited from annie.DisplayObject: libs/DisplayObject.js:303

Available since 1.0.0

显示对象旋转角度

Default:

0

scaleX

Number public

Inherited from annie.DisplayObject: libs/DisplayObject.js:257

Available since 1.0.0

显示对象x方向的缩放值

Default:

1

scaleY

Number public

Inherited from annie.DisplayObject: libs/DisplayObject.js:280

Available since 1.0.0

显示对象y方向的缩放值

Default:

1

skewX

Number public

Inherited from annie.DisplayObject: libs/DisplayObject.js:351

Available since 1.0.0

显示对象x方向的斜切值

Default:

0

skewY

Number public

Inherited from annie.DisplayObject: libs/DisplayObject.js:375

Available since 1.0.0

显示对象y方向的斜切值

Default:

0

soundList

Array public

Inherited from annie.DisplayObject: libs/DisplayObject.js:160

Available since 2.0.0

当前对象包含的声音列表

Default:

[]

stage

Stage public

Inherited from annie.DisplayObject: libs/DisplayObject.js:83

Available since 1.0.0

此显示对象所在的舞台对象,如果此对象没有被添加到显示对象列表中,此对象为空。

Default:

null;

totalFrames

Number public

Defined in libs/MovieClip.js:116

Available since 1.0.0

当前动画的总帧数

Default:

1

visible

Boolean public

Inherited from annie.DisplayObject: libs/DisplayObject.js:443

Available since 1.0.0

显未对象是否可见

Default:

0

width

Unknown public

Inherited from annie.DisplayObject: libs/DisplayObject.js:728

Available since 1.0.3

获取或者设置显示对象在父级里的x方向的宽，不到必要不要用此属性获取高 如果你要同时获取宽高，建议使用 getWH()方法获取宽和高

x

Number public

Inherited from annie.DisplayObject: libs/DisplayObject.js:211

Available since 1.0.0

显示对象位置x

Default:

0

y

Number public

Inherited from annie.DisplayObject: libs/DisplayObject.js:234

Available since 1.0.0

显示对象位置y

Default:

0

Events

ADD_TO_STAGE

Inherited from annie.DisplayObject: libs/DisplayObject.js:23

Available since 1.0.0

annie.DisplayObject显示对象加入到舞台事件

annie.Event.CALL_FRAME

String public static

Defined in libs/MovieClip.js:57

Available since 1.0.0

annie.MovieClip 帧标签事件

annie.Event.END_FRAME

String public static

Defined in libs/MovieClip.js:49

Available since 1.0.0

annie.MovieClip 播放完成事件

CLICK

String

Inherited from annie.DisplayObject: libs/DisplayObject.js:49

annie.DisplayObject鼠标或者手指单击

ENTER_FRAME

Inherited from annie.DisplayObject: libs/DisplayObject.js:33

Available since 1.0.0

annie.DisplayObject显示对象 循环帧事件

MOUSE_DOWN

Inherited from annie.DisplayObject: libs/DisplayObject.js:39

Available since 1.0.0

annie.DisplayObject鼠标或者手指按下事件

MOUSE_MOVE

Inherited from annie.DisplayObject: libs/DisplayObject.js:54

Available since 1.0.0

annie.DisplayObject鼠标或者手指移动事件

MOUSE_OUT

Inherited from annie.DisplayObject: libs/DisplayObject.js:64

Available since 1.0.0

annie.DisplayObject鼠标或者手指移出显示对象边界触发的事件

MOUSE_OVER

Inherited from annie.DisplayObject: libs/DisplayObject.js:59

Available since 1.0.0

annie.DisplayObject鼠标或者手指移入到显示对象上里触发的事件

MOUSE_UP

Inherited from annie.DisplayObject: libs/DisplayObject.js:44

Available since 1.0.0

annie.DisplayObject鼠标或者手指抬起事件

REMOVE_TO_STAGE

Inherited from annie.DisplayObject: libs/DisplayObject.js:28

Available since 1.0.0

annie.DisplayObject显示对象从舞台移出事件

Top