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

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

    return;
}

	HandleRenderRequest 関数について
	HandleRenderRequest 関数を利用して描画処理を実装すれば、 描画ハンドラの登録などが省略可能です。 上の例では、OnRenderRequest 描画ハンドラを定義・実装・登録していますが、 一般的には、描画処理は SFYWidget::HandleRenderRequest 関数をオーバーライドして実装します。 詳細は、描画ハンドラの解説を参照してください。

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

// 描画ハンドラの登録
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.28. 描画ハンドラの実装

// 描画ハンドラの実装
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.29. HandleRenderRequest 関数をオーバーライドして実装する方法

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

例 9.30. SFYApplication::HandleEvent 関数の実装

// BREW イベントを受信したときに呼び出される仮想関数
/*protected virtual */Bool SFYApplication::HandleEvent(SFXEventConstRef event)
{
    // ここに BREW 環境から受信した各種イベントの分岐処理を記述する

    SFCError  error;
    Bool      result(false);

    // 配信エンジンを起動し、トレーサを使用してイベントを配信する
    // イベントを最初に受信するのはルートに関連付けられた SFYDistributer インスタンス
    // その後、トレーサの配信規則に基づいてルートを頂点とするレスポンダツリー上のレスポンダにイベントは配信される
    // ※_root はルート(SFZRoot)
    if ((error = _root->Distribute(event, &result)) == SFERR_NO_ERROR) {

        if (result) { // ※result 引数には、イベントの配信結果が格納されている

            if (IsRenderable()) { // 画面を再描画しても良い場合（優先的イベントハンドラが登録されていない場合）

                // 描画エンジンを起動し、画面を再描画する
                error = _root->Render();
        }
    }
    if (error != SFERR_NO_ERROR) {

        // 配信エンジンや描画エンジンの起動時にメモリ不足などの致命的エラーが発生した場合、HandleError() を呼び出す
        if (HandleError(event, error)) {

            result = true;
        }
    }

    return result; // イベントを処理したときは true を返し, そうでないときは false を返す

}// SFYApplication::HandleEvent //

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

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

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

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.32. SFYApplication::HandleRender 関数の実装

// 全画面の再描画が必要なときに呼び出される仮想関数
/*protected virtual */Bool SFYApplication::HandleRender(SFXEventConstRef event)
{
    // ここにアプリ開始時とレジューム時の全画面の再描画処理を記述する

    SFCError  error;
    Bool      result(false);

    if (IsRenderable()) { // 画面が再描画可能なら(優先的イベントハンドラが登録されていないなら)

        // 全画面を再描画する [ Render() の引数に "true" が指定されているため ]
        // ※_root はルート(SFZRoot)
        if ((error = _root->Render(true)) == SFERR_NO_ERROR) {

            result = true;
        }

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

            result = true;
        }
    }

    return result; // 全画面を再描画したときは true を返し, そうでないときは false を返す

}// SFYApplication::HandleRender //

参照: SFYResponder::Render | SFCApplication::HandleRender | SFCApplication::IsRenderable | SFCApplication::HandleError | SFZRoot | ルート

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