AsBroadcaster


Object
    |
    +-AsBroadcaster

public class AsBroadcaster
extends Object

このクラスには、ユーザー定義オブジェクトに追加可能なイベント通知機能とリスナー管理機能があります。このクラスは、独自のイベント処理メカニズムを作成する上級ユーザー向けです。このクラスを使用すると、任意のオブジェクトをイベントブロードキャスターにすることができます。また、ブロードキャストオブジェクトが broadcastMessage() メソッドを呼び出したときにいつでも通知を受信するリスナーオブジェクトを作成できます。

AsBroadcaster クラスにはコンストラクタ関数がありません。このクラスを使用するには、次に示すプロセスに従います。

イベントブロードキャスターとして機能するオブジェクトを選択または作成します。
静的な AsBroadcaster.initialize(obj:Object) メソッドを呼び出すことでオブジェクトをイベントブロードキャスターにします。ここで、obj パラメータはブロードキャスターにするオブジェクトの名前です。
リスナーオブジェクトを選択または作成します。リスナーオブジェクトは、ブロードキャストオブジェクトがメッセージをブロードキャストするといつでも通知を受信します。
リスナーオブジェクトごとにリスナーメソッドを定義します。リスナーメソッドは、イベント通知に応答して ActionScript を実行します。メソッドの名前は、ブロードキャストオブジェクトからブロードキャストされるイベントの名前と一致させる必要があります。
myBroadcaster.addListener(myListener) を呼び出すことで各リスナーオブジェクトをイベントブロードキャスターに登録します。ここで、myBroadcaster はイベントブロードキャスターオブジェクトの名前であり、myListener はリスナーオブジェクトの名前です。各イベントブロードキャスターは、メッセージをブロードキャストするときの通知先リスナーオブジェクトのリストを格納します。リスナーをリストに追加するには addListener() メソッドを使用し、リストからリスナーを削除するには removeListener() メソッドを使用します。
最後に、メッセージをブロードキャストするために、myBroadcaster.broadcastMessage(eventName:String) メソッドを呼び出します。ここで、myBroadcaster はイベントブロードキャスターの名前であり、eventName は、リスナーメソッドの名前に一致するイベントの名前です。

メモ : AsBroadcaster の 2 番目の文字を大文字にするというミスが起こりやすくなっています。AsBroadcaster.initialize() メソッドを呼び出すときには、2 番目の文字が小文字になっていることを確認してください。AsBroadcaster のスペルを間違えると、警告なしに失敗します。

使用できるバージョン : ActionScript 1.0、Flash Player 6

プロパティ一覧

オプション	プロパティ	説明
	`_listeners:Array` (読み取り専用)	すべての登録済みリスナーオブジェクトへの参照リストです。

Object クラスから継承されるプロパティ

constructor (Object.constructor プロパティ), __proto__ (Object.__proto__ プロパティ), prototype (Object.prototype プロパティ), __resolve (Object.__resolve プロパティ)

メソッド一覧

オプション	署名	説明
	`addListener(listenerObj:Object) : Boolean`	イベント通知メッセージを受信するオブジェクトを登録します。
	`broadcastMessage(eventName:String) : Void`	リスナーリストに含まれる各オブジェクトにイベントメッセージを送信します。
`static`	`initialize(obj:Object) : Void`	指定されたオブジェクトにイベント通知機能とリスナー管理機能を追加します。
	`removeListener(listenerObj:Object) : Boolean`	イベント通知メッセージを受信するオブジェクトのリストからオブジェクトを削除します。

Object クラスから継承されるメソッド

addProperty (Object.addProperty メソッド), hasOwnProperty (Object.hasOwnProperty メソッド), isPropertyEnumerable (Object.isPropertyEnumerable メソッド), isPrototypeOf (Object.isPrototypeOf メソッド), registerClass (Object.registerClass メソッド), toString (Object.toString メソッド), unwatch (Object.unwatch メソッド), valueOf (Object.valueOf メソッド), watch (Object.watch メソッド)

Comments

ニックネームなしが Mar 30, 2006 の 8:36 PM に追加:

メモ代わりのサンプル。
空のMCを作成し、そのMCからイベントをブロードキャストしています。

var caster = this.createEmptyMovieClip("caster", 1);
AsBroadcaster.initialize(caster);

var listener = {};
listener.onSays = function(msg) {
trace("Caster says: " + msg);
}

caster.i = 0;
caster.onEnterFrame = function() {
if ((this.i++ % 20) == 0) {
this.broadcastMessage("onSays", "Hello listener");
}
}
caster.addListener(listener);

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

現在のページ: http://livedocs.adobe.com/flash/8_jp/main/00001921.html