Example 9.64. Declaration

SFMTYPEDEFCLASS(USRApplication)
class USRApplication: public SFYApplication {
    SFMSEALCOPY(USRApplication)
private:
    SFZDialogSmp _dialog;

    ...
private:
    SFCError Make(Void);

    // result handler
    XANDLER_DECLARE_VOIDRESULT(OnResult)
};

Example 9.65. Implementation

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

    // create the dialog
    if ((_dialog = SFZDialog::NewInstance(&error)) != null) {

        // set the dialog's parent responder to USRApplication
        error = _dialog->SetParent(GetThis());
        if (error == SFERR_NO_ERROR) {

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

                // Calculate the suitable dialog region within the hint region obtained by deflating the screen device region by (20, 20), 
                // which will be aligned at the center and the middle of the hint region.
                // Set the dialog's real region to it.
                _dialog->SetRealBound(_dialog->GetSuitableBound(GetLocalBound().Deflate(10, 10), SFYResponder::HORIZONTAL_CENTER, SFYResponder::VERTICAL_MIDDLE));

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

                // move the dialog foremost
                _dialog->ToFront();
            }
        }
    }

    return error;
}

// result handler
XANDLER_IMPLEMENT_VOIDRESULT(USRApplication, OnResult, invoker, reason, result)
{
    // the dialog will be passed via the invoker argument
    // the P16 value of the result event will be passed via the reason argument
    // "0" will be passed via the result argument

    switch (reason) {

        case SFP16_RESULT_OK:

            // when the operation key is pressed

            ...

            break;

        case SFP16_RESULT_ESCAPE:

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

            ...

            break;
    }

    // close the dialog
    invoker->Terminate();
    // or "_dialog->Terminate();"

    return;
}

Example 9.66. Declaration

SFMTYPEDEFCLASS(USRApplication)
class USRApplication: public SFYApplication {
    SFMSEALCOPY(USRApplication)
private:
    SFZMessageDialogSmp _dialog;

    ...
private:
    SFCError Make(Void);

    // result handler
    XANDLER_DECLARE_VOIDRESULT(OnResult)
};

Example 9.67. Implementation

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

    // create the dialog
    if ((_dialog = SFZMessageDialog::NewInstance(&error)) != null) {

        // set the dialog's parent responder to USRApplication
        error = _dialog->SetParent(GetThis());
        if (error == SFERR_NO_ERROR) {

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

                // set the image for the dialog's icon
                // * SFBImage image can be set from the resource file or normal file
                error = _dialog->SetIconImage(SFXPath("resource.bar"), IMAGE_ID);
                if (error == SFERR_NO_ERROR) {

                    // set the text for the dialog's message
                    // * SFXWideString text can be set from the resource file
                    error = _dialog->SetMessageText("hello world\n\nThis is a notification message.");
                    if (error == SFERR_NO_ERROR) {

                        // set the text for the dialog's OK button
                        // * SFXWideString text can be set from the resource file
                        error = _dialog->SetButtonText("OK");
                        if (error == SFERR_NO_ERROR) {

                            // Calculate the suitable dialog region within the hint region obtained by deflating the screen device region by (20, 20), 
                            // which will be aligned at the center and the middle of the hint region.
                            // Set the dialog's real region to it.
                            _dialog->SetRealBound(_dialog->GetSuitableBound(GetLocalBound().Deflate(10, 10), SFYResponder::HORIZONTAL_CENTER, SFYResponder::VERTICAL_MIDDLE));

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

                            // move the dialog foremost
                            _dialog->ToFront();
                        }
                    }
                }
            }
        }
    }

    return error;
}

// result handler
XANDLER_IMPLEMENT_VOIDRESULT(USRApplication, OnResult, invoker, reason, result)
{
    // the dialog will be passed via the invoker argument
    // the P16 value of the result event will be passed via the reason argument
    // "0" will be passed via the result argument

    switch (reason) {

        case SFP16_RESULT_OK:

            // when the OK button or the operation key is pressed

            ...

            break;

        case SFP16_RESULT_ESCAPE:

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

            ...

            break;
    }

    // close the dialog
    invoker->Terminate();
    // or "_dialog->Terminate();"

    return;
}

Example 9.68. Declaration

SFMTYPEDEFCLASS(USRApplication)
class USRApplication: public SFYApplication {
    SFMSEALCOPY(USRApplication)
private:
    SFZQuestionDialogSmp _dialog;

    ...
private:
    SFCError Make(Void);

    // result handler
    XANDLER_DECLARE_VOIDRESULT(OnResult)
};

Example 9.69. Implementation

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

    // create the dialog
    if ((_dialog = SFZQuestionDialog::NewInstance(&error)) != null) {

        // set the dialog's parent responder to USRApplication
        error = _dialog->SetParent(GetThis());
        if (error == SFERR_NO_ERROR) {

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

                // set the image for the dialog's icon
                // * SFBImage image can be set from the resource file or normal file
                error = _dialog->SetIconImage(SFXPath("resource.bar"), IMAGE_ID);
                if (error == SFERR_NO_ERROR) {

                    // set the text for the dialog's message
                    // * SFXWideString text can be set from the resource file
                    error = _dialog->SetMessageText("hello world\n\nThis is a question message.");
                    if (error == SFERR_NO_ERROR) {

                        // set the text for the dialog's ANOTHER button
                        // * SFXWideString text can be set from the resource file
                        error = _dialog->SetButtonText(SFZQuestionDialog::BUTTON_ANOTHER, "ANOTHER");
                        if (error == SFERR_NO_ERROR) {

                            // set the text for the dialog's CANCEL button
                            // * SFXWideString text can be set from the resource file
                            error = _dialog->SetButtonText(SFZQuestionDialog::BUTTON_CANCEL, "CANCEL");
                            if (error == SFERR_NO_ERROR) {

                                // set the text to the dialog's OK button
                                // since the text for the OK button is set last, first the OK button is displayed in the focus state
                                // * SFXWideString text can be set from the resource file
                                error = _dialog->SetButtonText(SFZQuestionDialog::BUTTON_OK, "OK");
                                if (error == SFERR_NO_ERROR) {

                                    // Calculate the suitable dialog region within the hint region obtained by deflating the screen device region by (20, 20), 
                                    // which will be aligned at the center and the middle of the hint region.
                                    // Set the dialog's real region to it.
                                    _dialog->SetRealBound(_dialog->GetSuitableBound(GetLocalBound().Deflate(10, 10), SFYResponder::HORIZONTAL_CENTER, SFYResponder::VERTICAL_MIDDLE));

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

                                    // move the dialog foremost
                                    _dialog->ToFront();
                                }
                            }
                        }
                    }
                }
            }
        }
    }

    return error;
}

// result handler
XANDLER_IMPLEMENT_VOIDRESULT(USRApplication, OnResult, invoker, reason, result)
{
    // the dialog will be passed via the invoker argument
    // the P16 value of the result event will be passed via the reason argument
    // "0" will be passed via the result argument

    switch (reason) {

        case SFP16_RESULT_OK:

            // when the OK button or the operation key is pressed

            ...

            break;

        case SFP16_RESULT_CANCEL:

            // when the CANCEL button is pressed

            ...

            break;

        case SFP16_RESULT_ANOTHER:

            // when the OTHER button is pressed

            ...

            break;

        case SFP16_RESULT_ESCAPE:

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

            ...

            break;
    }

    // close the dialog
    invoker->Terminate();
    // or "_dialog->Terminate();"

    return;
}

Example 9.70. Declaration

SFMTYPEDEFRESPONDER(USRDialog)
class USRDialog: public SFZDialog {
    SFMSEALRESPONDER(USRDialog)
    SFMRESPONDERINSTANTIATEFIVE(USRDialog, SFZDialog, SFZWindow, SFYContainer, 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', 'D', 'L', 'G')
    };
    SFMTYPEDEFTYPE(CodeEnum)

public:
    static USRDialogSmp NewInstance(SFCErrorPtr exception = null);
protected:
    explicit USRDialog(Void) static_throws;
    virtual ~USRDialog(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 HandleBoundReal(Void);
    virtual Void HandleBoundVirtual(Void);
    virtual Void HandleRenderRequest(SFXGraphicsPtr graphics) const;
};

Example 9.71. Implementation

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

        // set the responder type
        SetType(CODE_TYPE);

        // here describe the initialization
    }
}

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

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

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

    return;
}

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

    return;
}

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

    return;
}

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

    return;
}

Void USRDialog::HandleRenderRequest(SFXGraphicsPtr graphics) const
{
    // draw the dialog

    return;
}