當前消息！ANH5 影片剪輯（MovieClip）API 1.0

2022-08-07 16:39:45|

來源：嗶哩嗶哩作者：

影片剪輯類

擴展容器

定義在：MovieClip:41

模塊：畫架JS

(資料圖)

MovieClip 類將 TweenJS 時間軸與 EaselJS?Container相關(guān)聯(lián)。它允許您創(chuàng)建封裝時間線動畫、狀態(tài)更改和同步動作的對象。自 0.7.0 以來，MovieClip 類已包含在 EaselJS 縮小文件中。

目前，MovieClip 僅在基于刻度（而不是基于時間）的情況下才能正常工作，盡管已做出一些讓步以支持未來基于時間的時間線。

例子

此示例來回設置兩個形狀的動畫?；疑螤顝淖髠?cè)開始，但我們使用gotoAndPlay跳轉(zhuǎn)到動畫的中點。

建議使用tween.to()動畫和設置屬性（不使用持續(xù)時間立即設置），以及tween.wait()在動畫之間創(chuàng)建延遲的方法。請注意，使用該?tween.set()方法影響屬性可能不會提供所需的結(jié)果。

構(gòu)造函數(shù)MovieClip

(

[props]

)

定義于?MovieClip:41

參數(shù)：

[props]對象?可選

應用于此實例的配置屬性（例如{mode:MovieClip.SYNCHED}）。下面列出了 MovieClip 支持的道具。這些道具是在相應的實例屬性上設置的，除非另有說明。

此對象也將被傳遞到與此 MovieClip 關(guān)聯(lián)的 Timeline 實例中。paused有關(guān)支持的道具列表（例如、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

將子項添加到顯示列表的頂部。

例子

您還可以一次添加多個孩子：

參數(shù)：

child顯示對象

要添加的顯示對象。

回報：

顯示對象：?

添加的孩子，或者如果添加了多個孩子，則為最后一個孩子。

addChildAt

(

child

index

顯示對象

繼承自?Container：?addChildAt:209

將一個子元素添加到指定索引處的顯示列表中，將相等或更大索引處的子元素提升一個，并將其父元素設置為此 Container。

例子

您還可以添加多個孩子，例如：

索引必須介于 0 和 numChildren 之間。例如，要將 myShape 添加到顯示列表中的 otherShape 下，您可以使用：

這也會將 otherShape 的索引提高 1 個。如果索引超出范圍，則靜默失敗。

參數(shù)：

child顯示對象

要添加的顯示對象。

index數(shù)字

添加孩子的索引。

回報：

顯示對象：?

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

addEventListener

(

type

listener

[useCapture]

功能|?目的

繼承自?EventDispatcher：?addEventListener:140

添加指定的事件偵聽器。請注意，將多個偵聽器添加到同一個函數(shù)將導致多個回調(diào)被觸發(fā)。

例子參數(shù)：

type細繩

事件的字符串類型。

listener功能|?目的

一個具有handleEvent 方法的對象，或者一個在事件被調(diào)度時將被調(diào)用的函數(shù)。

[useCapture]布爾?可選

對于冒泡的事件，指示是否在捕獲或冒泡/目標階段偵聽事件。

回報：

功能|?對象：?

返回用于鏈接或分配的偵聽器。

advance

(

[time]

)

定義于?advance:498

前進播放頭。默認情況下，這會在每個刻度上自動發(fā)生。

參數(shù)：

[time]號碼?可選

以毫秒為單位前進的時間量。僅在設置幀率時適用。

cache

(

x

y

width

height

[scale=1]

[options=undefined]

)

繼承自?DisplayObject：?cache:803

將顯示對象繪制到一個新元素中，然后用于后續(xù)繪制。適用于不經(jīng)常更改的復雜內(nèi)容（例如，具有許多不移動的子項的容器，或復雜的矢量形狀），這可以提供更快的渲染速度，因為不需要在每個刻度上重新渲染內(nèi)容。緩存的顯示對象可以自由移動、旋轉(zhuǎn)、淡化等，但如果其內(nèi)容發(fā)生變化，則必須updateCache()再次調(diào)用手動更新緩存。您必須通過 x、y、w 和 h 參數(shù)指定緩存區(qū)域。這定義了將使用此顯示對象的坐標進行渲染和緩存的矩形。

例子

例如，如果您定義了一個在 0、0 處繪制一個半徑為 25 的圓的 Shape：

請注意，需要在應用緩存之前定義過濾器，否則您必須在應用之后調(diào)用 updateCache。查看過濾器類以獲取更多信息。某些過濾器（例如 BlurFilter）可能無法與比例參數(shù)一起按預期工作。

通常，生成的 cacheCanvas 將具有尺寸寬度比例、高度比例，但是一些過濾器（例如 BlurFilter）會為畫布尺寸添加填充。

在以前的版本中，緩存是在 DisplayObject 上處理的，但后來被移到了BitmapCache中。這允許更輕松的交互和備用緩存方法，例如 WebGL 和StageGL。有關(guān)選項對象的更多信息，請參閱 BitmapCache定義。

參數(shù)：

x數(shù)字

緩存區(qū)域的 x 坐標原點。

y數(shù)字

緩存區(qū)域的 y 坐標原點。

width數(shù)字

緩存區(qū)域的寬度。

height數(shù)字

緩存區(qū)域的高度。

[scale=1]號碼?可選

創(chuàng)建緩存的比例。例如，如果您使用 myShape.cache(0,0,100,100,2) 緩存矢量形狀，則生成的 cacheCanvas 將為 200x200 像素。這使您可以更保真地縮放和旋轉(zhuǎn)緩存的元素。默認值為 1。

[options=undefined]對象?可選

為緩存邏輯指定附加參數(shù)

clone

()

繼承自?DisplayObject?但被覆蓋?clone:522

無法克隆 MovieClip 實例。

contains

(

child

布爾值

繼承自?Container：?contains:435

如果指定的顯示對象是此容器或者是此容器的后代（子、孫等），則返回 true。

參數(shù)：

child顯示對象

要檢查的 DisplayObject。

回報：

布爾值：?

如果指定的顯示對象是此容器或后代，則為 true。

dispatchEvent

(

eventObj

[bubbles]

[cancelable]

布爾值

繼承自?EventDispatcher：?dispatchEvent:285

將指定的事件分派給所有偵聽器。

例子參數(shù)：

eventObj對象|?字符串|?事件

具有“類型”屬性或字符串類型的對象。雖然通用對象可以工作，但建議使用 CreateJS 事件實例。如果使用字符串，dispatchEvent 將在必要時構(gòu)造一個具有指定類型的 Event 實例。后一種方法可用于避免為可能沒有任何偵聽器的非冒泡事件實例化事件對象。

[bubbles]布爾?可選

指定將bubbles字符串傳遞給 eventObj 時的值。

[cancelable]布爾?可選

指定將cancelable字符串傳遞給 eventObj 時的值。

回報：

布爾值：?

preventDefault()如果在可取消事件上調(diào)用，則返回 false ，否則返回 true。

draw

(

ctx

ignoreCache

)

繼承自?DisplayObject?但被覆蓋?draw:444

將顯示對象繪制到指定的上下文中，忽略其可見、alpha、陰影和變換。如果繪制已處理，則返回 true（用于覆蓋功能）。注意：此方法主要供內(nèi)部使用，但它可能對高級用途有用。

參數(shù)：

ctxCanvasRenderingContext2D

要繪制的畫布 2D 上下文對象。

ignoreCache布爾值

指示繪制操作是否應忽略任何當前緩存。例如，用于繪制緩存（以防止它簡單地將現(xiàn)有緩存繪制回自身）。

getBounds

()?矩形

繼承自?DisplayObject：?getBounds:1100

返回一個矩形，表示該對象在其局部坐標系中的邊界（即沒有變換）。已緩存的對象將返回緩存的邊界。

并非所有顯示對象都可以計算自己的邊界（例如形狀）。對于這些對象，您可以使用?setBounds以便在計算容器邊界時將它們包括在內(nèi)。

全部所有顯示對象都支持使用 setBounds() 手動設置邊界。同樣，已使用 cache() 緩存的顯示對象將返回其緩存的邊界。手動和緩存邊界將覆蓋下面列出的自動計算。位圖返回從 (x=0,y=0) 擴展的位圖/源矩形（如果指定）或圖像的寬度和高度。雪碧返回當前幀的邊界。如果在 spritesheet 數(shù)據(jù)中指定了幀注冊點，則可能具有非零 x/y。另請參閱getFrameBounds容器返回從中返回非空值的所有子項的聚合（組合）邊界getBounds()。形狀當前不支持自動邊界計算。用于setBounds()手動定義邊界。文本返回近似邊界。水平值 (x/width) 非常準確，但垂直值 (y/height) 不準確，尤其是在使用textBaseline值而不是 "top" 時。位圖文本返回近似邊界。如果 spritesheet 幀注冊點接近 (x=0,y=0)，值會更準確。

計算某些對象（例如文本或具有許多子對象的容器）的邊界可能很昂貴，并且每次調(diào)用 getBounds() 時都會重新計算。您可以通過顯式設置邊界來防止重新計算靜態(tài)對象：

為了減少內(nèi)存影響，返回的 Rectangle 實例可以在內(nèi)部重用；如果需要保留它，請克隆實例或復制其值。

回報：

矩形：?

表示邊界的 Rectangle 實例，如果邊界不適用于此對象，則為 null。

getCacheDataURL

()?字符串

繼承自?DisplayObject：?getCacheDataURL:886

返回緩存的數(shù)據(jù) URL，如果未緩存此顯示對象，則返回 null。僅在緩存已更改時生成，否則返回最后一個結(jié)果。

回報：

字符串：?

緩存的圖像數(shù)據(jù) url。

getChildAt

(

index

顯示對象

繼承自?Container：?getChildAt:319

返回指定索引處的子級。

例子參數(shù)：

index數(shù)字

要返回的孩子的索引。

回報：

顯示對象：?

指定索引處的子項。如果索引處沒有子元素，則返回 null。

getChildByName

(

name

顯示對象

繼承自?Container：?getChildByName:334

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

參數(shù)：

name細繩

要返回的孩子的姓名。

回報：

顯示對象：?

具有指定名稱的孩子。

getChildIndex

(

child

數(shù)字

繼承自?Container：?getChildIndex:368

返回顯示列表中指定子項的索引，如果不在顯示列表中，則返回 -1。

例子參數(shù)：

child顯示對象

要返回其索引的子項。

回報：

號碼：?

指定子節(jié)點的索引。-1 如果沒有找到孩子。

getConcatenatedDisplayProps

(

[props]

展示道具

繼承自?DisplayObject：?getConcatenatedDisplayProps:1032

生成一個 DisplayProps 對象，該對象表示對象及其所有父 Container 的組合顯示屬性，直到最高級別的祖先（通常是Stage）。

參數(shù)：

[props]DisplayProps?可選

使用計算值填充的DisplayProps對象。如果為 null，則返回一個新的 DisplayProps 對象。

回報：

顯示道具：?

組合顯示屬性。

getConcatenatedMatrix

(

[matrix]

Matrix2D

繼承自?DisplayObject：?getConcatenatedMatrix:1014

生成一個 Matrix2D 對象，該對象表示顯示對象及其所有父 Container 的組合變換，直到最高級別的祖先（通常是Stage）。這可用于在坐標空間之間轉(zhuǎn)換位置，例如使用localToGlobal?和globalToLocal。

參數(shù)：

[matrix]Matrix2D?可選

使用計算值填充的Matrix2D對象。如果為 null，則返回一個新的 Matrix2D 對象。

回報：

矩陣2D：?

組合矩陣。

getCurrentLabel

()?已棄用

定義于?getCurrentLabel:358

請改用currentLabel屬性。

getDuration

()?已棄用

定義于?getDuration:376

請改用持續(xù)時間屬性。

getLabels

()?已棄用

定義于?getLabels:340

請改用標簽屬性。

getMatrix

(

matrix

Matrix2D

繼承自?DisplayObject：?getMatrix:1002

根據(jù)此對象的當前變換返回一個矩陣。

參數(shù)：

matrixMatrix2D

可選的。使用計算值填充的 Matrix2D 對象。如果為 null，則返回一個新的 Matrix 對象。

回報：

矩陣2D：?

表示此顯示對象變換的矩陣。

getNumChildren

()?已棄用

繼承自?Container：?getNumChildren:106

請改用numChildren屬性。

getObjectsUnderPoint

(

x

y

[mode=0]

大批

繼承自?Container：?getObjectsUnderPoint:465

返回此容器的顯示列表中指定坐標下的所有顯示對象的數(shù)組。此例程忽略mouseEnabled?設置為的任何顯示對象false。數(shù)組將按視覺深度排序，最頂部的顯示對象位于索引 0。這使用基于形狀的命中檢測，運行起來可能是一項昂貴的操作，因此最好謹慎使用。例如，如果在鼠標下測試對象，則在刻度上進行測試（而不是在stagemousemove上），并且僅在鼠標位置發(fā)生變化時進行測試。

默認情況下 (mode=0)，此方法評估所有顯示對象。

通過將mode參數(shù)設置為1，將尊重mouseEnabled?和 MouseChildren:property 屬性。

將設置mode為2另外排除沒有活動鼠標事件偵聽器或 DisplayObject:cursor:property 屬性的顯示對象。也就是說，只會包含通常會攔截鼠標交互的對象。在某些情況下，這可以通過減少需要測試的顯示對象的數(shù)量來顯著提高性能。

此方法同時考慮了hitArea和mask。

參數(shù)：

x數(shù)字

要測試的容器中的 x 位置。

y數(shù)字

要測試的容器中的 y 位置。

[mode=0]號碼?可選

用于確定要包括哪些顯示對象的模式。0-全部，1-尊重 mouseEnabled/mouseChildren，2-僅鼠標不透明對象。

回報：

數(shù)組：?

指定坐標下的 DisplayObject 數(shù)組。

getObjectUnderPoint

(

x

y

mode

顯示對象

繼承自?Container：?getObjectUnderPoint:497

類似于getObjectsUnderPoint，但只返回最頂層的顯示對象。它的運行速度明顯快于getObjectsUnderPoint()，但仍然可能是一項昂貴的操作。有關(guān)詳細信息，請參閱getObjectsUnderPoint。

參數(shù)：

x數(shù)字

要測試的容器中的 x 位置。

y數(shù)字

要測試的容器中的 y 位置。

mode數(shù)字

用于確定要包括哪些顯示對象的模式。0-全部，1-尊重 mouseEnabled/mouseChildren，2-僅鼠標不透明對象。

回報：

顯示對象：?

指定坐標下最頂層的顯示對象。

getStage

()?已棄用

繼承自?DisplayObject：?getStage:691

請改用舞臺屬性。

getTransformedBounds

()?矩形

繼承自?DisplayObject：?getTransformedBounds:1166

返回一個矩形，表示該對象在其父坐標系中的邊界（即應用了變換）。已緩存的對象將返回緩存的轉(zhuǎn)換邊界。

并非所有顯示對象都可以計算自己的邊界（例如形狀）。對于這些對象，您可以使用?setBounds以便在計算容器邊界時將它們包括在內(nèi)。

為了減少內(nèi)存影響，返回的 Rectangle 實例可以在內(nèi)部重用；如果需要保留它，請克隆實例或復制其值。

容器實例為所有通過 getBounds 返回邊界的子節(jié)點計算聚合邊界。

回報：

矩形：?

表示邊界的 Rectangle 實例，如果邊界不適用于此對象，則為 null。

globalToLocal

(

x

y

[pt]

觀點

繼承自?DisplayObject：?globalToLocal:921

將指定的 x 和 y 位置從全局（舞臺）坐標空間轉(zhuǎn)換到顯示對象的坐標空間。例如，這可用于確定顯示對象內(nèi)的當前鼠標位置。返回一個 Point 實例，其 x 和 y 屬性與顯示對象坐標空間中的變換位置相關(guān)。

例子參數(shù)：

x數(shù)字

舞臺上要變換的 x 位置。

y數(shù)字

舞臺上要變換的 y 位置。

[pt]點|?對象?可選

將結(jié)果復制到的對象。如果省略，將返回具有 x/y 屬性的新 Point 對象。

回報：

點：?

具有與顯示對象坐標空間中的變換位置相關(guān)的 x 和 y 屬性的 Point 實例。

gotoAndPlay

(

positionOrLabel

)

定義于?gotoAndPlay:478

將此影片剪輯前進到指定的位置或標簽，并將 paused 設置為 false。

參數(shù)：

positionOrLabel字符串|?數(shù)字

要轉(zhuǎn)到的動畫名稱或幀號。

gotoAndStop

(

positionOrLabel

)

定義于?gotoAndStop:488

將此影片剪輯前進到指定的位置或標簽，并將 paused 設置為 true。

參數(shù)：

positionOrLabel字符串|?數(shù)字

要轉(zhuǎn)到的動畫或幀名稱。

hasEventListener

(

type

布爾值

繼承自?EventDispatcher：?hasEventListener:339

指示是否至少有一個針對指定事件類型的偵聽器。

參數(shù)：

type細繩

事件的字符串類型。

回報：

布爾值：?

如果指定事件至少有一個偵聽器，則返回 true。

hitTest

(

x

y

布爾值

繼承自?DisplayObject?但被覆蓋?hitTest:450

測試顯示對象是否與指定的局部點相交（即在指定位置繪制一個 alpha > 0 的像素）。這會忽略顯示對象的 alpha、陰影和復合操作，以及包括 regX/Y 在內(nèi)的所有變換屬性。

參數(shù)：

x數(shù)字

在顯示對象的本地坐標中檢查的 x 位置。

y數(shù)字

在顯示對象的本地坐標中檢查的 y 位置。

回報：

布爾值：?

一個布爾值，指示是否存在與指定坐標重疊的 DisplayObject 的可見部分。

initialize

()?已棄用

繼承自?Container?但被覆蓋?initialize:423

用于向后兼容的構(gòu)造函數(shù)別名。此方法將在以后的版本中刪除。應該更新子類以使用extend和?promote。

isVisible

()?布爾值

繼承自?DisplayObject?但被覆蓋?isVisible:432

返回 true 或 false 指示如果將顯示對象繪制到畫布上是否可見。這不考慮它是否會在舞臺邊界內(nèi)可見。注意：此方法主要供內(nèi)部使用，但它可能對高級用途有用。

回報：

布爾值：?

布爾值，指示顯示對象在繪制到畫布時是否可見

localToGlobal

(

x

y

[pt]

觀點

繼承自?DisplayObject：?localToGlobal:896

將指定的 x 和 y 位置從顯示對象的坐標空間轉(zhuǎn)換到全局（舞臺）坐標空間。例如，這可用于將 HTML 標簽放置在嵌套顯示對象上的特定點上。返回一個 Point 實例，其 x 和 y 屬性與舞臺上變換后的坐標相關(guān)。

例子參數(shù)：

x數(shù)字

要變換的源顯示對象中的 x 位置。

y數(shù)字

要變換的源顯示對象中的 y 位置。

[pt]點|?對象?可選

將結(jié)果復制到的對象。如果省略，將返回具有 x/y 屬性的新 Point 對象。

回報：

點：?

具有與舞臺上變換后的坐標相關(guān)的 x 和 y 屬性的 Point 實例。

localToLocal

(

x

y

target

[pt]

觀點

繼承自?DisplayObject：?localToLocal:946

將指定的 x 和 y 位置從此顯示對象的坐標空間轉(zhuǎn)換到目標顯示對象的坐標空間。返回一個 Point 實例，其 x 和 y 屬性與目標坐標空間中的變換位置相關(guān)。實際上與將以下代碼與?localToGlobal和globalToLocal一起使用相同。

參數(shù)：

x數(shù)字

要變換的源顯示對象中的 x 位置。

y數(shù)字

要變換的源顯示對象上的 y 位置。

target顯示對象

坐標將轉(zhuǎn)換到的目標顯示對象。

[pt]點|?對象?可選

將結(jié)果復制到的對象。如果省略，將返回具有 x/y 屬性的新 Point 對象。

回報：

點：?

返回一個 Point 實例，其 x 和 y 屬性與目標坐標空間中的變換位置相關(guān)。

off

(

type

listener

[useCapture]

)

繼承自?EventDispatcher：?off:249

removeEventListener 方法的快捷方式，具有相同的參數(shù)和返回值。這是 .on 方法的伴侶。

重要提示：要刪除添加的偵聽on器，您必須將返回的包裝函數(shù)作為偵聽器傳入。請參閱?示例。

參數(shù)：

type細繩

事件的字符串類型。

listener功能|?目的

偵聽器函數(shù)或?qū)ο蟆?/p>

[useCapture]布爾?可選

對于冒泡的事件，指示是否在捕獲或冒泡/目標階段偵聽事件。

on

(

type

listener

[scope]

[once=false]

[data]

[useCapture=false]

功能

繼承自?EventDispatcher：?on:173

一種使用 addEventListener 的快捷方法，可以更輕松地指定執(zhí)行范圍，讓偵聽器只運行一次，將任意數(shù)據(jù)與偵聽器關(guān)聯(lián)，并刪除偵聽器。

此方法通過創(chuàng)建匿名包裝函數(shù)并使用 addEventListener 訂閱它來工作。返回包裝函數(shù)以用于removeEventListener（或off）。

重要提示：要刪除使用添加的偵聽on器，您必須將返回的包裝函數(shù)作為偵聽器傳入，或者使用?remove。同樣，每次調(diào)用on新包裝函數(shù)時都會訂閱，因此on使用相同參數(shù)的多次調(diào)用將創(chuàng)建多個偵聽器。

例子參數(shù)：

type細繩

事件的字符串類型。

listener功能|?目的

一個具有handleEvent 方法的對象，或者一個在事件被調(diào)度時將被調(diào)用的函數(shù)。

[scope]對象?可選

執(zhí)行偵聽器的范圍。函數(shù)偵聽器默認為 dispatcher/currentTarget，對象偵聽器默認為偵聽器本身（即使用 handleEvent）。

[once=false]布爾?可選

如果為 true，則偵聽器將在第一次觸發(fā)后自行移除。

[data]可選的

調(diào)用偵聽器時將作為第二個參數(shù)包含的任意數(shù)據(jù)。

[useCapture=false]布爾?可選

對于冒泡的事件，指示是否在捕獲或冒泡/目標階段偵聽事件。

回報：

功能：?

返回創(chuàng)建并分配為偵聽器的匿名函數(shù)。稍后需要使用 .removeEventListener 刪除偵聽器。

play

()

定義于?play:462

設置暫停為假。

removeAllChildren

()

繼承自?Container：?removeAllChildren:305

從顯示列表中刪除所有子項。

例子removeAllEventListeners

(

[type]

)

繼承自?EventDispatcher：?removeAllEventListeners:263

刪除指定類型的所有偵聽器，或所有類型的所有偵聽器。

例子參數(shù)：

[type]字符串?可選

事件的字符串類型。如果省略，所有類型的所有偵聽器都將被刪除。

removeChild

(

child

布爾值

繼承自?Container：?removeChild:249

從顯示列表中刪除指定的子項。請注意，如果索引已知，則使用 removeChildAt() 會更快。

例子

您還可以刪除多個孩子：

如果子項（或多個子項）已被刪除，則返回 true；如果它不在顯示列表中，則返回 false。

參數(shù)：

child顯示對象

要刪除的孩子。

回報：

布爾值：?

如果子項（或多個子項）已被刪除，則為 true；如果它不在顯示列表中，則為 false。

removeChildAt

(

index

布爾值

繼承自?Container?但被覆蓋?removeChildAt:276

從顯示列表中刪除指定索引處的子項，并將其父項設置為 null。

例子

您還可以刪除多個孩子：

如果子項（或多個子項）被刪除，則返回 true；如果任何索引超出范圍，則返回 false。

參數(shù)：

index數(shù)字

要刪除的孩子的索引。

回報：

布爾值：?

如果子項（或多個子項）被刪除，則為 true，如果任何索引超出范圍，則為 false。

removeEventListener

(

type

listener

[useCapture]

)

繼承自?EventDispatcher：?removeEventListener:219

刪除指定的事件偵聽器。

重要提示：您必須傳遞添加事件時使用的確切函數(shù)引用。如果使用代理函數(shù)或函數(shù)閉包作為回調(diào)，則必須使用代理/閉包引用 - 新的代理或閉包將不起作用。

例子參數(shù)：

type細繩

事件的字符串類型。

listener功能|?目的

偵聽器函數(shù)或?qū)ο蟆?/p>

[useCapture]布爾?可選

對于冒泡的事件，指示是否在捕獲或冒泡/目標階段偵聽事件。

set

(

props

DisplayObject?可鏈接

繼承自?DisplayObject：?set:1082

提供一種可鏈接的快捷方式，用于在實例上設置多個屬性。

例子參數(shù)：

props目的

包含要復制到 DisplayObject 實例的屬性的通用對象。

回報：

顯示對象：?

返回調(diào)用該方法的實例（對于鏈接調(diào)用很有用。）

setBounds

(

x

y

width

height

)

繼承自?DisplayObject：?setBounds:1185

允許您手動指定無法計算自己的邊界（例如形狀和文本）以供將來參考的對象的邊界，或者可以將對象包含在容器邊界中。手動設置的界限將始終覆蓋計算的界限。

邊界應在對象的本地（未轉(zhuǎn)換）坐標中指定。例如，一個以 0,0 為中心的半徑為 25px 的圓的 Shape 實例的邊界為 (-25, -25, 50, 50)。

參數(shù)：

x數(shù)字

邊界的 x 原點。傳遞 null 以刪除手動邊界。

y數(shù)字

邊界的 y 原點。

width數(shù)字

邊界的寬度。

height數(shù)字

邊界的高度。

setChildIndex

(

child

index

)

繼承自?Container：?setChildIndex:418

更改指定子項的深度。如果子項不是此容器的子項，或者索引超出范圍，則靜默失敗。

參數(shù)：

child顯示對象

index數(shù)字

setTransform

(

[x=0]

[y=0]

[scaleX=1]

[scaleY=1]

[rotation=0]

[skewX=0]

[skewY=0]

[regX=0]

[regY=0]

DisplayObject?可鏈接

繼承自?DisplayObject：?setTransform:968

在顯示對象上快速設置變換屬性的快捷方法。所有參數(shù)都是可選的。省略的參數(shù)將設置默認值。

例子參數(shù)：

[x=0]號碼?可選

以像素為單位的水平平移（x 位置）

[y=0]號碼?可選

以像素為單位的垂直平移（y 位置）

[scaleX=1]號碼?可選

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

[scaleY=1]號碼?可選

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

[rotation=0]號碼?可選

旋轉(zhuǎn)，以度為單位

[skewX=0]號碼?可選

水平偏斜系數(shù)

[skewY=0]號碼?可選

垂直偏斜系數(shù)

[regX=0]號碼?可選

以像素為單位的水平注冊點

[regY=0]號碼?可選

以像素為單位的垂直配準點

回報：

顯示對象：?

返回此實例。用于鏈接命令。

sortChildren

(

sortFunction

)

繼承自?Container：?sortChildren:348

對子列表執(zhí)行數(shù)組排序操作。

示例：顯示前面 y 較高的孩子。參數(shù)：

sortFunction功能

用于對子列表進行排序的函數(shù)。有關(guān)詳細信息，請參閱 JavaScript 的Array.sort文檔。

stop

()

定義于?stop:470

設置暫停為真。

swapChildren

(

child1

child2

)

繼承自?Container：?swapChildren:398

交換顯示列表中指定子項的深度。如果任一子級不是此容器的子級，則靜默失敗。

參數(shù)：

child1顯示對象

child2顯示對象

swapChildrenAt

(

index1

index2

)

繼承自?Container：?swapChildrenAt:383

交換指定索引處的子代。如果任一索引超出范圍，則靜默失敗。

參數(shù)：

index1數(shù)字

index2數(shù)字

toString

()?字符串

繼承自?EventDispatcher?但被覆蓋?toString:531

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

回報：

字符串：?

實例的字符串表示形式。

uncache

()

繼承自?DisplayObject：?uncache:875

清除當前緩存。有關(guān)詳細信息，請參閱緩存。

updateCache

(

compositeOperation

)

繼承自?DisplayObject：?updateCache:846

將顯示對象重繪到其緩存。在沒有活動緩存的情況下調(diào)用 updateCache 將引發(fā)錯誤。如果compositeOperation 為null，則當前緩存將在繪制之前被清除。否則，將使用指定的compositeOperation 在現(xiàn)有緩存上繪制顯示對象。

例子

清除緩存形狀的當前圖形，繪制一些新指令，然后更新緩存。新線將繪制在舊線之上。

在以前的版本中，緩存是在 DisplayObject 上處理的，但后來被移到了BitmapCache中。這允許更輕松的交互和替代緩存方法，如 WebGL 和StageGL。

參數(shù)：

compositeOperation細繩

要使用的compositeOperation，或null 以清除緩存并重繪它。?whatwg 合成規(guī)范。

updateContext

(

ctx

)

繼承自?DisplayObject：?updateContext:771

將此顯示對象的變換、alpha、globalCompositeOperation、剪切路徑（遮罩）和陰影應用到指定的上下文。這通常在draw之前調(diào)用。

參數(shù)：

ctxCanvasRenderingContext2D

要更新的 2D 畫布。

willTrigger

(

type

布爾值

繼承自?EventDispatcher：?willTrigger:350

指示此對象或其任何祖先（父級、父級的父級等）上的指定事件類型是否至少有一個偵聽器。返回值為 true 表示如果從該對象調(diào)度指定類型的冒泡事件，它將觸發(fā)至少一個偵聽器。

這類似于hasEventListener，但它在整個事件流中搜索偵聽器，而不僅僅是這個對象。

參數(shù)：

type細繩

事件的字符串類型。

回報：

布爾值：?

true如果指定事件至少有一個偵聽器，則返回。

屬性actionsEnabled

布爾值

定義于?actionsEnabled:162

如果為 true，則當播放頭前進時，將運行此 MovieClip 補間中的動作。

默認值：真

alpha

數(shù)字

繼承自?DisplayObject：?alpha:147

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

默認值：1

autoReset

布爾值

定義于?autoReset:170

如果為 true，每當時間線將其添加回顯示列表時，MovieClip 將自動重置為其第一幀。這僅適用于具有mode“獨立”的 MovieClip 實例。

例如，如果您有一個角色動畫，其中有一個“body”子 MovieClip 實例，每個幀上都有不同的服裝，您可以設置body.autoReset = false，這樣您就可以手動更改它所在的幀，而不必擔心它會自動重置。

默認值：真

bitmapCache

BitmapCache?只讀

繼承自?DisplayObject：?bitmapCache:165

如果已創(chuàng)建緩存，則返回管理 cacheCanvas 及其屬性的類。?有關(guān)詳細信息，請參閱位圖緩存。使用它來控制、檢查和更改緩存。在特殊情況下，這可能是經(jīng)過修改或子類化的 BitmapCache。

默認值：空

cacheCanvas

HTMLCanvasElement |?對象?只讀

繼承自?DisplayObject：?cacheCanvas:155

如果緩存處于活動狀態(tài)，則返回包含此顯示對象圖像的畫布。有關(guān)詳細信息，請參閱緩存?。使用它來顯示緩存的結(jié)果。這將是一個 HTMLCanvasElement，除非特意為此緩存啟用了特殊的緩存規(guī)則。

默認值：空

cacheID

數(shù)量?已棄用

繼承自?DisplayObject：?cacheID:706

返回唯一標識此顯示對象的當前緩存的 ID 號。這可用于確定自上次檢查以來緩存是否已更改。移至位圖緩存

默認值：0

children

大批

繼承自?Container：?children:61

顯示列表中的子元素數(shù)組。您通常應該使用子管理方法，例如?addChild、removeChild、?swapChildren等，而不是直接訪問它，但它包含在高級用途中。

默認值：空

compositeOperation

細繩

繼承自?DisplayObject：?compositeOperation:333

合成操作指示此顯示對象的像素將如何與其后面的元素合成。如果null，則此屬性是從父容器繼承的。有關(guān)更多信息，請閱讀?關(guān)于合成的 whatwg 規(guī)范。有關(guān)受支持的compositeOperation 值的列表，請訪問?關(guān)于合成和混合的W3C 草案。

默認值：空

currentFrame

數(shù)字?只讀

定義于?currentFrame:145

影片剪輯的當前幀。

默認值：0

currentLabel

字符串?只讀

定義于?currentLabel:391

返回當前幀上或之前的標簽名稱。

cursor

細繩

繼承自?DisplayObject：?cursor:391

當用戶將鼠標懸停在此顯示對象上時將顯示的 CSS 光標（例如“指針”、“幫助”、“文本”等）。您必須使用enableMouseOver方法啟用鼠標懸停事件才能使用此屬性。在 Container 上設置非空游標將覆蓋在其后代上設置的游標。

默認值：空

duration

數(shù)字?只讀

定義于?duration:405

返回此 MovieClip 的持續(xù)時間（以秒或節(jié)拍為單位）。

filters

大批

繼承自?DisplayObject：?filters:355

要應用于此顯示對象的過濾器對象數(shù)組。過濾器僅在顯示對象上調(diào)用 Cache 或 UpdateCache 時應用/更新，并且僅適用于緩存的區(qū)域。

默認值：空

frameBounds

大批

定義于?frameBounds:183

MovieClip 中每一幀的邊界數(shù)組。這主要用于工具輸出。

默認值：空

framerate

數(shù)字

定義于?framerate:191

默認情況下，MovieClip 實例每刻前進一幀。為 MovieClip 指定幀速率將使其根據(jù)滴答之間經(jīng)過的時間適當?shù)乇３帜繕藥俾省?/p>

例如，如果將幀率為 10 的 MovieClip 放置在以 40fps 更新的 Stage 上，則 MovieClip 將大約每 4 tick 前進一幀。這并不準確，因為每個刻度之間的時間在幀之間會略有不同。

此功能取決于傳遞給update的滴答事件對象（或具有適當“delta”屬性的對象）。

默認值：空

hitArea

顯示對象

繼承自?DisplayObject：?hitArea:374

在檢查鼠標交互或測試getObjectsUnderPoint時將測試的顯示對象。命中區(qū)域?qū)⑾鄬τ谠擄@示對象的坐標空間應用其變換（就好像命中測試對象是該顯示對象的子對象并相對于其 regX/Y）。alpha無論目標顯示對象或目標的祖先（父母）上的 alpha 值如何，都將僅使用其自己的值測試 hitArea 。

如果在 Container 上設置，則Container的子級將不會接收鼠標事件。這類似于將 MouseChildren 設置為 false。

請注意，該方法當前不使用 hitArea ，?StagehitTest()也不支持它。

默認值：空

id

數(shù)字

繼承自?DisplayObject：?id:175

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

默認值：-1

INDEPENDENT

字符串?靜態(tài)?只讀

定義于?INDEPENDENT:283

MovieClip 將獨立于其父級前進，即使其父級已暫停。這是默認模式。

默認值：“獨立”

labels

數(shù)組?只讀

定義于?labels:384

返回具有標簽和位置（又名框架）屬性的對象數(shù)組，按位置排序。

loop

數(shù)字

定義于?loop:136

指定此 MovieClip 應循環(huán)多少次。值 -1 表示它應該無限循環(huán)。值為 1 將導致它循環(huán)一次（即總共播放兩次）。

默認值：-1

mask

形狀

繼承自?DisplayObject：?mask:365

定義此顯示對象的矢量蒙版（剪切路徑）的 Shape 實例。形狀的變換將相對于顯示對象的父坐標應用（就好像它是父對象的子對象一樣）。

默認值：空

mode

細繩

定義于?mode:119

控制此 MovieClip 如何推進其時間。必須是 0 (INDEPENDENT)、1 (SINGLE_FRAME) 或 2 (SYNCHED) 之一。有關(guān)行為的描述，請參見每個常量。

默認值：空

mouseChildren

布爾值

繼承自?Container：?mouseChildren:72

指示此容器的子項是否獨立啟用鼠標/指針交互。如果為 false，則子元素將聚合在容器下 - 例如，單擊子形狀將觸發(fā)容器上的單擊事件。

默認值：真

mouseEnabled

布爾值

繼承自?DisplayObject：?mouseEnabled:183

指示在運行鼠標交互時是否包含此對象。將此項設置false為Container的子項將導致 Container 上的事件在單擊該子項時不會觸發(fā)。將此屬性設置為false不會阻止getObjectsUnderPoint?方法返回子項。

注意：在 EaselJS 0.7.0 中，mouseEnabled 屬性將無法與嵌套容器一起正常工作。請查看GitHub中最新的 NEXT 版本以獲取已解決此問題的更新版本。該修復將在 EaselJS 的下一個版本中提供。

默認值：真

name

細繩

繼承自?DisplayObject：?name:208

此顯示對象的可選名稱。包含在toString中。對調(diào)試很有用。

默認值：空

numChildren

數(shù)字?只讀

繼承自?Container：?numChildren:114

返回容器中的子節(jié)點數(shù)。

parent

容器?最終?只讀

繼承自?DisplayObject：?parent:217

對包含此顯示對象的Container或Stage對象的引用，如果尚未添加到其中，則為 null。

默認值：空

paused

布爾值

定義于?paused:154

如果為 true，則選中時，MovieClip 的位置不會前進。

默認值：假

regX

數(shù)字

繼承自?DisplayObject：?regX:229

此顯示對象注冊點的左偏移量。例如，要使 100x100px 位圖圍繞其中心旋轉(zhuǎn)，您可以將 regX 和regY設置為 50。緩存對象的注冊點應根據(jù)預緩存條件設置，而不是緩存大小。

默認值：0

regY

數(shù)字

繼承自?DisplayObject：?regY:239

此顯示對象的注冊點的 y 偏移量。例如，要使 100x100px 位圖圍繞其中心旋轉(zhuǎn)，您可以將regX和 regY 設置為 50。緩存對象的注冊點應根據(jù)預緩存條件設置，而不是緩存大小。

默認值：0

rotation

數(shù)字

繼承自?DisplayObject：?rotation:249

此顯示對象的旋轉(zhuǎn)度數(shù)。

默認值：0

scale

數(shù)字

繼承自?DisplayObject：?scale:716

將scaleX和scaleY?屬性設置為相同的值。請注意，當您獲取值時，如果scaleX和scaleY是不同的值，它將僅返回scaleX.

默認值：1

scaleX

數(shù)字

繼承自?DisplayObject：?scaleX:257

水平拉伸此顯示對象的因子。例如，將 scaleX 設置為 2 會將顯示對象拉伸為其標稱寬度的兩倍。要水平翻轉(zhuǎn)對象，請將比例設置為負數(shù)。

默認值：1

scaleY

數(shù)字

繼承自?DisplayObject：?scaleY:266

垂直拉伸此顯示對象的因子。例如，將 scaleY 設置為 0.5 會將顯示對象拉伸到其標稱高度的一半。要垂直翻轉(zhuǎn)對象，請將比例設置為負數(shù)。

默認值：1

shadow

陰影

繼承自?DisplayObject：?shadow:291

定義要在此顯示對象上呈現(xiàn)的陰影的陰影對象。設置為null刪除陰影。如果為 null，則從父容器繼承此屬性。

默認值：空

SINGLE_FRAME

字符串?靜態(tài)?只讀

定義于?SINGLE_FRAME:294

MovieClip 將僅顯示單個幀（由 startPosition 屬性確定）。

默認值：“單”

skewX

數(shù)字

繼承自?DisplayObject：?skewX:275

水平傾斜此顯示對象的因素。

默認值：0

skewY

數(shù)字

繼承自?DisplayObject：?skewY:283

垂直傾斜此顯示對象的因素。

默認值：0

snapToPixel

布爾值

繼承自?DisplayObject：?snapToPixel:345

指示當snapToPixelEnabled為 true時是否應將顯示對象繪制到整個像素。要在整個顯示對象類別上啟用/禁用捕捉，請在原型上設置此值（例如 Text.prototype.snapToPixel = true）。

默認值：真

stage

階段?只讀

繼承自?DisplayObject：?stage:699

返回此顯示對象將在其上呈現(xiàn)的 Stage 實例，如果尚未添加，則返回 null。

startPosition

數(shù)字

定義于?startPosition:128

指定要在此影片剪輯中播放的第一幀，或者如果模式為 SINGLE_FRAME 時要顯示的唯一幀。

默認值：0

SYNCHED

字符串?靜態(tài)?只讀

定義于?SYNCHED:304

MovieClip 僅在其父級前進時才會前進，并將同步到父級 MovieClip 的位置。

默認值：“同步”

tickChildren

布爾值

繼承自?Container：?tickChildren:82

如果為 false，則刻度不會傳播到此 Container 的子級。這可以提供一些性能優(yōu)勢。除了阻止“tick”事件被調(diào)度外，它還將阻止某些顯示對象上的與滴答相關(guān)的更新（例如 Sprite 和 MovieClip 幀推進、DOMElement 可見性處理）。

默認值：真

tickEnabled

布爾值

繼承自?DisplayObject：?tickEnabled:198

如果為 false，則刻度不會在此顯示對象（或其子對象）上運行。這可以提供一些性能優(yōu)勢。除了阻止“tick”事件被調(diào)度外，它還將阻止某些顯示對象（例如 Sprite 和 MovieClip 幀推進和 DOMElement 顯示屬性）上的與滴答相關(guān)的更新。

默認值：真

timeline

時間線

定義于?timeline:211

與此 MovieClip 關(guān)聯(lián)的 TweenJS 時間軸。這是在初始化 MovieClip 實例時自動創(chuàng)建的。通過將TweenJS?Tween 實例添加到時間軸來創(chuàng)建動畫。

例子

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不建議使用創(chuàng)建 MovieClip 動畫。下面的示例將在第 0 幀關(guān)閉目標，然后在第 1 幀重新打開。您可以使用“可見”屬性來實現(xiàn)相同的效果。

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

默認值：空

totalFrames

數(shù)字?只讀

定義于?totalFrames:398

返回此 MovieClip 的持續(xù)時間（以秒或節(jié)拍為單位）。

transformMatrix

Matrix2D

繼承自?DisplayObject：?transformMatrix:324

如果設置，則定義此顯示對象的變換，覆蓋所有其他變換屬性（x、y、旋轉(zhuǎn)、縮放、傾斜）。

默認值：空

visible

布爾值

繼承自?DisplayObject：?visible:300

指示在運行 Stage getObjectsUnderPoint方法時是否應將此顯示對象呈現(xiàn)到畫布并包含在內(nèi) 。

默認值：真

x

數(shù)字

繼承自?DisplayObject：?x:309

顯示對象相對于其父對象的 x（水平）位置。

默認值：0

y

數(shù)字

繼承自?DisplayObject：?y:317

默認值：0

事件added

繼承自?DisplayObject：?added:651

當顯示對象添加到父容器時調(diào)度。

click

繼承自?DisplayObject：?click:549

自 0.6.0 起可用

當用戶按下鼠標左鍵然后在顯示對象上方釋放它時調(diào)度。有關(guān)事件屬性的列表，請參見MouseEvent類。

dblclick

繼承自?DisplayObject：?dblclick:556

自 0.6.0 起可用

當用戶在此顯示對象上雙擊鼠標左鍵時調(diào)度。有關(guān)事件屬性的列表，請參見MouseEvent類。

mousedown

繼承自?DisplayObject：?mousedown:542

自 0.6.0 起可用

當用戶在顯示對象上按下鼠標左鍵時調(diào)度。有關(guān)事件屬性的列表，請參見?MouseEvent類。

mouseout

繼承自?DisplayObject：?mouseout:571

自 0.6.0 起可用

當用戶的鼠標離開此顯示對象時調(diào)度。必須使用?enableMouseOver啟用此事件。另請參閱推出。有關(guān)事件屬性的列表，請參見MouseEvent類。

mouseover

繼承自?DisplayObject：?mouseover:563

自 0.6.0 起可用

當用戶的鼠標進入此顯示對象時調(diào)度。必須使用?enableMouseOver啟用此事件。另請參閱翻轉(zhuǎn)。有關(guān)事件屬性的列表，請參見MouseEvent類。

pressmove

繼承自?DisplayObject：?pressmove:621

自 0.7.0 起可用

在顯示對象上發(fā)生mousedown后，只要鼠標移動，就會在該對象上生成一個 pressmove 事件，直到釋放鼠標按下為止。這對于拖動和類似操作很有用。

請注意，如果事件的初始鼠標目標mousedown在被按下后（例如在pressmove事件期間）從舞臺上移除，pressmove仍然會生成事件。但是，由于它不再在顯示列表中，因此該事件不能冒泡。這意味著以前的祖先（父容器）將不會收到該事件，因此無法重新調(diào)度它。如果您打算偵聽動態(tài)對象（例如MovieClippressup或Container?），請確保將mouseChildren設置為.pressmovefalse

pressup

繼承自?DisplayObject：?pressup:636

自 0.7.0 起可用

在顯示對象上發(fā)生mousedown后，釋放鼠標按下時將在該對象上生成 pressup 事件。這對于拖動和類似操作很有用。

請注意，如果事件的初始鼠標目標mousedown在被按下后（例如在pressmove事件期間）從舞臺上移除，pressup仍然會生成事件。但是，由于它不再在顯示列表中，因此該事件不能冒泡。這意味著以前的祖先（父容器）將不會收到該事件，因此無法重新調(diào)度它。如果您打算偵聽動態(tài)對象（例如MovieClippressmove或Container?），請確保將mouseChildren設置為.pressupfalse

removed

繼承自?DisplayObject：?removed:656

當顯示對象從其父容器中移除時調(diào)度。

rollout

繼承自?DisplayObject：?rollout:600

自 0.7.0 起可用

此事件類似于mouseout，但有以下區(qū)別：它不會冒泡，并將Container實例視為其內(nèi)容的聚合。

例如，myContainer 包含兩個重疊的孩子：shapeA 和 shapeB。用戶將鼠標移到 shapeA 上，然后直接移到 shapeB 上，然后兩者都關(guān)閉。使用 myContainer 上的 Mouseout:event 偵聽器，將收到兩個事件，每個事件都針對一個子元素：

當鼠標離開 shapeA (target=shapeA)

當鼠標離開 shapeB (target=shapeB)

但是，如果使用“rollout”偵聽器，當鼠標離開聚合 myContainer 內(nèi)容 (target=myContainer) 時，只會收到一個事件。

必須使用enableMouseOver啟用此事件。有關(guān)事件屬性的列表，請參見MouseEvent類。

rollover

繼承自?DisplayObject：?rollover:579

自 0.7.0 起可用

此事件類似于mouseover，但有以下區(qū)別：它不會冒泡，并將Container實例視為其內(nèi)容的聚合。

例如，myContainer 包含兩個重疊的孩子：shapeA 和 shapeB。用戶將鼠標移到 shapeA 上，然后直接移到 shapeB。使用 myContainer 上的 Mouseover:event 偵聽器，將接收兩個事件，每個事件都針對一個子元素：

當鼠標進入shapeA時（target=shapeA）

當鼠標進入shapeB時（target=shapeB）

但是，如果使用“翻轉(zhuǎn)”偵聽器，當鼠標首次進入聚合 myContainer 內(nèi)容 (target=myContainer) 時，只會收到一個事件。

必須使用enableMouseOver啟用此事件。有關(guān)事件屬性的列表，請參見MouseEvent類。

tick

繼承自?DisplayObject：?tick:661

自 0.6.0 起可用

每當舞臺更新時，在舞臺上的每個顯示對象上調(diào)度。這發(fā)生在渲染（繪制）通道之前。調(diào)用update時，首先舞臺上的所有顯示對象都調(diào)度 tick 事件，然后所有顯示對象都被繪制到舞臺上。子級將在事件在其父級上分派之前按其深度順序分派其 Tick:event 事件。

事件負載：

target目的

調(diào)度事件的對象。

type細繩

事件類型。

params大批

包含傳遞給 Stage.update() 方法的任何參數(shù)的數(shù)組。例如，如果您調(diào)用 stage.update("hello")，那么參數(shù)將是 ["hello"]。

標簽： CHILD CHILDREN CLICK MATRIX POINT TRUE