| int DialogBoxParam(hinst, lpTemplateName, hwndOwner, dlgprc, lInitParam) | |||||
| HANDLE hinst; | /* handle of application instance | */ | |||
| LPCTSTR lpTemplateName; | /* address of dialog box template name | */ | |||
| HWND hwndOwner; | /* handle of owner window | */ | |||
| DLGPROC dlgprc; | /* instance address of dialog box procedure | */ | |||
| LPARAM lInitParam; | /* initialization value | */ | |||
This function creates a modal dialog box, sends a WM_INITDIALOG message to the dialog function before displaying the dialog box, and passes lInitParam as the message lParam. This message allows the dialog function to initialize the dialog-box controls.
For more information on creating a modal dialog box, see the description of the DialogBox function.
hinst
Identifies the module that is creating the dialog window. GetModuleHandle(NULL) can be called to return the module handle of the current process.
lpTemplateName
Points to a character string that names the dialog-box template. The string must be a null-terminated character string.
hwndOwner
Identifies the window that owns the dialog box.
dlgprc
Specifies the procedure-instance address of the dialog function. For more information about the dialog box procedure, see the description of the DialogProc callback function.
lInitParam
Is a value which DialogBoxParam passes as the lParam of a WM_INITDIALOG message to the dialog function when it creates the dialog box.
The return value specifies the value of the nResult parameter in the EndDialog function that is used to terminate the dialog box. Values returned by the application's dialog box are processed by Windows and are not returned to the application. The return value is -1 if the function could not create the dialog box.
DialogBox, DialogProc, EndDialog WM_INITDIALOG