AS3のEventメタデータタグは何のためにあるの？

にこ　らす @Nicol_as

eventメタデータタグが何のためにあるのか、いまいちわかってない。ので使ったことない…

ザーヒル🍹👑⚖🍶👿 @zahir1929

@Nicol_as addEventListenerの入力補完ようですかね？

にこ　らす @Nicol_as

@zahir1929 FlashBuilder限定の話ですか？

ザーヒル🍹👑⚖🍶👿 @zahir1929

@Nicol_as FBしか使ってませんがFDでも行けたはずです。IDEとかその他はわかりません

にこ　らす @Nicol_as

@zahir1929 FDでは(FBでも？)、メタデータタグにしなくても「 addEventListener( 」と打った後には色々なEvent定数が補完候補として出ると思うのですが、それとの違いがよく分からないんです。

柊 @Hiiragi3

@nicol_as 主にMXMLタグでイベントを扱う時に重要ですねー。あとはFlashDevelopでもEventメタデータタグ書いておくと、そのクラスへのaddEventListenerの時にコードヒントに追加で出てきますよ。

柊 @Hiiragi3

あとはASDoc吐き出す時に、Eventメタデータタグに反応して対応するイベントが書き出されるから、それでも必要ですね。

ton @ton1517

@Nicol_as ASDocのためじゃないかな

にこ　らす @Nicol_as

@Hiiragi3 @ton1517 ASDocでも必要になるんですね！ありがとうございます！

にこ　らす @Nicol_as

@Hiiragi3 ありがとうございます。MXMLで必要になるのですね。コードヒントが出るとのことですが、ためしにMinimalCompsのComponentクラス("draw"が定義されている)のインスタンスにaddEventListenerしてみたところ補完は出ませんでした…

ザーヒル🍹👑⚖🍶👿 @zahir1929

@Nicol_as 自分でクラスとかカスタムイベントを作った時にはメタタグつけないと出なくないです？

bkzen @bkzen

@Nicol_as たぶんそれは Sprite等(EventDispatcherのサブクラス)の場合では？ 単純に EventDispatcher を new して addEventListener( をやっても ACTIVATE/DEACTIVATE くらいしか出てこないはず。

にこ　らす @Nicol_as

@Hiiragi3 @zahir1929 @bkzen もしかしたら理解できたかも知れません…。いつもaddEventListenerのあとにカスタムイベント定数を呼び出す際は、自分でカスタムイベントのクラス名を入れていたんですが、それがいらなくなるということですか？

ザーヒル🍹👑⚖🍶👿 @zahir1929

@Nicol_as 少なくとも入力補完の候補リストには表示されます

ザーヒル🍹👑⚖🍶👿 @zahir1929

@Nicol_as 例えば継承なしでIEventDispatcherを実装したクラスを作った場合はイベントタグを付けないと何一つ入力補完候補はでませんが[Event(name="complete", type="flash.events.Event")]とかすると出ます

にこ　らす @Nicol_as

@zahir1929 継承されたイベントだけが補完に出るわけですね！今調べてみたら、SpriteにaddEventListenerしたときに出る補完が、AS3リファレンスのSpriteの「イベント」のリストと同じでした…

柊 @Hiiragi3

@nicol_as @zahir1929 @bkzen 多分他の方が答えられてると思いますが、そんな感じです。EventDispatcher拡張クラスにEventメタデータタグで、何かしらのイベントを定義しておくと（続く）

柊 @Hiiragi3

@nicol_as @zahir1929 @bkzen （続き）そのEventDispatcherのインスタンスにaddEventListenerしようとすると、Eventメタデータタグで関連付けたイベントがコードヒントとして出るはずです。

柊 @Hiiragi3

まぁなんにしても、スーパークラスで定義されているイベント以外のイベントをディスパッチするように作った場合は、Eventメタデータタグを入れておくと、ASDocでも反応するし、コードヒントも出るし、って感じでメリットが多いんで、特に俺俺ライブラリではつけるのをお勧めー。

にこ　らす @Nicol_as

@Hiiragi3 詳しい説明ありがとうございます。だいぶ分かってきました。もう一つお聞きしたいのですが、補完されるためには、eventメタタグのnameの値("resize"など)は、typeの値が示すクラス(Eventなど)に定数として含まれていないといけないですよね？

柊 @Hiiragi3

@nicol_as コードヒントの場合は、定数として出したいならそういうことになりますけど、入って無くても大丈夫ですよ。ただし、"hoge"みたいな感じで、Stringとして出ますけど。ASDocだと多分エラーが出そうな・・・。ちょっとそこは判らないですねー。

柊 @Hiiragi3

Stringとして出るっていうのは、addEventListener("hoge", handler);っていうことですね。Event.HOGEみたいな感じでは出ないってことです。

にこ　らす @Nicol_as

@Hiiragi3 コードヒントなら定数でなくても出るんですね。ありがとうございます！

bkzen @bkzen

Event メタデータタグに限らず、メタデータタグはクラスに対してメタデータを定義する。describeTypeとかやってみるとわかる

にこ　らす @Nicol_as

@bkzen 色々やってみましたがtrace(describeType(new EventDispatcher))とやってみたら理解できました。ここにdeactivateとactivateが定義されているのですね。