Example 9.84. Declaration

SFMTYPEDEFRESPONDER(USRWindow)
class USRWindow: public SFZWindow {
    SFMSEALRESPONDER(USRWindow)
    SFMRESPONDERINSTANTIATEFOUR(USRWindow, SFZWindow, SFYContainer, SFYWidget, SFYResponder)
private:
    SFZSingleTextLabelControlSmp _label;

    ...
private:
    SFCError Make(Void);

    // result handler when the operation key is pressed in "enable" mode
    XANDLER_DECLARE_VOIDRESULT(OnResult)
};

Example 9.85. Implementation

SFCError USRWindow::Make(Void)
{
    SFCError error(SFERR_NO_ERROR);

    // create single text label control
    if ((_label = SFZSingleTextLabelControl::NewInstance(&error)) != null) {

        // set single text label control's parent responder to USRWindow
        error = _label->SetParent(GetThis());
        if (error == SFERR_NO_ERROR) {

            // register the result handler when the operation key is pressed in "enable" mode
            // in case of "disable" mode, it means nothing to register handler because it will not be booted up
            error = _label->RegisterHandler(
                SFXEventRange(SFEVT_RESPONDER_RESULT, SFEVT_RESPONDER_RESULT, SFP16_BEGIN, SFP16_END),
                XANDLER_INTERNAL(OnResult)
            );
            if (error == SFERR_NO_ERROR) {

                // set the text to be displayed
                // * SFXWideString text can be set from the resource file
                error = _label->SetText("hello world");
                if (error == SFERR_NO_ERROR) {

                    // set single text label control's real region to suitable size rectangle [origin=(10, 10)]
                    _label->SetRealBound(_label->GetSuitableBound().SetOrigin(10, 10));

                    // to set "enable" mode to "ON", set all states to "true"
                    _label->SetState(true, true, true, true);
                    // to set "disable" mode to "ON", set enable state to "false"
                    // _label->SetState(true, true, false, false);
                }
            }
        }
    }

    return error;
}

// result handler when the operation key is pressed in "enable" mode
XANDLER_IMPLEMENT_VOIDRESULT(USRWindow, OnResult, invoker, reason, result)
{
    // single text label control will be passed via invoker
    // SFP16_RESULT_OK will be passed via reason
    // the current value will be passed via the result argument [ current value = return value of GetCurrentValue() ]

    ...

    return;
}

Example 9.86. Declaration

SFMTYPEDEFRESPONDER(USRWindow)
class USRWindow: public SFZWindow {
    SFMSEALRESPONDER(USRWindow)
    SFMRESPONDERINSTANTIATEFOUR(USRWindow, SFZWindow, SFYContainer, SFYWidget, SFYResponder)
private:
    SFZSingleEditLabelControlSmp _label;

    ...
private:
    SFCError Make(Void);

    // result handler after text input in "enable" mode
    XANDLER_DECLARE_VOIDRESULT(OnResult)
};

Example 9.87. Implementation

SFCError USRWindow::Make(Void)
{
    SFCError error(SFERR_NO_ERROR);

    // create single edit label control
    if ((_label = SFZSingleEditLabelControl::NewInstance(&error)) != null) {

        // set single edit label control's parent responder to USRWindow
        error = _label->SetParent(GetThis());
        if (error == SFERR_NO_ERROR) {

            // register the result handler after text input in "enable" mode
            // in case of "disable" mode, it means nothing to register handler because it will not be booted up
            error = _label->RegisterHandler(
                SFXEventRange(SFEVT_RESPONDER_RESULT, SFEVT_RESPONDER_RESULT, SFP16_BEGIN, SFP16_END),
                XANDLER_INTERNAL(OnResult)
            );
            if (error == SFERR_NO_ERROR) {

                // set number input mode to "ON"
                _label->SetInputMode(AEE_TM_NUMBERS);

                // set password input mode to "ON"
                error = _label->SetPasswordMode(true);
                if (error == SFERR_NO_ERROR) {

                    // set the text to be displayed
                    // * SFXWideString text can be set from the resource file
                    error = _label->SetText("0123456789");
                    if (error == SFERR_NO_ERROR) {

                        // set single edit label control's real region to suitable size rectangle [origin=(10, 10)]
                        _label->SetRealBound(_label->GetSuitableBound().SetOrigin(10, 10));

                        // to set "enable" mode to "ON", set all states to "true"
                        _label->SetState(true, true, true, true);
                        // to set "disable" mode to "ON", set enable state to "false"
                        // _label->SetState(true, true, false, false);
                    }
                }
            }
        }
    }

    return error;
}

// result handler after text input in "enable" mode
XANDLER_IMPLEMENT_VOIDRESULT(USRWindow, OnResult, invoker, reason, result)
{
    SFXWideString text;

    // single edit label control will be passed via invoker
    // SFP16_RESULT_OK or SFP16_RESULT_ERROR will be passed via reason

    switch (reason) {

        case SFP16_RESULT_OK:
            // if text input succeeds, SFP16_RESULT_OK will be passed via reason
            // and current value will be passed via the result argument [ current value = return value of GetCurrentValue() ]

            // get inputted text
            text = _label->GetText();

            // trace inputted text on BREW Output Window
            TRACE("%S", text.GetCString());

            break;

        case SFP16_RESULT_ERROR:
            // if text input fails, SFP16_RESULT_ERROR will be passed via reason
            // and error value of SFCError type will be passed via the result argument

            ...

            break;
    }

    return;
}

Example 9.88. Declaration

SFMTYPEDEFRESPONDER(USRWindow)
class USRWindow: public SFZWindow {
    SFMSEALRESPONDER(USRWindow)
    SFMRESPONDERINSTANTIATEFOUR(USRWindow, SFZWindow, SFYContainer, SFYWidget, SFYResponder)
private:
    SFZMultipleTextLabelControlSmp _label;

    ...
private:
    SFCError Make(Void);

    // result handler when the operation key is pressed in "enable" mode
    XANDLER_DECLARE_VOIDRESULT(OnResult)
};

Example 9.89. Implementation

SFCError USRWindow::Make(Void)
{
    SFCError error(SFERR_NO_ERROR);

    // create multiple text label control
    if ((_label = SFZMultipleTextLabelControl::NewInstance(&error)) != null) {

        // set multiple text label control's parent responder to USRWindow
        error = _label->SetParent(GetThis());
        if (error == SFERR_NO_ERROR) {

            // register the result handler when the operation key is pressed in "enable" mode
            // in case of "disable" mode, it means nothing to register handler because it will not be booted up
            error = _label->RegisterHandler(
                SFXEventRange(SFEVT_RESPONDER_RESULT, SFEVT_RESPONDER_RESULT, SFP16_BEGIN, SFP16_END),
                XANDLER_INTERNAL(OnResult)
            );
            if (error == SFERR_NO_ERROR) {

                // set the text to be displayed
                // * SFXWideString text can be set from the resource file
                error = _label->SetText("hello world\nabc\nxyz");
                if (error == SFERR_NO_ERROR) {

                    // set multiple text label control's real region to suitable size rectangle within region obtained by deflating USRWindow by (10, 10) [origin=(10, 10)]
                    _label->SetRealBound(_label->GetSuitableBound(GetLocalBound().Deflate(10, 10)));

                    // to set "enable" mode to "ON", set all states to "true"
                    _label->SetState(true, true, true, true);
                    // to set "disable" mode to "ON", set enable state to "false"
                    // _label->SetState(true, true, false, false);
                }
            }
        }
    }

    return error;
}

// result handler when the operation key is pressed in "enable" mode
XANDLER_IMPLEMENT_VOIDRESULT(USRWindow, OnResult, invoker, reason, result)
{
    // multiple text label control will be passed via invoker
    // SFP16_RESULT_OK will be passed via reason
    // the current value will be passed via the result argument [ current value = return value of GetCurrentValue() ]

    ...

    return;
}

Example 9.90. Declaration

SFMTYPEDEFRESPONDER(USRWindow)
class USRWindow: public SFZWindow {
    SFMSEALRESPONDER(USRWindow)
    SFMRESPONDERINSTANTIATEFOUR(USRWindow, SFZWindow, SFYContainer, SFYWidget, SFYResponder)
private:
    SFZMultipleEditLabelControlSmp _label;

    ...
private:
    SFCError Make(Void);

    // result handler after text input in "enable" mode
    XANDLER_DECLARE_VOIDRESULT(OnResult)
};

Example 9.91. Implementation

SFCError USRWindow::Make(Void)
{
    SFCError error(SFERR_NO_ERROR);

    // create multiple edit label control
    if ((_label = SFZMultipleEditLabelControl::NewInstance(&error)) != null) {

        // set multiple edit label control's parent responder to USRWindow
        error = _label->SetParent(GetThis());
        if (error == SFERR_NO_ERROR) {

            // register the result handler after text input in "enable" mode
            // in case of "disable" mode, it means nothing to register handler because it will not be booted up
            error = _label->RegisterHandler(
                SFXEventRange(SFEVT_RESPONDER_RESULT, SFEVT_RESPONDER_RESULT, SFP16_BEGIN, SFP16_END),
                XANDLER_INTERNAL(OnResult)
            );
            if (error == SFERR_NO_ERROR) {

                // set number input mode to "ON"
                _label->SetInputMode(AEE_TM_NUMBERS);

                // set password input mode to "ON"
                error = _label->SetPasswordMode(true);
                if (error == SFERR_NO_ERROR) {

                    // set the text to be displayed
                    // * SFXWideString text can be set from the resource file
                    error = _label->SetText("0123456789\n012\n789");
                    if (error == SFERR_NO_ERROR) {

                        // set multiple edit label control's real region to suitable size rectangle within region obtained by deflating USRWindow by (10, 10) [origin=(10, 10)]
                        _label->SetRealBound(_label->GetSuitableBound(GetLocalBound().Deflate(10, 10)));

                        // to set "enable" mode to "ON", set all states to "true"
                        _label->SetState(true, true, true, true);
                        // to set "disable" mode to "ON", set enable state to "false"
                        // _label->SetState(true, true, false, false);
                    }
                }
            }
        }
    }

    return error;
}

// result handler after text input in "enable" mode
XANDLER_IMPLEMENT_VOIDRESULT(USRWindow, OnResult, invoker, reason, result)
{
    SFXWideString text;

    // multiple edit label control will be passed via invoker
    // SFP16_RESULT_OK or SFP16_RESULT_ERROR will be passed via reason

    switch (reason) {

        case SFP16_RESULT_OK:
            // if text input succeeds, SFP16_RESULT_OK will be passed via reason
            // and current value will be passed via the result argument [ current value = return value of GetCurrentValue() ]

            // get inputted text
            text = _label->GetText();

            // trace inputted text on BREW Output Window
            TRACE("%S", text.GetCString());

            break;

        case SFP16_RESULT_ERROR:
            // if text input fails, SFP16_RESULT_ERROR will be passed via reason
            // and error value of SFCError type will be passed via the result argument

            ...

            break;
    }

    return;
}

Example 9.92. Declaration

SFMTYPEDEFRESPONDER(USRWindow)
class USRWindow: public SFZWindow {
    SFMSEALRESPONDER(USRWindow)
    SFMRESPONDERINSTANTIATEFOUR(USRWindow, SFZWindow, SFYContainer, SFYWidget, SFYResponder)
private:
    SFZImageLabelControlSmp _label;

    ...
private:
    SFCError Make(Void);

    // result handler when the operation key is pressed in "enable" mode
    XANDLER_DECLARE_VOIDRESULT(OnResult)
};

Example 9.93. Implementation

SFCError USRWindow::Make(Void)
{
    SFCError error(SFERR_NO_ERROR);

    // create image label control
    if ((_label = SFZImageLabelControl::NewInstance(&error)) != null) {

        // set the image label control's parent responder to USRWindow
        error = _label->SetParent(GetThis());
        if (error == SFERR_NO_ERROR) {

            // register the result handler when the operation key is pressed in "enable" mode
            // in case of "disable" mode, it means nothing to register handler because it will not be booted up
            error = _label->RegisterHandler(
                SFXEventRange(SFEVT_RESPONDER_RESULT, SFEVT_RESPONDER_RESULT, SFP16_BEGIN, SFP16_END),
                XANDLER_INTERNAL(OnResult)
            );
            if (error == SFERR_NO_ERROR) {

                // set the image to be displayed
                // * SFBImage image can be set from the resource file or normal file
                error = _label->SetImage(SFXPath("resource.bar"), IMAGE_ID);
                if (error == SFERR_NO_ERROR) {

                    // set the image label control's real region to suitable size rectangle [origin=(10, 10)]
                    _label->SetRealBound(_label->GetSuitableBound().SetOrigin(10, 10));

                    // to set "enable" mode to "ON", set all states to "true"
                    _label->SetState(true, true, true, true);
                    // to set "disable" mode to "ON", set enable state to "false"
                    // _label->SetState(true, true, false, false);
                }
            }
        }
    }

    return error;
}

// result handler when the operation key is pressed in "enable" mode
XANDLER_IMPLEMENT_VOIDRESULT(USRWindow, OnResult, invoker, reason, result)
{
    // image label control will be passed via invoker
    // SFP16_RESULT_OK will be passed via reason
    // the current value will be passed via the result argument [ current value = return value of GetCurrentValue() ]

    ...

    return;
}

Example 9.94. Declaration

SFMTYPEDEFRESPONDER(USRWindow)
class USRWindow: public SFZWindow {
    SFMSEALRESPONDER(USRWindow)
    SFMRESPONDERINSTANTIATEFOUR(USRWindow, SFZWindow, SFYContainer, SFYWidget, SFYResponder)
private:
    SFZSingleTextBoxControlSmp _box;

    ...
private:
    SFCError Make(Void);

    // result handler when the operation key is pressed
    XANDLER_DECLARE_VOIDRESULT(OnResult)
};

Example 9.95. Implementation

SFCError USRWindow::Make(Void)
{
    SFCError error(SFERR_NO_ERROR);

    // create single text box control
    if ((_box = SFZSingleTextBoxControl::NewInstance(&error)) != null) {

        // set single text box control's parent responder to USRWindow
        error = _box->SetParent(GetThis());
        if (error == SFERR_NO_ERROR) {

            // register the result handler when the operation key is pressed
            error = _box->RegisterHandler(
                SFXEventRange(SFEVT_RESPONDER_RESULT, SFEVT_RESPONDER_RESULT, SFP16_BEGIN, SFP16_END),
                XANDLER_INTERNAL(OnResult)
            );
            if (error == SFERR_NO_ERROR) {

                // set the text to be displayed
                // * SFXWideString text can be set from the resource file
                error = _box->SetText("hello world");
                if (error == SFERR_NO_ERROR) {

                    // set single text box control's real region to suitable size rectangle [origin=(10, 10)]
                    _box->SetRealBound(_box->GetSuitableBound().SetOrigin(10, 10));

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

    return error;
}

// result handler when the operation key is pressed
XANDLER_IMPLEMENT_VOIDRESULT(USRWindow, OnResult, invoker, reason, result)
{
    // single text box control will be passed via invoker
    // SFP16_RESULT_OK will be passed via reason
    // the current value will be passed via the result argument [ current value = return value of GetCurrentValue() ]

    ...

    return;
}

Example 9.96. Declaration

SFMTYPEDEFRESPONDER(USRWindow)
class USRWindow: public SFZWindow {
    SFMSEALRESPONDER(USRWindow)
    SFMRESPONDERINSTANTIATEFOUR(USRWindow, SFZWindow, SFYContainer, SFYWidget, SFYResponder)
private:
    SFZSingleEditBoxControlSmp _box;

    ...
private:
    SFCError Make(Void);

    // result handler after text input
    XANDLER_DECLARE_VOIDRESULT(OnResult)
};

Example 9.97. Implementation

SFCError USRWindow::Make(Void)
{
    SFCError error(SFERR_NO_ERROR);

    // create single edit box control
    if ((_box = SFZSingleEditBoxControl::NewInstance(&error)) != null) {

        // set single edit box control's parent responder to USRWindow
        error = _box->SetParent(GetThis());
        if (error == SFERR_NO_ERROR) {

            // register the result handler after text input
            error = _box->RegisterHandler(
                SFXEventRange(SFEVT_RESPONDER_RESULT, SFEVT_RESPONDER_RESULT, SFP16_BEGIN, SFP16_END),
                XANDLER_INTERNAL(OnResult)
            );
            if (error == SFERR_NO_ERROR) {

                // set number input mode to "ON"
                _box->SetInputMode(AEE_TM_NUMBERS);

                // set password input mode to "ON"
                error = _box->SetPasswordMode(true);
                if (error == SFERR_NO_ERROR) {

                    // set the text to be displayed
                    // * SFXWideString text can be set from the resource file
                    error = _box->SetText("0123456789");
                    if (error == SFERR_NO_ERROR) {

                        // set single edit box control's real region to suitable size rectangle [origin=(10, 10)]
                        _box->SetRealBound(_box->GetSuitableBound().SetOrigin(10, 10));

                        // set single edit box control's state to "visible" + "active" + "enable" + "focus" together
                        _box->SetState(true, true, true, true);
                    }
                }
            }
        }
    }

    return error;
}

// result handler after text input
XANDLER_IMPLEMENT_VOIDRESULT(USRWindow, OnResult, invoker, reason, result)
{
    SFXWideString text;

    // single edit box control will be passed via invoker
    // SFP16_RESULT_OK or SFP16_RESULT_ERROR will be passed via reason

    switch (reason) {

        case SFP16_RESULT_OK:
            // if text input succeeds, SFP16_RESULT_OK will be passed via reason
            // and current value will be passed via the result argument [ current value = return value of GetCurrentValue() ]

            // get inputted text
            text = _box->GetText();

            // trace inputted text on BREW Output Window
            TRACE("%S", text.GetCString());

            break;

        case SFP16_RESULT_ERROR:
            // if text input fails, SFP16_RESULT_ERROR will be passed via reason
            // and error value of SFCError type will be passed via the result argument

            ...

            break;
    }

    return;
}

Example 9.98. Declaration

SFMTYPEDEFRESPONDER(USRWindow)
class USRWindow: public SFZWindow {
    SFMSEALRESPONDER(USRWindow)
    SFMRESPONDERINSTANTIATEFOUR(USRWindow, SFZWindow, SFYContainer, SFYWidget, SFYResponder)
private:
    SFZMultipleTextBoxControlSmp _box;

    ...
private:
    SFCError Make(Void);

    // result handler when the operation key is pressed
    XANDLER_DECLARE_VOIDRESULT(OnResult)
};

Example 9.99. Implementation

SFCError USRWindow::Make(Void)
{
    SFCError error(SFERR_NO_ERROR);

    // create multiple text box control
    if ((_box = SFZMultipleTextBoxControl::NewInstance(&error)) != null) {

        // set multiple text box control's parent responder to USRWindow
        error = _box->SetParent(GetThis());
        if (error == SFERR_NO_ERROR) {

            // register the result handler when the operation key is pressed
            error = _box->RegisterHandler(
                SFXEventRange(SFEVT_RESPONDER_RESULT, SFEVT_RESPONDER_RESULT, SFP16_BEGIN, SFP16_END),
                XANDLER_INTERNAL(OnResult)
            );
            if (error == SFERR_NO_ERROR) {

                // set the text to be displayed
                // * SFXWideString text can be set from the resource file
                error = _box->SetText("hello world\nabc\nxyz");
                if (error == SFERR_NO_ERROR) {

                    // set multiple text box control's real region to suitable size rectangle within region obtained by deflating USRWindow by (10, 10) [origin=(10, 10)]
                    _box->SetRealBound(_box->GetSuitableBound(GetLocalBound().Deflate(10, 10)));

                    // set multiple edit box control's state to "visible" + "active" + "enable" + "focus" together
                    _box->SetState(true, true, true, true);
                }
            }
        }
    }

    return error;
}

// result handler when the operation key is pressed
XANDLER_IMPLEMENT_VOIDRESULT(USRWindow, OnResult, invoker, reason, result)
{
    // multiple text box control will be passed via invoker
    // SFP16_RESULT_OK will be passed via reason
    // the current value will be passed via the result argument [ current value = return value of GetCurrentValue() ]

    ...

    return;
}

Example 9.100. Declaration

SFMTYPEDEFRESPONDER(USRWindow)
class USRWindow: public SFZWindow {
    SFMSEALRESPONDER(USRWindow)
    SFMRESPONDERINSTANTIATEFOUR(USRWindow, SFZWindow, SFYContainer, SFYWidget, SFYResponder)
private:
    SFZMultipleEditBoxControlSmp _box;

    ...
private:
    SFCError Make(Void);

    // result handler after text input
    XANDLER_DECLARE_VOIDRESULT(OnResult)
};

Example 9.101. Implementation

SFCError USRWindow::Make(Void)
{
    SFCError error(SFERR_NO_ERROR);

    // create multiple edit box control
    if ((_box = SFZMultipleEditBoxControl::NewInstance(&error)) != null) {

        // set multiple edit box control's parent responder to USRWindow
        error = _box->SetParent(GetThis());
        if (error == SFERR_NO_ERROR) {

            // register the result handler after text input
            error = _box->RegisterHandler(
                SFXEventRange(SFEVT_RESPONDER_RESULT, SFEVT_RESPONDER_RESULT, SFP16_BEGIN, SFP16_END),
                XANDLER_INTERNAL(OnResult)
            );
            if (error == SFERR_NO_ERROR) {

                // set number input mode to "ON"
                _box->SetInputMode(AEE_TM_NUMBERS);

                // set password input mode to "ON"
                error = _box->SetPasswordMode(true);
                if (error == SFERR_NO_ERROR) {

                    // set the text to be displayed
                    // * SFXWideString text can be set from the resource file
                    error = _box->SetText("0123456789\n012\n789");
                    if (error == SFERR_NO_ERROR) {

                        // set multiple edit box control's real region to suitable size rectangle within region obtained by deflating USRWindow by (10, 10) [origin=(10, 10)]
                        _box->SetRealBound(_box->GetSuitableBound(GetLocalBound().Deflate(10, 10)));

                        // set multiple edit box control's state to "visible" + "active" + "enable" + "focus" together
                        _box->SetState(true, true, true, true);
                    }
                }
            }
        }
    }

    return error;
}

// handler for event after text input
XANDLER_IMPLEMENT_VOIDRESULT(USRWindow, OnResult, invoker, reason, result)
{
    SFXWideString text;

    // multiple edit box control will be passed via invoker
    // SFP16_RESULT_OK or SFP16_RESULT_ERROR will be passed via reason

    switch (reason) {

        case SFP16_RESULT_OK:
            // if text input succeeds, SFP16_RESULT_OK will be passed via reason
            // and current value will be passed via the result argument [ current value = return value of GetCurrentValue() ]

            // get inputted text
            text = _box->GetText();

            // trace inputted text on BREW Output Window
            TRACE("%S", text.GetCString());

            break;

        case SFP16_RESULT_ERROR:
            // if text input fails, SFP16_RESULT_ERROR will be passed via reason
            // and error value of SFCError type will be passed via the result argument

            ...

            break;
    }

    return;
}

Example 9.102. Declaration

SFMTYPEDEFRESPONDER(USRWindow)
class USRWindow: public SFZWindow {
    SFMSEALRESPONDER(USRWindow)
    SFMRESPONDERINSTANTIATEFOUR(USRWindow, SFZWindow, SFYContainer, SFYWidget, SFYResponder)
private:
    SFZImageBoxControlSmp _box;

    ...
private:
    SFCError Make(Void);

    // result handler when the operation key is pressed
    XANDLER_DECLARE_VOIDRESULT(OnResult)
};

Example 9.103. Implementation

SFCError USRWindow::Make(Void)
{
    SFCError error(SFERR_NO_ERROR);

    // create image box control
    if ((_box = SFZImageBoxControl::NewInstance(&error)) != null) {

        // set the image box control's parent responder to USRWindow
        error = _box->SetParent(GetThis());
        if (error == SFERR_NO_ERROR) {

            // register the result handler when the operation key is pressed
            error = _box->RegisterHandler(
                SFXEventRange(SFEVT_RESPONDER_RESULT, SFEVT_RESPONDER_RESULT, SFP16_BEGIN, SFP16_END),
                XANDLER_INTERNAL(OnResult)
            );
            if (error == SFERR_NO_ERROR) {

                // set the image to be displayed
                // * SFBImage image can be set from the resource file or normal file
                error = _box->SetImage(SFXPath("resource.bar"), IMAGE_ID);
                if (error == SFERR_NO_ERROR) {

                    // set the image box control's real region to suitable size rectangle [origin=(10, 10)]
                    _box->SetRealBound(_box->GetSuitableBound().SetOrigin(10, 10));

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

    return error;
}

// result handler when the operation key is pressed
XANDLER_IMPLEMENT_VOIDRESULT(USRWindow, OnResult, invoker, reason, result)
{
    // image box control will be passed via invoker
    // SFP16_RESULT_OK will be passed via reason
    // the current value will be passed via the result argument [ current value = return value of GetCurrentValue() ]

    ...

    return;
}

Example 9.104. Declaration

SFMTYPEDEFRESPONDER(USRWindow)
class USRWindow: public SFZWindow {
    SFMSEALRESPONDER(USRWindow)
    SFMRESPONDERINSTANTIATEFOUR(USRWindow, SFZWindow, SFYContainer, SFYWidget, SFYResponder)
private:
    SFZTextButtonControlSmp _button;

    ...
private:
    SFCError Make(Void);

    // handler to handles result event when text button control is operated
    XANDLER_DECLARE_VOIDRESULT(OnResult)
};

Example 9.105. Implementation

SFCError USRWindow::Make(Void)
{
    SFCError error(SFERR_NO_ERROR);

    // create text button control
    if ((_button = SFZTextButtonControl::NewInstance(&error)) != null) {

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

            // register the result handler when text button control is operated
            error = _button->RegisterHandler(
                SFXEventRange(SFEVT_RESPONDER_RESULT, SFEVT_RESPONDER_RESULT, SFP16_BEGIN, SFP16_END),
                XANDLER_INTERNAL(OnResult)
            );
            if (error == SFERR_NO_ERROR) {

                // set the text to be displayed
                // * SFXWideString text can be set from the resource file
                error = _button->SetText("hello world");
                if (error == SFERR_NO_ERROR) {

                    // set the text button control's real region to suitable size rectangle [origin=(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);
                }
            }
        }
    }

    return error;
}

// handler to handles result event when text button control is operated
XANDLER_IMPLEMENT_VOIDRESULT(USRWindow, OnResult, invoker, reason, result)
{
    // text button control will be passed via invoker
    // SFP16_RESULT_OK will be passed via reason
    // the current value will be passed via the result argument [ current value = return value of GetCurrentValue() ]

    ...

    return;
}

Example 9.106. Declaration

SFMTYPEDEFRESPONDER(USRWindow)
class USRWindow: public SFZWindow {
    SFMSEALRESPONDER(USRWindow)
    SFMRESPONDERINSTANTIATEFOUR(USRWindow, SFZWindow, SFYContainer, SFYWidget, SFYResponder)
private:
    SFZImageButtonControlSmp _button;

    ...
private:
    SFCError Make(Void);

    // handler to handles result event when image button control is operated
    XANDLER_DECLARE_VOIDRESULT(OnResult)
};

Example 9.107. Implementation

SFCError USRWindow::Make(Void)
{
    SFCError error(SFERR_NO_ERROR);

    // create image button control
    if ((_button = SFZImageButtonControl::NewInstance(&error)) != null) {

        // set the image button control's parent responder to USRWindow
        error = _button->SetParent(GetThis());
        if (error == SFERR_NO_ERROR) {

            // register the result handler when image button control is operated
            error = _button->RegisterHandler(
                SFXEventRange(SFEVT_RESPONDER_RESULT, SFEVT_RESPONDER_RESULT, SFP16_BEGIN, SFP16_END),
                XANDLER_INTERNAL(OnResult)
            );
            if (error == SFERR_NO_ERROR) {

                // set the image to be displayed
                // * SFBImage image can be set from the resource file or normal file
                error = _button->SetImage(SFXPath("resource.bar"), IMAGE_ID);
                if (error == SFERR_NO_ERROR) {

                    // set the image button control's real region to suitable size rectangle [origin=(10, 10)]
                    _button->SetRealBound(_button->GetSuitableBound().SetOrigin(10, 10));

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

    return error;
}

// handler to handles result event when image button control is operated
XANDLER_IMPLEMENT_VOIDRESULT(USRWindow, OnResult, invoker, reason, result)
{
    // image button control will be passed via invoker
    // SFP16_RESULT_OK will be passed via reason
    // the current value will be passed via the result argument [ current value = return value of GetCurrentValue() ]

    ...

    return;
}

Example 9.108. Declaration

SFMTYPEDEFRESPONDER(USRWindow)
class USRWindow: public SFZWindow {
    SFMSEALRESPONDER(USRWindow)
    SFMRESPONDERINSTANTIATEFOUR(USRWindow, SFZWindow, SFYContainer, SFYWidget, SFYResponder)
private:
    SFZContainerSmp _container;
    SFZScrollBarControlSmp _bar;

public:
    SFCError Make(Void);

    // ...
private:

    // function to set position and size of scroll bar thumb by reading container's region information
    Void Listen(SFYResponderPtr container);

    // container's handler for real and virtual region events
    XANDLER_DECLARE_VOIDBOUND(OnContainerBound)
};

Example 9.109. Implementation

#define SCROLLBAR_WIDTH 5

SFCError USRWindow::Make(Void)
{
    SFCError error(SFERR_NO_ERROR);

    // create container
    if ((_container = SFZContainer::NewInstance(&error)) != null) {

        // set container's parent responder to USRWindow
        error = _container->SetParent(GetThis());
        if (error == SFERR_NO_ERROR) {

            // register handler for real and virtual region events into container
            error = _container->RegisterHandler(
                SFXEventRange(SFEVT_RESPONDER_BOUND, SFEVT_RESPONDER_BOUND, SFP16_BOUND_REAL, SFP16_BOUND_VIRTUAL),
                XANDLER_INTERNAL(OnContainerBound)
            );
            if (error == SFERR_NO_ERROR) {

                // set container's background color
                _container->SetBackgroundColor(SFXRGBColor(0xFF, 0xCC, 0xCC, 0x00));

                // set container's real region window's to local region excluding scroll bar's region
                _container->SetRealBound(GetLocalBound().SubWidth(SCROLLBAR_WIDTH));

                // set container's virtual region to region obtained by expanding container's real region up and down each by 100 pixels
                _container->SetVirtualBound(SFXRectangle(_container->GetRealBound()).Inflate(0, 100));

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

                // create scroll bar control
                if ((_bar = SFZScrollBarControl::NewInstance(&error)) != null) {

                    // set scroll bar control's parent responder to USRWindow
                    error = _bar->SetParent(GetThis());
                    if (error == SFERR_NO_ERROR) {

                        // place scroll bar control directly on right side of container
                        _bar->SetRealBound(GetLocalBound().SetX(_container->GetRealBound().GetRight()).SetWidth(SCROLLBAR_WIDTH));

                        // set scroll bar control's state to "visible" + "active" + "disable" + "unfocus" together
                        _bar->SetState(true, true, false, false);

                        // set position and size of scroll bar thumb by reading container's region information
                        Listen(_container.Get());
                    }
                }
            }
        }
    }

    return error;
}

// function to set position and size of scroll bar thumb by reading container's region information
Void USRWindow::Listen(SFYResponderPtr container)
{
    SFXRectangle rx;
    SFXRectangle vx;
    SInt16 max;
    SInt16 cur;
    SInt16 page;

    if (_bar != null & container != null) {

        // get container's real region
        rx = container->GetRealBound();

        // get container's virtual region
        vx = container->GetVirtualBound();

        if (_bar->GetOrientation() == SFYScrollBarControl::VERTICAL) {
            // if scroll orientation is vertical

            // set max to height of virtual region
            max = vx.GetHeight();

            // set cur to Y value of real region origin in local region coordinate
            cur = -vx.GetTop();

            // set page to height of real region
            page = rx.GetHeight();
        }
        else {
            // if scroll orientation is horizontal

            // set max to width of virtual region
            max = vx.GetWidth();

            // set cur to X value of real region origin in local region coordinate
            cur = -vx.GetLeft();

            // set page to height of real region
            page = rx.GetWidth();
        }


        // set minimum value (this value is always 0)
        _bar->SetMinimumValue(0);

        // set maximum value (this value is width or height of virtual region)
        _bar->SetMaximumValue(max);

        // set current value (this value is X or Y value of real region origin in local region coordinate)
        _bar->SetCurrentValue(cur);

        // set page size value (this value is width or height of real region)
        _bar->SetPageValue(page);
    }
}

// handler for real and virtual region events
XANDLER_IMPLEMENT_VOIDBOUND(USRWindow, OnContainerBound, invoker, reason, bound)
{
    unused(reason);
    unused(bound);

    // container control will be passed via invoker

    // update position and size of scroll bar thumb when container's region is changed
    Listen(invoker);
}

Example 9.110. Declaration

Example 9.111. Implementation

#define SCROLLBAR_WIDTH 5

SFCError USRWindow::Make(Void)
{
    SFCError error(SFERR_NO_ERROR);

    // create container
    if ((_container = SFZContainer::NewInstance(&error)) != null) {

        // set container's parent responder to USRWindow
        error = _container->SetParent(GetThis());
        if (error == SFERR_NO_ERROR) {

            // set container's background color
            _container->SetBackgroundColor(SFXRGBColor(0xFF, 0xCC, 0xCC, 0x00));

            // set container's real region to window's local region excluding scroll bar's region
            _container->SetRealBound(GetLocalBound().SubWidth(SCROLLBAR_WIDTH));

            // set container's virtual region to region obtained by expanding container's real region up and down each by 100 pixels
            _container->SetVirtualBound(SFXRectangle(_container->GetRealBound()).Inflate(0, 100));

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

            // create scroll bar control
            if ((_bar = SFZContainerScrollBarControl::NewInstance(&error)) != null) {
                error = _bar->SetParent(GetThis());
                if (error == SFERR_NO_ERROR) {

                    // place scroll bar control directly on right side of container
                    _bar->SetRealBound(GetLocalBound().SetX(_container->GetRealBound().GetRight()).SetWidth(SCROLLBAR_WIDTH));

                    // set scroll bar control's state to "visible" + "active" + "disable" + "unfocus" together
                    _bar->SetState(true, true, false, false);

                    // bind container with scroll bar control
                    _bar->Bind(_container);
                }
            }
        }
    }

    return error;
}

Example 9.112. Declaration

SFMTYPEDEFRESPONDER(USRWindow)
class USRWindow: public SFZWindow {
    SFMSEALRESPONDER(USRWindow)
    SFMRESPONDERINSTANTIATEFOUR(USRWindow, SFZWindow, SFYContainer, SFYWidget, SFYResponder)
private:
    SFZListBoxControlSmp _listbox;

    ...
private:
    SFCError Make(Void);

    // result handler when list box control is operated
    XANDLER_DECLARE_VOIDRESULT(OnResult)
};

Example 9.113. Implementation

SFCError USRWindow::Make(Void)
{
    SFCError error(SFERR_NO_ERROR);

    // create list box control
    if ((_listbox = SFZListBoxControl::NewInstance(&error)) != null) {

        // set list box control's parent responder to USRWindow
        error = _listbox->SetParent(GetThis());
        if (error == SFERR_NO_ERROR) {

            // register the result handler
            error = _listbox->RegisterHandler(
                SFXEventRange(SFEVT_RESPONDER_RESULT, SFEVT_RESPONDER_RESULT, SFP16_BEGIN, SFP16_END),
                XANDLER_INTERNAL(OnResult)
            );
            if (error == SFERR_NO_ERROR) {

                for (SInt32 i = 0; i < 20; ++i) {

                    // append item
                    error = _listbox->InsertLast(SFXWideString::Format("Item index is %d", i));

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

                    // set list box control's real region to suitable size rectangle [origin=(20, 20)]
                    _listbox->SetRealBound(_listbox->GetSuitableBound(GetLocalBound().Deflate(20, 20)).SetOrigin(20, 20));

                    // set list box control's state to "visible" + "active" + "enable" + "focus" together
                    _listbox->SetState(true, true, true, true);
                }
            }
        }
    }

    return error;
}

// result handler when list box control is operated
XANDLER_IMPLEMENT_VOIDRESULT(USRWindow, OnResult, invoker, reason, result)
{
    SFXWideString text;

    // list box control will be passed via invoker
    // SFP16_RESULT_OK or SFP16_RESULT_ESCAPE will be passed via reason

    switch (reason) {

        case SFP16_RESULT_OK:
            // when the operation key is pressed, SFP16_RESULT_OK will be passed via reason
            // and current value will be passed via the result argument [ current value = index of selected item or return value of GetCurrentValue() ]

            // get the text of the selected item
            text = _listbox->GetItemText(result);

            // trace text of selected item on BREW Output Window
            TRACE("%S", text.GetCString());

            break;

        case SFP16_RESULT_ESCAPE:
            // when the ESCAPE key is pressed, SFP16_RESULT_ESCAPE will be passed via reason
            // and "0" will be passed via the result argument

            ...

            break;
    }

    return;
}

Example 9.114. Declaration

SFMTYPEDEFRESPONDER(USRWindow)
class USRWindow: public SFZWindow {
    SFMSEALRESPONDER(USRWindow)
    SFMRESPONDERINSTANTIATEFOUR(USRWindow, SFZWindow, SFYContainer, SFYWidget, SFYResponder)
private:
    SFZComboBoxControlSmp _combobox;

    // ...
private:
    SFCError Make(Void);

    // result handler
    XANDLER_DECLARE_VOIDRESULT(OnResult)
};

Example 9.115. Implementation

SFCError USRWindow::Make(Void)
{
    SFCError error(SFERR_NO_ERROR);

    // create combo box control
    if ((_combobox = SFZComboBoxControl::NewInstance(&error)) != null) {

        // set combo box control's parent responder to USRWindow
        error = _combobox->SetParent(GetThis());
        if (error == SFERR_NO_ERROR) {

            // register the result handler into the combo box control
            error = _combobox->RegisterHandler(
                SFXEventRange(SFEVT_RESPONDER_RESULT, SFEVT_RESPONDER_RESULT, SFP16_BEGIN, SFP16_END),
                XANDLER_INTERNAL(OnResult)
            );
            if (error == SFERR_NO_ERROR) {

                for (SInt32 i = 0; i < 10; ++i) {

                    // append item on flex list box control internally contained by combo box control
                    error = _combobox->InsertLast(SFXWideString::Format("Item index is %d.", i));

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

                    // set combo box control's real region to suitable size rectangle [origin=(20, 20)]
                    _combobox->SetRealBound(_combobox->GetSuitableBound(GetLocalBound().Deflate(20, 20)).SetOrigin(20, 20));

                    // set combo box control's state to "visible" + "active" + "enable" + "focus" together
                    _combobox->SetState(true, true, true, true);
                }
            }
        }
    }

    return error;
}

// result handler
// * this handler will not be booted up when value is changed by SetCurrentValue function
XANDLER_IMPLEMENT_VOIDRESULT(USRWindow, OnResult, invoker, reason, result)
{
    SFXWideString text;

    // combo box control will be passed via invoker
    // SFP16_RESULT_OK will be passed via reason
    // the current value will be passed via the result argument [ current value = [ current value = index of selected item or return value of GetCurrentValue() ]

    // get the text of the selected item
    text = _combobox->GetItemText(result);

    // trace text of selected item on BREW Output Window
    TRACE("%S", text.GetCString());

    return;
}

Example 9.116. Declaration

SFMTYPEDEFRESPONDER(USRWindow)
class USRWindow: public SFZWindow {
    SFMSEALRESPONDER(USRWindow)
    SFMRESPONDERINSTANTIATEFOUR(USRWindow, SFZWindow, SFYContainer, SFYWidget, SFYResponder)
private:
    SFZCheckboxControlSmp _checkbox;

    ...
private:
    SFCError Make(Void);

    // result handler when check box control is operated
    XANDLER_DECLARE_VOIDRESULT(OnResult)
};

Example 9.117. Implementation

SFCError USRWindow::Make(Void)
{
    SFCError error(SFERR_NO_ERROR);

    // create check box control
    if ((_checkbox = SFZCheckboxControl::NewInstance(&error)) != null) {

        // set check box control's parent responder to USRWindow
        error = _checkbox->SetParent(GetThis());
        if (error == SFERR_NO_ERROR) {

            // register the result handler when check box control is operated
            error = _checkbox->RegisterHandler(
                SFXEventRange(SFEVT_RESPONDER_RESULT, SFEVT_RESPONDER_RESULT, SFP16_BEGIN, SFP16_END),
                XANDLER_INTERNAL(OnResult)
            );
            if (error == SFERR_NO_ERROR) {

                // set the text to be displayed
                // * SFXWideString text can be set from the resource file
                error = _checkbox->SetText("hello world");
                if (error == SFERR_NO_ERROR) {

                    // set check box control's current value to "true" (i.e., checked state)
                    _checkbox->SetCurrentValue(true);

                    // set check box control's real region to suitable size rectangle [origin=(10, 10)]
                    _checkbox->SetRealBound(_checkbox->GetSuitableBound().SetOrigin(10, 10));

                    // set check box control's state to "visible" + "active" + "enable" + "focus" together
                    _checkbox->SetState(true, true, true, true);
                }
            }
        }
    }

    return error;
}

// result handler when check box control is operated
XANDLER_IMPLEMENT_VOIDRESULT(USRWindow, OnResult, invoker, reason, result)
{
    // check box control will be passed via invoker
    // SFP16_RESULT_OK will be passed via reason
    // the current value will be passed via the result argument [ current value = return value of GetCurrentValue() ]

    ...

    return;
}

Example 9.118. Declaration

SFMTYPEDEFRESPONDER(USRWindow)
class USRWindow: public SFZWindow {
    SFMSEALRESPONDER(USRWindow)
    SFMRESPONDERINSTANTIATEFOUR(USRWindow, SFZWindow, SFYContainer, SFYWidget, SFYResponder)
private:
    SFZRadiobuttonControlSmp _radiobutton;

    ...
private:
    SFCError Make(Void);

    // handler to handles result event when radio button control is operated
    XANDLER_DECLARE_VOIDRESULT(OnResult)
};

Example 9.119. Implementation

SFCError USRWindow::Make(Void)
{
    SFCError error(SFERR_NO_ERROR);

    // create radio button control
    if ((_radiobutton = SFZRadiobuttonControl::NewInstance(&error)) != null) {

        // set radio button control's parent responder to USRWindow
        error = _radiobutton->SetParent(GetThis());
        if (error == SFERR_NO_ERROR) {

            // register the result handler when radio button control is operated
            error = _radiobutton->RegisterHandler(
                SFXEventRange(SFEVT_RESPONDER_RESULT, SFEVT_RESPONDER_RESULT, SFP16_BEGIN, SFP16_END),
                XANDLER_INTERNAL(OnResult)
            );
            if (error == SFERR_NO_ERROR) {

                // set the text to be displayed
                // * SFXWideString text can be set from the resource file
                error = _radiobutton->SetText("hello world");
                if (error == SFERR_NO_ERROR) {

                    // set radio button control's current value to "true" (i.e., checked state)
                    _radiobutton->SetCurrentValue(true);

                    // set radio button control's real region to suitable size rectangle [origin=(10, 10)]
                    _radiobutton->SetRealBound(_radiobutton->GetSuitableBound().SetOrigin(10, 10));

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

    return error;
}

// handler to handles result event when radio button control is operated
XANDLER_IMPLEMENT_VOIDRESULT(USRWindow, OnResult, invoker, reason, result)
{
    // radio button control will be passed via invoker
    // SFP16_RESULT_OK will be passed via reason
    // the current value will be passed via the result argument [ current value = return value of GetCurrentValue() ]

    ...

    return;
}

Example 9.120. Declaration

SFMTYPEDEFRESPONDER(USRWindow)
class USRWindow: public SFZWindow {
    SFMSEALRESPONDER(USRWindow)
    SFMRESPONDERINSTANTIATEFOUR(USRWindow, SFZWindow, SFYContainer, SFYWidget, SFYResponder)
private:
    SFZTabControlSmp _tab;

    ...
private:
    SFCError Make(Void);
};

Example 9.121. Implementation

SFCError USRWindow::Make(Void)
{
    SFBShellSmp shell;
    SFBImageSmp image;
    SFXWideString text;
    SFZTabPageSmp page[4];
    SFZTextButtonControlSmp button[4];
    SFXRectangle rectangle;
    SInt16 i;
    SFCError error(SFERR_NO_ERROR);

    // create tab control
    if ((_tab = SFZTabControl::NewInstance(&error)) != null) {

        // set tab control's parent responder to USRWindow
        error = _tab->SetParent(GetThis());

        if (error == SFERR_NO_ERROR) {

            // set tab control's real region to USRWindow's local region
            _tab->SetRealBound(GetLocalBound());

            // set tab control's background color
            _tab->SetBackgroundColor(SFXRGBColor(0xDD, 0xFF, 0xDD, 0x00));

            // set number of pages to be displayed in tab control region to 3
            _tab->SetFieldValue(3);

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

            // get SFBShell instance
            shell = SFBShell::GetInstance();

            if (shell != null) {

                // make 4 tab pages and append them
                for (i = 0; i < 4; ++ i) {

                    // create tab page
                    page[i] = SFZTabPage::NewInstance(&error);
                    if (page[i] != null) {

                        // set tab page's parent responder to tab control
                        // * since tab page's real region will be automatically set, you don't have to set it
                        error = page[i]->SetParent(_tab);

                        if (error == SFERR_NO_ERROR) {

                            // set tab page's title text
                            text = SFXWideString::Format("%c", 'A' + i);
                            page[i]->SetTitle(text);

                            // set tab page's hint text
                            text = SFXWideString::Format("Page %d", i);
                            error = page[i]->SetHint(text);
                            if (error == SFERR_NO_ERROR) {

                                // read image to be displayed from the resource file
                                image = shell->LoadResImage(TAB_RES_FILE, IDI_OBJECT_5001 + i);
                                if (image != null) {

                                    // set tab page's title image (this image can be set from the resource file or normal file)
                                    page[i]->SetImage(image);

                                    // set tab page's state to "visible" + "active" + "enable" + "unfocus" together
                                    // * this statement can be omitted since it is initial state of SFZTabPage instance
                                    page[i]->SetState(true, true, true, false);

                                    // place button in center of tab page

                                    // create text button control
                                    if ((button[i] = SFZTextButtonControl::NewInstance(&error)) != null) {

                                        // set the text button control's parent responder to tab page
                                        error = button[i]->SetParent(page[i]);

                                        if (error == SFERR_NO_ERROR) {

                                            // set the text button control's label text
                                            error = button[i]->SetText(SFXWideString::Format("Button %c", 'A' + i));

                                            if (error == SFERR_NO_ERROR) {

                                                // calculate text button control's suitable region size
                                                rectangle = button[i]->GetSuitableBound(page[i]->GetLocalBound());

                                                // place text button control's suitable region in center of tab page
                                                rectangle.SnapCenterMiddle(page[i]->GetLocalBound().GetCenterMiddle());

                                                // set the text button control's real region
                                                button[i]->SetRealBound(rectangle);

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

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

                    // move and display 1st tab page foremost
                    // by specifying index of tab page in argument of FocusPage()
                    _tab->FocusPage(0);

                    // following two methods to move tab page foremost are prohibited
                    // since there is possibility that selected tab may not match tab page placed foremost currently

                    // Method 1. move 1st tab page foremost by moving the focus
                    // NG: page[0]->SetStateFocus(true);

                    // Method 2. move 1st tab page foremost by calling ToFront()
                    // NG: page[0]->ToFront();
                }
            }
        }
    }

    return error;
}

Example 9.122. Define and make SoftKey control

// define screensaver_sfy application class
SFMTYPEDEFCLASS(screensaver_sfy)
class screensaver_sfy: public SFYApplication {
    SFMSEALCOPY(screensaver_sfy)
private:
    SFZSoftKeyControlSmp _softkey;  // SoftKey control must be defined as member variable of application class
    MainWindowSmp _main;
public:
    static SFCInvokerPtr Factory(Void);
    static SFZSoftKeyControlSmp GetSoftKey(Void);
private:
    explicit screensaver_sfy(Void) static_throws;
    virtual ~screensaver_sfy(Void);
    XANDLER_DECLARE_VOIDRENDER(OnRenderRequest)
};

// constructor of screensaver_sfy application class
screensaver_sfy::screensaver_sfy(Void) static_throws
{
    SFCError error;

    if (static_try()) {

        // .................

        if (static_try()) {

           // make SoftKey control
           // application class can have only one SoftKey control
           _softkey = SFZSoftKeyControl::NewInstance(&error);

           if (_softkey != null) {

                // set SoftKey control's parent responder to application class(root)
                // * SoftKey control must be root's child responder
                error = _softkey->SetParent(GetThis());

                // at this time, SoftKey control is automatically placed foremost among child responders of root by internal processing
                // key events of SoftKey are all handled in SoftKey control


                if (error == SFERR_NO_ERROR) {

                    // set SoftKey control's menu style to "extention style"
                    _softkey->SetStyle(SFZSoftKeyControl::EXTENSION);

                    // set real region to region automatically calculated from device screen size and SoftKey control style
                    // (to be set at the bottom in the device screen)
                    // *** CAUTION on specification of GetSuitableBound() only for SFZSoftKeyControl: 
                    // *** 1. A rectangular region will be ignored if specified in the argument and 
                    // ***    the suitable size will be calculated from the full screen region of the mobile phone gotten by calling SFXDevice::GetScreenSize().
                    // ***    In general, the argument is not specified since it has no meaning.
                    // *** 2. This function will return not only the suitable rectangle size but also the suitable origin position.
                    // ***    Therefore, there is no need to set the position of the real region after calling this function.
                    _softkey->SetRealBound(_softkey->GetSuitableBound());

                    // set SoftKey control's state to "visible" + "active" + "disable" + "unfocus" together
                    _softkey->SetState(true, true, false, false);

                    // move SoftKey control foremost
                    // _softkey->ToFront();  // this can be omitted since SoftKey control is always moved foremost by internal processing

                    // register each element (i.e., text, image, 3 colors) for SoftKey label
                    // before they are used for SoftKey menu
                    // * since image and 3 colors are not registered here, default setting are used for these elements
                    _softkey->RegisterText(KEY_TEXT_EXIT,   SFXWideString("End"));
                    _softkey->RegisterText(KEY_TEXT_EDIT,   SFXWideString("Set"));
                    _softkey->RegisterText(KEY_TEXT_ADD,    SFXWideString("Add"));
                    _softkey->RegisterText(KEY_TEXT_CHANGE, SFXWideString("Update"));
                    _softkey->RegisterText(KEY_TEXT_REMOVE, SFXWideString("Delete"));

                    // all elements can be registered together from the resource file
                    // _softkey->RegisterTextRange(
                    //   IDS_SK_EXIT, SFXPath(SCREENSAVER_SFY_RES_FILE), IDS_SK_EXIT, IDS_SK_REMOVE
                    // );
                }
            }
        }

        // make MainWindow
        if (error == SFERR_NO_ERROR) {
            _main = MainWindow::NewInstance(&error);

                .................

        }


        .................
    }
}


// implementation of function to get SoftKey control
SFZSoftKeyControlSmp screensaver_sfy::GetSoftKey(Void)
{
    return static_cast<screensaver_sfyPtr>(GetInstance())->_softkey;
}

Example 9.123. Set the SoftKey control in the responder class

// define MainWindow
SFMTYPEDEFRESPONDER(MainWindow)
class MainWindow: public SFZWindow {
    SFMSEALRESPONDER(MainWindow)
    SFMRESPONDERINSTANTIATEFOUR(MainWindow, SFZWindow, SFYContainer, SFYWidget, SFYResponder)
public:

        ................

private:
    SFZSoftKeyControlSmp _softkey;// SoftKey control

        ................

private:
    XANDLER_DECLARE_VOIDEVENT(OnKey)     // key handler
    XANDLER_DECLARE_VOIDEVENT(OnSoftkey) // SoftKey handler

        ................

};

// constructor of MainWindow
MainWindow::MainWindow(Void) static_throws
{
    static SFXEventRange::AtomRecConst range[] = {
        { SFEVT_APP_SUSPEND,       SFEVT_APP_SUSPEND,       SFP16_BEGIN,   SFP16_END },
        { SFEVT_APP_RESUME,        SFEVT_APP_RESUME,        SFP16_BEGIN,   SFP16_END },

        // normal key event
        { SFEVT_KEY,               SFEVT_KEY,               SFP16_BEGIN,   SFP16_END },

        // SoftKey event[SFEVT_RESPONDER_SOFTKEY] which SoftKey control will transfer
        // key event of SoftKey will be converted into SoftKey event[SFEVT_RESPONDER_SOFTKEY]
        { SFEVT_RESPONDER_SOFTKEY, SFEVT_RESPONDER_SOFTKEY, AVK_SOFT1,     AVK_SOFT4 }
    };
    SFYHandler::RuleRec rule[lengthof(range)];

    if (static_try()) {
        SetType(CODE_TYPE);

        rule[0].spp = XANDLER_FUNCTION(OnSuspend);
        rule[0].reference = this;
        rule[1].spp = XANDLER_FUNCTION(OnResume);
        rule[1].reference = this;

        // key handler
        rule[2].spp = XANDLER_FUNCTION(OnKey);
        rule[2].reference = this;

        // SoftKey handler
        rule[3].spp = XANDLER_FUNCTION(OnSoftkey);
        rule[3].reference = this;

        // register handlers
        static_throw(RegisterHandler(atomic_cast(range), rule, lengthof(range)));

        // get instance of SoftKey control
        if ((_softkey = screensaver_sfy::GetSoftKey()) != null) {

            if (!_softkey->ContainsMenuKey(MENUID_MAIN)) {
                // if SoftKey menu which corresponds to unique menu key "MENUID_MAIN" is not created

                // create SoftKey menu
                _softkey->CreateMenu(MENUID_MAIN);

                // set each element key to SoftKey menu above
                // * elements have already been registered in constructor of application class
                // keys below correspond to labels for SELECT, SOFTKEY_1, SOFTKEY_2, SOFTKEY_3, SOFTKEY_4 from left respectively
                UInt32 keyText[] = {
                    IDS_SK_EDIT, IDS_SK_EXIT, IDS_SK_ADD, IDS_SK_CHANGE, IDS_SK_REMOVE
                };
                _softkey->SetTextKey(MENUID_MAIN, keyText, lengthof(keyText));
           }

           // bind MainWindow with SoftKey menu of SoftKey control
           _softkey->Bind(this, MENUID_MAIN); 
           // or "_softkey->Bind(GetThis(), MENUID_MAIN);" *The former yields better performance than the latter.
        }
    }
}

Example 9.124. Implement the handler for the SoftKey event

// implement handler for SoftKey event: handler for key events from SoftKey1 to SoftKey4
// this handler will be booted up only if MainWindow is "active responder"
XANDLER_IMPLEMENT_VOIDEVENT(MainWindow, OnSoftkey, invoker, event)
{

                .................


    switch (event.GetP16()) {
        case AVK_SOFT1:
            // make the dialog which confirms termination

                .................

            break;
        case AVK_SOFT2:
            // make menu

                .................

}

Example 9.125. Declaration

SFMTYPEDEFRESPONDER(USRControl)
class USRControl: public SFYControl {
    SFMSEALRESPONDER(USRControl)
    SFMRESPONDERINSTANTIATETHREE(USRControl, SFYControl, 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', 'C', 'N', 'T')
    };
    SFMTYPEDEFTYPE(CodeEnum)

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

    // virtual functions defined in the parent class and recommended to be implemented
    virtual Void HandleBoundRequest(SFXRectanglePtr rectangle) const;
    virtual Void HandleBoundOptimize(SFXRectanglePtr rectangle) const;
    virtual Void HandleBoundVirtual(Void);
    virtual Void HandleRenderRequest(SFXGraphicsPtr graphics) const;
};

Example 9.126. Implementation

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

        // set the responder type
        SetType(CODE_TYPE);

        // here describe the initialization
    }
}

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

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

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

    return;
}

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

    return;
}

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

    return;
}

Void USRControl::HandleRenderRequest(SFXGraphicsPtr graphics) const
{
    // draw control

    return;
}

Example 9.127. Declaration

SFMTYPEDEFRESPONDER(USRLabelControl)
class USRLabelControl: public SFYLabelControl {
    SFMSEALRESPONDER(USRLabelControl)
    SFMRESPONDERINSTANTIATEFOUR(USRLabelControl, SFYLabelControl, SFYControl, 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', 'L', 'B', 'L')
    };
    SFMTYPEDEFTYPE(CodeEnum)

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

    // virtual functions defined in the parent class and recommended to be implemented
    virtual Void HandleBoundRequest(SFXRectanglePtr rectangle) const;
    virtual Void HandleBoundOptimize(SFXRectanglePtr rectangle) const;
    virtual Void HandleBoundVirtual(Void);
    virtual Void HandleRenderRequest(SFXGraphicsPtr graphics) const;
};

Example 9.128. Implementation

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

        // set the responder type
        SetType(CODE_TYPE);

        // in general, set transparency attribute to "true" since label control does not have background
        SetPropertyTransparent(true);

        // here describe the initialization
    }
}

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

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

Void USRLabelControl::HandleBoundRequest(SFXRectanglePtr rectangle) const
{
    // in case of using function of SFYLabelControl class to draw focus border [i.e., SFYLabelControl::DrawFocus()],
    // deflate rectangle by size of focus border
    rectangle->Deflate(GetFocusMargin());

    // calculate the suitable focus border size
    // set the rectangle argument to the calculated suitable focus border size
    // for the rectangle argument, it is recommended to set only its size and not to change its origin in this function

    // in case of using function of SFYLabelControl class to draw focus border [i.e., SFYLabelControl::DrawFocus()],
    // inflate rectangle by size of focus border
    rectangle->Inflate(GetFocusMargin());

    return;
}

Void USRLabelControl::HandleBoundOptimize(SFXRectanglePtr rectangle) const
{
    // in case of using function of SFYLabelControl class to draw focus border [i.e., SFYLabelControl::DrawFocus()],
    // deflate rectangle by size of focus border
    rectangle->Deflate(GetFocusMargin());

    // calculate the suitable focus border size within rectangular region given by the rectangle argument
    // set the rectangle argument to the calculated suitable focus border size
    // for the rectangle argument, it is recommended to set only its size and not to change its origin in this function

    // in case of using function of SFYLabelControl class to draw focus border [i.e., SFYLabelControl::DrawFocus()],
    // inflate rectangle by size of focus border
    rectangle->Inflate(GetFocusMargin());

    return;
}

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

    return;
}

Void USRLabelControl::HandleRenderRequest(SFXGraphicsPtr graphics) const
{
    // in case of using function of SFYLabelControl class to draw focus border [i.e., SFYLabelControl::DrawFocus()],
    // draw focus border as below
    DrawFocus(graphics, GetLocalBound());

    // draw inside focus border

    return;
}

Example 9.129. Declaration

SFMTYPEDEFRESPONDER(USRBoxControl)
class USRBoxControl: public SFYBoxControl {
    SFMSEALRESPONDER(USRBoxControl)
    SFMRESPONDERINSTANTIATEFOUR(USRBoxControl, SFYBoxControl, SFYControl, 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', 'B', 'O', 'X')
    };
    SFMTYPEDEFTYPE(CodeEnum)

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

    // virtual functions defined in the parent class and recommended to be implemented
    virtual Void HandleBoundRequest(SFXRectanglePtr rectangle) const;
    virtual Void HandleBoundOptimize(SFXRectanglePtr rectangle) const;
    virtual Void HandleBoundVirtual(Void);
    virtual Void HandleRenderRequest(SFXGraphicsPtr graphics) const;
};

Example 9.130. Implementation

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

        // set the responder type
        SetType(CODE_TYPE);

        // here describe the initialization
    }
}

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

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

Void USRBoxControl::HandleBoundRequest(SFXRectanglePtr rectangle) const
{
    // in case of using function of SFYBoxControl class to draw box [i.e., SFYBoxControl::DrawBox()],
    // deflate rectangle by size of box margin
    rectangle->Deflate(GetBoxMargin());

    // calculate the suitable box size
    // set the rectangle argument to the calculated suitable box size
    // for the rectangle argument, it is recommended to set only its size and not to change its origin in this function

    // in case of using function of SFYBoxControl class to draw box [i.e., SFYBoxControl::DrawBox()],
    // inflate rectangle by size of box margin
    rectangle->Inflate(GetBoxMargin());

    return;
}

Void USRBoxControl::HandleBoundOptimize(SFXRectanglePtr rectangle) const
{
    // in case of using function of SFYBoxControl class to draw box [i.e., SFYBoxControl::DrawBox()],
    // deflate rectangle by size of box margin
    rectangle->Deflate(GetBoxMargin());

    // calculate the suitable box size within rectangular region given by the rectangle argument
    // set the rectangle argument to the calculated suitable box size
    // for the rectangle argument, it is recommended to set only its size and not to change its origin in this function

    // in case of using function of SFYBoxControl class to draw box [i.e., SFYBoxControl::DrawBox()],
    // inflate rectangle by size of box margin
    rectangle->Inflate(GetBoxMargin());

    return;
}

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

    return;
}

Void USRBoxControl::HandleRenderRequest(SFXGraphicsPtr graphics) const
{
    // in case of using function of SFYBoxControl class to draw box [i.e., SFYBoxControl::DrawBox()],
    // draw box as below
    DrawBox(graphics, GetLocalBound());

    // draw inside box

    return;
}

Example 9.131. Declaration

SFMTYPEDEFRESPONDER(USRButtonControl)
class USRButtonControl: public SFYButtonControl {
    SFMSEALRESPONDER(USRButtonControl)
    SFMRESPONDERINSTANTIATEFOUR(USRButtonControl, SFYButtonControl, SFYControl, 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', 'B', 'T', 'N')
    };
    SFMTYPEDEFTYPE(CodeEnum)

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

    // virtual functions defined in the parent class and recommended to be implemented
    virtual Void HandleBoundRequest(SFXRectanglePtr rectangle) const;
    virtual Void HandleBoundOptimize(SFXRectanglePtr rectangle) const;
    virtual Void HandleBoundVirtual(Void);
    virtual Void HandleRenderRequest(SFXGraphicsPtr graphics) const;
};

Example 9.132. Implementation

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

        // set the responder type
        SetType(CODE_TYPE);

        // here describe the initialization
    }
}

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

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

Void USRButtonControl::HandleBoundRequest(SFXRectanglePtr rectangle) const
{
    // in case of using function of SFYButtonControl class to draw button and shadow [i.e., SFYButtonControl::DrawButton()/DrawShadow()],
    // deflate rectangle by size of button and shadow
    rectangle->Deflate(GetShadowMargin());
    rectangle->Deflate(GetButtonMargin());

    // calculate the suitable button size
    // set the rectangle argument to the calculated suitable button size
    // for the rectangle argument, it is recommended to set only its size and not to change its origin in this function

    // in case of using function of SFYButtonControl class to draw button and shadow [i.e., SFYButtonControl::DrawButton()/DrawShadow()],
    // inflate rectangle by size of button and shadow
    rectangle->Inflate(GetButtonMargin());
    rectangle->Inflate(GetShadowMargin());

    return;
}

Void USRButtonControl::HandleBoundOptimize(SFXRectanglePtr rectangle) const
{
    // in case of using function of SFYButtonControl class to draw button and shadow [i.e., SFYButtonControl::DrawButton()/DrawShadow()],
    // deflate rectangle by size of button and shadow
    rectangle->Deflate(GetShadowMargin());
    rectangle->Deflate(GetButtonMargin());

    // calculate the suitable button size within rectangular region given by the rectangle argument
    // set the rectangle argument to the calculated suitable button size
    // for the rectangle argument, it is recommended to set only its size and not to change its origin in this function

    // in case of using function of SFYButtonControl class to draw button and shadow [i.e., SFYButtonControl::DrawButton()/DrawShadow()],
    // inflate rectangle by size of button and shadow
    rectangle->Inflate(GetButtonMargin());
    rectangle->Inflate(GetShadowMargin());

    return;
}

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

    return;
}

Void USRButtonControl::HandleRenderRequest(SFXGraphicsPtr graphics) const
{
    // in case of using function of SFYButtonControl class to draw button and shadow [i.e., SFYButtonControl::DrawButton()/DrawShadow()],
    // draw button and shadow as below
    DrawButton(graphics, DrawShadow(graphics, GetLocalBound()));

    // draw inside button

    return;
}

Example 9.133. Declaration

SFMTYPEDEFRESPONDER(USRCheckboxControl)
class USRCheckboxControl: public SFYCheckboxControl {
    SFMSEALRESPONDER(USRCheckboxControl)
    SFMRESPONDERINSTANTIATEFIVE(USRCheckboxControl, SFYCheckboxControl, SFYButtonControl, SFYControl, 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', 'C', 'H', 'K')
    };
    SFMTYPEDEFTYPE(CodeEnum)

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

    // virtual functions defined in the parent class and recommended to be implemented
    virtual Void HandleBoundRequest(SFXRectanglePtr rectangle) const;
    virtual Void HandleBoundOptimize(SFXRectanglePtr rectangle) const;
    virtual Void HandleBoundVirtual(Void);
    virtual Void HandleRenderRequest(SFXGraphicsPtr graphics) const;
};

Example 9.134. Implementation

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

        // set the responder type
        SetType(CODE_TYPE);

        // since check box control's label doesn't have background, set true to transparent mode
        SetPropertyTransparent(true);

        // here describe the initialization
    }
}

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

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

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

    return;
}

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

    return;
}

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

    return;
}

Void USRCheckboxControl::HandleRenderRequest(SFXGraphicsPtr graphics) const
{
    SFXGrid grid;

    // in case of using function of SFYCheckboxControl class to draw check box and shadow [i.e., SFYCheckboxControl::DrawButton**()/DrawShadow**()/DrawCheckmark**()],
    // draw check box, shadow, and check mark as below

    // _height variable is hight of check box 
    // _origin variable is origin of check box
    // * these variable is calculated with font hight used for label

    if (_height >= 28) {

        grid.Set(DrawShadow28(graphics, _origin));
        DrawButton27(graphics, grid);
        grid.Add(3, 3);
        DrawCheckmark21(graphics, grid);
    }
    else if (_height >= 14) {

        grid.Set(DrawShadow14(graphics, _origin));
        DrawButton13(graphics, grid);
        grid.Add(2, 2);
        DrawCheckmark09(graphics, grid);
    }

    // draw check box control's label

    return;
}

Example 9.135. Declaration

SFMTYPEDEFRESPONDER(USRRadiobuttonControl)
class USRRadiobuttonControl: public SFYRadiobuttonControl {
    SFMSEALRESPONDER(USRRadiobuttonControl)
    SFMRESPONDERINSTANTIATESIX(USRRadiobuttonControl, SFYRadiobuttonControl, SFYCheckboxControl, SFYButtonControl, SFYControl, 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', 'R', 'D', 'O')
    };
    SFMTYPEDEFTYPE(CodeEnum)

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

    // virtual functions defined in the parent class and recommended to be implemented
    virtual Void HandleBoundRequest(SFXRectanglePtr rectangle) const;
    virtual Void HandleBoundOptimize(SFXRectanglePtr rectangle) const;
    virtual Void HandleBoundVirtual(Void);
    virtual Void HandleRenderRequest(SFXGraphicsPtr graphics) const;
};

Example 9.136. Implementation

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

        // set the responder type
        SetType(CODE_TYPE);

        // since radio button control's label doesn't have background, set true to transparent mode
        SetPropertyTransparent(true);

        // here describe the initialization
    }
}

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

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

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

    return;
}

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

    return;
}

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

    return;
}

Void USRRadiobuttonControl::HandleRenderRequest(SFXGraphicsPtr graphics) const
{
    SFXGrid grid;

    // in case of using function of SFYRadiobuttonControl class to draw radio button and shadow [i.e., SFYRadiobuttonControl::DrawButton**()/DrawShadow**()/DrawCheckmark**()],
    // draw radio button and shadow as below

    // _height variable is hight of radio button 
    // _origin variable is origin of radio button
    // * these variable is calculated with font hight used for label

    if (_height >= 28) {

        grid.Set(DrawShadow28(graphics, _origin));
        DrawButton27(graphics, grid);
        grid.Add(8, 8);
        DrawCheckmark11(graphics, grid);
    }
    else if (_height >= 14) {

        grid.Set(DrawShadow14(graphics, _origin));
        DrawButton13(graphics, grid);
        grid.Add(4, 4);
        DrawCheckmark05(graphics, grid);
    }

    // draw radio button control's label

    return;
}