例 9.1. ウィンドウの作成

SFCError USRApplication::MakeWindow(Void)
{
    SFZWindowSmp window;
    SFCError error(SFERR_NO_ERROR);

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

    // ウィンドウのインスタンスを生成する
    if ((window = SFZWindow::NewInstance(&error)) != null) {

        // ウィンドウの親レスポンダを USRApplication アプリケーションクラスが保持するルートに設定する
        // ※SFYApplication::GetThis() により USRApplication アプリケーションクラスが保持するルートを取得する
        error = window->SetParent(GetThis());
        if (error == SFERR_NO_ERROR) {

            // ウィンドウの実領域をルートのローカル領域から (10, 10) だけ Deflate した矩形に設定する
            // ※ルートのローカル領域はデフォルトでデバイス画面領域に初期化されている
            window->SetRealBound(GetLocalBound().Deflate(10, 10));

            // ウィンドウの状態を「可視＋活性＋操作可能＋フォーカス」にまとめて設定する
            window->SetState(true, true, true, true);

            // ウィンドウを最前面に移動する
            window->ToFront();
        }
    }

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

	ウィンドウを作成する手順
	SFZWindow::NewInstance 関数を呼び出して SFZWindow のインスタンス(以下、ウィンドウ)を生成します。 SFYResponder::SetParent 関数を呼び出して、 既に配置されているレスポンダまたはアプリケーションクラス[ルート（SFZRoot）]をウィンドウの親レスポンダとして設定します。 SFYResponder::SetRealBound 関数を呼び出して親レスポンダのローカル領域にウィンドウの実領域を設定します。 SFYResponder::SetState 関数を呼び出してウィンドウの状態を設定します。 SFYResponder::ToFront 関数を呼び出して子レスポンダと一緒にウィンドウを最前面に配置します。

参照: SFZWindow | SFYResponder::GetThis | SFYResponder::GetSuitableBound | SFYResponder::GetLocalBound | SFXRectangle::Deflate

例 9.2. テキストボタンコントロールの作成

SFCError USRApplication::MakeTextButtonControl(Void)
{
    SFZWindowSmp window;
    SFZTextButtonControlSmp button;
    SFCError error(SFERR_NO_ERROR);

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

    // テキストボタンコントロールのインスタンスを生成する
    if ((button = SFZTextButtonControl::NewInstance(&error)) != null) {

        // テキストボタンコントロールの親レスポンダをウィンドウに設定する
        error = button->SetParent(window);
        if (error == SFERR_NO_ERROR) {

            // テキストボタンコントロールのラベルを "hello world" に設定する
            error = button->SetText("hello world");
            if (error == SFERR_NO_ERROR) {

                // ウィンドウのローカル領域内にテキストボタンコントロールを表示するのに最適なサイズを確保し、開始点を(10, 10)に設定する
                button->SetRealBound(button->GetSuitableBound().SetOrigin(10, 10));

                // テキストボタンコントロールの状態を「可視＋活性＋操作可能＋フォーカス」にまとめて設定する
                button->SetState(true, true, true, true);
            }
        }
    }

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

	テキストボタンコントロールの作成する手順
	SFZTextButtonControl::NewInstance 関数を呼び出して SFZTextButtonControl のインスタンス(以下、テキストボタンコントロール)を生成します。 SFYResponder::SetParent 関数を呼び出して既に配置されているレスポンダをテキストボタンコントロールの親レスポンダとして設定します。 SFZTextButtonControl::SetText 関数を呼び出してテキストボタンコントロールのラベル項目を設定します。 SFYResponder::SetRealBound 関数を呼び出して親レスポンダのローカル領域にテキストボタンコントロールの実領域を設定します。 SFYResponder::SetState 関数を呼び出してテキストボタンコントロールの状態を設定します。

	ToFront 関数
	コントロールは配置されるウィンドウやダイアログ、コンテナなどの親レスポンダが最前面に移動しない限り、 最前面に移動しません。 親レスポンダの SFYResponder::ToFront 関数を呼び出すと、 親レスポンダと一緒に子レスポンダであるコントロールも自動的に最前面に移動します。

参照: SFZWindow | SFZTextButtonControl | SFYResponder::GetSuitableBound | SFXRectangle::SetOrigin

例 9.3. テキストボタンコントロールの使い方

SFZTextButtonControlSmp button;
SFCError error(SFERR_NO_ERROR);

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

// テキストボタンコントロールに OnResult 結果ハンドラを登録する
error = button->RegisterHandler(
    SFXEventRange(SFEVT_RESPONDER_RESULT, SFEVT_RESPONDER_RESULT, SFP16_BEGIN, SFP16_END),
    XANDLER_INTERNAL(OnResult)
);

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


// OnResult 結果ハンドラの実装
XANDLER_IMPLEMENT_VOIDRESULT(USRApplication, OnResult, invoker, reason, result)
{
    // デバッグウィンドウに "Text button control has been pushed." と表示する
    TRACE("Text button control has been pushed.");

    return;
}

	結果ハンドラの登録と実装
	SFYResponder::RegisterHandler 関数を使用して結果イベントのハンドラ(結果ハンドラ)をテキストボタンコントロールに登録します。 結果イベントを受信するハンドラ（結果ハンドラ）は XANDLER_IMPLEMENT_VOIDRESULT マクロを利用して実装します。 ※操作されると、テキストボタンコントロールは結果イベントを受信します。