Example 9.76. Declaration

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

    ...
private:
    SFCError Make(Void);

    // result handler which means that text menu item is selected
    XANDLER_DECLARE_VOIDRESULT(OnResult)
};

Example 9.77. Implementation

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

    // create the text menu
    if ((_menu = SFZTextMenu::NewInstance(&error)) != null) {
        error = _menu->SetParent(GetThis());
        if (error == SFERR_NO_ERROR) {

            // register the result handler to be booted up when an item of the text menu is selected
            error = _menu->RegisterHandler(
                SFXEventRange(SFEVT_RESPONDER_RESULT, SFEVT_RESPONDER_RESULT, SFP16_BEGIN, SFP16_END),
                XANDLER_INTERNAL(OnResult)
            );
            if (error == SFERR_NO_ERROR) {

                // set the text menu title
                // * SFXWideString text can be set from the resource file
                error = _menu->SetTitle("Text Menu");
                if (error == SFERR_NO_ERROR) {
                    for (i = 0; i < 3; ++i) {

                        // append the specified item onto the text menu
                        // * SFXWideString text can be set from the resource file
                        error = _menu->InsertLast(SFXWideString::Format("Menu item %d", i));

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

                        // place the text menu at the center of the screen

                        // calculate the suitable text menu region size
                        rectangle.Set(_menu->GetSuitableBound(GetLocalBound().Deflate(10, 0)));
                        rectangle.SetHeight(_menu->GetTitleHeight() + 3 * _menu->GetItemHeight());

                        // place the text menu at the center of the screen
                        rectangle.SnapCenterMiddle(GetLocalBound().GetCenterMiddle());

                        // set the text menu's real region
                        _menu->SetRealBound(rectangle);

                        // Calculate the suitable width of the menu region within the hint region obtained by deflating the screen device region by (10, 10)
                        // and set the height of the menu to "header height + 3 * item height", which will be aligned at the center and the middle of the hint region.
                        // Set the menu's real region to it.
                        _menu->SetRealBound(_menu->GetSuitableBound(GetLocalBound().Deflate(10, 10).SetHeight(_menu->GetTitleHeight() + 3 * _menu->GetItemHeight()), 
                                               SFYResponder::HORIZONTAL_CENTER, 
                                               SFYResponder::VERTICAL_MIDDLE));

                        // set the text menu's state to "visible" + "active" + "enable" + "focus" together
                        _menu->SetState(true, true, true, true);

                        // move the text menu foremost
                        _menu->ToFront();
                    }
                }
            }
        }
    }

    return error;
}

// result handler to be booted up when an item of the text menu is selected
XANDLER_IMPLEMENT_VOIDRESULT(USRApplication, OnResult, invoker, reason, result)
{
    SFXWideString text;

    // menu will be passed via the invoker argument
    // the P16 value of the result event will be passed via the reason argument

    switch (reason) {

        case SFP16_RESULT_OK:  // when the operation key is pressed[item needs to be enabled with SetItemEnable()]

            // the index of the selected item will be passed via the result argument

            // get the text of the selected item
            text = _menu->GetItemText(result);
            // display it on BREW Output Window
            TRACE("%S", text.GetCString());
            break;

        case SFP16_RESULT_ESCAPE:  // when the ESCAPE key is pressed or the time scheduled with ScheduleTimer() elapses

            // 0 will be passed via the result argument

            // close the menu
            invoker->Terminate();  
            // or "_menu->Terminate();"

            break;
    }

    return;
}

Example 9.78. Declaration

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

    ...
private:
    SFCError Make(Void);

    // result handler which means that grid menu is selected
    XANDLER_DECLARE_VOIDRESULT(OnResult)
};

Example 9.79. Implementation

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

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

            // register the result handler which means that grid menu item is selected
            error = _menu->RegisterHandler(
                SFXEventRange(SFEVT_RESPONDER_RESULT, SFEVT_RESPONDER_RESULT, SFP16_BEGIN, SFP16_END),
                XANDLER_INTERNAL(OnResult)
            );
            if (error == SFERR_NO_ERROR) {

                // set grid menu title
                // * SFXWideString text can be set from the resource file
                error = _menu->SetTitle("Text Menu");
                if (error == SFERR_NO_ERROR) {

                    // set the text color of grid menu title to white color
                    _menu->SetTitleForeColor(SFXRGBColor(0xFF, 0xFF, 0xFF, 0x00));

                    // set background color of grid menu title to blue color
                    _menu->SetTitleBackColor(SFXRGBColor(0x00, 0xBF, 0xF3, 0x00));

                    // set numbers of rows and colums of grid menu
                    _menu->SetRowCol(4, 3);

                    // get SFBShell instance
                    shell = SFBShell::GetInstance();
                    if (shell != null) {
                        for (i = 0; i < 12; ++i) {

                            // get image for unselected grid menu item from the resource file and ID
                            image = shell->LoadResImage(NEWWORLD_RES_FILE, IDI_OBJECT_5001 + i);

                            // get image for selected grid menu item
                            selectedImage = shell->LoadResImage(MENU_RES_FILE, IDI_OBJECT_5001 + i);

                            // append grid menu item
                            // * SFXWideString text can be set from the resource file
                            error = _menu->InsertLast(SFXWideString::Format("%d", i), image, selectedImage);

                            if (error != SFERR_NO_ERROR) break;
                        }

                        if (error == SFERR_NO_ERROR) {

                            // display grid menu item's name
                            _menu->SetDrawItemText(true);

                            // set grid menu's real region to device screen
                            _menu->SetRealBound(GetLocalBound());

                            // set grid menu's state to "visible" + "active" + "enable" + "focus" together
                            _menu->SetState(true, true, true, true);

                            // move grid menu foremost
                            _menu->ToFront();
                        }
                    }
                }
            }
        }
    }

    return error;
}

// result handler which means that grid menu item is selected
XANDLER_IMPLEMENT_VOIDRESULT(USRApplication, OnResult, invoker, reason, result)
{
    // menu will be passed via the invoker argument
    // the P16 value of the result event will be passed via the reason argument

    switch (reason) {

        case SFP16_RESULT_OK:  // when the operation key is pressed

            // the index of the selected item will be passed via the result argument

            // display index of selected item on BREW Output Window
            TRACE("%d", result);
            break;

        case SFP16_RESULT_ESCAPE:  // when the ESCAPE key is pressed or the time scheduled with ScheduleTimer() elapses

            // 0 will be passed via the result argument

            // close the menu
            invoker->Terminate();  
            // or "_menu->Terminate();"

            break;
    }

    return;
}

Example 9.80. Declaration

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

    // define responder type
    // small alphabet and symbol must not be used since they are reserved for SophiaFramework UNIVERSE
    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 functions defined in the parent class and recommended to be implemented
    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;
};

Example 9.81. Implementation

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

        // set the responder type
        SetType(CODE_TYPE);

        // here describe the initialization
    }
}

USRMenu::~USRMenu(Void)
{
    // here describe the finalization
}

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

Void USRMenu::HandleOperateKey(Void)
{
    // here describe processing necessary when the operation key is pressed
    // in general, send event as below
    // "_select" variable represents number of selected item
    InvokeForward(SFXEvent(SFEVT_RESPONDER_RESULT, SFP16_RESULT_OK, _select), false);

    return;
}

Void USRMenu::HandleSelectUpKey(Void)
{
    // here describe processing necessary when UP key is pressed
    // example: move selected item up by one

    return;
}

Void USRMenu::HandleSelectDownKey(Void)
{
    // here describe processing necessary when DOWN key is pressed
    // example: move selected item down by one

    return;
}

Void USRMenu::HandleBoundRequest(SFXRectanglePtr rectangle) const
{
    // calculate the suitable menu size
    // set the rectangle argument to the calculated suitable menu size
    // for the rectangle argument, it is recommended to set only its size and not to change its origin in this function

    return;
}

Void USRMenu::HandleBoundOptimize(SFXRectanglePtr rectangle) const
{
    // calculate the suitable menu size within rectangular region given by the rectangle argument
    // set the rectangle argument to the calculated suitable menu size
    // for the rectangle argument, it is recommended to set only its size and not to change its origin in this function

    return;
}

Void USRMenu::HandleBoundReal(Void)
{
    // here describe the size recalculation if necessary when the real region is changed

    return;
}

Void USRMenu::HandleBoundVirtual(Void)
{
    // here describe the size recalculation if necessary when the virtual region is changed

    return;
}

Void USRMenu::HandleRenderRequest(SFXGraphicsPtr graphics) const
{
    // draw menu

    return;
}