Win32 API. Справочник по диалоговому окну
Страница 5. Функция CreateDialogParam


Функция CreateDialogParam

(СоздатьДиалогПоПараметрам)

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

Синтаксис

HWND CreateDialogParam
(
HINSTANCE hInstance,// дескриптор экземпляра программы
LPCTSTR lpTemplateName,// идентификация шаблона блока диалога
HWND hWndParent,// дескриптор окна владельца
DLGPROC lpDialogFunc,// указатель на процедуру диалогового окна
LPARAM dwInitParam // инициализационное значение
);

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

Возвращаемые значения
Если функция завершилась успешно, возвращается значение дескриптор окна блока диалога.
Если функция потерпела неудачу, возвращается значение ПУСТО (NULL).

Замечания
Чтобы создать диалоговое окно, функция CreateDialogParam использует функцию CreateWindowEx. Затем CreateDialogParam отправляет сообщение WM_INITDIALOG (и сообщение WM_SETFONT, если шаблон определяет стиль DS_SETFONT) процедуре диалогового окна. Функция показывает диалоговое окно, если шаблон определяет стиль WS_VISIBLE. В конце концов, CreateDialogParam возвращает дескриптор окна блока диалога.
После того как CreateDialogParam возвращает значение, прикладная программа отображает на экране диалоговое окно (если оно ещё не отображено) используя функцию ShowWindow. Прикладная программа разрушает диалоговое окно, используя функцию DestroyWindow.

Windows 95: Система может поддерживать максимум 16,364 дескрипторов окна

Смотри также
CreateDialog, CreateDialogIndirect, CreateDialogIndirectParam, CreateWindowEx, DestroyWindow, DialogProc, MAKEINTRESOURCE, ShowWindow, WM_INITDIALOG, WM_SETFONT

Размещение и совместимость CreateDialogParam

Windows NTДа 
Win95Да
Win32sДа
Импортируемая библиотекаuser32.lib
Заголовочный файлwinuser.h
UnicodeWinNT
Замечания по платформеНе имеется

 
« Предыдущая статья   Следующая статья »