DestroyWindow

הפונקציה DestroyWindow הורס את החלון שצוין. הפונקציה שולחת הודעות WM_DESTROY ו- WM_NCDESTROY החלון כדי לבטל את הפעלתו ולהסיר מוקד לוח המקשים ממנו. הפונקציה גם הורסת את התפריט של החלון ריקונים התור של הליך משנה, הורסת את שעוני עצר, מסיר בעלות על הלוח, מנתקת את שרשרת מציג הלוח (אם החלון נמצא בחלק העליון של הרשת מציג).

אם החלון שצוין הוא חלון האב או הבעלים, DestroyWindow באופן אוטומטי הורס צאצא משויכות או בבעלות windows כאשר היא הורסת את החלון האב או בעלים. הפונקציה הורס קודם ילד או בבעלות של windows ולאחר מכן הוא הורס את החלון האב או בעלים.

DestroyWindow הורס גם תיבות הדו-שיח modeless שנוצרו על-ידי הפונקציה CreateDialog.

(BOOL DestroyWindow HWND  hWnd / / לטפל לחלון כדי להרוס);
 

פרמטרים

hWnd
לטפל לחלון כדי להשמיד.

להחזיר ערכים

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

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

הערות

הליך משנה לא ניתן להשתמש DestroyWindow כדי להרוס את חלון שנוצרו על-ידי הליך משנה אחר.

אם החלון השמדתה חלון צאצא שאינו כולל את סגנון WS_EX_NOPARENTNOTIFY, נשלחת הודעה WM_PARENTNOTIFY האב.

חלונות CE: הפונקציה DestroyWindow אינה שולחת הודעה WM_NCDESTROY.

QuickInfo

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

ראה גם

מבט כולל על Windows, פונקציות חלון, CreateDialog, של createwindow ליצירת, CreateWindowEx, WM_DESTROY, WM_NCDESTROY, WM_PARENTNOTIFY

Index