例 9.80. 宣言

SFMTYPEDEFCLASS(USRApplication)
class USRApplication: public SFYApplication {
    SFMSEALCOPY(USRApplication)
private:
    SFZTextMenuSmp _menu;

    // ...（省略）...
private:
    SFCError Make(Void);

    // 結果イベントを受信するハンドラ
    XANDLER_DECLARE_VOIDRESULT(OnResult)
};

例 9.81. 実装

SFCError USRApplication::Make(Void)
{
    SFXRectangle rectangle;
    SInt16 i;
    SFCError error(SFERR_NO_ERROR);

    if ((_menu = SFZTextMenu::NewInstance(&error)) != null) {
        error = _menu->SetParent(GetThis());
        if (error == SFERR_NO_ERROR) {

            // メニューに結果ハンドラを登録する
            error = _menu->RegisterHandler(
                SFXEventRange(SFEVT_RESPONDER_RESULT, SFEVT_RESPONDER_RESULT, SFP16_BEGIN, SFP16_END),
                XANDLER_INTERNAL(OnResult)
            );
            if (error == SFERR_NO_ERROR) {

                // メニュータイトルを設定する
                // SFXWideString オブジェクトの設定 (※リソースファイルから設定することも可能)
                error = _menu->SetTitle("Text Menu");
                if (error == SFERR_NO_ERROR) {
                    for (i = 0; i < 3; ++i) {

                        // 項目を追加する
                        // SFXWideString オブジェクトの設定 (※リソースファイルから設定することも可能)
                        error = _menu->InsertLast(SFXWideString::Format("Menu item %d", i));

                        if (error != SFERR_NO_ERROR) break;
                    }
                    if (error == SFERR_NO_ERROR) {

                        // メニューを画面中央に配置する

                        // 画面を (10, 10) だけ縮小した領域をヒント領域にしてメニューの最適な横幅を取得し、
                        // ヘッダーと 3 つの項目を表示するための縦幅を設定した領域を画面の中央に配置し、
                        // メニューの実領域として設定する
                        _menu->SetRealBound(_menu->GetSuitableBound(GetLocalBound().Deflate(10, 10).SetHeight(_menu->GetTitleHeight() + 3 * _menu->GetItemHeight()), 
                                               SFYResponder::HORIZONTAL_CENTER, 
                                               SFYResponder::VERTICAL_MIDDLE));

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

                        // メニューを最前面に移動する
                        _menu->ToFront();
                    }
                }
            }
        }
    }

    return error;
}

// メニューの結果ハンドラの実装
XANDLER_IMPLEMENT_VOIDRESULT(USRApplication, OnResult, invoker, reason, result)
{
    SFXWideString text;

    // invoker にはメニューが渡される
    // reason には結果イベントの P16 値が渡される

    switch (reason) {

        case SFP16_RESULT_OK:  // 操作キー押下時[ SetItemEnable() により項目が有効化されている必要がある]
            
            // result には選択された項目のインデックスが渡される

            // 選択された項目のテキストを取得する
            text = _menu->GetItemText(result);

            // デバッグ表示する
            TRACE("%S", text.GetCString());

            break;

        case SFP16_RESULT_ESCAPE:  // ESCAPE キー押下時、またはScheduleTimer 関数で設定した時間が経過した時

            // result には 0 が渡される

            // メニューを閉じる
            invoker->Terminate();  
            // "_menu->Terminate();" と記述しても良い

            break;
    }

    return;
}

例 9.82. 宣言

SFMTYPEDEFCLASS(USRApplication)
class USRApplication: public SFYApplication {
    SFMSEALCOPY(USRApplication)
private:
    SFZGridMenuSmp _menu;

    // ...（省略）...
private:
    SFCError Make(Void);

    // 結果イベントを受信するハンドラ
    XANDLER_DECLARE_VOIDRESULT(OnResult)
};

例 9.83. 実装

SFCError USRApplication::Make(Void)
{
    SFBShellSmp shell;
    SFBImageSmp image;
    SFBImageSmp selectedImage;
    SInt16 i;
    SFCError error(SFERR_NO_ERROR);

    if ((_menu = SFZGridMenu::NewInstance(&error)) != null) {
        error = _menu->SetParent(GetThis());
        if (error == SFERR_NO_ERROR) {

            // メニューに結果ハンドラを登録する
            error = _menu->RegisterHandler(
                SFXEventRange(SFEVT_RESPONDER_RESULT, SFEVT_RESPONDER_RESULT, SFP16_BEGIN, SFP16_END),
                XANDLER_INTERNAL(OnResult)
            );
            if (error == SFERR_NO_ERROR) {

                // メニュータイトルを設定する
                // SFXWideString オブジェクトの設定 (※リソースファイルから設定することも可能)
                error = _menu->SetTitle("Text Menu");
                if (error == SFERR_NO_ERROR) {

                    // メニュータイトルのテキストを白色に設定する
                    _menu->SetTitleForeColor(SFXRGBColor(0xFF, 0xFF, 0xFF, 0x00));

                    // メニュータイトルの背景を水色に設定する
                    _menu->SetTitleBackColor(SFXRGBColor(0x00, 0xBF, 0xF3, 0x00));

                    // 行の数と列の数を設定する
                    _menu->SetRowCol(4, 3);

                    // SFBShell インスタンスを取得する
                    shell = SFBShell::GetInstance();
                    if (shell != null) {

                        for (i = 0; i < 12; ++i) {

                            // リソースファイルと ID から項目イメージを取得する
                            image = shell->LoadResImage(NEWWORLD_RES_FILE, IDI_OBJECT_5001 + i);

                            // 選択時の項目イメージを取得する
                            selectedImage = shell->LoadResImage(MENU_RES_FILE, IDI_OBJECT_5001 + i);

                            // 項目を追加する
                            // SFXWideString オブジェクトの設定 (※リソースファイルから設定することも可能)
                            error = _menu->InsertLast(SFXWideString::Format("%d", i), image, selectedImage);

                            if (error != SFERR_NO_ERROR) break;
                        }

                        if (error == SFERR_NO_ERROR) {

                            // 項目名を表示するようにする
                            _menu->SetDrawItemText(true);

                            // メニューの実領域を画面全体に設定する
                            _menu->SetRealBound(GetLocalBound());

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

                            // メニューを最前面に移動する
                            _menu->ToFront();
                        }
                    }
                }
            }
        }
    }

    return error;
}

// メニューの結果ハンドラの実装
XANDLER_IMPLEMENT_VOIDRESULT(USRApplication, OnResult, invoker, reason, result)
{
    // invoker にはメニューが渡される
    // reason には結果イベントの P16 値が渡される

    switch (reason) {

        case SFP16_RESULT_OK:  // 操作キー押下時
            
            // result には選択された項目のインデックスが渡される

            // 選択された項目のインデックスをデバッグ表示する
            TRACE("%d", result);

            break;

        case SFP16_RESULT_ESCAPE:  // ESCAPE キー押下時、またはScheduleTimer 関数で設定した時間が経過した時

            // result には 0 が渡される

            // メニューを閉じる
            invoker->Terminate();  
            // "_menu->Terminate();" と記述しても良い

            break;
    }

    return;
}

例 9.84. 宣言

SFMTYPEDEFRESPONDER(USRMenu)
class USRMenu: public SFYMenu {
    SFMSEALRESPONDER(USRMenu)
    SFMRESPONDERINSTANTIATETHREE(USRMenu, SFYMenu, SFYWidget, SFYResponder)
public:

    // レスポンダのタイプを定義する
    // 小文字と記号のみからなるタイプは予約されているので使えない
    enum CodeEnum {
        CODE_TYPE = four_char_code('U', 'M', 'N', 'U')
    };
    SFMTYPEDEFTYPE(CodeEnum)

public:
    static USRMenuSmp NewInstance(SFCErrorPtr exception = null);
protected:
    explicit USRMenu(Void) static_throws;
    virtual ~USRMenu(Void);

    // 親クラスで定義されている仮想関数のうち、実装が推奨される仮想関数
    virtual Void HandleOperateKey(Void);
    virtual Void HandleSelectUpKey(Void);
    virtual Void HandleSelectDownKey(Void);
    virtual Void HandleBoundRequest(SFXRectanglePtr rectangle) const;
    virtual Void HandleBoundOptimize(SFXRectanglePtr rectangle) const;
    virtual Void HandleBoundReal(Void);
    virtual Void HandleBoundVirtual(Void);
    virtual Void HandleRenderRequest(SFXGraphicsPtr graphics) const;
};

例 9.85. 実装

USRMenu::USRMenu(Void) static_throws
{
    if (static_try()) {

        // レスポンダのタイプを設定する
        SetType(CODE_TYPE);

        // 初期化処理を記述する
    }
}

USRMenu::~USRMenu(Void)
{
    // 終了処理を記述する
}

USRMenuSmp USRMenu::NewInstance(SFCErrorPtr exception)
{
    return static_pointer_cast<USRMenu>(Factory(::new USRMenu, exception));
}

Void USRMenu::HandleOperateKey(Void)
{
    // 操作キー押下時に必要な処理があれば、ここに記述する
    // 通常、以下のようにイベントを送信する
    // _select 変数は選択されている項目の番号を表すものとする
    InvokeForward(SFXEvent(SFEVT_RESPONDER_RESULT, SFP16_RESULT_OK, _select), false);

    return;
}

Void USRMenu::HandleSelectUpKey(Void)
{
    // 上キー押下時に必要な処理があれば、ここに記述する
    // 例：選択されている項目を 1 つ戻すなど

    return;
}

Void USRMenu::HandleSelectDownKey(Void)
{
    // 下キー押下時に必要な処理があれば、ここに記述する
    // 例：選択されている項目を 1 つ進めるなど

    return;
}

Void USRMenu::HandleBoundRequest(SFXRectanglePtr rectangle) const
{
    // メニューに最適な大きさを計算して rectangle パラメータに設定する
    // この関数内では、rectangle の原点は変更せず、rectangle のサイズだけを設定する(推奨)

    return;
}

Void USRMenu::HandleBoundOptimize(SFXRectanglePtr rectangle) const
{
    // メニューに最適な大きさを rectangle パラメータ内の大きさに
    // 収まるように計算し、rectangle パラメータに設定する
    // この関数内では、rectangle の原点は変更せず、rectangle のサイズだけを設定する(推奨)

    return;
}

Void USRMenu::HandleBoundReal(Void)
{
    // 実領域が変更された場合に再計算が必要なものがあれば、ここに記述する

    return;
}

Void USRMenu::HandleBoundVirtual(Void)
{
    // 仮想領域が変更された場合に再計算が必要なものがあれば、ここに記述する

    return;
}

Void USRMenu::HandleRenderRequest(SFXGraphicsPtr graphics) const
{
    // メニューを描画する

    return;
}