例 9.1. ウィンドウの作成

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

    ...

    // ウィンドウのインスタンを生成する
    if ((window = SFZWindow::NewInstance(&error)) != null) {
        // ウィンドウの親レスポンダをアプリケーションクラス(USRApplication)に設定する
        error = window->SetParent(GetThis());
        if (error == SFERR_NO_ERROR) {
            // ウィンドウの実領域を携帯電話画面から(10, 10)だけ Deflate した矩形に設定する
            window->SetRealBound(window->GetSuitableBound(GetLocalBound().Deflate(10, 10)));
            // ウィンドウの状態を「可視＋活性＋操作可能＋フォーカス」にまとめて設定する
            window->SetState(true, true, true, true);
            // ウィンドウを最前面に配置する
            window->ToFront();
        }
    }

    ...
}

	ウィンドウの作成に必要な処理
	SFZWindow::NewInstance 関数を呼び出してウィンドウ(SFZWindow)のインスタンスを生成します。 SFYResponder::SetParent 関数を呼び出して既に配置されているレスポンダを親レスポンダとして設定します。 SFYResponder::SetRealBound 関数を呼び出して親レスポンダのローカル領域内での自レスポンダの実領域を設定します。 SFYResponder::SetState 関数を呼び出して自レスポンダの状態を設定します。 SFYResponder::ToFront 関数を呼び出して子レスポンダと一緒に自レスポンダを最前面に配置します。

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

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

SFCError USRApplication::MakeButtonControl(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);

...

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


// ボタンコントロール button のハンドラ OnResult の実装
XANDLER_IMPLEMENT_VOIDRESULT(USRApplication, OnResult, invoker, reason, result)
{
    // デバッグウィンドウに "button was pushed." と表示する
    TRACE("button was pushed.");
    return;
}

	ハンドラの登録と実装
	ボタンコントロールが操作されると、結果イベントが発生するので、 SFYApplication::RegisterHandler 関数を利用して結果イベントのハンドラをボタンコントロールに登録します。 結果イベントのハンドラは、XANDLER_DECLARE_VOIDRESULT マクロを利用して実装します。