Intel® Fortran Libraries Reference

Descriptions of the Library Routines 2hwndParent(Input) Integer. Specifies the parent window for the dialog box. If omitted, the value is determinedin this order:1. If DLGMODAL is called from the callback of a modal or modeless dialog box, then thatdialog box is the parent window.2. If it is a QuickWin or Standard Graphics application, then the frame window is the parentwindow.3. The Windows desktop window is the parent window.Results:The result type is INTEGER(4). By default, if successful, it returns the identifier of the controlthat caused the dialog to exit; otherwise, it returns –1. The return value can be changed with theDLGSETRETURN subroutine.During execution, DLGMODAL displays a dialog box and then waits for user control selections.When a control selection is made, the callback routine, if any, of the selected control (set withDLGSETSUB) is called.The dialog remains active until an exit control is executed: either the default exit associated withthe OK and Cancel buttons, or DLGEXIT within your own control callbacks. DLGMODAL doesnot return a value until the dialog box is exited.The default return value for DLGMODAL is the identifier of the control that caused it to exit (forexample, IDOK for the OK button and IDCANCEL for the Cancel button). You can specify yourown return value with DLGSETRETURN from within one of your dialog control callbackroutines. You should not specify –1 as your return value, because this is the error valueDLGMODAL returns if it cannot open the dialog.Use DLGMODALWITHPARENT when you want the parent window to be other than the defaultvalue (see the definition of hwndParent above). In particular, in an SDI or MDI Windowsapplication, you may want the parent window to be the main application window. The parentwindow is disabled for user input while the modal dialog box is displayed.CompatibilityCONSOLE STANDARD GRAPHICS QUICKWIN GRAPHICS WINDOWS LIBSee Also: “DLGSETRETURN”, “DLGSETSUB”, “DLGEXIT”, “DLGINIT,DLGINITWITHRESOURCEHANDLE”ExampleUSE IFLOGMINCLUDE "MYDLG.FD"INTEGER returnTYPE (DIALOG) mydialog2-57