| 套件 | fl.managers |
| 介面 | public interface IFocusManagerComponent |
| 實作者 | Button, ColorPicker, ComboBox, DataGrid, LabelButton, List, NumericStepper, ScrollPane, SelectableList, Slider, TextArea, TextInput, TileList |
| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
UIComponent 類別會提供此介面的基底實作,但是不會完整加以實作,因為並非所有 UIComponent 物件都會接收焦點。 衍生自 UIComponent 類別的組件必須實作此介面,才能接收焦點。 若要啟用焦點,請將陳述式 implements IFocusManagerComponent 加入到衍生自 UIComponent 類別之組件的類別定義。
相關 API 元素
| 屬性 | 定義自 | ||
|---|---|---|---|
| focusEnabled : Boolean
取得或設定 Boolean 值,指出選取的組件是否能從焦點管理員接收焦點。 | IFocusManagerComponent | ||
| mouseFocusEnabled : Boolean [唯讀]
取得 Boolean 值,指出使用滑鼠裝置選取的組件是否能接收焦點。 | IFocusManagerComponent | ||
| tabEnabled : Boolean [唯讀]
取得 Boolean 值,指出按下 Tab 鍵是否可將焦點移至此組件。 | IFocusManagerComponent | ||
| tabIndex : int [唯讀]
如果 tabEnabledis 設定為 true,則會取得組件接收焦點的順序。 | IFocusManagerComponent | ||
| 方法 | 定義自 | ||
|---|---|---|---|
會繪製視覺化焦點指示器。 | IFocusManagerComponent | ||
會設定組件的焦點。 | IFocusManagerComponent | ||
focusEnabled | 屬性 |
focusEnabled:Boolean| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
取得或設定 Boolean 值,指出選取的組件是否能從焦點管理員接收焦點。
若要讓組件能夠從焦點管理員接收焦點,請將此屬性設定為 true。 若要讓組件無法接收焦點,請將此屬性設定為 false。 當 focusEnabled 設定為 false 時,焦點管理員會在組件存留期間忽略此組件,而且不會監視它在下列屬性中的變更:tabEnabled、tabChildren 和 mouseFocusEnabled。
您可以使用 focusEnabled 屬性,防止實作 IFocusManagerComponent 介面之組件的子組件從焦點管理員接收焦點。 若要這樣做,請先將此屬性設定為 false,再使用 addChild() 方法,將子組件加入顯示清單。 請注意,如果您在組件加入顯示清單之前,將此屬性設定為 false,焦點管理員就會繼續忽略此組件,即使之後將此屬性設定為 true 也是一樣。
注意:即使將此屬性設定為 false,您仍然可以使用 setFocus() 方法,透過程式設計的方式設定焦點。
實作
public function get focusEnabled():Boolean public function set focusEnabled(value:Boolean):voidmouseFocusEnabled | 屬性 |
mouseFocusEnabled:Boolean [唯讀] | 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
取得 Boolean 值,指出使用滑鼠裝置選取的組件是否能接收焦點。
您可以將此屬性設定為 true,將焦點指定給使用滑鼠裝置所選取的組件; 也可以將此屬性設定為 false,避免將焦點指定給使用滑鼠裝置所選取的組件。 使用滑鼠裝置選取組件時,如果將此屬性設定為 false,焦點便會轉移到此屬性設為 true 的第一個父組件。
實作
public function get mouseFocusEnabled():BooleantabEnabled | 屬性 |
tabEnabled:Boolean [唯讀] | 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
取得 Boolean 值,指出按下 Tab 鍵是否可將焦點移至此組件。 值為 true 表示按下 Tab 鍵可讓焦點移至此組件;值為 false 則表示無法使用 Tab 鍵將焦點指定給此組件。
當使用滑鼠裝置選取組件,或透過呼叫 setFocus() 方法時,即使已將此值設定為 false,組件仍然可以接收焦點。
實作
public function get tabEnabled():BooleantabIndex | 屬性 |
tabIndex:int [唯讀] | 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
如果 tabEnabled 設定為 true,則會取得組件接收焦點的順序。 tabIndex 屬性預設為 -1,表示物件沒有設定任何定位鍵索引,而且物件會根據 z 順序接收焦點。
tabIndex 屬性可以是非負值的整數。 在這種情況下,物件是根據它們的 tabIndex 屬性,依遞增順序排列。 tabIndex 值為 1 的物件會排在 tabIndex 值為 2 的物件前面。 如果兩個物件的 tabIndex 值相同,則預設定位停駐點順序中最先出現的物件將會在另一個物件前面。
預設值為 -1。
實作
public function get tabIndex():intdrawFocus | () | 方法 |
setFocus | () | 方法 |
public function setFocus():void| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
會設定組件的焦點。
此方法是在組件收到焦點時,由焦點管理員呼叫。 此組件可能會反過來將焦點設定為內部組件。
Tue Jun 12 2018, 03:47 PM Z