Simple common dialog

<< Click to Display Table of Contents >>

Manual > Screen Creation Guide > Forms and Dialogs/Frames/Views > Common Dialogs >

Simple common dialog

What is Simple Common Dialog?

The simple common dialog is a general-purpose dialog that has been available for some time. General-purpose dialogs such as simple message displays and Yes/No confirmation dialogs can be easily displayed by calling common methods such as OpenMsg and OpenYesNoMsg.

For example, you can easily display a message box from a script like this:

event OnMouseUp(button)
{
	::OpenMsg("Hello");
}

There are the following types of simple common dialogs. For details on each calling method, please refer to the links below.

fap_dialog2_0002

Message box (OK button only)

Calling methods (common methods):

fap_dialog2_0003

Message box (Yes/No button)

Calling methods (common methods):

OpenModalYesNoMsg

fap_dialog2_0004

Message box (Yes/No/Cancel buttons)

Calling methods (common methods):

OpenYesNoCancelMsg

OpenModalYesNoCancelMsg

fap_dialog2_0005

Password setting dialog

Calling methods (common methods):

OpenModalPassword

fap_dialog2_0006

Numeric keyboard

Calling methods (common methods):

OpenModalNumKeyEdit

fap_dialog2_0007

Text Keyboard

Calling methods (common methods):

OpenTextKeyEdit

OpenModalTextKeyEdit

fap_dialog2_0008

calendar

Calling methods (common methods):

OpenModalCalendar

fap_dialog2_0009

Form Map

Calling methods (common methods):

OpenModalFormMap

fap_dialog2_0013

Color Selection

Calling methods (common methods):

fap_dialog2_0014

Search Dialog

Calling methods (common methods):

OpenModalSearch

Methods related to simple common dialogs are provided as common methods. For example, they can be executed as object methods such as "this.OpenYesNoMsg(...)", or as root methods such as "::OpenYesNoMsg(...)". Regardless of how they are called, the dialog will not be hidden behind the form, but the behavior of the hierarchical display when multiple dialogs are displayed at the same time will differ.

▪When executed as a method of an object
A displayed dialog will always be displayed in front of the object that called it (i.e., it will not be hidden behind the object that called it). Therefore, if you display another dialog from an object that has a displayed dialog, the later dialog will always be displayed in front of the earlier dialog.

▪When executed as a route method
When multiple dialogs are displayed as root methods, each dialog is positioned as being in the same hierarchy, so no dependency occurs in the hierarchy display. In other words, the operator can freely move between multiple dialog displays with the mouse.

When opening a simple common dialog, you may want to prevent the user from operating the background screen until the dialog is closed. In such cases, you can display the common dialog modally by calling a modal display method with the prefix OpenModal, such as "OpenModalMsg" or "OpenModalYesNoMsg".