CreateDialog

המאקרו CreateDialog יוצר תיבת הדו-שיח modeless ממשאב תבנית בתיבת הדו-שיח. המאקרו CreateDialog משתמשת בפונקציה CreateDialogParam.

(HWND CreateDialog HINSTANCE  hInstance, / / לטפל מופע היישוםLPCTSTRlpTemplate, / / מזהה שם תבנית של תיבת הדו-שיחHWNDhWndParent, / / לטפל לחלון הבעליםDLGPROClpDialogFunc / / המצביע אל תיבת הדו-שיח תיבת שגרה);
 

פרמטרים

hInstance
מזהה מופע של המודול מכיל קובץ ההפעלה שאת התבנית בתיבת הדו-שיח.
lpTemplate
מזהה התבנית בתיבת הדו-שיח. פרמטר זה הוא או את המצביע כדי מחרוזת המסתיימת ב- null תווים המציינת את שם התבנית בתיבת הדו-שיח או ערך של מספר שלם המציין את מזהה המשאב של התבנית בתיבת הדו-שיח. אם הפרמטר מציין את מזהה המשאב, word הגבוהות שלה חייב להיות אפס, word מסדר נמוך שלו חייב להכיל את המזהה. באפשרותך להשתמש במאקרו MAKEINTRESOURCE ליצירת ערך זה.
hWndParent
מזהה את החלון שבבעלותה בתיבת הדו-שיח.
lpDialogFunc
מצביע לשגרה בתיבת הדו-שיח. לקבלת מידע נוסף אודות ההליך בתיבת הדו-שיח, עיין DialogProc.

להחזיר ערכים

אם הפונקציה מצליחה, הערך המוחזר הוא נקודת האחיזה אל תיבת הדו-שיח.

אם הפעולה תיכשל, הערך המוחזר הוא 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 .

QuickInfo

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

Index