DialogBox

DialogBox макрос створює модальне діалогове вікно з діалоговому вікні шаблон ресурсу. DialogBox не повертає керування поки вказаного зворотного виклику функції припиняється модальне діалогове вікно шляхом виклику функції EndDialog . DialogBox макрос використовується функція DialogBoxParam.

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

Параметри

hInstance

Визначає екземпляр модуля, чиї виконуваний файл містить діалоговому вікні шаблон.

lpTemplate

Визначає діалоговому вікні шаблон. Цей параметр є або вказівник на рядок нульовим символів, який визначає ім'я діалоговому вікні шаблон або ціле значення, яке визначає ідентифікатор ресурсу діалоговому вікні шаблон. Якщо параметр задає ідентифікатор ресурсів, його слово вищого порядку повинні бути нульовим і його слово Низька замовлення може містити ідентифікатор. MAKEINTRESOURCE макрос можна використовувати для створення цього значення.

hWndParent

Визначає, що володіє діалогового вікна.

lpDialogFunc

Вказівник у діалоговому вікні порядку. Щоб отримати додаткові відомості про діалоговому вікні процедуру перегляньте DialogProc.

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

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

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

Зауваження

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

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

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

Windows CE: У структуру DLGTEMPLATE в діалоговому шаблон, на які посилаються lpTemplate параметра. підтримуються не всі стилі

QuickInfo

nbsp; Windows &NT: вимагає 3.1 або пізнішої версії.
Windows:Вимагає Windows 95 або пізнішої версії.
Windows CE:Потрібна Версія 1.0 або пізнішу версію.
Заголовка:Оголошена в winuser.h.
Імпортувати бібліотеки:Використання user32.lib.
Юнікод:Реалізований у вигляді Юнікод і ANSI версії на Windows NT.

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

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

Index