EndDialog

הפונקציה EndDialog הורס תיבת דו-שיח מודאלית, גורם למערכת לסיים כל עיבוד עבור תיבת הדו-שיח.

(BOOL EndDialog HWND  hDlg, / / לטפל בתיבת הדו-שיחintnResult / / ערך כדי לחזור);
 

פרמטרים

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

להחזיר ערכים

אם הפונקציה מצליחה, הערך המוחזר אינו אפס.

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

הערות

יש להשמיד תיבות דו-שיח שנוצרו על-ידי הפונקציות DialogBox, DialogBoxParam, DialogBoxIndirect, DialogBoxIndirectParam באמצעות הפונקציה EndDialog . יישום הקורא EndDialog מ בתוך השגרה תיבת הדו-שיח; הפונקציה לא לשימוש לכל מטרה אחרת.

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

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

QuickInfo

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

ראה גם

סקירה כללית של תיבות הדו-שיח, פונקציות של תיבת הדו-שיח, DialogBox, DialogBoxIndirect, DialogBoxIndirectParam, DialogBoxParam, WM_INITDIALOG

Index