パッケージmx.states
public class SetEventHandler
継承SetEventHandler Inheritance EventDispatcher Inheritance Object
ImplementsIOverride

SetEventHandler クラスは、特定のビューステートでのみアクティブになるイベントハンドラを指定します。たとえば、基本ビューステートではあるイベントハンドラを使用し、ビューステートを変更するときには別のイベントハンドラを使用する Button コントロールを定義できます。

このクラスは、State クラスの overrides プロパティで使用します。

MXML シンタックスexpandedMXML シンタックスの非表示

The <mx:SetEventHanlder> tag has the following attributes:

 <mx:SetEventHandler Properties name="null" handlerFunction="null" target="null"
  
  Events handler=No default /> 

関連項目

mx.states.State
mx.states.SetProperty
mx.states.SetStyle


パブリックプロパティ
 プロパティ定義
 Inheritedconstructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
Object
  handlerFunction : Function
イベントのハンドラ関数です。
SetEventHandler
  name : String
ハンドラを設定する対象となるイベントの名前です。
SetEventHandler
 Inheritedprototype : Object
[static] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
Object
  target : EventDispatcher
イベントを送出するコンポーネントです。
SetEventHandler
パブリック Methods
 メソッド定義
  
SetEventHandler(target:EventDispatcher = null, name:String = null)
コンストラクタです。
SetEventHandler
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
リスナーがイベントの通知を受け取るように、イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録します。
EventDispatcher
  
オーバーライドを適用します。
SetEventHandler
 Inherited
イベントをイベントフローに送出します。
EventDispatcher
 Inherited
EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。
EventDispatcher
 Inherited
指定されたプロパティがオブジェクトに定義されているかどうかを示します。
Object
  
IOverride インターフェイスのメソッド。このクラスは、このインターフェイスのメソッドを空のメソッドとして実装します。
SetEventHandler
 Inherited
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
Object
 Inherited
指定されたプロパティが存在し、列挙できるかどうかを示します。
Object
  
オーバーライドを削除します。
SetEventHandler
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
EventDispatcher オブジェクトからリスナーを削除します。
EventDispatcher
 Inherited
ループ処理に対するダイナミックプロパティの可用性を設定します。
Object
 Inherited
指定されたオブジェクトのストリング表現を返します。
Object
 Inherited
指定されたオブジェクトのプリミティブな値を返します。
Object
 Inherited
指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。
EventDispatcher
イベント
 イベント一覧定義
 Inherited Flash Player がオペレーティングシステムのフォーカスを取得して、アクティブになったときに送出されます。EventDispatcher
 Inherited Flash Player がオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。EventDispatcher
   name プロパティで指定されたイベントに応じて実行するイベントハンドラ関数です。SetEventHandler
プロパティの詳細
handlerFunctionプロパティ
public var handlerFunction:Function

イベントのハンドラ関数です。このプロパティは、ActionScript を使用してビューステートを作成し、それにアクセスする開発者を対象としています。MXML では、同等の handler イベント属性も使用できますが、単一の MXML タグに両方の属性を使用しないでください。

デフォルト値ヌル (null).

nameプロパティ 
public var name:String

ハンドラを設定する対象となるイベントの名前です。SetEventHandler コンストラクタでこのプロパティを設定するか、プロパティ値を直接設定する必要があります。

targetプロパティ 
public var target:EventDispatcher

イベントを送出するコンポーネントです。プロパティ値が null の場合、Flex では <mx:states> タグの直接の親が使用されます。

デフォルト値ヌル (null).

コンストラクタの詳細
SetEventHandler()コンストラクタ
public 関数 SetEventHandler(target:EventDispatcher = null, name:String = null)

コンストラクタです。

パラメータ
target:EventDispatcher (default = null) — 処理対象のイベントを送出するオブジェクトです。デフォルトでは、Flex は State オブジェクトの直接の親を使用します。
 
name:String (default = null) — ハンドラを設定するイベントタイプです。
メソッドの詳細
apply()メソッド
public function apply(parent:UIComponent):void

オーバーライドを適用します。Flex では元の値が保持されるため、後で remove() メソッドに元の値を復元できます。

そのビューステートに移行すると、自動的にこのメソッドが呼び出されます。このメソッドは直接呼び出さないでください。

パラメータ
parent:UIComponent — このオーバーライドを含む状態オブジェクトの親です。ターゲットが明示的に指定されていない場合、オーバーライドのターゲットとして使用されます。
initialize()メソッド 
public function initialize():void

IOverride インターフェイスのメソッド。このクラスは、このインターフェイスのメソッドを空のメソッドとして実装します。

オーバーライドを初期化します。Flex では apply() メソッドを最初に呼び出す前にこのメソッドを呼び出すため、このメソッドのオーバーライドには、1 回だけ実行する初期化コードを配置します。

そのビューステートに移行すると、Flex が自動的にこのメソッドを呼び出します。このメソッドは直接呼び出さないでください。

remove()メソッド 
public function remove(parent:UIComponent):void

オーバーライドを削除します。apply() メソッドに記憶されている値が復元されます。

そのビューステートに移行すると、自動的にこのメソッドが呼び出されます。このメソッドは直接呼び出さないでください。

パラメータ
parent:UIComponent — このオーバーライドを含む状態オブジェクトの親です。ターゲットが明示的に指定されていない場合、オーバーライドのターゲットとして使用されます。
イベントの詳細
handlerevent 
イベントオブジェクトの型: Object

name プロパティで指定されたイベントに応じて実行するイベントハンドラ関数です。

単一の <mx:SetEventHandler> タグに handler プロパティと handlerFunction プロパティの両方を指定しないでください。

そのようにすると、Flex は handler イベントを "送出しません"。MXML 属性には handler キーワードのみを使用します。handler ハンドラ属性を使用すると、Event オブジェクトだけではなく、複数のパラメータを使用するメソッドを指定できます。また、MXML タグにイベントハンドラのコードをインラインで指定できます。