オブジェクトの操作

特定のイベントに応答して実行される特定のアクションを指定する手段を「イベント処理」と呼びます。イベント処理を実行する ActionScript コードを作成する場合、特定する必要がある 3 つの重要な要素があります。

• イベントソース：イベントはどのオブジェクトに対して発生するか。例えば、どのボタンがクリックされたか、またはどの Loader オブジェクトがイメージを読み込んでいるかなどの要素です。イベントソースは、イベントターゲットとも呼ばれます。イベントソースは、コンピューターがイベントのターゲットとする（イベントが実際に発生する）オブジェクトです。

• イベント：起ころうとしていること、すなわち応答が必要な出来事は何か。多くのオブジェクトが複数のイベントをトリガーするため、イベントの特定作業は重要です。

• 応答：イベントが起こったときに、どの手順を実行するか。

イベントを処理する ActionScript コードを作成する場合は、常にコードにこれら 3 つの要素を指定する必要があります。コードは次の基本構造に従います（太字の要素は、固有の事例に応じて入力するプレースホルダーを示します）。

function eventResponse(eventObject:EventType):void 
{ 
    // Actions performed in response to the event go here. 
} 
  
eventSource.addEventListener(EventType.EVENT_NAME, eventResponse);

このコードは 2 つのことを行います。まず、関数を定義します。関数はイベントに対応して実行するアクションをユーザーが指定する方法です。 次に、ソースオブジェクトの addEventListener() メソッドを呼び出します。 addEventListener() を呼び出すと、指定したイベントに対して関数が「サブスクライブ」されます。そのイベントが発生すると、機能のアクションが実行されます。ここで、各動作を詳細に検討します。

関数は、いくつかのアクションを 1 つの名前でグループ化する手段を提供します。これは、アクションを実行するためのショートカット名のようなものです。関数はメソッドに似ていますが、必ずしも特定のクラスに関連付けられているわけではありません（実際には、「メソッド」を特定のクラスに関連付けられた関数として定義することはできます）。イベント処理を行う関数を作成する場合は、関数の名前を選択する必要があります（この場合は eventResponse ）。またパラメーターを 1 つ（この例では eventObject ）指定する必要があります。関数パラメーターの指定は、変数の宣言に似ています。このため、パラメーターのデータ型を指定する必要があります。 この例ではパラメーターのデータ型は EventType です。

監視するイベントの各タイプには、ActionScript クラスが関連付けられています。関数パラメーターに指定するデータ型は常に、応答の必要な特定のイベントに関連付けられたクラスになります。例えば、 click イベント（ユーザーがアイテムをマウスでクリックしたときにトリガーされる）は、MouseEvent クラスに関連付けられています。 click イベントに対してリスナー関数を作成するには、MouseEvent データ型のパラメーターを使用してリスナー関数を定義します。最後に、左中括弧と右中括弧の間（ { ... } ）に、イベントの発生時にコンピューターに実行を指示する命令を記述します。

以上で、イベント処理関数が作成されました。次に、イベントソースオブジェクト（ボタンなど、イベントの発生原因となるオブジェクト）に、イベントが発生したときにその関数を呼び出すように指示します。関数をイベントソースオブジェクトに登録するには、そのオブジェクトの addEventListener() メソッドを呼び出します（イベントに関連付けられたオブジェクトはすべて、 addEventListener() メソッドにも関連付けられます）。 addEventListener() メソッドは 2 つのパラメーターを受け取ります。

• 1 つ目は、応答の必要な個々のイベントの名前です。 各イベントは特定のクラスに関連付けられています。すべてのクラスは、固有の値を持ちます。この値は、各イベント用に定義されている固有の名前のようなものです。この値は、最初のパラメーターに使用します。

• 2 つ目は、イベント応答関数の名前です。 関数名をパラメーターとして渡す場合は、括弧なしで記述します。

次に、イベントリスナーを作成するときに発生するプロセスの詳しい手順を説明します。 この例では、 myButton という名前のオブジェクトをクリックしたときに呼び出されるリスナー関数を作成します。

プログラマーが作成する実際のコードは次のとおりです。

function eventResponse(event:MouseEvent):void 
{ 
    // Actions performed in response to the event go here. 
} 
 
myButton.addEventListener(MouseEvent.CLICK, eventResponse);

実行時のこのコードの実際の機能を次に示します。

1. SWF ファイルがロードされると、コンピューターは、 eventResponse() という名前の関数があることを認識します。

   フルサイズのグラフィックを表示

2. 次に、コンピューターはコード（具体的には、関数に含まれないコード行）を実行します。この場合は、1 行だけのコードです。イベントソースオブジェクト（ myButton ）で addEventListener() メソッドを呼び出し、 eventResponse 関数をパラメーターとして渡します。

   フルサイズのグラフィックを表示

   myButton の内部には、その各イベントを監視する関数のリストがあります。その addEventListener() メソッドが呼び出されると、 myButton が eventResponse() 関数をそのイベントリスナーのリストに保存します。

   フルサイズのグラフィックを表示

3. ある時点で、ユーザーが myButton オブジェクトをクリックし、その click イベント（コードで MouseEvent.CLICK と識別される）をトリガーします。

   

   その時点で、以下の処理が行われます。

   1. 対象のイベントに関連付けられたクラスのインスタンスとなるオブジェクトが作成されます（この例では MouseEvent）。多くのイベントでは、このオブジェクトは Event クラスのインスタンスです。マウスイベントでは、MouseEvent インスタンスです。その他のイベントでは、そのイベントに関連付けられたクラスのインスタンスです。作成されるこのオブジェクトはイベントオブジェクトと呼ばれ、ここには、イベントのタイプ、発生場所、その他のイベント固有の情報など、発生したイベントに関する固有の情報が含まれます。

      フルサイズのグラフィックを表示

   2. 次に、コンピューターは myButton に格納されているイベントリスナーのリストを参照します。この関数を 1 つずつ確認し、各関数を呼び出し、イベントオブジェクトをパラメーターとして関数に渡します。 eventResponse() 関数は myButton のリスナーの 1 つなので、このプロセスの一環として、コンピューターは eventResponse() 関数を呼び出します。

      フルサイズのグラフィックを表示

   3. eventResponse() 関数が呼び出されると、その関数のコードが実行されるので、指定したアクションが実行されます。

      フルサイズのグラフィックを表示

ここでは、イベント処理コードの具体例をいくつか紹介します。これらの例は、イベント処理コードの作成に際し、共通のイベント要素とそのバリエーションを考えるときに参考になります。

• ボタンをクリックして、現在のムービークリップの再生を開始。 次の例では、 playButton はボタンのインスタンス名であり、 this は「現在のオブジェクト」を意味する特別な名前です。

  this.stop(); 
   
  function playMovie(event:MouseEvent):void 
  { 
      this.play(); 
  } 
   
  playButton.addEventListener(MouseEvent.CLICK, playMovie);

• テキストフィールドへの入力の検出。 この例では、 entryText はテキスト入力フィールド、 outputText はダイナミックテキストフィールドです。

  function updateOutput(event:TextEvent):void 
  { 
      var pressedKey:String = event.text; 
      outputText.text = "You typed: " + pressedKey; 
  } 
   
  entryText.addEventListener(TextEvent.TEXT_INPUT, updateOutput);

• ボタンをクリックして URL に移動。 この場合、 linkButton はボタンのインスタンス名です。

  function gotoAdobeSite(event:MouseEvent):void 
  { 
      var adobeURL:URLRequest = new URLRequest("http://www.adobe.com/"); 
      navigateToURL(adobeURL); 
  } 
   
  linkButton.addEventListener(MouseEvent.CLICK, gotoAdobeSite);