(СоздатьДиалог)

Макрокоманда CreateDialog создает немодальное диалоговое окно из ресурса шаблона блока диалога. Макрокоманда CreateDialog использует функцию CreateDialogParam.

Синтаксис

HWND CreateDialog
(
	HINSTANCE hInstance,		// дескриптор экземпляра прикладной программы
	LPCTSTR lpTemplate,		// идентифицирует название шаблона блока диалога
	HWND hWndParent,		// дескриптор окна владельца
	DLGPROC lpDialogFunc 		// указатель на процедуру диалогового окна
);

Параметры
hInstance
Идентифицирует экземпляр модуля, исполняемый файл которого содержит шаблон диалогового окна.
lpTemplate
Идентифицирует шаблон диалогового окна. Этот параметр является или указателем на строку символов с нуль-терминатором в конце, которая определяет название шаблона блока диалога или на целочисленное значение, которое определяет идентификатор ресурса шаблона диалогового окна. Если параметр устанавливает идентификатор ресурса, его старшее слово должно быть нулевое, а его младшее слово должно содержать идентификатор. Вы можете использовать макрокоманду MAKEINTRESOURCE, чтобы создать это значение.
hWndParent
Идентифицирует окно, которому принадлежит блок диалога.
lpDialogFunc
Указывает на процедуру диалогового окна. Для получения дополнительной информации о процедуре диалогового окна, см. статью DialogProc.

Возвращаемые значения
Если функция завершает работу успешно, возвращаемое значение - дескриптор диалогового окна.
Если функция терпит неудачу, возвращаемое значение -ПУСТО (NULL).

Замечания
Функция CreateDialog использует для создания диалогового окна функцию CreateWindowEx. Затем CreateDialog отправляет сообщение WM_INITDIALOG (и сообщение WM_SETFONT, если шаблон определяет стиль DS_SETFONT) в процедуру диалогового окна. Функция показывает блок диалога, если шаблон определяет стиль WS_VISIBLE. В заключение, CreateDialog возвращает дескриптор окна блока диалога.
После того как CreateDialog возвращает значение, прикладная программа показывает диалоговое окно (если оно еще не отображено на экране) при помощи использования функции ShowWindow. Приложение разрушает диалоговое окно, используя функцию DestroyWindow.

Windows 95: Система может поддерживать максимум 16 364 дескриптора окна.

Смотри также
CreateDialogIndirect, CreateDialogIndirectParam, CreateDialogParam, CreateWindowEx, DestroyWindow, DialogBox, DialogProc, ShowWindow, WM_INITDIALOG, WM_SETFONT

Размещение и совместимость CreateDialog

Windows NT				Да 
Win95					Да 
Win32s					Да 
Импортируемая библиотека			user32.lib 
Заголовочный файл				winuser.h 
Unicode					WinNT
Замечания по платформе			Не имеется