Example 9.82. Declaration

SFMTYPEDEFCLASS(USRApplication)
class USRApplication: public SFYApplication {
    SFMSEALCOPY(USRApplication)
private:

    SFZTitleBevelFrameSmp _frame;
    SFZMessageDialogSmp _dialog;

    // ...

private:
    SFCError MakeFrame(Void);
    SFCError MakeDialog(Void);


    // result handler
    XANDLER_DECLARE_VOIDRESULT(OnResult)
};

Example 9.83. Implementation

// make the frame
SFCError USRApplication::MakeFrame(Void)
{
    SFCError error(SFERR_NO_ERROR);

    // create the bevel frame with title(each frame has different design)
    // other types of frames can be set to a window or a dialog in the same way
    if ((_frame = SFZTitleBevelFrame::NewInstance(&error)) != null) {

        // In general, the frame's state is set to "visible" + "active" + "enable" + "focus".
        _frame->SetState(true, true, true, true);

        // set the other attributes of the frame
        // ...
    }
    if ( error == SFERR_NO_ERROR) {

        // make the dialog to which the frame will be attached
        error = MakeDialog();
    }

    return error;
}

// make the dialog to which the frame will be attached
SFCError USRApplication::MakeDialog(Void)
{
    SFXRectangle rectangle;
    SFXMargin margin;
    SFCError error(SFERR_NO_ERROR);

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

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

            // attach the frame to the dialog
            error = _dialog->SetFrame(_frame);
            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 dialog's message
                    error = _dialog->SetMessageText("in\nSFZTitleBevelFrame\n\nThis is a notification message.");
                    if (error == SFERR_NO_ERROR) {

                        // set the dialog's OK button text
                        error = _dialog->SetButtonText("OK");

                        if (error == SFERR_NO_ERROR) {

                            // set the frame title
                            error = _frame->SetText("SFZTitleBevelFrame");

                            if (error == SFERR_NO_ERROR) {

                                // Calculate the suitable region of the frame within the hint region obtained by deflating the screen device region by (10, 10), 
                                // which will be aligned at the center and the middle of the hint region.
                                // Set the frame's real region to it
                                // * Automatically, the dialog's real region will be set to the region obtained by deflating it by the frame margin.
                                _frame->SetRealBound(_frame->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
                                // * automatically, the frame will be moved foremost together
                                _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 only
    // * automatically, the frame will be detached from the dialog and become invisible
    invoker->Terminate();

    return;
}

	Tip
	If a content-responder is closed with the SFYResponder::Terminate function, the corresponding attachment-frame will be detached from it, become invisible, and restore to the normal frame which can be attached to other responder. There is no need to close the corresponding attachment-frame.