例 9.28. 再描画領域の登録と再描画

// 描画ハンドラの登録
USRResponder::USRResponder(Void) static_throws
{
    if (static_try()) {

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

        // 描画ハンドラを登録する
        static_throw(RegisterHandler(
            SFXEventRange(SFEVT_RESPONDER_RENDER, SFEVT_RESPONDER_RENDER, SFP16_RENDER_REQUEST, SFP16_RENDER_REQUEST),
            XANDLER_INTERNAL(OnRenderRequest)
        ));

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

    }
}

// 再描画領域の登録
Void USRResponder::SetText(SFXAnsiStringConstRef param)
{
    SFCError error(SFERR_NO_ERROR);

    if (!param.equals(_text)) {

        if ((error = _text.Set(param)) == SFERR_NO_ERROR) {

            Invalidate(); // 再描画領域を登録する
        }
    }

    return error;
}

// 描画ハンドラ: ラベルテキストの描画
XANDLER_IMPLEMENT_VOIDRENDER(USRResponder, OnRenderRequest, invoker, reason, graphics)
{
    // ラベルテキストを描画する
    graphics->DrawSingleText(_text, GetLocalBound(), SFXRGBColor(0x00, 0x00, 0x00, 0x00));

    return;
}

// ※ 以下のように HandleRenderRequest 関数をオーバーライドして描画処理を実装することも可能
//    この場合、USRResponder::OnRenderRequest 関数は不要になる
Void USRResponder::HandleRenderRequest(SFXGraphicsPtr graphics) const
{
    // ラベルテキストを描画する
    graphics->DrawSingleText(_text, GetLocalBound(), SFXRGBColor(0x00, 0x00, 0x00, 0x00));

    return;
}

	HandleRenderRequest 関数について
	SFYWidget::HandleRenderRequest 関数をオーバーライドして描画処理を記述すれば、 描画ハンドラの登録を省略できます。 詳細は、描画ハンドラの解説を参照してください。

例 9.29. 描画ハンドラの登録

// 描画ハンドラの登録
USRResponder::USRResponder(Void) static_throws
{
    if (static_try()) {

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

        static_throw(RegisterHandler(
            SFXEventRange(SFEVT_RESPONDER_RENDER, SFEVT_RESPONDER_RENDER, SFP16_RENDER_REQUEST, SFP16_RENDER_REQUEST),
            XANDLER_INTERNAL(OnRenderRequest)
        ));

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

    }
}

	Tip
	描画ハンドラは、SFYResponder::RegisterHandler 関数を使用して登録します。

例 9.30. 描画ハンドラの実装

// 描画ハンドラの実装
XANDLER_IMPLEMENT_VOIDRENDER(USRResponder, OnRenderRequest, invoker, reason, graphics)
{
    // "Hello World" を中央に黒色で描画する
    graphics->DrawSingleText("Hello World", 
                              GetLocalBound(), 
                              SFXRGBColor(0x00, 0x00, 0x00, 0x00));
    return;
}

	Tip
	描画ハンドラは、 graphics 引数（SFXGraphics） を使用してレスポンダのローカル領域を描画します。

例 9.31. HandleRenderRequest 関数をオーバーライドして実装する方法

// HandleRenderRequest 関数を利用した描画処理の実装
Void USRResponder::HandleRenderRequest(SFXGraphicsPtr graphics) const
{
    // "Hello World" を中央に黒色で描画する
    graphics->DrawSingleText("Hello World", 
                              GetLocalBound(), 
                              SFXRGBColor(0x00, 0x00, 0x00, 0x00));
    return;
}

例 9.32. 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 //

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

	優先的イベントハンドラについて
	SFXEventBypass クラスの解説を参照してください。

例 9.33. コールバック内での再描画

SFCError USRResponder::OpenConnection(Void)
{
    SFCError error(SFERR_NO_ERROR);

    _label->SetText("); 

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

    error = _http.Connect(XALLBACK_INTERNAL(OnConnect));

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

    return error;
}

// http 接続完了コールバックの実装
XALLBACK_IMPLEMENT_SFXHTTPCONNECTION(USRResponder, OnConnect, error)
{
    if (error == SFERR_NO_ERROR) {

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

    }
    _label->SetText("OnConnect was called."); // Invalidate 関数は SetText 関数の内部で呼び出される
    Render(); // 明示的に描画エンジンを起動する

    return;
}

例 9.34. SFCApplication::RenderDeviceScreen 関数の内部実装

/*public */Bool SFCApplication::RenderDeviceScreen(Void)
{
    return HandleRender(SFXEvent(0, 0, 0));
}// SFCApplication::RenderDeviceScreen //

例 9.35. SFYApplication::HandleRender 関数の内部実装

// アプリ開始/再開時と優先的イベントハンドラ終了時に呼び出される仮想関数
/*protected virtual */Bool SFYApplication::HandleRender(SFXEventConstRef event)
{
    // ここに全画面（デバイス画面とルート以下のレスポンダツリー）の再描画を記述する
    SFCError  error;
    Bool      result(false);

    if (SFCApplication::HandleRender(event)) { // デバイス画面を再描画する

        // ルート以下のレスポンダツリーを再描画する
        // ※1. 可能であれば、デバイス画面保存用ビットマップを利用して高速に再描画行う
        // ※2. SFEVT_APP_START 受信時などデバイス画面保存用ビットマップが利用不可の場合は引数に true を指定して Render 関数を呼び出す（強制再描画を行う）
        error = _root->Render((event.GetType() == SFEVT_APP_START) || (_root->Recover() != SFERR_NO_ERROR));

        if (error == SFERR_NO_ERROR) {

            result = true;
        }
        else {
            // 描画エンジンの起動時にメモリ不足などの致命的エラーが発生した場合、HandleError() を呼び出す
            HandleError(event, error);
        }
    }
    return result;
}// SFYApplication::HandleRender //

参照: SFCApplication::HandleRender | SFCApplication::HandleError | SFCApplication::RenderDeviceScreen | SFYResponder::Render | SFYResponder::Recover | SFZRoot | ルート | 描画エンジン