המאקרו CreateDialog יוצר תיבת הדו-שיח modeless ממשאב תבנית בתיבת הדו-שיח. המאקרו CreateDialog משתמשת בפונקציה CreateDialogParam.
(HWND CreateDialog HINSTANCE hInstance, / / לטפל מופע היישוםLPCTSTRlpTemplate, / / מזהה שם תבנית של תיבת הדו-שיחHWNDhWndParent, / / לטפל לחלון הבעליםDLGPROClpDialogFunc / / המצביע אל תיבת הדו-שיח תיבת שגרה);
אם הפונקציה מצליחה, הערך המוחזר הוא נקודת האחיזה אל תיבת הדו-שיח.
אם הפעולה תיכשל, הערך המוחזר הוא NULL. כדי לקבל מידע שגיאות מורחב, לקרוא GetLastError.
הפונקציה CreateDialog משתמשת בפונקציה CreateWindowEx כדי ליצור את תיבת הדו-שיח. CreateDialog מכן שולח הודעה WM_INITDIALOG (ולא הודעה WM_SETFONT ) אם התבנית מציין את סגנון DS_SETFONT הפרוצדורה של תיבת הדו-שיח. הפונקציה מציגה את תיבת הדו-שיח אם התבנית מציין את סגנון WS_VISIBLE. לבסוף, CreateDialog מחזיר את נקודת האחיזה של חלון אל תיבת הדו-שיח.
לאחר CreateDialog מחזיר, היישום מציג את תיבת הדו-שיח (אם לא מוצג כבר) על-ידי שימוש בפונקציה מסוג ShowWindow . היישום הורסת את תיבת הדו-שיח על-ידי שימוש בפונקציה DestroyWindow.
Windows 95 ואילך:המערכת יכול לתמוך מרבי של 255 פקדים לכל תבנית בתיבת הדו-שיח. כדי למקם פקדים יותר מ- 255 בתיבת דו-שיח, צור את הפקדים במטפל בהודעות WM_INITDIALOG במקום להציבם בתבנית.
חלונות CE: לא כל סגנונות נתמכים במבנה DLGTEMPLATE בתבנית הדו-שיח המכונה על-ידי הפרמטר lpTemplate .
nbsp; Windows &NT: מחייב גירסה 3.1 או גירסה מתקדמת יותר.
Windows:נדרש Windows 95 או גירסה מתקדמת יותר.
חלונות CE:דורש גירסה 1.0 ואילך.
כותרת עליונה:להצהיר על winuser.h.
ייבוא ספריית:השתמש user32.lib.
Unicode:מיושם על גירסאות Unicode ו- ANSI ב- Windows NT.
סקירה כללית של תיבות הדו-שיח, פונקציות של תיבת הדו-שיח, CreateDialogIndirect, CreateDialogIndirectParam, CreateDialogParam, CreateWindowEx, DestroyWindow, DialogBox, DialogProc, מסוג ShowWindow, WM_INITDIALOG, WM_SETFONT