例 9.68. 宣言

SFMTYPEDEFCLASS(USRApplication)
class USRApplication : public SFYApplication {
    SFMSEALCOPY(USRApplication)
private:

    SFZTitleBevelFrameSmp _frame;
    SFZMessageDialogSmp _dialog;

    //  ...

private:
    SFCError MakeFrame(Void);
    SFCError MakeDialog(Void);


    // ダイアログ選択結果イベントのハンドラ
    XANDLER_DECLARE_VOIDRESULT(OnResult)
};

例 9.69. 実装

// フレームの作成
SFCError USRApplication::MakeFrame(Void)
{
    SFCError error(SFERR_NO_ERROR);

    // タイトル付きベベルフレームの生成(フレームの種類によってデザインが異なる)
    // 他のフレームについても同様にしてウィンドウやダイアログに枠組みを設定できる
    if ((_frame = SFZTitleBevelFrame::NewInstance(&error)) != null) {

        // ※注意１：フレームの親をルートに設定する
        error = _frame->SetParent(GetThis());
        if (error == SFERR_NO_ERROR) {

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

            // その他フレームの設定
            //  ...
        }
    }
    if ( error == SFERR_NO_ERROR) {

        // フレーム付きダイアログを作成し表示する
        error = MakeDialog();
    }

    return error;
}

// フレーム付きダイアログの作成と表示
SFCError USRApplication::MakeDialog(Void)
{
    SFXRectangle rectangle;
    SFXMargin margin;
    SFCError error(SFERR_NO_ERROR);

    // ダイアログの生成
    if ((_dialog = SFZMessageDialog::NewInstance(&error)) != null) {

        // ※注意２：ダイアログの親レスポンダをフレームにする
        error = _dialog->SetParent(_frame);
        if (error == SFERR_NO_ERROR) {

            // ダイアログ選択結果イベントを処理するハンドラを登録する
            error = _dialog->RegisterHandler(
                           SFXEventRange(SFEVT_RESPONDER_RESULT, SFEVT_RESPONDER_RESULT, SFP16_BEGIN, SFP16_END),
                           XANDLER_INTERNAL(OnResult)
            );
            if (error == SFERR_NO_ERROR) {

                // メッセージ部分に表示するテキストを設定する
                error = _dialog->SetMessageText("in\nSFZTitleBevelFrame\n\nThis is a notification message.");
                if (error == SFERR_NO_ERROR) {

                    // OK ボタン部分に表示するテキストを設定する
                    error = _dialog->SetButtonText("OK");

                    if (error == SFERR_NO_ERROR) {

                        // フレームのタイトルを設定する
                        error = _frame->SetText("SFZTitleBevelFrame");

                        if (error == SFERR_NO_ERROR) {

                            // ダイアログに合ったフレームのサイズを計算する

                            // フレームの余白(影、枠、ベベル枠、ヘッダー)を取得する
                            margin.Set(_frame->GetSuitableMargin());

                            // ダイアログの最適な領域のサイズを計算する
                            rectangle.Set(_dialog->GetSuitableBound(GetLocalBound().Deflate(10, 10).Deflate(margin)));

                            // ダイアログにフレームの余白を付けてフレームの実領域のサイズを計算する
                            rectangle.Inflate(margin);

                            // フレームの実領域を画面中央に設定する
                            rectangle.SnapCenterMiddle(GetLocalBound().GetCenterMiddle());
                            _frame->SetRealBound(rectangle);

                            // ダイアログをフレームの中に配置する
                            _dialog->SetRealBound(_frame->GetLocalBound().Deflate(margin));

                            // ダイアログの状態を「可視＋活性＋操作可能＋フォーカス」にまとめて設定する
                            _dialog->SetState(true, true, true, true);

                            // ダイアログを最前面に移動する

                            // ※注意３：ダイアログの親であるフレームを最前面に移動する
                            _frame->ToFront();
                        }
                    }
                }
            }
        }
    }
    return error;
}

// ダイアログ選択結果イベントを処理するハンドラ
XANDLER_IMPLEMENT_VOIDRESULT(USRApplication, OnResult, invoker, reason, result)
{
    switch (reason) {
        case SFP16_RESULT_OK:

            // OK ボタン押下時、または操作キー押下時に受信され、result は常に 0 となります。

            break;
        case SFP16_RESULT_ESCAPE:

            // 一定時間経過後に自動的にダイアログが閉じられる場合、またはクリアキー押下時に受信され、result は常に 0 となります。

            break;
    }

    // フレームは親レスポンダなので、フレームを閉じるとダイアログも自動的に閉じる
    _frame->Terminate();

    return;
}

	フレームの親レスポンダ
	多くの場合、フレームの親レスポンダはアプリケーションクラス(ルート[SFZRoot])に設定します。

	フレームとウィンドウやダイアログの親子関係
	通常、フレームは枠組みを設定するウィンドウやダイアログの親レスポンダとなります。

	最前面への移動
	フレームを設定したウィンドウやダイアログは、 親レスポンダであるフレームを最前面に移動することでフレームと共に自動的に最前面に移動します。 フレームの SFYResponder::ToFront 関数の呼び出しは必須です。 ウィンドウやダイアログだけを最前面に移動した場合、 フレームが他のレスポンダに隠れて表示されない可能性があります。 複数のウィンドウやダイアログが同じフレームを共有している場合、 最前面に移動させたいウィンドウまたはダイアログの SFYResponder::ToFront 関数も呼び出します。

	フレーム付きのウィンドウやダイアログの閉じ方
	ウィンドウやダイアログだけを閉じても親レスポンダであるフレームが残ってしまうので、 フレームを不可視状態にするか、 親レスポンダであるフレームを閉じることでウィンドウやダイアログをも自動的に閉じるようにします。