Example 3.9. Define MyWindow

// define the MyWindow class
SFMTYPEDEFRESPONDER(MyWindow)  //  macro to generate the useful types
class MyWindow : public SFZWindow // inherit from SFZWindow
{
    SFMSEALRESPONDER(MyWindow)  //  macro to prohibit the developer from copying this instance

    // macro to specify the inheritance relation from SFYResponder to this class
    SFMRESPONDERINSTANTIATEFOUR(MyWindow, SFZWindow, SFYContainer, SFYWidget, SFYResponder)

public:

    // since small alphabet is reserved for 4-character literals, 
    // define ('M', 'W', 'N', 'D') as 4-character literals for MyWindow with capital alphabet
    enum CodeEnum {
        CODE_TYPE = four_char_code('M', 'W', 'N', 'D')
    };

public:

    // generate the MyWindow instance managed by the smart pointer
    static MyWindowSmp NewInstance(SFCErrorPtr exception = null);

protected:

    explicit MyWindow(Void) static_throws;
    virtual ~MyWindow(Void);

    // drawing handler(override the HandleRenderRequest virtual function booted up first when the drawing event is received)
    virtual Void HandleRenderRequest(SFXGraphicsPtr graphics) const; 

private:

    // key handler
    XANDLER_DECLARE_BOOLEVENT(OnKey)
};

Example 3.10. Update the helloworld application class

// define the helloworld class
SFMTYPEDEFCLASS(helloworld)  //  macro to generate the useful types
class helloworld : public SFYApplication
{
    SFMSEALCOPY(helloworld)  //  macro to prohibit the developer from copying this instance

private:

    // *** added code segments are in bold

    MyWindowSmp _myWindow; // smart pointer of MyWindow

public:

    static SFCInvokerPtr Factory(Void);

private:

    explicit helloworld(Void) static_throws;
    virtual ~helloworld(Void);

    // make MyWindow
    SFCError Make(Void); 

    XANDLER_DECLARE_VOIDRENDER(OnRenderRequest) // declare the drawing handler
    XANDLER_DECLARE_BOOLEVENT(OnKey)            // declare the key handler
};

Example 3.11. Implement MyWindow

// create the MyWindow instance
MyWindowSmp MyWindow::NewInstance(SFCErrorPtr exception)
{

   // create the MyWindow instance with Factory()
   // since Factory() returns the SFYResponderSmp type
   // downcast into the MyWindowSmp type with the static_pointer_cast operator
   return static_pointer_cast<MyWindow>(Factory(:: new MyWindow, exception));

}

// define the color scheme
// light green color for MyWindow's background
#define COLOR_MY_WINDOW_BACK        (SFXRGBColor(0xCC, 0xFF, 0xCC, 0x00))

// constructor
MyWindow::MyWindow(Void) static_throws
{
    if (static_try()) {

        // four_char_code('M', 'W', 'N', 'D') is set as the responder type
        SetType(CODE_TYPE);

        // register the key handler
        static_throw(RegisterHandler(
            SFXEventRange(SFEVT_KEY, SFEVT_KEY, SFP16_BEGIN, SFP16_END),
            XANDLER_INTERNAL(OnKey)
        ));

        // since MyWindow::HandleRenderRequest function will be called first when the drawing event is received
        // it is enough to describe the drawing processing of MyWindow in this function
        // it is unnecessary to define, implement, register the drawing handler newly into MyWindow

        // set the MyWindow's background color to light green
        SetBackgroundColor(COLOR_MY_WINDOW_BACK);
    }
}

// destructor
MyWindow::~MyWindow(Void)
{
}

// define the color scheme
// black color for string
#define COLOR_BLACK                 (SFXRGBColor(0x00, 0x00, 0x00, 0x00))

// drawing handler
Void MyWindow::HandleRenderRequest(SFXGraphicsPtr graphics) const
{
    // SFXGraphics instance for drawing is passed as the 1st argument(graphics)
    // left-top of MyWindow's local region is origin of the drawing region

    // MyWindow's local region is filled in light green, 
    // which is set in the constructor with SFYWidget::SetBackgroundColor()

    // draw "Hello Window" string in black color at the center of MyWindow's local region
    graphics->DrawSingleText("Hello Window", GetLocalBound(), COLOR_BLACK);

    // there is no need to execute "graphics->Update();" when the GUI framework is used

    return;
}

// key handler (called when MyWindow is focused and some key is pressed) 
// invoker is the responder of the SFYResponderPtr type which called this handler(in this case, MyWindow)
// event is key event of SFXEventConstRef type
XANDLER_IMPLEMENT_BOOLEVENT(MyWindow, OnKey, invoker, event)
{
    switch (event.GetP16()) {
        case AVK_CLR: // when the CLEAR key is pressed

            // close MyWindow
            invoker->Terminate();

            // return "true" since the key event is handled
            return true;

        case AVK_1: // when the "1" key is pressed

            // draw "1-key" in BREW Output Window
            TRACE("1-key");

            // return "true" since the key event is handled
            return true;
    }

    // return "false" since the key event is NOT handled
    return false;
}

Example 3.12. Make MyWindow

// make MyWindow
SFCError helloworld::Make(Void)
{
    SFCError error(SFERR_NO_ERROR);

    // create the MyWindow instance(called "_myWindow" in the below)
    if ((_myWindow = MyWindow::NewInstance(&error)) != null) {

        // obtain the root which the application class contains internally with SFYApplication::GetThis()
        // set the parent responder of _myWindow to the root
        error = _myWindow->SetParent(GetThis());

        if (error == SFERR_NO_ERROR) {

            // set the real region of _myWindow to the region obtained by deflating the device screen region by (10, 10)
            _myWindow->SetRealBound(GetLocalBound().Deflate(10, 10));

            // set the state of _myWindow to "visible" + "active" + "enable" + "focus" together
            _myWindow->SetState(true, true, true, true);

            // move _myWindow foremost
            _myWindow->ToFront();
        }
    }
    return error;
}

Example 3.13. Update the key handler of the helloworld application class

// key handler 
XANDLER_IMPLEMENT_BOOLEVENT(helloworld, OnKey, invoker, event)
{
    unused(invoker);

    // key handler
    switch (event.GetP16()) {
        case AVK_SELECT: // when the SELECT key is pressed
            Terminate(); // terminate the helloworld applet
            return true;

        // *** added code segments are in bold

        case AVK_1: // when the "1" key is pressed

            // make MyWindow
            if (Make() != SFERR_NO_ERROR) {
                return false;
            }

        // return "true" since the key event is handled
        return true;
    }

    // return "false" since the key event is NOT handled
    return false;
}