(ПараметрыБлокаДиалога)

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

Синтаксис

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

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

Возвращаемые значения
Если функция завершается успешно, возвращаемое значение - значение параметра nResult, заданного при вызове функции EndDialog, которая завершает работу диалогового окна.
Если функция не выполняет задачу, возвращаемое значение – (минус)1.

Замечания
Функция DialogBoxParam использует функцию CreateWindowEx, чтобы создать диалоговое окно. Затем DialogBoxParam отправляет сообщение WM_INITDIALOG (и сообщение WM_SETFONT, если шаблон устанавливает стиль DS_SETFONT) в процедуру диалогового окна. Функция отображает на экране диалоговое окно (независимо от того, определяет ли шаблон стиль WS_VISIBLE), отключает окно владельца, и запускает свой собственный цикл сообщений, чтобы извлекать и распределять сообщения для блока диалога.
Когда процедура диалогового окна вызывает функцию EndDialog, DialogBoxParam разрушает диалоговое окно, заканчивает цикл сообщений, включает окно владельца (если оно ранее было включено) и возвращает параметр nResult, заданный процедурой диалогового окна, когда она вызвала EndDialog.
Windows 95: Система может поддерживать максимум 16,364 дескрипторов окна.

Смотри также
CreateWindowEx, DialogBox, DialogBoxIndirect, DialogBoxIndirectParam, DialogProc, EndDialog, MAKEINTRESOURCE, WM_INITDIALOG, WM_SETFONT

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

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