DialogBoxParam

Функція DialogBoxParam створює модальне діалогове вікно з діалоговому вікні шаблон ресурсу. Перед відображенням діалогового вікна, функція проходить значення застосування визначено у діалоговому вікні порядку як параметр lParam WM_INITDIALOG повідомлення. Застосунок може використовувати це значення ініціалізувати елементи керування діалоговим вікном.

int DialogBoxParam ( HINSTANCE  hInstance, / / ручка екземпляр програмиLPCTSTRlpTemplateName, / / ідентифікує діалоговому вікні шаблонHWNDhWndParent, / / ручка власник вікноDLGPROClpDialogFunc, / / вказівник на діалоговому вікні процедуриLPARAMdwInitParam / / Ініціалізація значення);
 

Параметри

hInstance
Визначає екземпляр модуля, чиї виконуваний файл містить діалоговому вікні шаблон.
lpTemplateName
Визначає діалоговому вікні шаблон. Цей параметр є або вказівник на рядок нульовим символів, який визначає ім'я діалоговому вікні шаблон або ціле значення, яке визначає ідентифікатор ресурсу діалоговому вікні шаблон. Якщо параметр задає ідентифікатор ресурсів, його слово вищого порядку повинні бути нульовим і його слово Низька замовлення може містити ідентифікатор. MAKEINTRESOURCE макрос можна використовувати для створення цього значення.
hWndParent
Визначає, що володіє діалогового вікна.
lpDialogFunc
Вказівник у діалоговому вікні порядку. Щоб отримати додаткові відомості про діалоговому вікні процедуру перегляньте DialogProc.
dwInitParam
Визначає значення перейти до діалогового вікна в параметрі lParam WM_INITDIALOG повідомлення.

Повернення значень

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

Якщо функцію не вдається, значення, що повертається, є – 1. Щоб отримати докладні відомості про помилку, зателефонуйте GetLastError.

Зауваження

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

Коли діалоговому вікні порядок закликає EndDialog функції, DialogBoxParam руйнує діалогового вікна, закінчується повідомлення петлі, дозволяє власник вікна (якщо увімкнуто) та повертає nResult параметр визначений діалоговому вікні процедури, коли він називається EndDialog.

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.

Дивіться також

Діалогове вікно огляд коробки, діалоговому вікні функції, CreateWindowEx, DialogBox, DialogBoxIndirect, DialogBoxIndirectParam, DialogProc, EndDialog, MAKEINTRESOURCE, WM_INITDIALOG, WM_SETFONT

Index