| 套件 | fl.managers |
| 介面 | public interface IFocusManager |
| 實作者 | FocusManager |
| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
相關 API 元素
| 屬性 | 定義自 | ||
|---|---|---|---|
| defaultButton : Button
取得或設定預設按鈕的參考。 | IFocusManager | ||
| defaultButtonEnabled : Boolean
取得或設定值,指出是否已啟用預設按鈕。 | IFocusManager | ||
| form : DisplayObjectContainer
IFocusManager 的基底 DisplayObjectContainer,通常是舞台。 | IFocusManager | ||
| nextTabIndex : int [唯讀]
會取得要在目前定位鍵迴圈中使用的下一個唯一定位鍵索引。 | IFocusManager | ||
| showFocusIndicator : Boolean
會取得或設定值,決定使用者介面是否要改變以指出特定組件具有焦點。 | IFocusManager | ||
| 方法 | 定義自 | ||
|---|---|---|---|
會啟動焦點管理員。 | IFocusManager | ||
會停用焦點管理員。 | IFocusManager | ||
會擷取包含指定之物件的 IFocusManagerComponent 物件 (如果有的話)。 | IFocusManager | ||
會擷取目前成為焦點的 IFocusManagerComponent 組件。 | IFocusManager | ||
會擷取當使用者用 Tab 鍵移動焦點時,緊接著將接收焦點的組件。 | IFocusManager | ||
會將 showFocusIndicator 屬性設定為 false。 | IFocusManager | ||
將焦點設定為 IFocusManagerComponent 組件。 | IFocusManager | ||
將 showFocusIndicator 屬性設定為 true。 | IFocusManager | ||
defaultButton | 屬性 |
defaultButton:Button| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
取得或設定預設按鈕的參考。 預設按鈕可用來當做按下 Enter 鍵時擁有焦點之任何組件的替身按鈕。 按下 Enter 鍵會代表擁有焦點的組件,在預設按鈕上觸發 click 事件的傳送作業。 Button 組件不需要預設按鈕。 當焦點移至 Button 組件時,並不能觸發預設的按鈕;如果焦點從 Button 組件移動至不是按鈕的組件,則可能會再次觸發預設的按鈕。
實作
public function get defaultButton():Button public function set defaultButton(value:Button):voiddefaultButtonEnabled | 屬性 |
defaultButtonEnabled:Boolean| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
取得或設定值,指出是否已啟用預設按鈕。 如果將這個值設定為 true,並在非 Button 組件的組件具有焦點時按下 Enter 鍵,焦點管理員便會監視 Enter 鍵,並且在預設按鈕上傳送 click 事件。 如果將這個值設定為 false,則焦點管理員不會監視 Enter 鍵。 使用 Enter 鍵的組件會將此屬性設定為 false,避免當使用者按下 Enter 鍵時在預設按鈕 (如果有的話) 上傳送 click 事件。
實作
public function get defaultButtonEnabled():Boolean public function set defaultButtonEnabled(value:Boolean):voidform | 屬性 |
form:DisplayObjectContainer| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS5.5 |
| 執行階段版本: | AIR 1.0, Flash Player 9.0.28.0 |
IFocusManager 的基底 DisplayObjectContainer,通常是舞台。
實作
public function get form():DisplayObjectContainer public function set form(value:DisplayObjectContainer):voidnextTabIndex | 屬性 |
showFocusIndicator | 屬性 |
showFocusIndicator:Boolean| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
會取得或設定值,決定使用者介面是否要改變以指出特定組件具有焦點。
如果將此屬性設定為 true,便會以視覺化指示器標示成為焦點的組件。 如果設定為 false,則不使用焦點視覺化指示器。
根據預設,直到使用者按下 Tab 鍵為止,此屬性都設定為 false;之後才設定為 true。
實作
public function get showFocusIndicator():Boolean public function set showFocusIndicator(value:Boolean):voidactivate | () | 方法 |
public function activate():void| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
會啟動焦點管理員。
如果在螢幕上同時顯示多個 DisplayObjectContainer 物件,則系統管理員會在焦點由某個容器移至下一個容器時,啟用和停用這些容器的 FocusManager 物件。 當焦點移至其焦點管理員已停用之 DisplayObjectContainer 物件中的組件時,系統管理員會呼叫 activate() 方法,以啟用該焦點管理員。 由於一次只會啟用一個焦點管理員,因此在啟用某個焦點管理員之前,系統管理員會先使用 deactivate() 方法,停用作用中的焦點管理員 (其組件已失去焦點)。
deactivate | () | 方法 |
public function deactivate():void| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
會停用焦點管理員。
如果在螢幕上同時顯示多個 DisplayObjectContainer 物件,則系統管理員會在焦點由某個容器移至下一個容器時,啟用和停用這些容器的 FocusManager 物件。 當焦點移至其焦點管理員已停用之 DisplayObjectContainer 物件中的組件時,系統管理員會呼叫 activate() 方法,以啟用該焦點管理員。 由於一次只會啟用一個焦點管理員,因此在啟用某個焦點管理員之前,系統管理員會先使用 deactivate() 方法,停用作用中的焦點管理員 (其組件已失去焦點)。
findFocusManagerComponent | () | 方法 |
public function findFocusManagerComponent(component:InteractiveObject):InteractiveObject| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
會擷取包含指定之物件的 IFocusManagerComponent 物件 (如果有的話)。
Flash Player 可以將焦點設定於子組件以及組件本身。 此方法可以用來尋找成為焦點的組件,或者是包含成為焦點之子組件的組件。
參數
component:InteractiveObject — 可以具有 Flash Player 層級焦點的物件。
|
InteractiveObject — 包含指定物件的 IFocusManagerComponent;否則,此方法會傳回 null。
|
getFocus | () | 方法 |
public function getFocus():InteractiveObject| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
會擷取目前成為焦點的 IFocusManagerComponent 組件。 您可以使用此方法來判斷成為焦點的組件。 使用 Stage 物件來找出成為焦點的組件時,可能會導致傳回該組件的子組件。
傳回值InteractiveObject — 成為焦點的 IFocusManagerComponent 物件。
|
getNextFocusManagerComponent | () | 方法 |
public function getNextFocusManagerComponent(backward:Boolean = false):InteractiveObject| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
會擷取當使用者用 Tab 鍵移動焦點時,緊接著將接收焦點的組件。
當焦點向前或向後移動一個元素時,此方法可以用來偵測定位鍵迴圈中下一個要接收焦點的組件。 如果應用程式沒有包含其他有效的組件,此方法就會擷取成為焦點的目前組件。
參數
backward:Boolean (default = false) — 指出焦點是否依循定位鍵迴圈的倒退方向移動。 如果這個值是 true,則此方法會在使用者按下 Shift+Tab 鍵組合並依倒退方向移動焦點時,傳回成為焦點的組件。
|
InteractiveObject — 緊接著要接收焦點的組件。
|
hideFocus | () | 方法 |
public function hideFocus():void| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
會將 showFocusIndicator 屬性設定為 false。 如果成為焦點的組件具有焦點視覺化指示器的標記,此方法便會移除該指示器。
setFocus | () | 方法 |
public function setFocus(o:InteractiveObject):void| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
將焦點設定為 IFocusManagerComponent 組件。 此方法不會檢查組件的可見性、啟用狀態,或任何其他條件。
參數
o:InteractiveObject — 要接收焦點的組件。
|
showFocus | () | 方法 |
public function showFocus():void| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
將 showFocusIndicator 屬性設定為 true。 如果某個組件成為焦點,此方法便會在該組件上繪製視覺化焦點指示器。
Tue Jun 12 2018, 03:47 PM Z