Example 9.1. Making a window in an application class(root)

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

    ...

    // create the instance of SFZWindow ("window" in the below)
    if ((window = SFZWindow::NewInstance(&error)) != null) {

        // set the window's parent responder to the application class(i.e., the root)
        error = window->SetParent(GetThis());
        if (error == SFERR_NO_ERROR) {

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

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

           // move the window foremost
           window->ToFront();
        }
    }

    ...
}

Procedure to make a window

Create the SFZWindow instance (called "window" in the below) with the SFZWindow::NewInstance function. Set the parent responder of "window" with the SFYResponder::SetParent function. Set the real region of "window" to to the rectangular region in its parent responder's local region coordinate system with the SFYResponder::SetRealBound function. Set the state of "window" with the SFYResponder::SetState function. Move the "window" and its child responders foremost with the SFYResponder::ToFront function.

Reference: SFZWindow | SFYResponder::GetThis | SFYResponder::GetLocalBound | SFXRectangle::Deflate

Example 9.2. Make a text button control in a window

SFCError USRApplication::MakeTextButtonControl(Void)
{
    SFZWindowSmp window;
    SFZTextButtonControlSmp button;
    SFCError error(SFERR_NO_ERROR);

    ...

    // create the instance of SFZTextButtonControl ("text button control" in the below)
    if ((button = SFZTextButtonControl::NewInstance(&error)) != null) {

        // set the text button control's parent responder to the window
        error = button->SetParent(window);
        if (error == SFERR_NO_ERROR) {

            // set the text button control's label to "hello world"
            error = button->SetText("hello world");
            if (error == SFERR_NO_ERROR) {

                // get the suitable size for displaying the text button control within the window's local region, and set the origin to (10, 10)
                button->SetRealBound(button->GetSuitableBound().SetOrigin(10, 10));

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

    ...
}

Procedure to make a text button control

Create the SFZTextButtonControl instance (called "button" in the below) with the SFZTextButtonControl::NewInstance function. Set the parent responder of "button" to an existing responder already placed with the SFYResponder::SetParent function. Set the label of "button" with the SFZTextButtonControl::SetText function. Set the real region of "button" to the rectangular region in its parent responder's local region coordinate system with the SFYResponder::SetRealBound function. Set the state of "button" with the SFYResponder::SetState function.

	SFYResponder::ToFront function
	The control will not be moved foremost unless its parent responder such as a window, a dialog, or a container is moved foremost. It will be automatically moved foremost after calling the SFYResponder::ToFront function of its parent responder.

Reference: SFZWindow | SFZTextButtonControl | SFYResponder::GetSuitableBound | SFXRectangle::SetOrigin

Example 9.3. Registering and implementing the result handler

SFZTextButtonControlSmp button;
SFCError error(SFERR_NO_ERROR);

...

// register the "OnResult" result handler into the text button control
error = button->RegisterHandler(
    SFXEventRange(SFEVT_RESPONDER_RESULT, SFEVT_RESPONDER_RESULT, SFP16_BEGIN, SFP16_END),
    XANDLER_INTERNAL(OnResult)
);
...


// implement the "OnResult" result handler
XANDLER_IMPLEMENT_VOIDRESULT(USRApplication, OnResult, invoker, reason, result)
{
    // display "Text button control has been pushed." on BREW Output window
    TRACE("Text button control has been pushed.");

    return;
}

	NOTE
	The handler for result event (i.e., result handler) is registered into the text button control with the SFYResponder::RegisterHandler function. The result handler (i.e result handler) is implemented with the XANDLER_IMPLEMENT_VOIDRESULT macro. * The result event will occur when the text button control is pushed.