Макрос CreateDialogW (winuser.h)

Статья
11/20/2024

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

Синтаксис

void CreateDialogW(
  [in, optional]  hInstance,
  [in]            lpName,
  [in, optional]  hWndParent,
  [in, optional]  lpDialogFunc
);

Параметры

[in, optional] hInstance

Тип: HINSTANCE

Дескриптор модуля, содержащего шаблон диалогового окна. Если этот параметр имеет значение NULL, используется текущий исполняемый файл.

[in] lpName

Тип: LPCTSTR

Шаблон диалогового окна. Этот параметр является указателем на строку символов, завершающую значение NULL, указывающее имя шаблона диалогового окна или целочисленное значение, указывающее идентификатор ресурса шаблона диалогового окна. Если параметр задает идентификатор ресурса, его слово высокого порядка должно быть равно нулю, а его слово с низким порядком должно содержать идентификатор. Для создания этого значения можно использовать макрос MAKEINTRESOURCE.

[in, optional] hWndParent

Тип: HWND

Дескриптор окна, которому принадлежит диалоговое окно.

[in, optional] lpDialogFunc

Тип: DLGPROC

Указатель на процедуру диалогового окна. Дополнительные сведения о процедуре диалогового окна см. в разделе DialogProc.

Возвращаемое значение

Никакой

Замечания

Функция CreateDialog использует функцию CreateWindowEx для создания диалогового окна. CreateDialog затем отправляет сообщение WM_INITDIALOG (и сообщение WM_SETFONT, если шаблон задает стиль DS_SETFONT или DS_SHELLFONT) в процедуру диалогового окна. Функция отображает диалоговое окно, если шаблон задает стиль WS_VISIBLE. Наконец, CreateDialog возвращает дескриптор окна в диалоговое окно.

После возврата CreateDialog приложение отображает диалоговое окно (если оно еще не отображается) с помощью функции ShowWindow. Приложение уничтожает диалоговое окно с помощью функции DestroyWindow. Чтобы поддерживать навигацию по клавиатуре и другие функции диалогового окна, цикл сообщений для диалогового окна должен вызвать функцию IsDialogMessage.

Примеры

Пример см. в разделе Создание диалогового окна без режима.

Заметка

Заголовок winuser.h определяет CreateDialog как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	winuser.h (включая Windows.h)
библиотеки	User32.lib
DLL	User32.dll