パッケージ | 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
選択したコンポーネントがフォーカスマネージャーからフォーカスを受け取ることができるかどうかを示す値を取得または設定します。 | IFocusManagerComponent | ||
mouseFocusEnabled : Boolean [読み取り専用]
マウスを使用して選択されたコンポーネントが、フォーカスを受け取ることができるかどうかを示すブール値を取得します。 | IFocusManagerComponent | ||
tabEnabled : 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 |
選択したコンポーネントがフォーカスマネージャーからフォーカスを受け取ることができるかどうかを示す値を取得または設定します。
コンポーネントでフォーカスマネージャーからフォーカスを受け取れるようにするには、このプロパティを 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 |
マウスを使用して選択されたコンポーネントが、フォーカスを受け取ることができるかどうかを示すブール値を取得します。
マウスデバイスを使用して選択されたコンポーネントにフォーカスを与えるには、このプロパティを 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 |
Tab キーを押すことでこのコンポーネントにフォーカスを移動できるかどうかを示すブール値を取得します。値 true
は、Tab キーを使用してこのコンポーネントまでフォーカスを移動できることを示します。値 false
は、Tab キーを使用しても、このコンポーネントまでフォーカスを移動できないことを示します。
この値が false
に設定されていても、マウスデバイスで選択するか、setFocus()
メソッドを呼び出せば、コンポーネントでフォーカスを受け取ることができます。
実装
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 であるオブジェクトの前になります。2 つのオブジェクトの tabIndex
値が同じである場合、デフォルトタブの順序が早い方が他方よりも優先されます。
デフォルト値: -1。
実装
public function get tabIndex():int
drawFocus | () | メソッド |
public function drawFocus(draw:Boolean):void
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flash CS3 |
ランタイムバージョン: | Flash Player 9.0.28.0, AIR 1.0 |
可視のフォーカスインジケーターを描画します。
このメソッドは、コンポーネントがフォーカスを受け取ったときにフォーカスマネージャーによって呼び出されます。コンポーネントは、コンポーネントにフォーカスがあることを示すグラフィックを描画するか、非表示にします。
パラメーター
draw:Boolean — true の場合はフォーカスインジケーターを描画し、それ以外の場合は非表示にします。
|
setFocus | () | メソッド |
public function setFocus():void
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flash CS3 |
ランタイムバージョン: | Flash Player 9.0.28.0, AIR 1.0 |
コンポーネントに対するフォーカスを設定します。
このメソッドは、コンポーネントがフォーカスを受け取ったときにフォーカスマネージャーによって呼び出されます。コンポーネントは、受け取ったフォーカスを内部コンポーネントに設定します。
Tue Jun 12 2018, 10:34 AM Z