CreateDialogParam

Функция CreateDialogParam создает немодальное диалоговое окно из ресурса шаблона поля диалогового окна. Перед отображением диалогового окна, функция передает определенное приложением значение процедуру диалогового окна в качестве параметра lParam сообщение WM_INITDIALOG . Приложение может использовать это значение для инициализации элементов управления диалогового окна.

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

Параметры

hInstance
Определяет экземпляр модуля, чьи исполняемый файл содержит шаблон поля диалогового окна.
lpTemplateName
Идентифицирует шаблон поля диалогового окна. Этот параметр является либо указатель завершающуюся значением null строку, которая определяет имя шаблона поля диалогового окна или целочисленное значение, указывающее идентификатор ресурса поле шаблона диалогового окна. Если параметр задает идентификатор ресурса, его старшее слово должно быть равным нулю и младшее слово должно содержать идентификатор. Для создания этого значения можно использовать макрос MAKEINTRESOURCE.
hWndParent
Идентифицирует окно, которому принадлежит диалогового окна.
lpDialogFunc
Указатель на процедуру диалогового окна. Для получения дополнительных сведений о процедуру диалогового окна см. DialogProc.
dwInitParam
Указывает значение для передачи в процедуру диалогового окна в параметре lParam в сообщение WM_INITDIALOG.

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

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

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

Примечания

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

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

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

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

QuickInfo

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

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

Обзор полей диалогового окна, диалогового окна функций CreateDialog, CreateDialogIndirect, CreateDialogIndirectParam, CreateWindowEx, DestroyWindow, DialogProc, MAKEINTRESOURCE, ShowWindow, WM_INITDIALOG, WM_SETFONT

Index