CreateDialogIndirectParamA / CreateDialogIndirectParamW
The CreateDialogIndirectParam function creates a modeless dialog box from a dialog box
template in memory. Before displaying the dialog box, the function passes a
program-defined value to the dialog box procedure as the lParam parameter of the
WM_INITDIALOG message. A program can use this value to initialize dialog box
controls.
HWND CreateDialogIndirectParam(
HINSTANCE hInstance, // handle of application instance
LPCDLGTEMPLATE lpTemplate, // address of dialog box template
HWND hWndParent, // handle of owner window
DLGPROC lpDialogFunc, // address of dialog box procedure
LPARAM lParamInit // initialization value
);
Returns
If the function succeeds, the return value is the handle of the dialog box. If the
function fails, the return value is NULL.
value is 0xFFFFFFFF.
|
CreateDialogParamA / CreateDialogParamW
The CreateDialogParam function creates a modeless dialog box from a dialog box template
resource. Before displaying the dialog box, the function passes a program-defined value
to the dialog box procedure as the lParam parameter of the the WM_INITDIALOG message. A
program can use this value to initialize dialog box controls.
HWND CreateDialogParam(
HINSTANCE hInstance, // handle of application instance
LPCTSTR lpTemplateName, // identifies dialog box template
HWND hWndParent, // handle of owner window
DLGPROC lpDialogFunc, // address of dialog box procedure
LPARAM dwInitParam // initialization value
);
Returns
If the window was previously disabled, the return value is TRUE; otherwise, the return
value is FALSE. To get extended error information, call GetLastError.
|
DialogBox
The DialogBox function creates a modal dialog box from a dialog box template resource.
DialogBox does not return control until the specified callback function terminates the
modal dialog box by calling the EndDialog function.
int DialogBox(
HANDLE hInstance, // handle of application instance
LPCTSTR lpTemplate, // identifies dialog box template
HWND hWndParent, // handle of owner window
DLGPROC lpDialogFunc // address of dialog box procedure
);
Returns
If the function succeeds, the return value is the nResult parameter in the call to
the EndDialog function used to terminate the dialog box. If the function fails, the
return value is -1.
|
DialogBoxIndirect
The DialogBoxIndirect function creates a modal dialog box from a dialog box template
in memory.
int DialogBoxIndirect(
HANDLE hInstance, // handle of application instance
LPDLGTEMPLATE lpTemplate, // identifies dialog box template
HWND hWndParent, // handle of owner window
DLGPROC lpDialogFunc // address of dialog box procedure
);
Returns
The return value is the value of the nResult parameter specified in the EndDialog function
that is used to terminate the dialog box. The system processes values returned by the dialog
box procedure and does not return them to the program. The return value is -1 if the
function cannot create the dialog box. |
DialogBoxParam / DialogBoxParamA / DialogBoxParamW
The DialogBoxParam function creates a modal dialog box from a dialog box template
resource. Before displaying the dialog box, the function passes a program-defined
value to the dialog box procedure as the lParam parameter of the WM_INITDIALOG
message. A program can use this value to initialize dialog box controls.
int DialogBoxParam(
HINSTANCE hInstance, // handle of application instance
LPCTSTR lpTemplateName, // identifies dialog box template
HWND hWndParent, // handle of owner window
DLGPROC lpDialogFunc, // address of dialog box procedure
LPARAM dwInitParam // initialization value
);
Returns
If the function succeeds, the return value is the nResult parameter in the call to the
EndDialog function used to terminate the dialog box. If the function fails, the return
value is -1. |
EndDialog
The EndDialog function destroys a modal dialog box, causing the system to end any
processing for the dialog box.
BOOL EndDialog(
HWND hDlg, // handle of dialog box
int nResult // value to return
);
Returns
If the function succeeds, the return value is TRUE. If the function fails, the return
value is FALSE. |
MessageBeep
Plays a waveform sound. The waveform sound for each sound type is identified by
an entry in the [sounds] section of the registry.
BOOL MessageBeep(
UINT uType // sound type
);
Returns
If the function succeeds, the return value is TRUE. If the function fails, the return
value is FALSE. To get extended error information, call GetLastError. |
MessageBoxA / MessageBoxW
Creates, displays, and operates a message box. The message box contains a
program-defined message and title, plus any combination of predefined icons
and push buttons.
int MessageBox(
HWND hWnd, // handle of owner window
LPCTSTR lpText, // address of text in message box
LPCTSTR lpCaption, // address of title of message box
UINT uType // style of message box
);
Returns
The return value is zero if there is not enough memory to create the message box.
If the function succeeds, the return value is one of the following menu-item values
returned by the dialog box:
IDABORT, IDCANCEL, IDIGNORE, IDNO, IDOK, IDRETRY, IDYES
If a message box has a Cancel button, the function returns the IDCANCEL value if
either the ESC key is pressed or the Cancel button is selected. If the message box
has no Cancel button, pressing ESC has no effect. |
MessageBoxExA / MessageBoxExW
Creates, displays, and operates a message box. The message box contains a
program-defined message and title, plus any combination of predefined icons
and push buttons. The wLanguageId parameter specifies which set of language
resources is used for the predefined push buttons.
int MessageBoxEx(
HWND hWnd, // handle of owner window
LPCTSTR lpText, // address of text in message box
LPCTSTR lpCaption, // address of title of message box
UINT uType, // style of message box
WORD wLanguageId // language identifier
);
Returns
If the function succeeds, the return value is a nonzero menu-item value returned by the
dialog box. |
MessageBoxIndirect / MessageBoxIndirectA / MessageBoxIndirectW
The MessageBoxIndirect function creates, displays, and operates a message box. The message
box contains a program-defined message text and title, any icon, and any combination of
predefined push buttons.
BOOL API MessageBoxIndirect(
LPMSGBOXPARAMS lpMsgBoxParams // address of structure for msg box parameters
); |
|
00. INDEX
03. Breakpoints & Win API Details
2 Dialog Boxes