Макрос DialogBoxW (winuser.h)
Создает модальное диалоговое окно из ресурса шаблона диалогового окна. DialogBox не возвращает управление, пока указанная функция обратного вызова не завершит модальное диалоговое окно путем вызова функции EndDialog .
DialogBox реализуется как вызов функции DialogBoxParam .
Синтаксис
void DialogBoxW(
[in, optional] hInstance,
[in] lpTemplate,
[in, optional] hWndParent,
[in, optional] lpDialogFunc
);
Параметры
[in, optional] hInstance
Тип: HINSTANCE
Дескриптор модуля, который содержит шаблон диалогового окна. Если этот параметр имеет значение NULL, используется текущий исполняемый файл.
[in] lpTemplate
Тип: LPCTSTR
Шаблон диалогового окна. Этот параметр является либо указателем на строку символов, завершающуюся null, которая указывает имя шаблона диалогового окна, либо целочисленное значение, указывающее идентификатор ресурса шаблона диалогового окна. Если параметр задает идентификатор ресурса, его высокоупорядоченное слово должно быть равно нулю, а слово нижнего порядка должно содержать идентификатор. Для создания этого значения можно использовать макрос MAKEINTRESOURCE .
[in, optional] hWndParent
Тип: HWND
Дескриптор окна, которому принадлежит диалоговое окно.
[in, optional] lpDialogFunc
Тип: DLGPROC
Указатель на процедуру диалогового окна. Дополнительные сведения о процедуре диалогового окна см. в разделе DialogProc.
Возвращаемое значение
None
Remarks
Макрос DialogBox использует функцию CreateWindowEx для создания диалогового окна. Затем DialogBox отправляет WM_INITDIALOG сообщение (и WM_SETFONT сообщение, если шаблон задает DS_SETFONT или стиль DS_SHELLFONT) в процедуру диалогового окна. Функция отображает диалоговое окно (независимо от того, указывает ли шаблон стиль WS_VISIBLE ), отключает окно владельца и запускает собственный цикл сообщений для получения и отправки сообщений для диалогового окна.
Когда процедура диалогового окна вызывает функцию EndDialog , DialogBox уничтожает диалоговое окно, завершает цикл сообщений, включает окно владельца (если оно включено ранее) и возвращает параметр nResult , заданный процедурой диалогового окна при вызове метода EndDialog.
Примеры
Пример см. в разделе Создание модального диалогового окна.
Примечание
Заголовок winuser.h определяет DialogBox в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
Целевая платформа | Windows |
Header | winuser.h (включая Windows.h) |
Библиотека | User32.lib |
DLL | User32.dll |
См. также раздел
Основные понятия
Справочные материалы