說明

MovieClip 是形狀和其他 MovieClip 實體的容器。每個 MovieClip 都會播放其時間軸中的動畫。您可以使用 SceneGraphFactory 來建立 MovieClip 實體。

延伸

  • flwebgl.event.EventDispatcher

方法

addChild(child)

說明

    這個方法會加入傳遞的子物件,做為這個 MovieClip 的最上層子系。此子系可以是形狀或 MovieClip。

參數

傳回值

  • 作業是否成功
  • 類型 - boolean
名稱類型說明
child形狀或 MovieClip要以子系加入的物件。

addChildAt(child, index)

說明

    這個方法會在這個影片段的指定索引位置加入傳遞的子物件。子系可以是形狀或影片片段。

參數

傳回值

  • 作業是否成功
  • 類型 - boolean
名稱類型說明
child形狀或 MovieClip要加入索引的子系。
index數字要將子系加入其中的索引。

getBounds(targetCoordinateSpace, bFastBounds)

說明

    這個方法會傳回矩形邊界。

參數

傳回值

  • 顯示物件的邊緣
  • 類型 - flwebgl.geom.Rect
名稱類型說明
targetCoordinateSpace
形狀或 MovieClip
(選擇性,預設值 = undefined) 定義要使用的座標系統的顯示物件。如果未指定,則會傳回局部邊緣。
bFastBounds
boolean
(選擇性,預設值 = true) 指定要傳回原始或預設邊緣 (快速計算) 或轉換的局部邊緣 (較為精確但比較慢)

getChildAt(index)

說明

這個方法會傳回這個影片段的指定索引位置的子系。如果指定的索引位置沒有子系,則會傳回「undefined」

參數

傳回值

  • 類型 - 形狀或 MovieClip

範例

在這個範例中,節點會從一個 MovieClip 移到另一個 MovieClip。

名稱類型說明
index數字要求子系的索引位置。
        var stage = player.getStage();
        var mc1 = stage.getChildAt(0);
        var mc2 = stage.getChildAt(1);
        
        var child = mc1.getChildAt(0);
        mc2.addChildAt(child, 0);

getChildByName(name)

說明

    這個方法會傳回具有指定名稱的子顯示物件。如果一個以上的子顯示物件具有相同的指定名稱,則方法會傳回子清單中的第一個物件。

參數

傳回值

  • 具有指定名稱的子系
  • 類型 - number
名稱類型說明
name字串要搜尋的子系名稱

getChildIndex(child)

說明

    此方法會傳回子清單中的子系索引。如果找不到子系,則會傳回「1」。

參數

傳回值

  • 類型 - number
名稱類型說明
child形狀或 MovieClip要搜尋的子系。

getChildren()

說明

    這個方法會傳回影片片段的子系。

傳回值

  • 類型 - 包含形狀或 MovieClip 的陣列

getCurrentFrame()

說明

    這個方法會傳回目前影格編號。影格編號從 1 開始計算。

傳回值

  • 類型 - number

getCurrentFrameLabel()

說明

    這個方法會傳回 MovieClip 實體時間軸中目前影格的標籤。如果目前影格沒有標籤,則 currentLabel 會傳回「undefined」。

傳回值

  • 類型 - 字串

範例

這個範例會在遇到標籤為「stop_anim」的影格時,停止將 MovieClip 製成動畫。

function exitHandler(e) {
	var m = e.getTarget();
	var curLabel = m.getCurrentFrameLabel();
	
	if (curLabel == "stop_anim")
		m.stop();
}

var stage = player.getStage();
stage.addEventListener(flwebgl.events.Event.EXIT_FRAME, exitHandler);

getCurrentLabel()

說明

    這個方法會傳回 MovieClip 實體時間軸中,播放磁頭所在的目前標籤。如果目前影格沒有標籤,getCurrentLabel() 會傳回上一個包含標籤的影格的名稱。如果目前影格及先前的影格都沒有標籤,則 getCurrentLabel() 會傳回值「undefined」。

傳回值

  • 類型 - 字串

getFrameLabels()

說明

    這個方法會傳回影片片段或場景中所有標籤的清單。您可以依照每個標籤的「name」和「frameNum」屬性來存取標籤。

傳回值

  • {frameNum: number, name: string} 的陣列

getGlobalColorTransform()

說明

    這個方法會傳回顯示物件的全域顏色變形。

傳回值

  • 類型 - flwebgl.geom.ColorTransform

getGlobalTransform()

說明

    這個方法會傳回顯示物件的全域變形。

傳回值

  •     類型 - flwebgl.geom.Matrix

getLocalColorTransform()

說明

    這個方法會傳回顯示物件的局部顏色變形。

傳回值

  • 類型 - flwebgl.geom.ColorTransform

getLocalTransform()

說明

    這個方法會傳回顯示物件的局部變形。

傳回值

  • 類型 - flwebgl.geom.Matrix

getName()

說明

    這個方法會傳回這個顯示物件的名稱。

傳回值

  • 類型 - 字串

getNumChildren()

說明

    這個方法會傳回子系的數目。

傳回值

  • 類型 - number

getTotalFrames()

說明

    這個方法會傳回對應時間軸中的影格總數。

傳回值

  • 類型 - number

gotoAndPlay(frame)

說明

    這個方法會在指定的影格位置開始播放影片片段。

參數

範例

這個範例會在 MovieClip 加入處理常式,使其在遇到影格 5 後直接跳至影格 15。

名稱類型說明
影格數字或字串要求的影格編號或影格標籤
function exitHandler(e) {
    var m = e.getTarget();
    var curFrame = m.getCurrentFrame();

    if (curFrame == 5)
        m.gotoAndPlay(15);
}

var stage = player.getStage();
stage.addEventListener(flwebgl.events.Event.EXIT_FRAME, exitHandler);

gotoAndStop(frame)

說明

    這個方法會將播放磁頭帶到影片片段的指定影格,並停在那裡。

參數

名稱類型說明
影格數字或字串要求的影格編號或影格標籤

isVisible()

說明

    這個方法會傳回顯示物件的可見性標幟。

傳回值

  • 類型 - boolean

play()

說明

    這個方法會在影片片段的時間軸中移動播放磁頭。

removeChild(child)

說明

    這個方法會從影片片段中移除指定的子物件。子系可以是形狀或影片片段。

參數

傳回值

  • 作業是否成功
  • 類型 - boolean
名稱類型說明
child形狀或 MovieClip要移除的子系

removeChildAt(index)

說明

    這個方法會移除影片片段中位於指定索引位置的子系。子系可以是形狀或影片片段。

參數

傳回值

  • 作業是否成功
  • 類型 - boolean
名稱類型說明
index數字要移除的子系索引。

setChildIndex(child, newIndex)

說明

這個方法可以用來重新排列 MovieClip 的子系順序。當您使用 setChildIndex() 方法並指定已遭佔用的索引位置時,變更的位置只會介於顯示物件之前的位置和新位置之間,其他所有位置將維持不變。

參數

範例

這個範例採用舞台的最下層子系,並將它放置在所有其他子系上方。

名稱類型說明
child形狀或 movieclip要移動的子系
newIndexNumber子系顯示物件的新索引
var stage = player.getStage();
var n = stage.getNumChildren();
var child = stage.getChildAt(n - 1);
stage.setChildIndex(child, 0);

setLocalColorTransform(colorTransform)

說明

    這個方法會設定顯示物件的局部顏色變形。

參數

名稱類型說明
colorTransformflwebgl.geom.ColorTransform您要設定的顏色變形

setLocalTransform(transform)

說明

    這個方法會設定顯示物件的局部變形。

參數

名稱類型說明
transformflwebgl.geom.Matrix您要設定的變形

範例

這個範例會將舞台上的 MovieClip 實體水平及垂直變形 20 像素,藉此修改其局部變形。

var stage = player.getStage();
var mc = stage.getChildAt(0);
var mat = mc.getLocalTransform();
mat.translate(20, 20);
mc.setLocalTransform(mat);

setName(name)

說明

    這個方法會設定這個顯示物件的名稱。

參數

名稱類型說明
name字串顯示物件的名稱

setVisible(flag)

說明

    這個方法會為這個顯示物件設定可見性標幟。

參數

名稱類型說明
flagboolean可見性標幟

範例

這個範例會切換舞台最上層子系的可見性標幟。

var stage = player.getStage();
var mc = stage.getChildAt(0);
var visibiliity = mc.isVisible();
mc.setVisible(!visibiliity);

stop()

說明

    這個方法會停止影片片段中的播放磁頭。

此産品由 Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License 授權  Creative Commons 條款未涵蓋 Twitter™ 與 Facebook 文章。

法律說明   |   線上隱私權政策