套件 | 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):void
mouseFocusEnabled | 屬性 |
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():Boolean
tabEnabled | 屬性 |
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():Boolean
tabIndex | 屬性 |
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():int
drawFocus | () | 方法 |
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