Object.ClearEventメソッド

説明

イベントキューからイベントを削除します。

大量のイベントが発生すると、イベントキュー内のイベントをすべて処理するまでに時間がかかる場合があります。

そのような場合に、このメソッドを使用しイベントキューからイベントを削除することで、処理を素早く中断させることができます。

イベントに関する詳細はイベントとイベントハンドラを参照してください。

呼出形式

obj.ClearEvent( ev )

戻り値

なし

引数

Event ev

送付するユーザ定義イベントのEventオブジェクト

またはシステム定義イベント名

例外

なし

使用例

/* イベントを大量に発生させる */
for (var i = 0; i < 10000; i++) {
    /* ユーザ定義イベント */
    PostEvent(new Event(UserEvent + 1, "AppEvent1"));
     
    /* システム定義イベント */
    PostEvent(Touch);
}
 
Function OnAppEvent1(e) {
    print("AppEvent1\n");
}
Function OnTouch(e) {
    print("Touch\n");
}
Button btnClear{
    X = 10;
    Y = 10;
    Title = "イベントをクリア";
    TapEventMode = Object.POST_FRONT;
    Function OnTouch(e) {
        /* ユーザ定義イベント */
        ^.ClearEvent(new Event(UserEvent + 1, "AppEvent1"));
        /* システム定義イベント */
        ^.ClearEvent(Touch);
    }
}

関連項目

PostEventメソッド

Eventクラス