パッケージmx.managers
インターフェイスpublic interface IFocusManager
実装者 FocusManager

IFocusManager インターフェイスは、マウスまたはキーボード(Tab キー)の操作に応じてコンポーネントのフォーカスを管理し、デフォルトボタンをサポートするためにコンポーネントが実装する必要があるインターフェイスを定義します。

関連項目

mx.managers.FocusManager


パブリックプロパティ
 プロパティ定義元
  defaultButton : IButton
元のデフォルト Button コントロールへの参照です。
IFocusManager
  defaultButtonEnabled : Boolean
FocusManager がデフォルトボタンをアクティブ化するときに Enter キーが押されていることをチェックするかどうかを示すフラグです。
IFocusManager
  focusPane : Sprite
コンテナ間でフォーカスが移動されるときにコンテナ間で移動する単一の Sprite オブジェクトです。
IFocusManager
  nextTabIndex : int
[読み取り専用] このタブループで次に使用する一意のタブインデックス。
IFocusManager
  showFocusIndicator : Boolean
コンポーネントがフォーカスを持っていることを表すインジケータを表示するかどうかを示すフラグです。
IFocusManager
パブリックメソッド
 メソッド定義元
  
複数の IFocusManagerContainer が同時に可視である場合、SystemManager は FocusManager をアクティブまたは非アクティブにします。
IFocusManager
  
SWF ブリッジをこのフォーカスマネージャに追加します。
IFocusManager
  
複数の IFocusManagerContainer が同時に可視である場合、SystemManager は FocusManager をアクティブまたは非アクティブにします。
IFocusManager
  
指定されたオブジェクトが含まれている IFocusManagerComponent を返します(存在する場合)。
IFocusManager
  
現在フォーカスを持っている IFocusManagerComponent コンポーネントを取得します。
IFocusManager
  
ユーザーが Tab キーを押して別のコンポーネントにナビゲートするとフォーカスを取得する IFocusManagerComponent を返します。
IFocusManager
  
showFocusIndicator を false に設定し、フォーカスがあるオブジェクト(存在する場合)から可視のフォーカスインジケータを削除します。
IFocusManager
  
moveFocus(direction:String, fromDisplayObject:DisplayObject = null):void
現在のコントロールからタブ順序での前または次のコントロールにフォーカスを移動します。
IFocusManager
  
フォーカスマネージャを削除します。
IFocusManager
  
フォーカスを IFocusManagerComponent コンポーネントに設定します。
IFocusManager
  
showFocusIndicator を true に設定し、フォーカスがあるオブジェクト(存在する場合)に可視のフォーカスインジケータを描画します。
IFocusManager
プロパティの詳細
defaultButtonプロパティ
defaultButton:IButton

元のデフォルト Button コントロールへの参照です。 任意の Button コントロールにフォーカスがあるときに Enter キーを押すと、マウスでクリックした場合と同様に、Button コントロールの click イベントが送出され、その Button コントロールがアクティブになります。 実際のデフォルト Button コントロールは、フォーカスが別の Button コントロールに移ると変更されますが、フォーカスがボタンにない場合は元に戻ります。

このプロパティは Flex コンテナによって管理されるため、デフォルトボタンを指定するために直接設定しないでください。

defaultButton は、mx.controls.Button クラスでなければなりません。これは、このプロパティが IUIComponent タイプの場合でも同様です。



実装
    public function get defaultButton():IButton
    public function set defaultButton(value:IButton):void
defaultButtonEnabledプロパティ 
defaultButtonEnabled:Boolean

デフォルトボタンをアクティブ化するために Enter キーが押されていることを FocusManager がチェックするかどうかを示すフラグです。 Enter キーを認識する必要のある TextArea およびその他のコンポーネントでは、このプロパティを false に設定し、デフォルトボタンが存在する場合に Enter キーがデフォルトボタンの click イベントを送出しないようにします。



実装
    public function get defaultButtonEnabled():Boolean
    public function set defaultButtonEnabled(value:Boolean):void
focusPaneプロパティ 
focusPane:Sprite

コンテナ間でフォーカスが移動されるときにコンテナ間で移動する単一の Sprite オブジェクトです。 Sprite は、コンポーネントがフォーカスを持つ可視インジケータの親として使用されます。



実装
    public function get focusPane():Sprite
    public function set focusPane(value:Sprite):void
nextTabIndexプロパティ 
nextTabIndex:int  [読み取り専用]

このタブループで次に使用する一意のタブインデックス。



実装
    public function get nextTabIndex():int
showFocusIndicatorプロパティ 
showFocusIndicator:Boolean

コンポーネントがフォーカスを持っていることを表すインジケータを表示するかどうかを示すフラグです。 true の場合、フォーカスを取得するコンポーネントは、そのコンポーネントがフォーカスを持つ可視インジケータを描画します。

デフォルトは false で、ユーザーが Tab キーを使用すると true に設定されます。

showFocus() メソッドおよび hideFocus() メソッドを使用してこのプロパティを変更すると、コンポーネントがフォーカスを持つ可視インジケータも更新されるため、通常はこれらのメソッドを使用することをお勧めします。



実装
    public function get showFocusIndicator():Boolean
    public function set showFocusIndicator(value:Boolean):void
メソッドの詳細
activate()メソッド
public function activate():void

複数の IFocusManagerContainer が同時に可視である場合、SystemManager は FocusManager をアクティブまたは非アクティブにします。 FocusManager が非アクティブ化されている IFocusManagerContainer の中でマウスがクリックされると、その FocusManager を対象とする activate() メソッドが SystemManager から呼び出されます。アクティブにされた FocusManager の deactivate() メソッドは、他の FocusManager がアクティブにされる前に呼び出されます。

addSWFBridge()メソッド 
public function addSWFBridge(bridge:IEventDispatcher, owner:DisplayObject):void

SWF ブリッジをこのフォーカスマネージャに追加します。SWF ブリッジを追加するには、フォーカスを取得して、他のサンドボックス内のフォーカスマネージャ間で、または異なるバージョンのフォーカスマネージャを使用して、シームレスに転送する必要があります。

パラメータ

bridge:IEventDispatcher — 別のフォーカスマネージャへのブリッジです。
 
owner:DisplayObject — ブリッジを所有する表示オブジェクトです。

deactivate()メソッド 
public function deactivate():void

複数の IFocusManagerContainer が同時に可視である場合、SystemManager は FocusManager をアクティブまたは非アクティブにします。 FocusManager が非アクティブ化されている IFocusManagerContainer の中でマウスがクリックされると、その FocusManager を対象とする activate() メソッドが SystemManager から呼び出されます。アクティブにされた FocusManager の deactivate() メソッドは、他の FocusManager がアクティブにされる前に呼び出されます。

findFocusManagerComponent()メソッド 
public function findFocusManagerComponent(o:InteractiveObject):IFocusManagerComponent

指定されたオブジェクトが含まれている IFocusManagerComponent を返します(存在する場合)。 プレーヤーでは Flex コンポーネントのサブコンポーネントにフォーカスを設定できるため、このメソッドでは、コンポーネント側から見てどの IFocusManagerComponent にフォーカスがあるかを判別します。

パラメータ

o:InteractiveObject — プレーヤーレベルのフォーカスを取得できるオブジェクトです。

戻り値
IFocusManagerComponent — または o が格納されている IFOcusManagerComponent です。null
getFocus()メソッド 
public function getFocus():IFocusManagerComponent

現在フォーカスを持っている IFocusManagerComponent コンポーネントを取得します。 このメソッドを呼び出すと、どのコンポーネントにフォーカスがあるかが示されるので、Stage オブジェクトよりもこのメソッドを使用することをお勧めします。 Stage オブジェクトは、該当コンポーネント内のサブコンポーネントを返す場合があります。

戻り値
IFocusManagerComponent — フォーカスを持っている IFocusManagerComponent オブジェクト。
getNextFocusManagerComponent()メソッド 
public function getNextFocusManagerComponent(backward:Boolean = false):IFocusManagerComponent

ユーザーが Tab キーを押して別のコンポーネントにナビゲートするとフォーカスを取得する IFocusManagerComponent を返します。 アプリケーション内に他に有効なコンポーネントがない場合は、現在フォーカスがあるコンポーネントと同じコンポーネントを返します。

パラメータ

backward:Boolean (default = false)true の場合、Shift+Tab キーを押した場合と同じオブジェクトを返します。

戻り値
IFocusManagerComponent — フォーカスを取得するコンポーネント。
hideFocus()メソッド 
public function hideFocus():void

showFocusIndicatorfalse に設定し、フォーカスがあるオブジェクト(存在する場合)から可視のフォーカスインジケータを削除します。

moveFocus()メソッド 
public function moveFocus(direction:String, fromDisplayObject:DisplayObject = null):void

現在のコントロールからタブ順序での前または次のコントロールにフォーカスを移動します。移動の方向は、direction パラメータで指定されます。

パラメータ

direction:StringFocusRequestDirection.FORWARD は、現在フォーカスがあるコントロールから上位のタブインデックスを持つコントロールに移動します。同じインデックスを持つコントロールが複数ある場合は、ドキュメントのフロー内の次のコントロールに移動します。FocusRequestDirection.BACKWARD は、下位のタブインデックスを持つコントロールに移動します。FocusRequestDirection.TOP は、最小のタブインデックスを持つコントロールにフォーカスを移動します。同じインデックスを持つコントロールが複数ある場合は、ドキュメントのフロー内の最初のコントロールにフォーカスが移動します。FocusRequestDirection.BOTTOM は、最大のタブインデックスを持つコントロールにフォーカスを移動します。同じインデックスを持つコントロールが複数ある場合は、ドキュメントのフロー内の最後のコントロールにフォーカスが移動します。
 
fromDisplayObject:DisplayObject (default = null) — フォーカスの移動の開始点です。オブジェクトが提供されている場合は、これにより、現在フォーカスを持つオブジェクトからフォーカスが移動するデフォルトの動作がオーバーライドされます。

removeSWFBridge()メソッド 
public function removeSWFBridge(bridge:IEventDispatcher):void

フォーカスマネージャを削除します。これは、addSWFBridge を呼び出すことで追加されたブリッジが削除された場合に呼び出す必要があります。

パラメータ

bridge:IEventDispatcher — 削除するブリッジです。

setFocus()メソッド 
public function setFocus(o:IFocusManagerComponent):void

フォーカスを IFocusManagerComponent コンポーネントに設定します。コンポーネントの可視性や、有効にされた状態またはその他の状態はチェックされません。

パラメータ

o:IFocusManagerComponent — フォーカスを取得可能なコンポーネント。

showFocus()メソッド 
public function showFocus():void

showFocusIndicatortrue に設定し、フォーカスがあるオブジェクト(存在する場合)に可視のフォーカスインジケータを描画します。





 

 

このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。 | コメントレポート

現在のページ: http://livedocs.adobe.com/flex/3_jp/langref/mx/managers/IFocusManager.html