GetWindowLong

הפונקציה GetWindowLong מאחזרת מידע אודות החלון שצוין. הפונקציה מאחזר גם את הערך 32 סיביות (ארוכה) ההיסט שצוין לזיכרון חלון נוסף של חלון.

(GetWindowLong ארוך HWND  hWnd, / / לטפל של חלוןintnIndex / / ההיסט של הערך כדי לאחזר);
 

פרמטרים

hWnd

לטפל כדי החלון, בעקיפין, את המחלקה אליה שייך החלון.

nIndex

מציין את ההיסט מבוסס אפס לערך שיש לאחזר. ערכים חוקיים נעים בטווח שבין אפס דרך מספר הבתים של זיכרון חלון נוסף, מינוס ארבע; לדוגמה, אם ציינת הבתים 12 או יותר של זיכרון נוסף, ערך של 8 יהיה אינדקס השלישי מספר שלם של 32 סיביות. כדי לאחזר כל ערך אחר, ציין אחד מהערכים הבאים:

ערך	פעולה
GWL_EXSTYLE	מאחזר את סגנונות חלון.
GWL_STYLE	מאחזר את סגנונות חלון.
GWL_WNDPROC	מאחזר את הכתובת של ההליך חלון או נקודת אחיזה המייצג את הכתובת של הפרוצדורה של החלון. עליך להשתמש בפונקציה CallWindowProc כדי לקרוא לפרוצדורה חלון.
GWL_HINSTANCE	מאחזר את המזהה הייחודי של מופע היישום.
GWL_HWNDPARENT	מאחזר את נקודת האחיזה של חלון האב, אם בכלל.
GWL_ID	מאחזר את המזהה של חלון.
GWL_USERDATA	מאחזר את ערך 32 סיביות המשויך החלון. לכל חלון יש ערך 32 סיביות תואם מיועד לשימוש על-ידי היישום שיצר את החלון.

הערכים הבאים זמינים גם כאשר הפרמטר hWnd מזהה תיבת דו-שיח:

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

להחזיר ערכים

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

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

הערות

שמירת זיכרון נוסף חלון על-ידי ציון ערך שאינו אפס חבר cbWndExtra של מבנה WNDCLASSEX בהם משתמשים עם הפונקציה RegisterClassEx.

חלונות CE: הפרמטר nIndex חייב להיות כפולה של 4 בתים. גישה unaligned אינו נתמך.

Windows CE אינו תומך את ערכי GWL_HINSTANCE ו- GWL_HWNDPARENT בפרמטר nIndex.

Windows CE 1.0 גם אינו תומך DWL_DLGPROC וערך GWL_USERDATA בפרמטר nIndex.

QuickInfo

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

ראה גם

מבט כולל על מחלקות חלון, פונקציות המחלקה חלון, CallWindowProc, RegisterClassEx, SetParent, SetWindowLong, WNDCLASS

Index