IContainer  - AS3 Flex

可指定此 sprite 的按鈕模式。 若為 true，則此 Sprite 將執行按鈕般的行為，也就是說，它會在指標通過 Sprite 上方時觸發顯示手掌游標，而且如果 Enter 或空格鍵在 Sprite 成為焦點時按下，還可以接收 click 事件。您可以先將 useHandCursor 屬性設為 false，這樣一來，指標就會顯示出來，同時抑制手掌游標不讓它顯示出來。

雖然使用 SimpleButton 類別來建立按鈕是比較好的作法，您還是可以使用 buttonMode 屬性，賦予 Sprite 一些按鈕般的功能。 若要將 Sprite 包含在定位停駐點順序中，請將 tabEnabled 屬性 (從 InteractiveObject 類別繼承而來，而且預設為 false) 設為 true。 此外，是否讓您的 Sprite 子系支援啟用使用者輸入動作，也需要納入考量。大部分按鈕都無法針對其子物件支援啟用使用者輸入互動，因為這樣會讓事件流程混淆。若要針對所有子物件停用使用者輸入互動，您必須將 mouseChildren 屬性 (繼承自 DisplayObjectContainer 類別) 設為 false。

如果您使用 MovieClip 類別 (Sprite 類別的子類別) 的 buttonMode 屬性，您的按鈕可能會帶有其它附加的功能。 如果您納入 labeled _up、labeled_over，以及 labeled_down 的影格，則 Flash Player 會提供自動狀態變更 (與舊版 ActionScript 中提供給影片片段做為按鈕使用的功能相似)。 這些自動狀態變更無法提供 sprite 使用，因為它們沒有時間軸，因此也沒有可以加上標籤的影格。

Containers use an internal content pane to control scrolling. The creatingContentPane is true while the container is creating the content pane so that some events can be ignored or blocked.

The Button control designated as the default button for the container. When controls in the container have focus, pressing the Enter key is the same as clicking this Button control.

指定物件是否接收 doubleClick 事件。 預設值為 false，也就是說，InteractiveObject 依預設無法接收 doubleClick 事件。 如果將 doubleClickEnabled 屬性設為 true，則實體會接收到其範圍內的 doubleClick 事件。 InteractiveObject 實體的 mouseEnabled 屬性必須同時設為 true，這樣物件才能接收 doubleClick 事件。

設定這個屬性不會傳送任何事件。 您必須使用 addEventListener() 方法來加入 doubleClick 事件所需的事件偵聽程式。

指定要將 sprite 拖曳至或丟棄至哪個顯示物件上。

Gets the FocusManager that controls focus for this component and its peers. Each popup has its own focus loop and therefore its own instance of a FocusManager. To make sure you're talking to the right one, use this method.

會指定這個物件是否會顯示焦點矩形。 它可以接受下列三個值中的其中一個：true、false 或 null。true 和 false 值會如預期方式運作，指定是否顯示焦點矩形。null 值表示此物件會遵循舞台的 stageFocusRect 屬性。

指定屬於此 sprite 物件的 Graphics 物件，其中可能會產生向量繪圖命令。

指定用來當作 sprite 作用區域的另一個 sprite。 如果 hitArea 屬性不存在，或者其值為 null 或 undefined，會將 Sprite 本身當作作用區域。 hitArea 屬性的值可以是 Sprite 物件的參照。

您可以隨時更改 hitArea 屬性；修改後的 Sprite 會立即採用新的作用區域行為指令。 被指定當成感應區的 Sprite 不一定要看得見；即使看不見它的圖像形狀，仍然會偵測為感應區。

注意： 您必須將指定為作用區域的 Sprite 之 mouseEnabled 屬性設為 false， 否則，您的 Sprite 按鈕可能無法運作，因為指定為感應區的 Sprite 會接收使用者輸入事件，而不是您的 Sprite 按鈕。

The current position of the horizontal scroll bar. This is equal to the distance in pixels between the left edge of the scrollable surface and the leftmost piece of the surface that is currently visible.

判斷物件的子系是否支援啟用滑鼠或使用者輸入裝置。如果啟用某個物件，則使用者可以使用滑鼠或使用者輸入裝置，與其進行互動。預設值為 true。

當您使用 Sprite 類別 (而不是使用 SimpleButton 類別) 來建立按鈕時，這個方法就會很有用。 當您使用 Sprite 實體來建立按鈕時，可以選擇使用 addChild() 方法加入額外的 Sprite 實體來裝飾按鈕。 此程序可能會造成未預期的滑鼠事件行為，因為當做子系加入的 Sprite 實體可能會在您預期父輩實體將成為目標物件時，成為滑鼠事件的目標物件。 為了確保父輩實體能夠當作滑鼠事件的目標物件來運作，可以將父輩實體的 mouseChildren 屬性設為 false。

設定這個屬性不會傳送任何事件。 您必須使用 addEventListener() 方法來建立互動式功能。

指定此物件是否接收滑鼠或其他使用者輸入及訊息。預設值為 true，也就是說，任何位於顯示清單上的 InteractiveObject 實體，依預設都會接收滑鼠事件或其他使用者輸入事件。如果 mouseEnabled 設定成 false，則此實體不會接收任何滑鼠事件 (或其他使用者輸入事件，例如鍵盤事件)。在顯示清單上，此實體的任何子系都不會受到影響。 若要變更顯示清單上某個物件的所有子系之 mouseEnabled 行為指令，請使用 flash.display.DisplayObjectContainer.mouseChildren。

設定這個屬性不會傳送任何事件。 您必須使用 addEventListener() 方法來建立互動式功能。

傳回此物件的子系數量。

控制此 Sprite 的聲音。

注意：此屬性不會影響 HTMLControl 物件中的 HTML 內容 (在 Adobe AIR 中)。

Determines whether the children of the object are tab enabled.

Note: Do not use this property with Flex. Instead, use the UIComponent.hasFocusableChildren property.

相關 API 元素

會指定這個物件是否在停駐點順序中。 如果此物件在定位停駐點順序中，則其數值為 true，否則為 false。 根據預設，除了下列情況以外，這個值都為 false：

• 對於 SimpleButton 物件，這個值為 true。
• 對於具有 type = "input" 的 TextField 物件，這個值為 true。
• 對於 Sprite 物件或具有 buttonMode = true 的 MovieClip 物件，這個值為 true。

會指定 SWF 檔中的物件停駐點順序。 tabIndex 屬性預設為 -1，也就是說該物件沒有設定任何定位停駐點索引。

如果目前該 SWF 檔所顯示的任何物件含有 tabIndex 屬性，自動定位停駐點順序便會停用，而定位停駐點的順序會從物件在 SWF 檔中的 tabIndex 屬性開始計算。 自訂定位停駐點順序只會包含具有 tabIndex 屬性的物件。

tabIndex 屬性可以是非負值的整數。 物件是根據它們的 tabIndex 屬性，依遞增順序排列。 tabIndex 值為 1 的物件會排在 tabIndex 值為 2 的物件前面。 請勿對多個物件使用相同的 tabIndex 值。

由 tabIndex 屬性所定義的自訂定位停駐點順序是「平面」。 也就是說，SWF 檔中物件的階層架構關係是被忽略的。 該 SWF 檔中具有 tabIndex 屬性的所有物件都是依照定位停駐點順序放置的；這個定位停駐點順序是由 tabIndex 值的順序來決定。

注意：若要為 TLFTextField 實體設定停駐點順序，請將 TLFTextField 的顯示物件子系轉換為 InteractiveObject，然後設定 tabIndex 屬性。例如：

	 InteractiveObject(tlfInstance.getChildAt(1)).tabIndex = 3;
	 

	 InteractiveObject(tlfInstance1.getChildAt(1)).tabIndex = 3;
	 InteractiveObject(tlfInstance2.getChildAt(1)).tabIndex = 2;
	 InteractiveObject(tlfInstance3.getChildAt(1)).tabIndex = 1;
	 

傳回此 DisplayObjectContainer 實體的 TextSnapshot 物件。

指示當指標滑入 Sprite，且其 buttonMode 屬性設為 true 時，是否要出現指示手掌 (手掌游標) 的 Boolean 值。useHandCursor 屬性的預設值是 true。如果 useHandCursor 設為 true，當指標滑入按鈕 Sprite 上方時，便會顯示按鈕所作用的指示手掌。如果 useHandCursor 為 false，則會改用箭頭游標。

您可以隨時更改 useHandCursor 屬性；修改後的 Sprite 會立即採用新的游標行為指令。

注意：在 Flex 或 Flash Builder 中，如果您的 Sprite 具有子 Sprite，便可以將 mouseChildren 屬性設定為 false。例如，您要在 Flex <mx:Label> 控制項上方顯示手掌游標，請將 useHandCursor 和 buttonMode 屬性設定為 true，以及將 mouseChildren 屬性設定為 false。

The current position of the vertical scroll bar. This is equal to the distance in pixels between the top edge of the scrollable surface and the topmost piece of the surface that is currently visible.

Returns an object that has four properties: left, top, right, and bottom. The value of each property equals the thickness of the chrome (visual elements) around the edge of the container.

The chrome includes the border thickness. If the horizontalScrollPolicy or verticalScrollPolicy property value is ScrollPolicy.ON, the chrome also includes the thickness of the corresponding scroll bar. If a scroll policy is ScrollPolicy.AUTO, the chrome measurement does not include the scroll bar thickness, even if a scroll bar is displayed.

Subclasses of Container should override this method, so that they include other chrome to be taken into account when positioning the Container's children. For example, the viewMetrics property for the Panel class should return an object whose top property includes the thickness of the Panel container's title bar.

將 DisplayObject 子實體加入至此 DisplayObjectContainer 實體。 此子系會加入到此 DisplayObjectContainer 實體中所有其它子系的前面 (上層)。(若要將子系加入至特定的索引位置，請使用 addChildAt() 方法)。

如果您加入一個已經包含不同顯示物件容器的子物件做為父物件，則物件會從其它顯示物件容器的子清單中移除。

注意：命令 stage.addChild() 會導致發佈的 SWF 檔案發生問題，包括安全性問題以及與其他載入 SWF 檔案的衝突。無論您載入多少 SWF 檔案到執行階段中 ，Flash 執行階段實體中只會有一個舞台。因此，在一般情況下不該將物件直接新增至舞台。舞台唯一該包含的物件就是根物件。建立一個 DisplayObjectContainer 來包含顯示清單中的所有項目。然後，視需要將 DisplayObjectContainer 新增至舞台。

參數

將 DisplayObject 子實體加入至此 DisplayObjectContainer 實體。 子系會加入至指定的索引位置。 0 的索引代表位於此 DisplayObjectContainer 物件的顯示清單後面 (下層)。

例如，下列範例將說明三個加上 a、b 與 c 標籤的顯示物件，分別位於 0、2 與 1 的索引位置：

如果您加入一個已經包含不同顯示物件容器的子物件做為父物件，則物件會從其它顯示物件容器的子清單中移除。

參數

指出安全性限制是否會造成傳回的清單 (可用指定的 point 點呼叫 DisplayObjectContainer.getObjectsUnderPoint() 方法來取得) 省略任何顯示物件。 根據預設，來自某個網域的內容無法存取另一個網域的物件，除非您呼叫 Security.allowDomain() 方法才能這麼做。如需有關安全性的詳細資訊，請參閱「Flash Player 開發人員中心」主題：安全性。

point 參數位於「舞台」的座標空間，與顯示物件容器的座標空間可能不同 (除非顯示物件容器位於「舞台」)。 您可以使用 globalToLocal() 與 localToGlobal() 方法，在這些座標空間之間轉換座標點。

參數

判斷指定的顯示物件是否為 DisplayObjectContainer 實體的子系，或為實體本身。 搜尋範圍包含了整個顯示清單 (包括此 DisplayObjectContainer 實體)。 孫系，或曾孫系 (以此類推) 每個都會傳回 true。

參數

傳回存在於指定索引位置的子顯示物件實體。

參數

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

getChildAt() 方法的執行速度比 getChildByName() 方法來得快。 getChildAt() 方法可以存取快取陣列中的子系，而 getChildByName() 方法則是可以跨越連接清單來存取子系。

參數

傳回 child DisplayObject 實體的索引位置。

參數

傳回位於指定點底下，且屬於此 DisplayObjectContainer 實體之子系 (或孫系，以下類推) 的物件陣列。 任何因為安全理由而無法存取的子物件都會從傳回的陣列中省略掉。 若要判斷此安全性限制是否會影響到傳回的陣列，請呼叫 areInaccessibleObjectsUnderPoint() 方法。

point 參數位於「舞台」的座標空間，與顯示物件容器的座標空間可能不同 (除非顯示物件容器位於「舞台」)。 您可以使用 globalToLocal() 與 localToGlobal() 方法，在這些座標空間之間轉換座標點。

參數

將指定的 child DisplayObject 實體從 DisplayObjectContainer 實體的子清單中移除。 移除的子系 parent 屬性是設為 null，而且如果子系沒有其它參照，物件就會被垃圾回收器移除。 任何位於 DisplayObjectContainer 子系上層的顯示物件，其索引位置會減掉 1。

垃圾回收器會重新分配未使用的記憶體空間。當變數或物件不再被參照使用，或是已經儲存至其它位置，則垃圾回收器會對記憶體空間進行清掃，掃除變數或物件之前佔用但已經沒有任何參照的記憶體空間。

參數

從 DisplayObjectContainer 子清單中的指定 index 位置移除子 DisplayObject。 移除的子系 parent 屬性是設為 null，而且如果子系沒有其它參照，物件就會被垃圾回收器移除。 任何位於 DisplayObjectContainer 子系上層的顯示物件，其索引位置會減掉 1。

垃圾回收器會重新分配未使用的記憶體空間。當變數或物件不再被參照使用，或是已經儲存至其它位置，則垃圾回收器會對記憶體空間進行清掃，掃除變數或物件之前佔用但已經沒有任何參照的記憶體空間。

參數

變更顯示物件容器中現有子系的位置。 這樣會影響子物件的圖層。 例如，下列範例說明三個加上 a、b 與 c 標籤的顯示物件，分別位於 0、1 與 2 的索引位置：

當您使用 setChildIndex() 方法並指定已遭佔用的索引位置時，變更的位置只會介於顯示物件之前的位置和新位置之間，其它所有位置將維持不變。如果將子系移至比本身目前索引還「低」的索引位置，則兩者之間所有子系的索引參考都將「遞增」1。如果將子系移至比本身目前索引還「高」的索引位置，則兩者之間所有子系的索引參考都將「遞減」1。例如，如果上一個範例中的顯示物件容器名為 container，則您可以呼叫下列程式碼來切換加上 a 與 b 標籤的顯示物件位置：

container.setChildIndex(container.getChildAt(1), 0);

這個程式碼會產生如下所示的物件排列：

參數

讓使用者拖曳指定的 sprite。 某個 Sprite 會在您呼叫 Sprite.stopDrag() 方法來明確停止拖曳它之前，或者在您啟用拖曳另一個 Sprite 之前，維持可拖曳的狀態。 您一次只能拖曳一個 sprite。

三維顯示物件會隨著指標移動，而且 Sprite.startDrag() 會將物件在顯示物件所定義的三維平面內移動。或者，如果顯示物件是二維物件，而且是三維物件的子物件，則二維物件會在三維父物件所定義的三維平面內移動。

參數

結束 startDrag() 方法。 某個 Sprite 若是因為 startDrag() 方法成為可拖曳，則該 sprtie 將會維持可拖曳的狀態，直到加入 stopDrag() 方法、或是有另一個 sprtie 成為可拖曳為止。 您一次只能拖曳一個 sprite。

替換兩個指定子物件的 z 順序 (深度階層，由前至後順序)。 顯示物件容器中的所有其它子物件都會保留在相同的索引位置。

參數

在子清單的兩個指定索引位置，替換子物件的 z 順序 (深度階層，由前至後順序)。顯示物件容器中的所有其它子物件都會保留在相同的索引位置。

參數