|
Overview |
|
|
|
Group |
|
|
|
Quick Info
Windows NT
| Yes
| Win95
| Yes
| Win32s
| Yes
| Import Library
| user32.lib
| Header File
| winuser.h
| Unicode
| WinNT
| Platform Notes
| None
|
|
|
CreateDialog
The CreateDialog macro creates a modeless dialog box from a dialog box template resource. The CreateDialog macro uses the CreateDialogParam function.
HWND CreateDialog(
HINSTANCE hInstance,
| // handle to application instance
| LPCTSTR lpTemplate,
| // identifies dialog box template name
| HWND hWndParent,
| // handle to owner window
| DLGPROC lpDialogFunc
| // pointer to dialog box procedure
| );
|
|
Parameters
hInstance
Identifies an instance of the module whose executable file contains the dialog
box template.
lpTemplate
Identifies the dialog box template. This parameter is either the pointer to a
null-terminated character string that specifies the name of the dialog box
template or an integer value that specifies the resource identifier of the dialog
box template. If the parameter specifies a resource identifier, its high-order
word must be zero and its low-order word must contain the identifier. You can
use the MAKEINTRESOURCE macro to create this value.
hWndParent
Identifies the window that owns the dialog box.
lpDialogFunc
Points to the dialog box procedure. For more information about the dialog box
procedure, see DialogProc.
Return Values
If the function succeeds, the return value is the handle to the dialog box.
If the function fails, the return value is NULL.
Remarks
The CreateDialog function uses the CreateWindowEx function to create the dialog box. CreateDialog then sends a WM_INITDIALOG message (and a WM_SETFONT message if the template specifies the DS_SETFONT style) to the dialog box
procedure. The function displays the dialog box if the template specifies the
WS_VISIBLE style. Finally, CreateDialog returns the window handle to the dialog box.
After CreateDialog returns, the application displays the dialog box (if it is not already
displayed) by using the ShowWindow function. The application destroys the dialog box by using the DestroyWindow function.
Windows 95: The system can support a maximum of 16,364 window handles.
See Also
CreateDialogIndirect, CreateDialogIndirectParam, CreateDialogParam, CreateWindowEx, DestroyWindow, DialogBox, DialogProc, ShowWindow, WM_INITDIALOG, WM_SETFONT
Related Links
Software for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
TMS Scripter Studio Pro components for Delphi/C++Builder
More Online Helps
Win32 Multimedia Programmer's Reference (mmedia.hlp)
OLE Programmer's Reference (ole.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (tapi.hlp)
Unix Manual Pages
|
