CreateDialogParam

הפונקציה CreateDialogParam יוצר תיבת הדו-שיח modeless ממשאב תבנית בתיבת הדו-שיח. לפני הצגת תיבת הדו-שיח, הפונקציה שמעבירים ערך המוגדר על-ידי יישום הנוהל תיבת הדו-שיח כפרמטר lParam של ההודעה WM_INITDIALOG . יישום להשתמש בערך זה כדי לאתחל פקדי תיבת הדו-שיח.

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

פרמטרים

hInstance

מזהה מופע של המודול מכיל קובץ ההפעלה שאת התבנית בתיבת הדו-שיח.

lpTemplateName

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

hWndParent

מזהה את החלון שבבעלותה בתיבת הדו-שיח.

lpDialogFunc

מצביע לשגרה בתיבת הדו-שיח. לקבלת מידע נוסף אודות ההליך בתיבת הדו-שיח, עיין DialogProc.

dwInitParam

מציין את הערך שיש להעביר לפרוצדורה תיבת הדו-שיח בפרמטר lParam בהודעה WM_INITDIALOG.

להחזיר ערכים

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

אם הפעולה תיכשל, הערך המוחזר הוא NULL. כדי לקבל מידע שגיאות מורחב, לקרוא GetLastError.

הערות

הפונקציה CreateDialogParam משתמשת בפונקציה CreateWindowEx כדי ליצור את תיבת הדו-שיח. CreateDialogParam מכן שולח הודעה WM_INITDIALOG (ולא הודעה WM_SETFONT) אם התבנית מציין את סגנון DS_SETFONT הפרוצדורה של תיבת הדו-שיח. הפונקציה מציגה את תיבת הדו-שיח אם התבנית מציין את סגנון WS_VISIBLE. לבסוף, CreateDialogParam מחזיר את נקודת האחיזה של חלון של תיבת הדו-שיח.

לאחר CreateDialogParam מחזיר, היישום מציג את תיבת הדו-שיח (אם לא מוצג כבר) על-ידי שימוש בפונקציה מסוג ShowWindow . היישום הורסת את תיבת הדו-שיח על-ידי שימוש בפונקציה DestroyWindow.

Windows 95 ואילך:המערכת יכול לתמוך מרבי של 255 פקדים לכל תבנית בתיבת הדו-שיח. כדי למקם פקדים יותר מ- 255 בתיבת דו-שיח, צור את הפקדים במטפל בהודעות WM_INITDIALOG במקום להציבם בתבנית.

חלונות CE: לא כל סגנונות נתמכים במבנה DLGTEMPLATE בתבנית הדו-שיח המכונה על-ידי הפרמטר lpTemplateName .

QuickInfo

nbsp; Windows &NT: מחייב גירסה 3.1 או גירסה מתקדמת יותר.
Windows:נדרש Windows 95 או גירסה מתקדמת יותר.
חלונות CE:דורש גירסה 1.0 ואילך.
כותרת עליונה:להצהיר על winuser.h.
ייבוא ספריית:השתמש user32.lib.
Unicode:מיושם על גירסאות Unicode ו- ANSI ב- Windows NT.

ראה גם

סקירה כללית של תיבות הדו-שיח, פונקציות של תיבת הדו-שיח, CreateDialog, CreateDialogIndirect, CreateDialogIndirectParam, CreateWindowEx, DestroyWindow, DialogProc, MAKEINTRESOURCE, מסוג ShowWindow, WM_INITDIALOG, WM_SETFONT

Index