當(dāng)前消息!ANH5 影片剪輯(MovieClip)API 1.0
擴(kuò)展容器
定義在:MovieClip:41
模塊:畫架JS
(資料圖)
MovieClip 類將 TweenJS 時(shí)間軸與 EaselJS?Container相關(guān)聯(lián)。它允許您創(chuàng)建封裝時(shí)間線動(dòng)畫、狀態(tài)更改和同步動(dòng)作的對(duì)象。自 0.7.0 以來,MovieClip 類已包含在 EaselJS 縮小文件中。
目前,MovieClip 僅在基于刻度(而不是基于時(shí)間)的情況下才能正常工作,盡管已做出一些讓步以支持未來基于時(shí)間的時(shí)間線。
例子此示例來回設(shè)置兩個(gè)形狀的動(dòng)畫?;疑螤顝淖髠?cè)開始,但我們使用gotoAndPlay跳轉(zhuǎn)到動(dòng)畫的中點(diǎn)。
var stage = new createjs.Stage("canvas"); createjs.Ticker.addEventListener("tick", stage); var mc = new createjs.MovieClip({loop:-1, labels:{myLabel:20}}); stage.addChild(mc); var child1 = new createjs.Shape( ? ? new createjs.Graphics().beginFill("#999999") ? ? ? ? .drawCircle(30,30,30)); var child2 = new createjs.Shape( ? ? new createjs.Graphics().beginFill("#5a9cfb") ? ? ? ? .drawCircle(30,30,30)); mc.timeline.addTween( ? ? createjs.Tween.get(child1) ? ? ? ? .to({x:0}).to({x:60}, 50).to({x:0}, 50)); mc.timeline.addTween( ? ? createjs.Tween.get(child2) ? ? ? ? .to({x:60}).to({x:0}, 50).to({x:60}, 50)); mc.gotoAndPlay("start");
建議使用tween.to()
動(dòng)畫和設(shè)置屬性(不使用持續(xù)時(shí)間立即設(shè)置),以及tween.wait()
在動(dòng)畫之間創(chuàng)建延遲的方法。請(qǐng)注意,使用該?tween.set()
方法影響屬性可能不會(huì)提供所需的結(jié)果。
MovieClip
(
[props]
)
定義于?MovieClip:41
[props]
對(duì)象?可選
應(yīng)用于此實(shí)例的配置屬性(例如{mode:MovieClip.SYNCHED}
)。下面列出了 MovieClip 支持的道具。這些道具是在相應(yīng)的實(shí)例屬性上設(shè)置的,除非另有說明。
此對(duì)象也將被傳遞到與此 MovieClip 關(guān)聯(lián)的 Timeline 實(shí)例中。paused
有關(guān)支持的道具列表(例如、labels
、loop
、reversed
等) ,請(qǐng)參閱 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
on
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
id
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
x
y
事件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 recalculating
var 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=-100
displayObject.x = 300; displayObject.y = 200; stage.addChild(displayObject); var point = displayObject.localToGlobal(100, 100); // Results in x=400, y=300
var 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
)?
顯示對(duì)象
繼承自?Container:?addChild:178
將子項(xiàng)添加到顯示列表的頂部。
例子您還可以一次添加多個(gè)孩子:
參數(shù):child
顯示對(duì)象
要添加的顯示對(duì)象。
回報(bào):顯示對(duì)象:?
添加的孩子,或者如果添加了多個(gè)孩子,則為最后一個(gè)孩子。
addChildAt
(
child
index
)?
顯示對(duì)象
繼承自?Container:?addChildAt:209
將一個(gè)子元素添加到指定索引處的顯示列表中,將相等或更大索引處的子元素提升一個(gè),并將其父元素設(shè)置為此 Container。
例子您還可以添加多個(gè)孩子,例如:
索引必須介于 0 和 numChildren 之間。例如,要將 myShape 添加到顯示列表中的 otherShape 下,您可以使用:
這也會(huì)將 otherShape 的索引提高 1 個(gè)。如果索引超出范圍,則靜默失敗。
參數(shù):child
顯示對(duì)象
要添加的顯示對(duì)象。
index
數(shù)字
添加孩子的索引。
回報(bào):顯示對(duì)象:?
返回添加的最后一個(gè)孩子,或者如果添加了多個(gè)孩子,則返回最后一個(gè)孩子。
addEventListener
(
type
listener
[useCapture]
)?
功能|?目的
繼承自?EventDispatcher:?addEventListener:140
添加指定的事件偵聽器。請(qǐng)注意,將多個(gè)偵聽器添加到同一個(gè)函數(shù)將導(dǎo)致多個(gè)回調(diào)被觸發(fā)。
例子參數(shù):type
細(xì)繩
事件的字符串類型。
listener
功能|?目的
一個(gè)具有handleEvent 方法的對(duì)象,或者一個(gè)在事件被調(diào)度時(shí)將被調(diào)用的函數(shù)。
[useCapture]
布爾?可選
對(duì)于冒泡的事件,指示是否在捕獲或冒泡/目標(biāo)階段偵聽事件。
回報(bào):功能|?對(duì)象:?
返回用于鏈接或分配的偵聽器。
advance
(
[time]
)
定義于?advance:498
前進(jìn)播放頭。默認(rèn)情況下,這會(huì)在每個(gè)刻度上自動(dòng)發(fā)生。
參數(shù):[time]
號(hào)碼?可選
以毫秒為單位前進(jìn)的時(shí)間量。僅在設(shè)置幀率時(shí)適用。
cache
(
x
y
width
height
[scale=1]
[options=undefined]
)
繼承自?DisplayObject:?cache:803
將顯示對(duì)象繪制到一個(gè)新元素中,然后用于后續(xù)繪制。適用于不經(jīng)常更改的復(fù)雜內(nèi)容(例如,具有許多不移動(dòng)的子項(xiàng)的容器,或復(fù)雜的矢量形狀),這可以提供更快的渲染速度,因?yàn)椴恍枰诿總€(gè)刻度上重新渲染內(nèi)容。緩存的顯示對(duì)象可以自由移動(dòng)、旋轉(zhuǎn)、淡化等,但如果其內(nèi)容發(fā)生變化,則必須updateCache()
再次調(diào)用手動(dòng)更新緩存。您必須通過 x、y、w 和 h 參數(shù)指定緩存區(qū)域。這定義了將使用此顯示對(duì)象的坐標(biāo)進(jìn)行渲染和緩存的矩形。
例如,如果您定義了一個(gè)在 0、0 處繪制一個(gè)半徑為 25 的圓的 Shape:
請(qǐng)注意,需要在應(yīng)用緩存之前定義過濾器,否則您必須在應(yīng)用之后調(diào)用 updateCache。查看過濾器類以獲取更多信息。某些過濾器(例如 BlurFilter)可能無法與比例參數(shù)一起按預(yù)期工作。
通常,生成的 cacheCanvas 將具有尺寸寬度比例、高度比例,但是一些過濾器(例如 BlurFilter)會(huì)為畫布尺寸添加填充。
在以前的版本中,緩存是在 DisplayObject 上處理的,但后來被移到了BitmapCache中。這允許更輕松的交互和備用緩存方法,例如 WebGL 和StageGL。有關(guān)選項(xiàng)對(duì)象的更多信息,請(qǐng)參閱 BitmapCache定義。
參數(shù):x
數(shù)字
緩存區(qū)域的 x 坐標(biāo)原點(diǎn)。
y
數(shù)字
緩存區(qū)域的 y 坐標(biāo)原點(diǎn)。
width
數(shù)字
緩存區(qū)域的寬度。
height
數(shù)字
緩存區(qū)域的高度。
[scale=1]
號(hào)碼?可選
創(chuàng)建緩存的比例。例如,如果您使用 myShape.cache(0,0,100,100,2) 緩存矢量形狀,則生成的 cacheCanvas 將為 200x200 像素。這使您可以更保真地縮放和旋轉(zhuǎn)緩存的元素。默認(rèn)值為 1。
[options=undefined]
對(duì)象?可選
為緩存邏輯指定附加參數(shù)
clone
()
繼承自?DisplayObject?但被覆蓋?clone:522
無法克隆 MovieClip 實(shí)例。
contains
(
child
)?
布爾值
繼承自?Container:?contains:435
如果指定的顯示對(duì)象是此容器或者是此容器的后代(子、孫等),則返回 true。
參數(shù):child
顯示對(duì)象
要檢查的 DisplayObject。
回報(bào):布爾值:?
如果指定的顯示對(duì)象是此容器或后代,則為 true。
dispatchEvent
(
eventObj
[bubbles]
[cancelable]
)?
布爾值
繼承自?EventDispatcher:?dispatchEvent:285
將指定的事件分派給所有偵聽器。
例子參數(shù):eventObj
對(duì)象|?字符串|?事件
具有“類型”屬性或字符串類型的對(duì)象。雖然通用對(duì)象可以工作,但建議使用 CreateJS 事件實(shí)例。如果使用字符串,dispatchEvent 將在必要時(shí)構(gòu)造一個(gè)具有指定類型的 Event 實(shí)例。后一種方法可用于避免為可能沒有任何偵聽器的非冒泡事件實(shí)例化事件對(duì)象。
[bubbles]
布爾?可選
指定將bubbles
字符串傳遞給 eventObj 時(shí)的值。
[cancelable]
布爾?可選
指定將cancelable
字符串傳遞給 eventObj 時(shí)的值。
布爾值:?
preventDefault()
如果在可取消事件上調(diào)用,則返回 false ,否則返回 true。
draw
(
ctx
ignoreCache
)
繼承自?DisplayObject?但被覆蓋?draw:444
將顯示對(duì)象繪制到指定的上下文中,忽略其可見、alpha、陰影和變換。如果繪制已處理,則返回 true(用于覆蓋功能)。注意:此方法主要供內(nèi)部使用,但它可能對(duì)高級(jí)用途有用。
參數(shù):ctx
CanvasRenderingContext2D
要繪制的畫布 2D 上下文對(duì)象。
ignoreCache
布爾值
指示繪制操作是否應(yīng)忽略任何當(dāng)前緩存。例如,用于繪制緩存(以防止它簡單地將現(xiàn)有緩存繪制回自身)。
getBounds
()?矩形
繼承自?DisplayObject:?getBounds:1100
返回一個(gè)矩形,表示該對(duì)象在其局部坐標(biāo)系中的邊界(即沒有變換)。已緩存的對(duì)象將返回緩存的邊界。
并非所有顯示對(duì)象都可以計(jì)算自己的邊界(例如形狀)。對(duì)于這些對(duì)象,您可以使用?setBounds以便在計(jì)算容器邊界時(shí)將它們包括在內(nèi)。
全部所有顯示對(duì)象都支持使用 setBounds() 手動(dòng)設(shè)置邊界。同樣,已使用 cache() 緩存的顯示對(duì)象將返回其緩存的邊界。手動(dòng)和緩存邊界將覆蓋下面列出的自動(dòng)計(jì)算。位圖返回從 (x=0,y=0) 擴(kuò)展的位圖/源矩形(如果指定)或圖像的寬度和高度。雪碧返回當(dāng)前幀的邊界。如果在 spritesheet 數(shù)據(jù)中指定了幀注冊(cè)點(diǎn),則可能具有非零 x/y。另請(qǐng)參閱getFrameBounds容器返回從 中返回非空值的所有子項(xiàng)的聚合(組合)邊界getBounds()
。形狀當(dāng)前不支持自動(dòng)邊界計(jì)算。用于setBounds()
手動(dòng)定義邊界。文本返回近似邊界。水平值 (x/width) 非常準(zhǔn)確,但垂直值 (y/height) 不準(zhǔn)確,尤其是在使用textBaseline值而不是 "top" 時(shí)。位圖文本返回近似邊界。如果 spritesheet 幀注冊(cè)點(diǎn)接近 (x=0,y=0),值會(huì)更準(zhǔn)確。
計(jì)算某些對(duì)象(例如文本或具有許多子對(duì)象的容器)的邊界可能很昂貴,并且每次調(diào)用 getBounds() 時(shí)都會(huì)重新計(jì)算。您可以通過顯式設(shè)置邊界來防止重新計(jì)算靜態(tài)對(duì)象:
為了減少內(nèi)存影響,返回的 Rectangle 實(shí)例可以在內(nèi)部重用;如果需要保留它,請(qǐng)克隆實(shí)例或復(fù)制其值。
回報(bào):矩形:?
表示邊界的 Rectangle 實(shí)例,如果邊界不適用于此對(duì)象,則為 null。
getCacheDataURL
()?字符串
繼承自?DisplayObject:?getCacheDataURL:886
返回緩存的數(shù)據(jù) URL,如果未緩存此顯示對(duì)象,則返回 null。僅在緩存已更改時(shí)生成,否則返回最后一個(gè)結(jié)果。
回報(bào):字符串:?
緩存的圖像數(shù)據(jù) url。
getChildAt
(
index
)?
顯示對(duì)象
繼承自?Container:?getChildAt:319
返回指定索引處的子級(jí)。
例子參數(shù):index
數(shù)字
要返回的孩子的索引。
回報(bào):顯示對(duì)象:?
指定索引處的子項(xiàng)。如果索引處沒有子元素,則返回 null。
getChildByName
(
name
)?
顯示對(duì)象
繼承自?Container:?getChildByName:334
返回具有指定名稱的孩子。
參數(shù):name
細(xì)繩
要返回的孩子的姓名。
回報(bào):顯示對(duì)象:?
具有指定名稱的孩子。
getChildIndex
(
child
)?
數(shù)字
繼承自?Container:?getChildIndex:368
返回顯示列表中指定子項(xiàng)的索引,如果不在顯示列表中,則返回 -1。
例子參數(shù):child
顯示對(duì)象
要返回其索引的子項(xiàng)。
回報(bào):號(hào)碼:?
指定子節(jié)點(diǎn)的索引。-1 如果沒有找到孩子。
getConcatenatedDisplayProps
(
[props]
)?
展示道具
繼承自?DisplayObject:?getConcatenatedDisplayProps:1032
生成一個(gè) DisplayProps 對(duì)象,該對(duì)象表示對(duì)象及其所有父 Container 的組合顯示屬性,直到最高級(jí)別的祖先(通常是Stage)。
參數(shù):[props]
DisplayProps?可選
使用計(jì)算值填充的DisplayProps對(duì)象。如果為 null,則返回一個(gè)新的 DisplayProps 對(duì)象。
回報(bào):顯示道具:?
組合顯示屬性。
getConcatenatedMatrix
(
[matrix]
)?
Matrix2D
繼承自?DisplayObject:?getConcatenatedMatrix:1014
生成一個(gè) Matrix2D 對(duì)象,該對(duì)象表示顯示對(duì)象及其所有父 Container 的組合變換,直到最高級(jí)別的祖先(通常是Stage)。這可用于在坐標(biāo)空間之間轉(zhuǎn)換位置,例如使用localToGlobal?和globalToLocal。
參數(shù):[matrix]
Matrix2D?可選
使用計(jì)算值填充的Matrix2D對(duì)象。如果為 null,則返回一個(gè)新的 Matrix2D 對(duì)象。
回報(bào):矩陣2D:?
組合矩陣。
getCurrentLabel
()?已棄用
定義于?getCurrentLabel:358
請(qǐng)改用currentLabel屬性。
getDuration
()?已棄用
定義于?getDuration:376
請(qǐng)改用持續(xù)時(shí)間屬性。
getLabels
()?已棄用
定義于?getLabels:340
請(qǐng)改用標(biāo)簽屬性。
getMatrix
(
matrix
)?
Matrix2D
繼承自?DisplayObject:?getMatrix:1002
根據(jù)此對(duì)象的當(dāng)前變換返回一個(gè)矩陣。
參數(shù):matrix
Matrix2D
可選的。使用計(jì)算值填充的 Matrix2D 對(duì)象。如果為 null,則返回一個(gè)新的 Matrix 對(duì)象。
回報(bào):矩陣2D:?
表示此顯示對(duì)象變換的矩陣。
getNumChildren
()?已棄用
繼承自?Container:?getNumChildren:106
請(qǐng)改用numChildren屬性。
getObjectsUnderPoint
(
x
y
[mode=0]
)?
大批
繼承自?Container:?getObjectsUnderPoint:465
返回此容器的顯示列表中指定坐標(biāo)下的所有顯示對(duì)象的數(shù)組。此例程忽略mouseEnabled?設(shè)置為 的任何顯示對(duì)象false
。數(shù)組將按視覺深度排序,最頂部的顯示對(duì)象位于索引 0。這使用基于形狀的命中檢測(cè),運(yùn)行起來可能是一項(xiàng)昂貴的操作,因此最好謹(jǐn)慎使用。例如,如果在鼠標(biāo)下測(cè)試對(duì)象,則在刻度上進(jìn)行測(cè)試(而不是在stagemousemove上),并且僅在鼠標(biāo)位置發(fā)生變化時(shí)進(jìn)行測(cè)試。
默認(rèn)情況下 (mode=0),此方法評(píng)估所有顯示對(duì)象。
通過將mode
參數(shù)設(shè)置為1
,將尊重mouseEnabled?和 MouseChildren:property 屬性。
將 設(shè)置mode
為2
另外排除沒有活動(dòng)鼠標(biāo)事件偵聽器或 DisplayObject:cursor:property 屬性的顯示對(duì)象。也就是說,只會(huì)包含通常會(huì)攔截鼠標(biāo)交互的對(duì)象。在某些情況下,這可以通過減少需要測(cè)試的顯示對(duì)象的數(shù)量來顯著提高性能。
此方法同時(shí)考慮了hitArea和mask。
參數(shù):x
數(shù)字
要測(cè)試的容器中的 x 位置。
y
數(shù)字
要測(cè)試的容器中的 y 位置。
[mode=0]
號(hào)碼?可選
用于確定要包括哪些顯示對(duì)象的模式。0-全部,1-尊重 mouseEnabled/mouseChildren,2-僅鼠標(biāo)不透明對(duì)象。
回報(bào):數(shù)組:?
指定坐標(biāo)下的 DisplayObject 數(shù)組。
getObjectUnderPoint
(
x
y
mode
)?
顯示對(duì)象
繼承自?Container:?getObjectUnderPoint:497
類似于getObjectsUnderPoint,但只返回最頂層的顯示對(duì)象。它的運(yùn)行速度明顯快于getObjectsUnderPoint()
,但仍然可能是一項(xiàng)昂貴的操作。有關(guān)詳細(xì)信息,請(qǐng)參閱getObjectsUnderPoint。
x
數(shù)字
要測(cè)試的容器中的 x 位置。
y
數(shù)字
要測(cè)試的容器中的 y 位置。
mode
數(shù)字
用于確定要包括哪些顯示對(duì)象的模式。0-全部,1-尊重 mouseEnabled/mouseChildren,2-僅鼠標(biāo)不透明對(duì)象。
回報(bào):顯示對(duì)象:?
指定坐標(biāo)下最頂層的顯示對(duì)象。
getStage
()?已棄用
繼承自?DisplayObject:?getStage:691
請(qǐng)改用舞臺(tái)屬性。
getTransformedBounds
()?矩形
繼承自?DisplayObject:?getTransformedBounds:1166
返回一個(gè)矩形,表示該對(duì)象在其父坐標(biāo)系中的邊界(即應(yīng)用了變換)。已緩存的對(duì)象將返回緩存的轉(zhuǎn)換邊界。
并非所有顯示對(duì)象都可以計(jì)算自己的邊界(例如形狀)。對(duì)于這些對(duì)象,您可以使用?setBounds以便在計(jì)算容器邊界時(shí)將它們包括在內(nèi)。
為了減少內(nèi)存影響,返回的 Rectangle 實(shí)例可以在內(nèi)部重用;如果需要保留它,請(qǐng)克隆實(shí)例或復(fù)制其值。
容器實(shí)例為所有通過 getBounds 返回邊界的子節(jié)點(diǎn)計(jì)算聚合邊界。
回報(bào):矩形:?
表示邊界的 Rectangle 實(shí)例,如果邊界不適用于此對(duì)象,則為 null。
globalToLocal
(
x
y
[pt]
)?
觀點(diǎn)
繼承自?DisplayObject:?globalToLocal:921
將指定的 x 和 y 位置從全局(舞臺(tái))坐標(biāo)空間轉(zhuǎn)換到顯示對(duì)象的坐標(biāo)空間。例如,這可用于確定顯示對(duì)象內(nèi)的當(dāng)前鼠標(biāo)位置。返回一個(gè) Point 實(shí)例,其 x 和 y 屬性與顯示對(duì)象坐標(biāo)空間中的變換位置相關(guān)。
例子參數(shù):x
數(shù)字
舞臺(tái)上要變換的 x 位置。
y
數(shù)字
舞臺(tái)上要變換的 y 位置。
[pt]
點(diǎn)|?對(duì)象?可選
將結(jié)果復(fù)制到的對(duì)象。如果省略,將返回具有 x/y 屬性的新 Point 對(duì)象。
回報(bào):點(diǎn):?
具有與顯示對(duì)象坐標(biāo)空間中的變換位置相關(guān)的 x 和 y 屬性的 Point 實(shí)例。
gotoAndPlay
(
positionOrLabel
)
定義于?gotoAndPlay:478
將此影片剪輯前進(jìn)到指定的位置或標(biāo)簽,并將 paused 設(shè)置為 false。
參數(shù):positionOrLabel
字符串|?數(shù)字
要轉(zhuǎn)到的動(dòng)畫名稱或幀號(hào)。
gotoAndStop
(
positionOrLabel
)
定義于?gotoAndStop:488
將此影片剪輯前進(jìn)到指定的位置或標(biāo)簽,并將 paused 設(shè)置為 true。
參數(shù):positionOrLabel
字符串|?數(shù)字
要轉(zhuǎn)到的動(dòng)畫或幀名稱。
hasEventListener
(
type
)?
布爾值
繼承自?EventDispatcher:?hasEventListener:339
指示是否至少有一個(gè)針對(duì)指定事件類型的偵聽器。
參數(shù):type
細(xì)繩
事件的字符串類型。
回報(bào):布爾值:?
如果指定事件至少有一個(gè)偵聽器,則返回 true。
hitTest
(
x
y
)?
布爾值
繼承自?DisplayObject?但被覆蓋?hitTest:450
測(cè)試顯示對(duì)象是否與指定的局部點(diǎn)相交(即在指定位置繪制一個(gè) alpha > 0 的像素)。這會(huì)忽略顯示對(duì)象的 alpha、陰影和復(fù)合操作,以及包括 regX/Y 在內(nèi)的所有變換屬性。
參數(shù):x
數(shù)字
在顯示對(duì)象的本地坐標(biāo)中檢查的 x 位置。
y
數(shù)字
在顯示對(duì)象的本地坐標(biāo)中檢查的 y 位置。
回報(bào):布爾值:?
一個(gè)布爾值,指示是否存在與指定坐標(biāo)重疊的 DisplayObject 的可見部分。
initialize
()?已棄用
繼承自?Container?但被覆蓋?initialize:423
用于向后兼容的構(gòu)造函數(shù)別名。此方法將在以后的版本中刪除。應(yīng)該更新子類以使用extend和?promote。
isVisible
()?布爾值
繼承自?DisplayObject?但被覆蓋?isVisible:432
返回 true 或 false 指示如果將顯示對(duì)象繪制到畫布上是否可見。這不考慮它是否會(huì)在舞臺(tái)邊界內(nèi)可見。注意:此方法主要供內(nèi)部使用,但它可能對(duì)高級(jí)用途有用。
回報(bào):布爾值:?
布爾值,指示顯示對(duì)象在繪制到畫布時(shí)是否可見
localToGlobal
(
x
y
[pt]
)?
觀點(diǎn)
繼承自?DisplayObject:?localToGlobal:896
將指定的 x 和 y 位置從顯示對(duì)象的坐標(biāo)空間轉(zhuǎn)換到全局(舞臺(tái))坐標(biāo)空間。例如,這可用于將 HTML 標(biāo)簽放置在嵌套顯示對(duì)象上的特定點(diǎn)上。返回一個(gè) Point 實(shí)例,其 x 和 y 屬性與舞臺(tái)上變換后的坐標(biāo)相關(guān)。
例子參數(shù):x
數(shù)字
要變換的源顯示對(duì)象中的 x 位置。
y
數(shù)字
要變換的源顯示對(duì)象中的 y 位置。
[pt]
點(diǎn)|?對(duì)象?可選
將結(jié)果復(fù)制到的對(duì)象。如果省略,將返回具有 x/y 屬性的新 Point 對(duì)象。
回報(bào):點(diǎn):?
具有與舞臺(tái)上變換后的坐標(biāo)相關(guān)的 x 和 y 屬性的 Point 實(shí)例。
localToLocal
(
x
y
target
[pt]
)?
觀點(diǎn)
繼承自?DisplayObject:?localToLocal:946
將指定的 x 和 y 位置從此顯示對(duì)象的坐標(biāo)空間轉(zhuǎn)換到目標(biāo)顯示對(duì)象的坐標(biāo)空間。返回一個(gè) Point 實(shí)例,其 x 和 y 屬性與目標(biāo)坐標(biāo)空間中的變換位置相關(guān)。實(shí)際上與將以下代碼與?localToGlobal和globalToLocal一起使用相同。
參數(shù):x
數(shù)字
要變換的源顯示對(duì)象中的 x 位置。
y
數(shù)字
要變換的源顯示對(duì)象上的 y 位置。
target
顯示對(duì)象
坐標(biāo)將轉(zhuǎn)換到的目標(biāo)顯示對(duì)象。
[pt]
點(diǎn)|?對(duì)象?可選
將結(jié)果復(fù)制到的對(duì)象。如果省略,將返回具有 x/y 屬性的新 Point 對(duì)象。
回報(bào):點(diǎn):?
返回一個(gè) Point 實(shí)例,其 x 和 y 屬性與目標(biāo)坐標(biāo)空間中的變換位置相關(guān)。
off
(
type
listener
[useCapture]
)
繼承自?EventDispatcher:?off:249
removeEventListener 方法的快捷方式,具有相同的參數(shù)和返回值。這是 .on 方法的伴侶。
重要提示:要?jiǎng)h除添加的偵聽on
器,您必須將返回的包裝函數(shù)作為偵聽器傳入。請(qǐng)參閱?示例。
type
細(xì)繩
事件的字符串類型。
listener
功能|?目的
偵聽器函數(shù)或?qū)ο蟆?/p>
[useCapture]
布爾?可選
對(duì)于冒泡的事件,指示是否在捕獲或冒泡/目標(biāo)階段偵聽事件。
on
(
type
listener
[scope]
[once=false]
[data]
[useCapture=false]
)?
功能
繼承自?EventDispatcher:?on:173
一種使用 addEventListener 的快捷方法,可以更輕松地指定執(zhí)行范圍,讓偵聽器只運(yùn)行一次,將任意數(shù)據(jù)與偵聽器關(guān)聯(lián),并刪除偵聽器。
此方法通過創(chuàng)建匿名包裝函數(shù)并使用 addEventListener 訂閱它來工作。返回包裝函數(shù)以用于removeEventListener
(或off
)。
重要提示:要?jiǎng)h除使用 添加的偵聽on
器,您必須將返回的包裝函數(shù)作為偵聽器傳入,或者使用?remove。同樣,每次調(diào)用on
新包裝函數(shù)時(shí)都會(huì)訂閱,因此on
使用相同參數(shù)的多次調(diào)用將創(chuàng)建多個(gè)偵聽器。
type
細(xì)繩
事件的字符串類型。
listener
功能|?目的
一個(gè)具有handleEvent 方法的對(duì)象,或者一個(gè)在事件被調(diào)度時(shí)將被調(diào)用的函數(shù)。
[scope]
對(duì)象?可選
執(zhí)行偵聽器的范圍。函數(shù)偵聽器默認(rèn)為 dispatcher/currentTarget,對(duì)象偵聽器默認(rèn)為偵聽器本身(即使用 handleEvent)。
[once=false]
布爾?可選
如果為 true,則偵聽器將在第一次觸發(fā)后自行移除。
[data]
可選的
調(diào)用偵聽器時(shí)將作為第二個(gè)參數(shù)包含的任意數(shù)據(jù)。
[useCapture=false]
布爾?可選
對(duì)于冒泡的事件,指示是否在捕獲或冒泡/目標(biāo)階段偵聽事件。
回報(bào):功能:?
返回創(chuàng)建并分配為偵聽器的匿名函數(shù)。稍后需要使用 .removeEventListener 刪除偵聽器。
play
()
定義于?play:462
設(shè)置暫停為假。
removeAllChildren
()
繼承自?Container:?removeAllChildren:305
從顯示列表中刪除所有子項(xiàng)。
例子removeAllEventListeners
(
[type]
)
繼承自?EventDispatcher:?removeAllEventListeners:263
刪除指定類型的所有偵聽器,或所有類型的所有偵聽器。
例子參數(shù):[type]
字符串?可選
事件的字符串類型。如果省略,所有類型的所有偵聽器都將被刪除。
removeChild
(
child
)?
布爾值
繼承自?Container:?removeChild:249
從顯示列表中刪除指定的子項(xiàng)。請(qǐng)注意,如果索引已知,則使用 removeChildAt() 會(huì)更快。
例子您還可以刪除多個(gè)孩子:
如果子項(xiàng)(或多個(gè)子項(xiàng))已被刪除,則返回 true;如果它不在顯示列表中,則返回 false。
參數(shù):child
顯示對(duì)象
要?jiǎng)h除的孩子。
回報(bào):布爾值:?
如果子項(xiàng)(或多個(gè)子項(xiàng))已被刪除,則為 true;如果它不在顯示列表中,則為 false。
removeChildAt
(
index
)?
布爾值
繼承自?Container?但被覆蓋?removeChildAt:276
從顯示列表中刪除指定索引處的子項(xiàng),并將其父項(xiàng)設(shè)置為 null。
例子您還可以刪除多個(gè)孩子:
如果子項(xiàng)(或多個(gè)子項(xiàng))被刪除,則返回 true;如果任何索引超出范圍,則返回 false。
參數(shù):index
數(shù)字
要?jiǎng)h除的孩子的索引。
回報(bào):布爾值:?
如果子項(xiàng)(或多個(gè)子項(xiàng))被刪除,則為 true,如果任何索引超出范圍,則為 false。
removeEventListener
(
type
listener
[useCapture]
)
繼承自?EventDispatcher:?removeEventListener:219
刪除指定的事件偵聽器。
重要提示:您必須傳遞添加事件時(shí)使用的確切函數(shù)引用。如果使用代理函數(shù)或函數(shù)閉包作為回調(diào),則必須使用代理/閉包引用 - 新的代理或閉包將不起作用。
例子參數(shù):type
細(xì)繩
事件的字符串類型。
listener
功能|?目的
偵聽器函數(shù)或?qū)ο蟆?/p>
[useCapture]
布爾?可選
對(duì)于冒泡的事件,指示是否在捕獲或冒泡/目標(biāo)階段偵聽事件。
set
(
props
)?
DisplayObject?可鏈接
繼承自?DisplayObject:?set:1082
提供一種可鏈接的快捷方式,用于在實(shí)例上設(shè)置多個(gè)屬性。
例子參數(shù):props
目的
包含要復(fù)制到 DisplayObject 實(shí)例的屬性的通用對(duì)象。
回報(bào):顯示對(duì)象:?
返回調(diào)用該方法的實(shí)例(對(duì)于鏈接調(diào)用很有用。)
setBounds
(
x
y
width
height
)
繼承自?DisplayObject:?setBounds:1185
允許您手動(dòng)指定無法計(jì)算自己的邊界(例如形狀和文本)以供將來參考的對(duì)象的邊界,或者可以將對(duì)象包含在容器邊界中。手動(dòng)設(shè)置的界限將始終覆蓋計(jì)算的界限。
邊界應(yīng)在對(duì)象的本地(未轉(zhuǎn)換)坐標(biāo)中指定。例如,一個(gè)以 0,0 為中心的半徑為 25px 的圓的 Shape 實(shí)例的邊界為 (-25, -25, 50, 50)。
參數(shù):x
數(shù)字
邊界的 x 原點(diǎn)。傳遞 null 以刪除手動(dòng)邊界。
y
數(shù)字
邊界的 y 原點(diǎn)。
width
數(shù)字
邊界的寬度。
height
數(shù)字
邊界的高度。
setChildIndex
(
child
index
)
繼承自?Container:?setChildIndex:418
更改指定子項(xiàng)的深度。如果子項(xiàng)不是此容器的子項(xiàng),或者索引超出范圍,則靜默失敗。
參數(shù):child
顯示對(duì)象
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
在顯示對(duì)象上快速設(shè)置變換屬性的快捷方法。所有參數(shù)都是可選的。省略的參數(shù)將設(shè)置默認(rèn)值。
例子參數(shù):[x=0]
號(hào)碼?可選
以像素為單位的水平平移(x 位置)
[y=0]
號(hào)碼?可選
以像素為單位的垂直平移(y 位置)
[scaleX=1]
號(hào)碼?可選
水平刻度,以 1 的百分比表示
[scaleY=1]
號(hào)碼?可選
垂直比例,以 1 的百分比表示
[rotation=0]
號(hào)碼?可選
旋轉(zhuǎn),以度為單位
[skewX=0]
號(hào)碼?可選
水平偏斜系數(shù)
[skewY=0]
號(hào)碼?可選
垂直偏斜系數(shù)
[regX=0]
號(hào)碼?可選
以像素為單位的水平注冊(cè)點(diǎn)
[regY=0]
號(hào)碼?可選
以像素為單位的垂直配準(zhǔn)點(diǎn)
回報(bào):顯示對(duì)象:?
返回此實(shí)例。用于鏈接命令。
sortChildren
(
sortFunction
)
繼承自?Container:?sortChildren:348
對(duì)子列表執(zhí)行數(shù)組排序操作。
示例:顯示前面 y 較高的孩子。參數(shù):sortFunction
功能
用于對(duì)子列表進(jìn)行排序的函數(shù)。有關(guān)詳細(xì)信息,請(qǐng)參閱 JavaScript 的Array.sort
文檔。
stop
()
定義于?stop:470
設(shè)置暫停為真。
swapChildren
(
child1
child2
)
繼承自?Container:?swapChildren:398
交換顯示列表中指定子項(xiàng)的深度。如果任一子級(jí)不是此容器的子級(jí),則靜默失敗。
參數(shù):child1
顯示對(duì)象
child2
顯示對(duì)象
swapChildrenAt
(
index1
index2
)
繼承自?Container:?swapChildrenAt:383
交換指定索引處的子代。如果任一索引超出范圍,則靜默失敗。
參數(shù):index1
數(shù)字
index2
數(shù)字
toString
()?字符串
繼承自?EventDispatcher?但被覆蓋?toString:531
返回此對(duì)象的字符串表示形式。
回報(bào):字符串:?
實(shí)例的字符串表示形式。
uncache
()
繼承自?DisplayObject:?uncache:875
清除當(dāng)前緩存。有關(guān)詳細(xì)信息,請(qǐng)參閱緩存。
updateCache
(
compositeOperation
)
繼承自?DisplayObject:?updateCache:846
將顯示對(duì)象重繪到其緩存。在沒有活動(dòng)緩存的情況下調(diào)用 updateCache 將引發(fā)錯(cuò)誤。如果compositeOperation 為null,則當(dāng)前緩存將在繪制之前被清除。否則,將使用指定的compositeOperation 在現(xiàn)有緩存上繪制顯示對(duì)象。
例子清除緩存形狀的當(dāng)前圖形,繪制一些新指令,然后更新緩存。新線將繪制在舊線之上。
在以前的版本中,緩存是在 DisplayObject 上處理的,但后來被移到了BitmapCache中。這允許更輕松的交互和替代緩存方法,如 WebGL 和StageGL。
參數(shù):compositeOperation
細(xì)繩
要使用的compositeOperation,或null 以清除緩存并重繪它。?whatwg 合成規(guī)范。
updateContext
(
ctx
)
繼承自?DisplayObject:?updateContext:771
將此顯示對(duì)象的變換、alpha、globalCompositeOperation、剪切路徑(遮罩)和陰影應(yīng)用到指定的上下文。這通常在draw之前調(diào)用。
參數(shù):ctx
CanvasRenderingContext2D
要更新的 2D 畫布。
willTrigger
(
type
)?
布爾值
繼承自?EventDispatcher:?willTrigger:350
指示此對(duì)象或其任何祖先(父級(jí)、父級(jí)的父級(jí)等)上的指定事件類型是否至少有一個(gè)偵聽器。返回值為 true 表示如果從該對(duì)象調(diào)度指定類型的冒泡事件,它將觸發(fā)至少一個(gè)偵聽器。
這類似于hasEventListener,但它在整個(gè)事件流中搜索偵聽器,而不僅僅是這個(gè)對(duì)象。
參數(shù):type
細(xì)繩
事件的字符串類型。
回報(bào):布爾值:?
true
如果指定事件至少有一個(gè)偵聽器,則返回。
actionsEnabled
布爾值
定義于?actionsEnabled:162
如果為 true,則當(dāng)播放頭前進(jìn)時(shí),將運(yùn)行此 MovieClip 補(bǔ)間中的動(dòng)作。
默認(rèn)值:真
alpha
數(shù)字
繼承自?DisplayObject:?alpha:147
此顯示對(duì)象的 alpha(透明度)。0 是完全透明的,1 是完全不透明的。
默認(rèn)值:1
autoReset
布爾值
定義于?autoReset:170
如果為 true,每當(dāng)時(shí)間線將其添加回顯示列表時(shí),MovieClip 將自動(dòng)重置為其第一幀。這僅適用于具有mode
“獨(dú)立”的 MovieClip 實(shí)例。
例如,如果您有一個(gè)角色動(dòng)畫,其中有一個(gè)“body”子 MovieClip 實(shí)例,每個(gè)幀上都有不同的服裝,您可以設(shè)置body.autoReset = false
,這樣您就可以手動(dòng)更改它所在的幀,而不必?fù)?dān)心它會(huì)自動(dòng)重置。
默認(rèn)值:真
bitmapCache
BitmapCache?只讀
繼承自?DisplayObject:?bitmapCache:165
如果已創(chuàng)建緩存,則返回管理 cacheCanvas 及其屬性的類。?有關(guān)詳細(xì)信息,請(qǐng)參閱位圖緩存。使用它來控制、檢查和更改緩存。在特殊情況下,這可能是經(jīng)過修改或子類化的 BitmapCache。
默認(rèn)值:空
cacheCanvas
HTMLCanvasElement |?對(duì)象?只讀
繼承自?DisplayObject:?cacheCanvas:155
如果緩存處于活動(dòng)狀態(tài),則返回包含此顯示對(duì)象圖像的畫布。有關(guān)詳細(xì)信息,請(qǐng)參閱緩存?。使用它來顯示緩存的結(jié)果。這將是一個(gè) HTMLCanvasElement,除非特意為此緩存啟用了特殊的緩存規(guī)則。
默認(rèn)值:空
cacheID
數(shù)量?已棄用
繼承自?DisplayObject:?cacheID:706
返回唯一標(biāo)識(shí)此顯示對(duì)象的當(dāng)前緩存的 ID 號(hào)。這可用于確定自上次檢查以來緩存是否已更改。移至位圖緩存
默認(rèn)值:0
children
大批
繼承自?Container:?children:61
顯示列表中的子元素?cái)?shù)組。您通常應(yīng)該使用子管理方法,例如?addChild、removeChild、?swapChildren等,而不是直接訪問它,但它包含在高級(jí)用途中。
默認(rèn)值:空
compositeOperation
細(xì)繩
繼承自?DisplayObject:?compositeOperation:333
合成操作指示此顯示對(duì)象的像素將如何與其后面的元素合成。如果null
,則此屬性是從父容器繼承的。有關(guān)更多信息,請(qǐng)閱讀?關(guān)于合成的 whatwg 規(guī)范。有關(guān)受支持的compositeOperation 值的列表,請(qǐng)?jiān)L問?關(guān)于合成和混合的W3C 草案。
默認(rèn)值:空
currentFrame
數(shù)字?只讀
定義于?currentFrame:145
影片剪輯的當(dāng)前幀。
默認(rèn)值:0
currentLabel
字符串?只讀
定義于?currentLabel:391
返回當(dāng)前幀上或之前的標(biāo)簽名稱。
cursor
細(xì)繩
繼承自?DisplayObject:?cursor:391
當(dāng)用戶將鼠標(biāo)懸停在此顯示對(duì)象上時(shí)將顯示的 CSS 光標(biāo)(例如“指針”、“幫助”、“文本”等)。您必須使用enableMouseOver方法啟用鼠標(biāo)懸停事件才能使用此屬性。在 Container 上設(shè)置非空游標(biāo)將覆蓋在其后代上設(shè)置的游標(biāo)。
默認(rèn)值:空
duration
數(shù)字?只讀
定義于?duration:405
返回此 MovieClip 的持續(xù)時(shí)間(以秒或節(jié)拍為單位)。
filters
大批
繼承自?DisplayObject:?filters:355
要應(yīng)用于此顯示對(duì)象的過濾器對(duì)象數(shù)組。過濾器僅在顯示對(duì)象上調(diào)用 Cache 或 UpdateCache 時(shí)應(yīng)用/更新,并且僅適用于緩存的區(qū)域。
默認(rèn)值:空
frameBounds
大批
定義于?frameBounds:183
MovieClip 中每一幀的邊界數(shù)組。這主要用于工具輸出。
默認(rèn)值:空
framerate
數(shù)字
定義于?framerate:191
默認(rèn)情況下,MovieClip 實(shí)例每刻前進(jìn)一幀。為 MovieClip 指定幀速率將使其根據(jù)滴答之間經(jīng)過的時(shí)間適當(dāng)?shù)乇3帜繕?biāo)幀速率。
例如,如果將幀率為 10 的 MovieClip 放置在以 40fps 更新的 Stage 上,則 MovieClip 將大約每 4 tick 前進(jìn)一幀。這并不準(zhǔn)確,因?yàn)槊總€(gè)刻度之間的時(shí)間在幀之間會(huì)略有不同。
此功能取決于傳遞給update的滴答事件對(duì)象(或具有適當(dāng)“delta”屬性的對(duì)象) 。
默認(rèn)值:空
hitArea
顯示對(duì)象
繼承自?DisplayObject:?hitArea:374
在檢查鼠標(biāo)交互或測(cè)試getObjectsUnderPoint時(shí)將測(cè)試的顯示對(duì)象。命中區(qū)域?qū)⑾鄬?duì)于該顯示對(duì)象的坐標(biāo)空間應(yīng)用其變換(就好像命中測(cè)試對(duì)象是該顯示對(duì)象的子對(duì)象并相對(duì)于其 regX/Y)。alpha
無論目標(biāo)顯示對(duì)象或目標(biāo)的祖先(父母)上的 alpha 值如何,都將僅使用其自己的值測(cè)試 hitArea 。
如果在 Container 上設(shè)置,則Container的子級(jí)將不會(huì)接收鼠標(biāo)事件。這類似于將 MouseChildren 設(shè)置為 false。
請(qǐng)注意,該方法當(dāng)前不使用 hitArea ,?StagehitTest()
也不支持它。
默認(rèn)值:空
id
數(shù)字
繼承自?DisplayObject:?id:175
此顯示對(duì)象的唯一 ID。使顯示對(duì)象更容易用于某些用途。
默認(rèn)值:-1
INDEPENDENT
字符串?靜態(tài)?只讀
定義于?INDEPENDENT:283
MovieClip 將獨(dú)立于其父級(jí)前進(jìn),即使其父級(jí)已暫停。這是默認(rèn)模式。
默認(rèn)值:“獨(dú)立”
labels
數(shù)組?只讀
定義于?labels:384
返回具有標(biāo)簽和位置(又名框架)屬性的對(duì)象數(shù)組,按位置排序。
loop
數(shù)字
定義于?loop:136
指定此 MovieClip 應(yīng)循環(huán)多少次。值 -1 表示它應(yīng)該無限循環(huán)。值為 1 將導(dǎo)致它循環(huán)一次(即總共播放兩次)。
默認(rèn)值:-1
mask
形狀
繼承自?DisplayObject:?mask:365
定義此顯示對(duì)象的矢量蒙版(剪切路徑)的 Shape 實(shí)例。形狀的變換將相對(duì)于顯示對(duì)象的父坐標(biāo)應(yīng)用(就好像它是父對(duì)象的子對(duì)象一樣)。
默認(rèn)值:空
mode
細(xì)繩
定義于?mode:119
控制此 MovieClip 如何推進(jìn)其時(shí)間。必須是 0 (INDEPENDENT)、1 (SINGLE_FRAME) 或 2 (SYNCHED) 之一。有關(guān)行為的描述,請(qǐng)參見每個(gè)常量。
默認(rèn)值:空
mouseChildren
布爾值
繼承自?Container:?mouseChildren:72
指示此容器的子項(xiàng)是否獨(dú)立啟用鼠標(biāo)/指針交互。如果為 false,則子元素將聚合在容器下 - 例如,單擊子形狀將觸發(fā)容器上的單擊事件。
默認(rèn)值:真
mouseEnabled
布爾值
繼承自?DisplayObject:?mouseEnabled:183
指示在運(yùn)行鼠標(biāo)交互時(shí)是否包含此對(duì)象。將此項(xiàng)設(shè)置false
為Container的子項(xiàng)將導(dǎo)致 Container 上的事件在單擊該子項(xiàng)時(shí)不會(huì)觸發(fā)。將此屬性設(shè)置為false
不會(huì)阻止getObjectsUnderPoint?方法返回子項(xiàng)。
注意:在 EaselJS 0.7.0 中,mouseEnabled 屬性將無法與嵌套容器一起正常工作。請(qǐng)查看GitHub中最新的 NEXT 版本以獲取已解決此問題的更新版本。該修復(fù)將在 EaselJS 的下一個(gè)版本中提供。
默認(rèn)值:真
name
細(xì)繩
繼承自?DisplayObject:?name:208
此顯示對(duì)象的可選名稱。包含在toString中。對(duì)調(diào)試很有用。
默認(rèn)值:空
numChildren
數(shù)字?只讀
繼承自?Container:?numChildren:114
返回容器中的子節(jié)點(diǎn)數(shù)。
parent
容器?最終?只讀
繼承自?DisplayObject:?parent:217
對(duì)包含此顯示對(duì)象的Container或Stage對(duì)象的引用,如果尚未添加到其中,則為 null。
默認(rèn)值:空
paused
布爾值
定義于?paused:154
如果為 true,則選中時(shí),MovieClip 的位置不會(huì)前進(jìn)。
默認(rèn)值:假
regX
數(shù)字
繼承自?DisplayObject:?regX:229
此顯示對(duì)象注冊(cè)點(diǎn)的左偏移量。例如,要使 100x100px 位圖圍繞其中心旋轉(zhuǎn),您可以將 regX 和regY設(shè)置為 50。緩存對(duì)象的注冊(cè)點(diǎn)應(yīng)根據(jù)預(yù)緩存條件設(shè)置,而不是緩存大小。
默認(rèn)值:0
regY
數(shù)字
繼承自?DisplayObject:?regY:239
此顯示對(duì)象的注冊(cè)點(diǎn)的 y 偏移量。例如,要使 100x100px 位圖圍繞其中心旋轉(zhuǎn),您可以將regX和 regY 設(shè)置為 50。緩存對(duì)象的注冊(cè)點(diǎn)應(yīng)根據(jù)預(yù)緩存條件設(shè)置,而不是緩存大小。
默認(rèn)值:0
rotation
數(shù)字
繼承自?DisplayObject:?rotation:249
此顯示對(duì)象的旋轉(zhuǎn)度數(shù)。
默認(rèn)值:0
scale
數(shù)字
繼承自?DisplayObject:?scale:716
將scaleX和scaleY?屬性設(shè)置為相同的值。請(qǐng)注意,當(dāng)您獲取值時(shí),如果scaleX
和scaleY
是不同的值,它將僅返回scaleX
.
默認(rèn)值:1
scaleX
數(shù)字
繼承自?DisplayObject:?scaleX:257
水平拉伸此顯示對(duì)象的因子。例如,將 scaleX 設(shè)置為 2 會(huì)將顯示對(duì)象拉伸為其標(biāo)稱寬度的兩倍。要水平翻轉(zhuǎn)對(duì)象,請(qǐng)將比例設(shè)置為負(fù)數(shù)。
默認(rèn)值:1
scaleY
數(shù)字
繼承自?DisplayObject:?scaleY:266
垂直拉伸此顯示對(duì)象的因子。例如,將 scaleY 設(shè)置為 0.5 會(huì)將顯示對(duì)象拉伸到其標(biāo)稱高度的一半。要垂直翻轉(zhuǎn)對(duì)象,請(qǐng)將比例設(shè)置為負(fù)數(shù)。
默認(rèn)值:1
shadow
陰影
繼承自?DisplayObject:?shadow:291
定義要在此顯示對(duì)象上呈現(xiàn)的陰影的陰影對(duì)象。設(shè)置為null
刪除陰影。如果為 null,則從父容器繼承此屬性。
默認(rèn)值:空
SINGLE_FRAME
字符串?靜態(tài)?只讀
定義于?SINGLE_FRAME:294
MovieClip 將僅顯示單個(gè)幀(由 startPosition 屬性確定)。
默認(rèn)值:“單”
skewX
數(shù)字
繼承自?DisplayObject:?skewX:275
水平傾斜此顯示對(duì)象的因素。
默認(rèn)值:0
skewY
數(shù)字
繼承自?DisplayObject:?skewY:283
垂直傾斜此顯示對(duì)象的因素。
默認(rèn)值:0
snapToPixel
布爾值
繼承自?DisplayObject:?snapToPixel:345
指示當(dāng)snapToPixelEnabled為 true時(shí)是否應(yīng)將顯示對(duì)象繪制到整個(gè)像素 。要在整個(gè)顯示對(duì)象類別上啟用/禁用捕捉,請(qǐng)?jiān)谠蜕显O(shè)置此值(例如 Text.prototype.snapToPixel = true)。
默認(rèn)值:真
stage
階段?只讀
繼承自?DisplayObject:?stage:699
返回此顯示對(duì)象將在其上呈現(xiàn)的 Stage 實(shí)例,如果尚未添加,則返回 null。
startPosition
數(shù)字
定義于?startPosition:128
指定要在此影片剪輯中播放的第一幀,或者如果模式為 SINGLE_FRAME 時(shí)要顯示的唯一幀。
默認(rèn)值:0
SYNCHED
字符串?靜態(tài)?只讀
定義于?SYNCHED:304
MovieClip 僅在其父級(jí)前進(jìn)時(shí)才會(huì)前進(jìn),并將同步到父級(jí) MovieClip 的位置。
默認(rèn)值:“同步”
tickChildren
布爾值
繼承自?Container:?tickChildren:82
如果為 false,則刻度不會(huì)傳播到此 Container 的子級(jí)。這可以提供一些性能優(yōu)勢(shì)。除了阻止“tick”事件被調(diào)度外,它還將阻止某些顯示對(duì)象上的與滴答相關(guān)的更新(例如 Sprite 和 MovieClip 幀推進(jìn)、DOMElement 可見性處理)。
默認(rèn)值:真
tickEnabled
布爾值
繼承自?DisplayObject:?tickEnabled:198
如果為 false,則刻度不會(huì)在此顯示對(duì)象(或其子對(duì)象)上運(yùn)行。這可以提供一些性能優(yōu)勢(shì)。除了阻止“tick”事件被調(diào)度外,它還將阻止某些顯示對(duì)象(例如 Sprite 和 MovieClip 幀推進(jìn)和 DOMElement 顯示屬性)上的與滴答相關(guān)的更新。
默認(rèn)值:真
timeline
時(shí)間線
定義于?timeline:211
與此 MovieClip 關(guān)聯(lián)的 TweenJS 時(shí)間軸。這是在初始化 MovieClip 實(shí)例時(shí)自動(dòng)創(chuàng)建的。通過將TweenJS?Tween 實(shí)例添加到時(shí)間軸來創(chuàng)建動(dò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”屬性,可以從時(shí)間軸中添加和刪除元素。請(qǐng)注意,Tween.set
不建議使用創(chuàng)建 MovieClip 動(dòng)畫。下面的示例將在第 0 幀關(guān)閉目標(biāo),然后在第 1 幀重新打開。您可以使用“可見”屬性來實(shí)現(xiàn)相同的效果。
var tween = createjs.Tween.get(target).to({_off:false}) ? ? .wait(1).to({_off:true}) ? ? .wait(1).to({_off:false});
默認(rèn)值:空
totalFrames
數(shù)字?只讀
定義于?totalFrames:398
返回此 MovieClip 的持續(xù)時(shí)間(以秒或節(jié)拍為單位)。
transformMatrix
Matrix2D
繼承自?DisplayObject:?transformMatrix:324
如果設(shè)置,則定義此顯示對(duì)象的變換,覆蓋所有其他變換屬性(x、y、旋轉(zhuǎn)、縮放、傾斜)。
默認(rèn)值:空
visible
布爾值
繼承自?DisplayObject:?visible:300
指示在運(yùn)行 Stage getObjectsUnderPoint方法時(shí)是否應(yīng)將此顯示對(duì)象呈現(xiàn)到畫布并包含在內(nèi) 。
默認(rèn)值:真
x
數(shù)字
繼承自?DisplayObject:?x:309
顯示對(duì)象相對(duì)于其父對(duì)象的 x(水平)位置。
默認(rèn)值:0
y
數(shù)字
繼承自?DisplayObject:?y:317
默認(rèn)值:0
事件added
繼承自?DisplayObject:?added:651
當(dāng)顯示對(duì)象添加到父容器時(shí)調(diào)度。
click
繼承自?DisplayObject:?click:549
自 0.6.0 起可用
當(dāng)用戶按下鼠標(biāo)左鍵然后在顯示對(duì)象上方釋放它時(shí)調(diào)度。有關(guān)事件屬性的列表,請(qǐng)參見MouseEvent類。
dblclick
繼承自?DisplayObject:?dblclick:556
自 0.6.0 起可用
當(dāng)用戶在此顯示對(duì)象上雙擊鼠標(biāo)左鍵時(shí)調(diào)度。有關(guān)事件屬性的列表,請(qǐng)參見MouseEvent類。
mousedown
繼承自?DisplayObject:?mousedown:542
自 0.6.0 起可用
當(dāng)用戶在顯示對(duì)象上按下鼠標(biāo)左鍵時(shí)調(diào)度。有關(guān)事件屬性的列表,請(qǐng)參見?MouseEvent類。
mouseout
繼承自?DisplayObject:?mouseout:571
自 0.6.0 起可用
當(dāng)用戶的鼠標(biāo)離開此顯示對(duì)象時(shí)調(diào)度。必須使用?enableMouseOver啟用此事件。另請(qǐng)參閱推出。有關(guān)事件屬性的列表,請(qǐng)參見MouseEvent類。
mouseover
繼承自?DisplayObject:?mouseover:563
自 0.6.0 起可用
當(dāng)用戶的鼠標(biāo)進(jìn)入此顯示對(duì)象時(shí)調(diào)度。必須使用?enableMouseOver啟用此事件。另請(qǐng)參閱翻轉(zhuǎn)。有關(guān)事件屬性的列表,請(qǐng)參見MouseEvent類。
pressmove
繼承自?DisplayObject:?pressmove:621
自 0.7.0 起可用
在顯示對(duì)象上發(fā)生mousedown后,只要鼠標(biāo)移動(dòng),就會(huì)在該對(duì)象上生成一個(gè) pressmove 事件,直到釋放鼠標(biāo)按下為止。這對(duì)于拖動(dòng)和類似操作很有用。
請(qǐng)注意,如果事件的初始鼠標(biāo)目標(biāo)mousedown
在被按下后(例如在pressmove
事件期間)從舞臺(tái)上移除,pressmove
仍然會(huì)生成事件。但是,由于它不再在顯示列表中,因此該事件不能冒泡。這意味著以前的祖先(父容器)將不會(huì)收到該事件,因此無法重新調(diào)度它。如果您打算偵聽動(dòng)態(tài)對(duì)象(例如MovieClippressup
或Container?) ,請(qǐng)確保將mouseChildren設(shè)置為.pressmove
false
pressup
繼承自?DisplayObject:?pressup:636
自 0.7.0 起可用
在顯示對(duì)象上發(fā)生mousedown后,釋放鼠標(biāo)按下時(shí)將在該對(duì)象上生成 pressup 事件。這對(duì)于拖動(dòng)和類似操作很有用。
請(qǐng)注意,如果事件的初始鼠標(biāo)目標(biāo)mousedown
在被按下后(例如在pressmove
事件期間)從舞臺(tái)上移除,pressup
仍然會(huì)生成事件。但是,由于它不再在顯示列表中,因此該事件不能冒泡。這意味著以前的祖先(父容器)將不會(huì)收到該事件,因此無法重新調(diào)度它。如果您打算偵聽動(dòng)態(tài)對(duì)象(例如MovieClippressmove
或Container?) ,請(qǐng)確保將mouseChildren設(shè)置為.pressup
false
removed
繼承自?DisplayObject:?removed:656
當(dāng)顯示對(duì)象從其父容器中移除時(shí)調(diào)度。
rollout
繼承自?DisplayObject:?rollout:600
自 0.7.0 起可用
此事件類似于mouseout,但有以下區(qū)別:它不會(huì)冒泡,并將Container實(shí)例視為其內(nèi)容的聚合。
例如,myContainer 包含兩個(gè)重疊的孩子:shapeA 和 shapeB。用戶將鼠標(biāo)移到 shapeA 上,然后直接移到 shapeB 上,然后兩者都關(guān)閉。使用 myContainer 上的 Mouseout:event 偵聽器,將收到兩個(gè)事件,每個(gè)事件都針對(duì)一個(gè)子元素:
當(dāng)鼠標(biāo)離開 shapeA (target=shapeA)
當(dāng)鼠標(biāo)離開 shapeB (target=shapeB)
但是,如果使用“rollout”偵聽器,當(dāng)鼠標(biāo)離開聚合 myContainer 內(nèi)容 (target=myContainer) 時(shí),只會(huì)收到一個(gè)事件。
必須使用enableMouseOver啟用此事件。有關(guān)事件屬性的列表,請(qǐng)參見MouseEvent類。
rollover
繼承自?DisplayObject:?rollover:579
自 0.7.0 起可用
此事件類似于mouseover,但有以下區(qū)別:它不會(huì)冒泡,并將Container實(shí)例視為其內(nèi)容的聚合。
例如,myContainer 包含兩個(gè)重疊的孩子:shapeA 和 shapeB。用戶將鼠標(biāo)移到 shapeA 上,然后直接移到 shapeB。使用 myContainer 上的 Mouseover:event 偵聽器,將接收兩個(gè)事件,每個(gè)事件都針對(duì)一個(gè)子元素:
當(dāng)鼠標(biāo)進(jìn)入shapeA時(shí)(target=shapeA)
當(dāng)鼠標(biāo)進(jìn)入shapeB時(shí)(target=shapeB)
但是,如果使用“翻轉(zhuǎn)”偵聽器,當(dāng)鼠標(biāo)首次進(jìn)入聚合 myContainer 內(nèi)容 (target=myContainer) 時(shí),只會(huì)收到一個(gè)事件。
必須使用enableMouseOver啟用此事件。有關(guān)事件屬性的列表,請(qǐng)參見MouseEvent類。
tick
繼承自?DisplayObject:?tick:661
自 0.6.0 起可用
每當(dāng)舞臺(tái)更新時(shí),在舞臺(tái)上的每個(gè)顯示對(duì)象上調(diào)度。這發(fā)生在渲染(繪制)通道之前。調(diào)用update時(shí),首先舞臺(tái)上的所有顯示對(duì)象都調(diào)度 tick 事件,然后所有顯示對(duì)象都被繪制到舞臺(tái)上。子級(jí)將在事件在其父級(jí)上分派之前按其深度順序分派其 Tick:event 事件。
事件負(fù)載:target
目的
調(diào)度事件的對(duì)象。
type
細(xì)繩
事件類型。
params
大批
包含傳遞給 Stage.update() 方法的任何參數(shù)的數(shù)組。例如,如果您調(diào)用 stage.update("hello"),那么參數(shù)將是 ["hello"]。