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

Статья
08/27/2023

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

Синтаксис

void CreateDialogA(
  [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.

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

None

Remarks

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

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

Примеры

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

Примечание

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

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	winuser.h (включая Windows.h)
Библиотека	User32.lib
DLL	User32.dll