GetWindow

הפונקציה GetWindow מאחזר נקודת אחיזה חלון בעל הקשר שצוין (סדר z או בעלים) אל החלון שצוין.

(HWND GetWindow HWND  hWnd, / / לטפל לחלון המקוריUINTuCmd / / דגל הקשר);
 

פרמטרים

hWnd
לטפל לחלון. נקודת האחיזה חלון אחזור נמצאת ביחס לחלון זה, בהתבסס על הערך של הפרמטר uCmd.
uCmd
מציין את מערכת היחסים בין החלון שצוין והחלון האחיזה שאת נמצאת שיש לאחזר. פרמטר זה יכול להיות אחד מהבאים:
ערך משמעות
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 נתמך רק עבור תיבות דו-שיח.

QuickInfo

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

ראה גם

מבט כולל על Windows, פונקציות חלון, EnumChildWindows

Index