例 9.24. SFYApplication::HandleEvent 関数の内部実装

// アプリが BREW 環境からイベントを受信したときに呼び出される関数
/*protected virtual */Bool SFYApplication::HandleEvent(SFXEventConstRef event)
{
    SFCError  error;
    Bool      result(false);

    // 配信エンジンを起動してイベントを配信する
    // ※ イベントは最初にルートに関連付けられた SFYDistributer インスタンスに配信される
    //    その後、トレーサの配信規則に基づいてルート以下のレスポンダツリーに配信される
    if ((error = _root->Distribute(event, &result)) == SFERR_NO_ERROR) {
        // （_root はルート、result 引数にはイベントの処理結果が格納される）

        if (event.GetType() != SFEVT_APP_STOP & event.GetType() != SFEVT_APP_SUSPEND)) {  
            // 再描画が必要な場合

            if (IsRenderable()) {  // 優先的イベントハンドラが登録されていない場合

                // 描画エンジンを起動してルート以下のレスポンダツリーを再描画する
                error = _root->Render();
            }
        }
    }
    if (error != SFERR_NO_ERROR) {
        // 配信エンジンや描画エンジンの起動時にメモリ不足などの致命的エラーが発生した場合

        if (HandleError(event, error)) {

            result = true;
        }
    }
    if ((event.GetType() == SFEVT_APP_SUSPEND) & IsRendererIntermissive()) {
        // サスペンド時に描画エンジン内部のデバイス画面保存用ビットマップを解放する場合

        // 描画エンジンを終了する
        _renderer.Terminate();
    }
    return result; // イベントを処理したときは true を返し, そうでないときは false を返す

}// SFYApplication::HandleEvent //

参照: SFYApplication::HandleEvent | SFCApplication::HandleError | SFYResponder::Distribute | SFYResponder::Render | SFCApplication::IsRenderable | SFYApplication::IsRendererIntermissive | SFZRoot | ルート | トレーサ | 配信エンジン | 描画エンジン | 描画ハンドラ | イベントループ

例 9.25. トレーサへの配信規則の登録

USRResponder::USRResponder(Void) static_throws
{
    if (static_try()) {

        // ...（省略）...

        static_throw(RegisterTracer(
            SFXEventRange(SFEVT_KEY, SFEVT_KEY, AVK_SOFT1, AVK_SOFT4),
            SFYTracer::ORDER_FORWARD, SFYTracer::STATE_ALL, false
        ));

        // ...（省略）...
    }
}

	Tip
	配信規則は SFYResponder::RegisterTracer / SFYDistributer::RegisterTracer 関数を使用してトレーサに登録します。

例 9.26. ハンドラの登録

USRResponder::USRResponder(Void) static_throws
{
    if (static_try()) {

        // ...（省略）...

        static_throw(RegisterHandler(
            SFXEventRange(SFEVT_KEY, SFEVT_KEY, SFP16_BEGIN, SFP16_END),
            XANDLER_INTERNAL(OnKey)
        ));

        // ...（省略）...
    }
}

例 9.27. ハンドラの実装

XANDLER_IMPLEMENT_BOOLEVENT(USRResponder, OnKey, invoker, event)
{
    switch (event.GetP16()) {

        case AVK_SELECT:

            TRACE("select key was pressed.");
            return true;

        case AVK_CLR:

            TRACE("clear key was pressed.");
            return true;

        default:

            TRACE("unknown key was pressed.");
            return true;
    }

    return false;
}

	重要
	ハンドラは、イベントを処理したときは true、 しなかったときは false を返すように実装します。 イベントループ内の処理で 1 つ以上のハンドラが true を返した場合、 レスポンダシステムは SFYResponder::Render 関数を呼び出して描画エンジンを起動し、 再描画を行います。 参照: SFYApplication::HandleEvent 関数の内部実装