הפונקציה GetWindow מאחזר נקודת אחיזה חלון בעל הקשר שצוין (סדר z או בעלים) אל החלון שצוין.
(HWND GetWindow HWND hWnd, / / לטפל לחלון המקוריUINTuCmd / / דגל הקשר);
| ערך | משמעות |
|---|---|
| GW_CHILD | נקודת האחיזה המאוחזרים מזהה את חלון צאצא בראש סדר Z, אם החלון שצוין הוא חלון האב; אחרת, נקודת האחיזה המאוחזרים הוא NULL. הפונקציה בודקת רק את חלונות צאצאים של החלון שצוין. היא לא לבחון חלונות צאצאים. |
| GW_ENABLEDPOPUP | Windows NT 5.0 ואילך: נקודת האחיזה המאוחזרים מזהה את החלון המוקפץ המותאם בבעלות את החלון שצוין (החיפוש ישתמש הראשון חלון כזה נמצא שימוש GW_HWNDNEXT); אחרת, אם אין חלונות מוקפצים זמין, נקודת האחיזה המאוחזרים היא של החלון שצוין. |
| GW_HWNDFIRST | נקודת האחיזה המאוחזרים מזהה את החלון מאותו סוג, לפי סדר z הגבוהה ביותר. אם החלון שצוין הוא החלון העליון, נקודת האחיזה מזהה את החלון העליון לפי סדר z הגבוהה ביותר. אם החלון שצוין הוא חלון ברמה העליונה, נקודת האחיזה מזהה את החלון ברמה הגבוהה ביותר לפי סדר Z. אם החלון שצוין הוא חלון צאצא, נקודת האחיזה מזהה את החלון אח הגבוהה ביותר לפי סדר z. |
| GW_HWNDLAST | נקודת האחיזה המאוחזרים מזהה את החלון מאותו סוג שהוא הנמוך ביותר לפי סדר Z. אם החלון שצוין הוא החלון העליון, נקודת האחיזה מזהה את החלון העליון שהוא הנמוך ביותר לפי סדר Z. אם החלון שצוין הוא חלון ברמה העליונה, נקודת האחיזה מזהה את החלון ברמה הנמוכה ביותר לפי סדר Z. אם החלון שצוין הוא חלון צאצא, נקודת האחיזה מזהה את חלון אח שהוא הנמוך ביותר לפי סדר z. |
| GW_HWNDNEXT | נקודת האחיזה המאוחזרים מזהה את החלון מתחת החלון שצוין לפי סדר Z. אם החלון שצוין הוא החלון העליון, נקודת האחיזה מזהה את החלון העליון מתחת החלון שצוין. אם החלון שצוין הוא חלון ברמה העליונה, נקודת האחיזה מזהה את החלון הראשי מתחת החלון שצוין. אם החלון שצוין הוא חלון צאצא, נקודת האחיזה מזהה את החלון אחים מתחת החלון שצוין. |
| GW_HWNDPREV | נקודת האחיזה המאוחזרים מזהה את החלון מעל החלון שצוין לפי סדר Z. אם החלון שצוין הוא החלון העליון, נקודת האחיזה מזהה את החלון העליון מעל החלון שצוין. אם החלון שצוין הוא חלון ברמה העליונה, נקודת האחיזה מזהה את החלון ברמה העליונה מעל החלון שצוין. אם החלון שצוין הוא חלון צאצא, נקודת האחיזה מזהה את החלון אח מעל החלון שצוין. |
| GW_OWNER | נקודת האחיזה המאוחזרים מזהה חלון הבעלים של החלון שצוין, אם בכלל. |
אם הפונקציה מצליחה, הערך המוחזר הוא מטפל בחלון. אם החלון לא קיים עם קשרי גומלין שצוין אל החלון שצוין, הערך המוחזר הוא NULL. כדי לקבל מידע שגיאות מורחב, לקרוא GetLastError.
הפונקציה EnumChildWindows היא אמינה יותר מאשר קריאה GetWindow בלולאה. יישום כי שיחות GetWindow כדי לבצע משימה זו סיכונים להיות תפס בלולאה אינסופית או הפניה נקודת אחיזה חלון אשר נהרס.
חלונות CE: ב- Windows CE גירסה 1.0, ערך דגל GW_OWNER עבור הפרמטר uCmd נתמך רק עבור תיבות דו-שיח.
nbsp; Windows &NT: מחייב גירסה 3.1 או גירסה מתקדמת יותר.
Windows:נדרש Windows 95 או גירסה מתקדמת יותר.
חלונות CE:דורש גירסה 1.0 ואילך.
כותרת עליונה:להצהיר על winuser.h.
ייבוא ספריית:השתמש user32.lib.
מבט כולל על Windows, פונקציות חלון, EnumChildWindows