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