CreateDialogIndirectParam

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

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

Параметры

hInstance
Определяет экземпляр модуля, который будет создан диалогового окна.
lpTemplate
Указатель на объект глобальной памяти, содержащий шаблон, который CreateDialogIndirectParam использует для создания диалогового окна. Диалоговое окно поле шаблон состоит из заголовка, который содержит описание диалогового окна, а затем один или несколько дополнительных блоков данных, которые описывают каждый из элементов управления в диалоговом окне. Этот шаблон можно использовать стандартный формат или расширенный формат.

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

В шаблоне окна расширенного диалогового окна заголовка использует формат DLGTEMPLATEEX и определения элемента управления используют формат DLGITEMTEMPLATEEX.

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

hWndParent
Идентифицирует окно, которому принадлежит диалогового окна.
lpDialogFunc
Указатель на процедуру диалогового окна. Для получения дополнительных сведений о процедуру диалогового окна см. DialogProc.
lParamInit
Указывает значение для передачи в диалоговым окном в параметре lParam сообщения WM_INITDIALOG.

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

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

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

Примечания

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

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

В шаблоне коробка стандартного диалога DLGTEMPLATE структуры и каждой из структур DLGITEMTEMPLATE должны быть выровнены по границам DWORD . Создание данных массив, который соответствует структуре DLGITEMTEMPLATE также должны быть выровнены по границе DWORD . Все другие массивы переменной длины в шаблоне должен должны быть выровнены по границам слов.

В шаблоне окна расширенного диалогового окна заголовка DLGTEMPLATEEX и каждой из определений управления DLGITEMTEMPLATEEX должны быть выровнены по границам DWORD . Массив данных создание, если таковые имеются, которые следует структуре DLGITEMTEMPLATEEX также должны быть выровнены по границе DWORD . Все другие массивы переменной длины в шаблоне должны быть выровнены по границам слов.

Все строки символов в поле шаблона диалогового окна, таких как названия для диалогового окна и кнопки, должны быть строками в Юникоде. Для создания кода, который работает на Windows и Windows NT, используйте функцию MultiByteToWideChar для создания этих строк Юникода.

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

Windows CE: Диалоговые окна за пределы видимой области экрана не перепозиционирован автоматически.

Если пользователь нажимает ALT + H, когда диалоговое окно имеет фокус ввода, система посылает сообщение WM_HELP к процедуре диалогового окна. Приложение должно отвечать на это сообщение путем отображения контекстной справки для диалогового окна.

Для стиля член DLGTEMPLATE структуры не поддерживаются следующие стили:

Чтобы получить размещение по умолчанию, используйте стиль DS_CENTER.

Если стиль WS_CHILD не указан, подразумевается WS_POPUP стиль.

QuickInfo

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

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

Диалогового окна Обзор функции окна диалога, CreateDialog, CreateDialogIndirect, CreateDialogParam, CreateWindowEx, DestroyWindow, DialogProc, DLGITEMTEMPLATE, DLGITEMTEMPLATEEX, DLGTEMPLATE, DLGTEMPLATEEX, MultiByteToWideChar, ShowWindow, WM_INITDIALOG, WM_SETFONT

Index