Диалоговое окно

Диалоговое окно макрос создает модальное диалоговое окно в ресурсе шаблона диалогового окна поле. Диалоговое окно не возвращает управления до тех пор, пока функция обратного вызова указанного прекращает модальным диалоговым окном путем вызова функции EndDialog . Диалоговое окно макрос использует функцию DialogBoxParam.

int (диалоговое окно HINSTANCE  hInstance, / / обработать для экземпляра приложенияLPCTSTRlpTemplate, / / идентифицирует шаблон диалогового окна HWNDhWndParent, / / дескриптор окна-владельцаDLGPROClpDialogFunc / / указатель в диалоговое окно поле процедура);
 

Параметры

hInstance

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

lpTemplate

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

hWndParent

Идентифицирует окно, которому принадлежит диалогового окна.

lpDialogFunc

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

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

Если функция выполнена успешно, возвращаемое значение является параметр nResult в вызове функции EndDialog , используемой для завершения диалогового окна.

Если вызов функции был неуспешен, возвращается значение –1. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError.

Примечания

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

Когда процедуру диалогового окна вызывает функцию EndDialog , диалоговое окно разрушает диалогового окна, завершает цикл обработки сообщений, позволяет окно-владелец (если ранее) и возвращает nResult параметр, указанный в процедуру диалогового окна, когда он называется EndDialog.

Windows 95 и более поздние версии:Система может поддерживать до 255 элементов управления на поле шаблона диалогового окна. Для размещения более 255 элементов управления в диалоговом окне, создайте элементы управления в обработчике сообщение WM_INITDIALOG, а не их помещения в шаблоне.

Windows CE: В структуре DLGTEMPLATE в диалоговом окне шаблон, упоминаемый в параметре lpTemplate .. поддерживаются не все стили

QuickInfo

nbsp; Windows &NT: требует версии 3.1 или более поздней версии.
Windows:Требует Windows 95 или более поздней версии.
Windows CE:Требует версии 1.0 или более поздней версии.
Заголовок:Объявленные в winuser.h.
Импорта библиотеки:Используйте user32.lib.
Юникод:В версии Юникода и ANSI в Windows NT.

Родственные слова

Обзор полей диалогового окна, диалогового окна функций CreateDialog, CreateWindowEx, DialogBoxIndirect, DialogBoxIndirectParam, DialogBoxParam, DialogProc, EndDialog, MAKEINTRESOURCE, WM_INITDIALOG, WM_SETFONT

Index