4D v13.4DIALOG |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
4D v13.4
DIALOG
DIALOG
The DIALOG command presents the form form to the user. This command is often used to get information from the user through the use of variables, or to present information to the user, such as options for performing an operation. It is common to display the form inside a modal window created with the Open window command. Here is a typical example of a dialog: Use DIALOG instead of ALERT, CONFIRM or Request when the information that must be presented or gathered is more complex than those commands can manage. Note: In converted databases, it is possible to prohibit data entry in fields of dialog boxes (and thus limit data entry to variables only) using an option in the Preferences of 4D (Compatibility page). This restriction corresponds to the operation of former versions of 4D. Unlike ADD RECORD or MODIFY RECORD, DIALOG does not use the current input form. You must specify the form (project form or table form) to be used in the form parameter. Also, the default button panel is not used if buttons are omitted. In this case, only the Escape (Windows) or Esc (Mac OS) key lets you exit the form. The dialog is accepted if the user clicks an Accept button or presses the Enter key (numeric key pad), or if the ACCEPT command is executed. The dialog is canceled if the user clicks a Cancel button or presses the cancel key (Escape on Windows, Esc on Macintosh), or if the CANCEL command is executed. If you pass the optional * parameter, the form is loaded and displayed in the last open window of the current process and the command finishes it execution while leaving the active form on screen. Note: You must create a window before calling the statement DIALOG(form;*); it is not possible to use the current dialog window in the process nor the window created by default for each process. Otherwise, the error -9909 is generated. After a call to DIALOG, if the dialog is accepted, OK is set to 1; if it is canceled, OK is set to 0. The following example shows the use of DIALOG to specify search criteria. A custom form containing the variables vName and vState is displayed so the user can enter the search criteria. Open window(10;40;370;220) ` Open a modal window The following example can be used to create a tool palette: `Display tool palette After a call to DIALOG, if the dialog is accepted, OK is set to 1; if it is canceled, OK is set to 0. |
PROPERTIES
Product: 4D
INDEX HISTORY
Modified: 4D v11 SQL SEE ALSO
ACCEPT |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||