| 套件 | flash.display |
| 類別 | public dynamic class MovieClip |
| 繼承 | MovieClip  Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
| 子類別 | FlexMovieClip, GravityBootstrap, LivePreviewParent, SystemManager, UIMovieClip, WindowedSystemManager |
| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | AIR 1.0, Flash Player 9, Flash Lite 4 |
與 Sprite 物件不同的是，MovieClip 物件擁有時間軸。
在 Flash Professional，MovieClip 類別的方法可提供與設定影片片段目標的動作相同的功能。另外，有些方法在 Flash 編寫工具之「動作」面板的「動作工具箱」中並沒有對等的動作。
放在 Flash Professional 的「舞台」上的子實體，無法從父實體的建構函式內以程式碼存取，因為在程式碼執行時該實體尚未建立。存取子系之前，父輩必須改為利用程式碼建立子實體，或是延遲回呼函數的存取，該函數會偵聽子系，以傳送其 Event.ADDED_TO_STAGE 事件。
如果您修改移動包含補間動畫之 MovieClip 物件的下列屬性，播放磁頭便會在該 MovieClip 物件中停止：alpha、blendMode、filters、height、opaqueBackground、rotation、scaleX、scaleY、scale9Grid、scrollRect、transform、visible、width、x 或 y。然而，Flash Player 並不會停止該 MovieClip 物件中任何一個 MovieClip 子物件的播放磁頭。
注意：只有在 FEATURE_BITMAPCACHE 已定義的情況下，Flash Lite 4 才支援 MovieClip.opaqueBackground 屬性。Flash Lite 4 的預設組態不會定義 FEATURE_BITMAPCACHE。若要替適當的裝置啟用 MovieClip.opaqueBackground 屬性，請在專案中定義 FEATURE_BITMAPCACHE。
公用屬性
隱藏繼承公用屬性
顯示繼承公用屬性| 屬性 | 定義自 | ||
|---|---|---|---|
 | accessibilityImplementation : AccessibilityImplementation
對此 InteractiveObject 實體目前的輔助功能實作 (AccessibilityImplementation)。 | InteractiveObject | |
| accessibilityProperties : AccessibilityProperties
此顯示物件的目前輔助功能選項。 | DisplayObject | |
| alpha : Number
指出所指定物件的 Alpha 透明度值。 | DisplayObject | |
| blendMode : String
來自 BlendMode 類別的值，會指定要使用何種混合模式。 | DisplayObject | |
| blendShader : Shader [唯寫]
設定用來混合前景和背景的著色器。 | DisplayObject | |
| buttonMode : Boolean
可指定此 sprite 的按鈕模式。 | Sprite | |
| cacheAsBitmap : Boolean
如果設定為 true，Flash 執行階段會快取顯示物件的內部點陣圖表示法。 | DisplayObject | |
| cacheAsBitmapMatrix : Matrix
如果為非 null，當 cacheAsBitmap 設定為 true 時，這個 Matrix 物件會定義顯示物件的顯示方法。 | DisplayObject | |
| constructor : Object
類別物件的參照或是特定物件實體的建構函數。 | Object | |
| contextMenu : NativeMenu
指定與此物件有關聯的快顯選單。 | InteractiveObject | |
| currentFrame : int [唯讀]
指定在影片片段實體時間軸上，播放磁頭所在的影格編號。 | MovieClip | ||
| currentFrameLabel : String [唯讀]
MovieClip 實體之時間軸的目前影格中的標籤。 | MovieClip | ||
| currentLabel : String [唯讀]
在 MovieClip 實體時間軸中，播放磁頭所在的目前標籤。 | MovieClip | ||
| currentLabels : Array [唯讀]
從目前場景傳回 FrameLabel 物件陣列。 | MovieClip | ||
| currentScene : Scene [唯讀]
在 MovieClip 實體時間軸中，播放磁頭所在的目前場景。 | MovieClip | ||
| doubleClickEnabled : Boolean
會指定物件是否會收到 doubleClick 事件。 | InteractiveObject | |
| dropTarget : DisplayObject [唯讀]
指定要將 sprite 拖曳至或丟棄至哪個顯示物件上。 | Sprite | |
| enabled : Boolean
這是一個 Boolean 值，用來指示影片片段是否已啟用。 | MovieClip | ||
| filters : Array
索引的陣列，其中包含目前和顯示物件相關的每個濾鏡物件。 | DisplayObject | |
| focusRect : Object
會指定這個物件是否會顯示焦點矩形。 | InteractiveObject | |
| framesLoaded : int [唯讀]
從串流 SWF 檔中載入的影格數目。 | MovieClip | ||
| graphics : Graphics [唯讀]
指定屬於此 sprite 物件的 Graphics 物件，其中可能會產生向量繪圖命令。 | Sprite | |
| height : Number
會指出顯示物件的高度，以像素為單位。 | DisplayObject | |
| hitArea : Sprite
指定用來當作 sprite 作用區域的另一個 sprite。 | Sprite | |
| isPlaying : Boolean [唯讀]
Boolean 值，指示目前是否正在播放影片片段。 | MovieClip | ||
| loaderInfo : LoaderInfo [唯讀]
會傳回 LoaderInfo 物件，其中包含關於載入此顯示物件所屬之檔案的資訊。 | DisplayObject | |
| mask : DisplayObject
呼叫之顯示物件會以指定的 mask 物件遮蓋。 | DisplayObject | |
| metaData : Object
如果中繼資料是透過 PlaceObject4 標籤與 SWF 檔案中的這個 DisplayObject 實體一同儲存，則會取得 DisplayObject 實體的中繼資料物件。 | DisplayObject | |
| mouseChildren : Boolean
判斷物件的子系是否支援啟用滑鼠或使用者輸入裝置。 | DisplayObjectContainer | |
| mouseEnabled : Boolean
指定此物件是否接收滑鼠或其他使用者輸入及訊息。 | InteractiveObject | |
| mouseX : Number [唯讀]
指出滑鼠或使用者輸入裝置位置的 x 座標，以像素為單位。 | DisplayObject | |
| mouseY : Number [唯讀]
指出滑鼠或使用者輸入裝置位置的 y 座標，以像素為單位。 | DisplayObject | |
| name : String
指出 DisplayObject 的實體名稱。 | DisplayObject | |
| needsSoftKeyboard : Boolean
指定虛擬鍵盤 (螢幕上的軟體鍵盤) 是否應在此 InteractiveObject 實體接收到焦點時顯示。 | InteractiveObject | |
| numChildren : int [唯讀]
傳回此物件的子系數量。 | DisplayObjectContainer | |
| opaqueBackground : Object
會指定顯示物件是否不透明，並具有特定背景顏色。 | DisplayObject | |
| parent : DisplayObjectContainer [唯讀]
指出包含此顯示物件的 DisplayObjectContainer 物件。 | DisplayObject | |
| root : DisplayObject [唯讀]
對載入之 SWF 檔案的顯示物件而言，root 屬性就是該 SWF 檔案所呈現之顯示清單樹狀結構部分的最上層顯示物件。 | DisplayObject | |
| rotation : Number
指出 DisplayObject 實體的旋轉度數 (從該物件原本方向算起)。 | DisplayObject | |
| rotationX : Number
表示 DisplayObject 實體相對於 3D 父輩容器從原始方向旋轉的 x 軸旋轉 (以度數為單位)。 | DisplayObject | |
| rotationY : Number
表示 DisplayObject 實體相對於 3D 父輩容器從原始方向旋轉的 y 軸旋轉 (以度數為單位)。 | DisplayObject | |
| rotationZ : Number
表示 DisplayObject 實體相對於 3D 父輩容器從原始方向旋轉的 z 軸旋轉 (以度數為單位)。 | DisplayObject | |
| scale9Grid : Rectangle
目前產生效用的縮放格線。 | DisplayObject | |
| scaleX : Number
指出從註冊點套用的物件水平縮放 (百分比)。 | DisplayObject | |
| scaleY : Number
指出從物件註冊點套用的物件垂直縮放 (百分比)。 | DisplayObject | |
| scaleZ : Number
指出從物件註冊點套用的物件深度縮放 (百分比)。 | DisplayObject | |
| scenes : Array [唯讀]
Scene 物件的陣列，每個 Scene 物件都會列出 MovieClip 實體場景的名稱、影格數目，以及影格標籤。 | MovieClip | ||
| scrollRect : Rectangle
顯示物件的捲動矩形範圍。 | DisplayObject | |
| softKeyboard : String
控制軟體鍵盤的外觀。 | InteractiveObject | |
| softKeyboardInputAreaOfInterest : Rectangle
定義顯示軟體鍵盤時，應保留於螢幕上的區域 (iOS 未提供)。 | InteractiveObject | |
| soundTransform : flash.media:SoundTransform
控制此 Sprite 的聲音。 | Sprite | |
| stage : Stage [唯讀]
顯示物件的「舞台」。 | DisplayObject | |
| tabChildren : Boolean
判斷物件的子系是否支援啟用定位鍵。 | DisplayObjectContainer | |
| tabEnabled : Boolean
會指定這個物件是否在停駐點順序中。 | InteractiveObject | |
| tabIndex : int
會指定 SWF 檔中的物件停駐點順序。 | InteractiveObject | |
| textSnapshot : flash.text:TextSnapshot [唯讀]
傳回此 DisplayObjectContainer 實體的 TextSnapshot 物件。 | DisplayObjectContainer | |
| totalFrames : int [唯讀]
MovieClip 實體中的影格總數。 | MovieClip | ||
| trackAsMenu : Boolean
指出屬於 SimpleButton 或 MovieClip 物件的其他顯示工具是否可以接收滑鼠放開事件或其他使用者輸入放開事件。 | MovieClip | ||
| transform : flash.geom:Transform
這是一個物件，具有和顯示物件的矩陣、顏色轉換和像素邊界有關的屬性。 | DisplayObject | |
| useHandCursor : Boolean
指示當指標滑入 Sprite，且其 buttonMode 屬性設為 true 時，是否要出現指示手掌 (手掌游標) 的 Boolean 值。 | Sprite | |
| visible : Boolean
不管是否看得見顯示物件。 | DisplayObject | |
| width : Number
會指出顯示物件的寬度，以像素為單位。 | DisplayObject | |
| x : Number
指出 DisplayObject 實體相對於父輩 DisplayObjectContainer 之區域座標的 x 座標。 | DisplayObject | |
| y : Number
指出 DisplayObject 實體相對於父輩 DisplayObjectContainer 之區域座標的 y 座標。 | DisplayObject | |
| z : Number
表示 DisplayObject 實體相對於 3D 父輩容器的 z 座標位置 (沿著 z 軸)。 | DisplayObject | |
公用方法
| 方法 | 定義自 | ||
|---|---|---|---|
建立新的 MovieClip 實體。 | MovieClip | ||
|
將 DisplayObject 子實體加入至此 DisplayObjectContainer 實體。 | DisplayObjectContainer | |
|
將 DisplayObject 子實體加入至此 DisplayObjectContainer 實體。 | DisplayObjectContainer | |
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
會在 EventDispatcher 物件註冊事件偵聽程式，以便讓偵聽程式收到事件的通知。 | EventDispatcher | |
|
指出安全性限制是否會造成傳回的清單 (可用指定的 point 點呼叫 DisplayObjectContainer.getObjectsUnderPoint() 方法來取得) 省略任何顯示物件。 | DisplayObjectContainer | |
|
判斷指定的顯示物件是否為 DisplayObjectContainer 實體的子系，或為實體本身。 | DisplayObjectContainer | |
|
會將事件傳送到事件流程。 | EventDispatcher | |
|
傳回可定義顯示物件區域 (相對於 targetCoordinateSpace 物件的座標系統) 的矩形。 | DisplayObject | |
|
傳回存在於指定索引位置的子顯示物件實體。 | DisplayObjectContainer | |
|
傳回具有指定名稱的子顯示物件。 | DisplayObjectContainer | |
|
傳回 child DisplayObject 實體的索引位置。 | DisplayObjectContainer | |
|
傳回位於指定點底下，且屬於此 DisplayObjectContainer 實體之子系 (或孫系，以下類推) 的物件陣列。 | DisplayObjectContainer | |
|
根據 targetCoordinateSpace 參數所定義的座標系統，並排除形狀上的任何筆畫，傳回可定義顯示物件邊界的矩形。 | DisplayObject | |
|
將 point 物件從「舞台」(全域) 座標轉換成顯示物件的 (區域) 座標。 | DisplayObject | |
|
將二維點從「舞台」(全域) 座標轉換為三維顯示物件的 (區域) 座標。 | DisplayObject | |
在指定影格開始播放 SWF 檔。 | MovieClip | ||
將播放磁頭移到此影片片段中的指定影格，然後停在該處。 | MovieClip | ||
|
會檢查 EventDispatcher 物件是否有對特定的事件類型註冊偵聽程式。 | EventDispatcher | |
|
指出物件是否有已定義的指定屬性。 | Object | |
|
評估顯示物件的範圍框，看它是否與 obj 顯示物件的範圍框重疊或相交。 | DisplayObject | |
|
評估顯示物件，看它是否與 x 和 y 參數所指定的點重疊或相交。 | DisplayObject | |
|
指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。 | Object | |
|
將三維顯示物件的 (區域) 座標的三維點轉換為「舞台」(全域) 座標中的二維點。 | DisplayObject | |
|
將 point 物件從顯示物件的 (區域) 座標轉換成「舞台」(全域) 座標。 | DisplayObject | |
將播放磁頭移到下一個影格，並停止播放。 | MovieClip | ||
將播放磁頭移動到 MovieClip 實體的下一個場景。 | MovieClip | ||
移動影片片段時間軸上的播放磁頭。 | MovieClip | ||
將播放磁頭移到上一個影格，並停止播放。 | MovieClip | ||
將播放磁頭移動到 MovieClip 實體的上一個場景。 | MovieClip | ||
|
指出指定的屬性是否存在，以及是否可列舉。 | Object | |
|
將指定的 child DisplayObject 實體從 DisplayObjectContainer 實體的子清單中移除。 | DisplayObjectContainer | |
|
從 DisplayObjectContainer 子清單中的指定索引位置移除子 DisplayObject。 | DisplayObjectContainer | |
|
將所有 child DisplayObject 實體從 DisplayObjectContainer 實體的子清單中移除。 | DisplayObjectContainer | |
|
會從 EventDispatcher 物件移除偵聽程式。 | EventDispatcher | |
|
升起顯示虛擬鍵盤。 | InteractiveObject | |
|
變更顯示物件容器中現有子系的位置。 | DisplayObjectContainer | |
|
為迴圈作業設定動態屬性的可用性。 | Object | |
|
讓使用者拖曳指定的 sprite。 | Sprite | |
|
讓使用者將指定的 Sprite 拖曳至觸控裝置上。 | Sprite | |
停止影片片段中的播放磁頭。 | MovieClip | ||
|
遞迴停止執行所有 MovieClips 的時間軸根源於此物件。 | DisplayObjectContainer | |
|
結束 startDrag() 方法。 | Sprite | |
|
結束觸控裝置使用的 startTouchDrag() 方法。 | Sprite | |
|
替換兩個指定子物件的 z 順序 (深度階層，由前至後順序)。 | DisplayObjectContainer | |
|
在子清單的兩個指定索引位置，替換子物件的 z 順序 (深度階層，由前至後順序)。 | DisplayObjectContainer | |
|
傳回代表此物件的字串，根據地區特定慣例進行格式化。 | Object | |
|
會傳回指定之物件的字串形式。 | Object | |
|
會傳回指定之物件的基本值。 | Object | |
|
檢查此 EventDispatcher 物件是否已註冊事件偵聽程式，或者此物件的任何祖系已為特定事件類型註冊事件偵聽程式。 | EventDispatcher | |
屬性詳細資訊
currentFrame | 屬性 |
currentFrame:int [唯讀] | 語言版本: | ActionScript 3.0 |
| 執行階段版本: | AIR 1.0, Flash Player 9, Flash Lite 4 |
指定在影片片段實體時間軸上，播放磁頭所在的影格編號。 如果影片片段有多個場景，此值就是目前場景的影格編號。
實作
public function get currentFrame():int範例 ( 如何使用本範例 )
下列程式碼會使用
gotoAndStop() 方法和 currentFrame 屬性，將 mc1 影片片段的播放磁頭從目前位置向前移動五個影格然後停止：
mc1.gotoAndStop(mc1.currentFrame + 5);
currentFrameLabel | 屬性 |
currentLabel | 屬性 |
currentLabel:String [唯讀] | 語言版本: | ActionScript 3.0 |
| 執行階段版本: | AIR 1.0, Flash Player 9, Flash Lite 4 |
在 MovieClip 實體時間軸中，播放磁頭所在的目前標籤。 如果目前的影格沒有標籤，currentLabel 就會設定為先前包含標籤的影格名稱。 如果目前與先前的影格都不含任何標籤，則 currentLabel 會傳回 null。
實作
public function get currentLabel():String範例 ( 如何使用本範例 )
下列程式碼會說明如何存取
currentLabel 屬性 (屬於名為 mc1 的 MovieClip 物件)：
trace(mc1.currentLabel);
currentLabels | 屬性 |
currentLabels:Array [唯讀] | 語言版本: | ActionScript 3.0 |
| 執行階段版本: | AIR 1.0, Flash Player 9, Flash Lite 4 |
從目前場景傳回 FrameLabel 物件陣列。 如果 MovieClip 實體不使用場景，陣列會包括來自整個 MovieClip 實體的所有影格標籤。
實作
public function get currentLabels():Array相關 API 元素
範例 ( 如何使用本範例 )
下列程式碼說明如何使用
currentLabels 屬性 (屬於名為 mc1 的 MovieClip 物件)：
import flash.display.FrameLabel;
var labels:Array = mc1.currentLabels;
for (var i:uint = 0; i < labels.length; i++) {
var label:FrameLabel = labels[i];
trace("frame " + label.frame + ": " + label.name);
}
currentScene | 屬性 |
currentScene:Scene [唯讀] | 語言版本: | ActionScript 3.0 |
| 執行階段版本: | AIR 1.0, Flash Player 9, Flash Lite 4 |
在 MovieClip 實體時間軸中，播放磁頭所在的目前場景。
實作
public function get currentScene():Scene相關 API 元素
範例 ( 如何使用本範例 )
下列程式碼說明如何使用
currentScene 屬性 (屬於名為 mc1 的 MovieClip 物件)：
import flash.display.Scene; var scene:Scene = mc1.currentScene; trace(scene.name + ": " + scene.numFrames + " frames");
enabled | 屬性 |
enabled:Boolean| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | AIR 1.0, Flash Player 9, Flash Lite 4 |
這是一個 Boolean 值，用來指示影片片段是否已啟用。 enabled 的預設值是 true。 如果 enabled 設為 false，便會停用影片片段的「滑入」、「按下」與「未滑入」影格。 影片片段會繼續接收事件 (例如，mouseDown、mouseUp、keyDown 和 keyUp)。
enabled 屬性只會影響影片片段中類似按鈕的屬性。 您可以隨時更改 enabled 屬性；修改後的影片片段會立即啟用或停用。 如果將 enabled 設定為 false，則不會將物件包含在自動定位停駐點順序中。
實作
public function get enabled():Boolean public function set enabled(value:Boolean):void範例 ( 如何使用本範例 )
下列程式碼說明如何使用
enabled 屬性來停用類似按鈕且名為 mc1 的 MovieClip 物件屬性：
mc1.enabled = false;
framesLoaded | 屬性 |
framesLoaded:int [唯讀] | 語言版本: | ActionScript 3.0 |
| 執行階段版本: | AIR 1.0, Flash Player 9, Flash Lite 4 |
從串流 SWF 檔中載入的影格數目。 若要判斷指定的影格以及它前面所有影格的內容是否都已載入，而且可在本機的瀏覽器使用，請使用 framesLoaded 屬性。您也可以使用它來監視大型 SWF 檔案的下載。 例如，尚未完成某個 SWF 檔案中指定影格的載入動作之前，您可能會想要顯示一個訊息，告訴使用者該 SWF 檔案正在載入中。
如果影片片段包含多個場景，framesLoaded 屬性就會傳回影片片段中載入的「所有」場景之影格數目。
實作
public function get framesLoaded():int相關 API 元素
範例 ( 如何使用本範例 )
下列程式碼會說明如何使用
framesLoaded 屬性與 totalFrames 屬性，判斷名為 mc1 的串流 MovieClip 物件是否已完全載入：
if (mc1.framesLoaded == mc1.totalFrames) {
trace("OK.");
}
isPlaying | 屬性 |
scenes | 屬性 |
scenes:Array [唯讀] | 語言版本: | ActionScript 3.0 |
| 執行階段版本: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Scene 物件的陣列，每個 Scene 物件都會列出 MovieClip 實體場景的名稱、影格數目，以及影格標籤。
實作
public function get scenes():Array相關 API 元素
範例 ( 如何使用本範例 )
下列程式碼說明如何使用
scenes 屬性 (屬於名為 mc1 的 MovieClip 物件)：
import flash.display.Scene;
for (var i:uint = 0; i < mc1.scenes.length; i++) {
var scene:Scene = mc1.scenes[i];
trace("scene " + scene.name + ": " + scene.numFrames + " frames");
}
totalFrames | 屬性 |
trackAsMenu | 屬性 |
trackAsMenu:Boolean| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | AIR 1.0, Flash Player 9 |
指出屬於 SimpleButton 或 MovieClip 物件的其他顯示工具是否可以接收滑鼠放開事件或其他使用者輸入放開事件。trackAsMenu 屬性可讓您建立選單。 您可以在任何 SimpleButton 或 MovieClip 物件上設定 trackAsMenu 屬性。 trackAsMenu 屬性的預設值是 false。
您可以隨時更改 trackAsMenu 屬性；修改後的影片片段會立即採用新的行為指令。
實作
public function get trackAsMenu():Boolean public function set trackAsMenu(value:Boolean):void範例 ( 如何使用本範例 )
下列程式碼會說明如何使用
trackAsMenu 屬性，啟用 MovieClip 物件的滑鼠放開事件，此物件名為 mc1：
mc1.trackAsMenu = true;
建構函式詳細資料
MovieClip | () | 建構函式 |
public function MovieClip()| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | AIR 1.0, Flash Player 9, Flash Lite 4 |
建立新的 MovieClip 實體。 在建立 MovieClip 之後，呼叫在舞台上顯示的物件容器之 addChild() 或 addChildAt() 方法。
方法詳細資訊
gotoAndPlay | () | 方法 |
public function gotoAndPlay(frame:Object, scene:String = null):void| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | AIR 1.0, Flash Player 9, Flash Lite 4 |
在指定影格開始播放 SWF 檔。 當影格中的所有剩餘動作都執行完畢之後，就會發生這個情況。 若要指定場景與影格，請為 scene 參數指定一個值。
參數
frame:Object — 代表影格編號的數字，或是代表影格標籤的字串 (假設播放磁頭已移到該影格上)。 如果您指定一個編號，該編號將相對於您指定的場景。 如果您沒有指定場景，目前的場景便會決定要播放的全域影格編號。如果您沒有指定場景，播放磁頭會跳到指定場景中的影格編號。
| |
scene:String (default = null) |
範例 ( 如何使用本範例 )
下列程式碼會使用
gotoAndPlay() 方法，將 mc1 影片片段的播放磁頭從目前位置向前移動五個影格：
mc1.gotoAndPlay(mc1.currentFrame + 5);
下列程式碼會使用
gotoAndPlay() 方法，將 mc1 影片片段的播放磁頭移動至場景中標示為 "intro" 的影格 (該場景名為 "Scene 12")：
mc1.gotoAndPlay("intro", "Scene 12");
gotoAndStop | () | 方法 |
public function gotoAndStop(frame:Object, scene:String = null):void| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | AIR 1.0, Flash Player 9, Flash Lite 4 |
將播放磁頭移到此影片片段中的指定影格，然後停在該處。 當影格中的所有剩餘動作都執行完畢之後，就會發生這個情況。 除了影格之外，如果您還想要指定場景，請使用 scene 參數。
參數
frame:Object — 代表影格編號的數字，或是代表影格標籤的字串 (假設播放磁頭已移到該影格上)。 如果您指定一個編號，該編號將相對於您指定的場景。 如果您沒有指定場景，目前的場景便會決定要前往或停止的全域影格編號。如果您沒有指定場景，播放磁頭會前往並停在指定場景中的影格編號。
| |
scene:String (default = null) |
擲回值
ArgumentError — 如果此影片片段中找不到指定的 scene 或 frame。
|
範例 ( 如何使用本範例 )
下列程式碼會使用
gotoAndStop() 方法和 currentFrame 屬性，將 mc1 影片片段的播放磁頭從目前位置向前移動五個影格然後停止：
mc1.gotoAndStop(mc1.currentFrame + 5);
下列程式碼會使用
gotoAndStop()，將 mc1 影片片段的播放磁頭移動至場景中標示為 "finale" 的影格 (該場景名為 "Scene 12") 然後停止播放磁頭：
mc1.gotoAndStop("finale", "Scene 12");
nextFrame | () | 方法 |
public function nextFrame():void| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | AIR 1.0, Flash Player 9, Flash Lite 4 |
將播放磁頭移到下一個影格，並停止播放。 當影格中的所有剩餘動作都執行完畢之後，就會發生這個情況。
相關 API 元素
範例 ( 如何使用本範例 )
在下列範例中，兩個 SimpleButton 物件會控制時間軸。
prev 按鈕會將播放磁頭移到上一個影格；nextBtn 按鈕則會將播放磁頭移到下一個影格：
import flash.events.MouseEvent;
mc1.stop();
prevBtn.addEventListener(MouseEvent.CLICK, goBack);
nextBtn.addEventListener(MouseEvent.CLICK, goForward);
function goBack(event:MouseEvent):void {
mc1.prevFrame();
}
function goForward(event:MouseEvent):void {
mc1.nextFrame();
}
nextScene | () | 方法 |
public function nextScene():void| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | AIR 1.0, Flash Player 9, Flash Lite 4 |
將播放磁頭移動到 MovieClip 實體的下一個場景。 當影格中的所有剩餘動作都執行完畢之後，就會發生這個情況。
範例 ( 如何使用本範例 )
在下列範例中，兩個 SimpleButton 物件會控制時間軸。
prevBtn 按鈕會將播放磁頭移到上一個場景；nextBtn 按鈕則會將播放磁頭移到下一個場景：
import flash.events.MouseEvent;
mc1.stop();
prevBtn.addEventListener(MouseEvent.CLICK, goBack);
nextBtn.addEventListener(MouseEvent.CLICK, goForward);
function goBack(event:MouseEvent):void {
mc1.prevScene();
}
function goForward(event:MouseEvent):void {
mc1.nextScene();
}
play | () | 方法 |
public function play():void| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | AIR 1.0, Flash Player 9, Flash Lite 4 |
移動影片片段時間軸上的播放磁頭。
相關 API 元素
範例 ( 如何使用本範例 )
下列程式碼使用
stop() 方法來停止名為 mc1 的影片片段，並在使用者按下文字欄位時繼續播放 (該文字欄位名為 continueText)：
import flash.text.TextField;
import flash.events.MouseEvent;
var continueText:TextField = new TextField();
continueText.text = "Play movie...";
addChild(continueText);
mc1.stop();
continueText.addEventListener(MouseEvent.CLICK, resumeMovie);
function resumeMovie(event:MouseEvent):void {
mc1.play();
}
prevFrame | () | 方法 |
public function prevFrame():void| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | AIR 1.0, Flash Player 9, Flash Lite 4 |
將播放磁頭移到上一個影格，並停止播放。 當影格中的所有剩餘動作都執行完畢之後，就會發生這個情況。
範例 ( 如何使用本範例 )
在下列範例中，兩個 SimpleButton 物件會控制時間軸。
prev 按鈕會將播放磁頭移到上一個影格；nextBtn 按鈕則會將播放磁頭移到下一個影格：
import flash.events.MouseEvent;
mc1.stop();
prevBtn.addEventListener(MouseEvent.CLICK, goBack);
nextBtn.addEventListener(MouseEvent.CLICK, goForward);
function goBack(event:MouseEvent):void {
mc1.prevFrame();
}
function goForward(event:MouseEvent):void {
mc1.nextFrame();
}
prevScene | () | 方法 |
public function prevScene():void| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | AIR 1.0, Flash Player 9, Flash Lite 4 |
將播放磁頭移動到 MovieClip 實體的上一個場景。 當影格中的所有剩餘動作都執行完畢之後，就會發生這個情況。
範例 ( 如何使用本範例 )
在下列範例中，兩個 SimpleButton 物件會控制時間軸。
prevBtn 按鈕會將播放磁頭移到上一個場景；nextBtn 按鈕則會將播放磁頭移到下一個場景：
import flash.events.MouseEvent;
mc1.stop();
prevBtn.addEventListener(MouseEvent.CLICK, goBack);
nextBtn.addEventListener(MouseEvent.CLICK, goForward);
function goBack(event:MouseEvent):void {
mc1.prevScene();
}
function goForward(event:MouseEvent):void {
mc1.nextScene();
}
stop | () | 方法 |
public function stop():void| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | AIR 1.0, Flash Player 9, Flash Lite 4 |
停止影片片段中的播放磁頭。
範例 如何使用本範例
MovieClipExample.as
下列範例會使用 MovieClipExample 類別，說明如何監視 MovieClip 的多種屬性。 您可以執行下列步驟來完成這項工作：
- 此建構函數會定義一個文字欄位，此文字欄位是用於顯示 MovieClipExample 物件 (會擴充 MovieClip) 的屬性值。
getPropertiesString()方法的傳回值可用來當作outputText文字欄位的文字。getPropertiesString()方法會傳回以下列影片片段之屬性值所填入的字串：currentFrame、currentLabel、currentScene、framesLoaded、totalFrames和trackAsMenu。- 建構函數中的兩行程式碼會調整
outputText文字欄位的width與height屬性。 - 建構函數的最後一行會將
outputText文字欄位加入至顯示清單中。
package {
import flash.display.MovieClip;
import flash.text.TextField;
public class MovieClipExample extends MovieClip {
public function MovieClipExample() {
var outputText:TextField = new TextField();
outputText.text = getPropertiesString();
outputText.width = stage.stageWidth;
outputText.height = outputText.textHeight;
addChild(outputText);
}
private function getPropertiesString():String {
var str:String = ""
+ "currentFrame: " + currentFrame + "\n"
+ "currentLabel: " + currentLabel + "\n"
+ "currentScene: " + currentScene + "\n"
+ "framesLoaded: " + framesLoaded + "\n"
+ "totalFrames: " + totalFrames + "\n"
+ "trackAsMenu: " + trackAsMenu + "\n";
return str;
}
}
}
Tue Jun 12 2018, 03:47 PM Z