GetClassLong

הפונקציה GetClassLong מאחזר הערך (ארוכה) שצוין של 32 סיביות המשויך את החלון שצוין בתוך מבנה WNDCLASSEX.

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

פרמטרים

hWnd
לטפל כדי החלון, בעקיפין, את המחלקה אליה שייך החלון.
nIndex
מציין את הערך 32 סיביות כדי לאחזר. כדי לאחזר ערך של 32 סיביות מהזיכרון מחלקה נוספת, ציין את היסט הבית חיובי, מבוסס אפס של הערך שיש לאחזר. ערכים חוקיים נעים בטווח שבין אפס דרך מספר הבתים של זיכרון מחלקה נוספת, מינוס ארבע; לדוגמה, אם ציינת הבתים 12 או יותר של זיכרון מחלקה נוספת, ערך של 8 יהיה אינדקס השלישי מספר שלם של 32 סיביות. כדי לאחזר ערך אחר בתוך מבנה WNDCLASSEX , ציין אחד מהערכים הבאים:
ערך פעולה
GCW_ATOM אחזור ערך אטום אשר מזהה באופן ייחודי את מחלקת חלון. זהו האטום באותו שמחזירה הפונקציה RegisterClassEx.
GCL_CBCLSEXTRA מאחזר את הגודל, בבתים, של זיכרון נוסף המשויכות למחלקה.
GCL_CBWNDEXTRA מאחזר את הגודל, בבתים, של זיכרון חלון נוסף המשויך לכל חלון בכיתה. לקבלת מידע אודות גישה אל זיכרון זה, ראה GetWindowLong.
GCL_HBRBACKGROUND מאחזר את נקודת האחיזה של המברשת ברקע המשויכות למחלקה.
GCL_HCURSOR מאחזר את נקודת האחיזה של הסמן המשויכות למחלקה.
GCL_HICON מאחזר את נקודת האחיזה של סמל המשויכות למחלקה.
GCL_HICONSM מאחזר את נקודת האחיזה של סמל קטן המשויכות למחלקה.
GCL_HMODULE מאחזר את נקודת האחיזה של המודול שנרשמו המחלקה.
GCL_MENUNAME מאחזר את הכתובת של מחרוזת שם תפריט. המחרוזת מזהה המשאב תפריט המשויכות למחלקה.
GCL_STYLE מאחזר את הסיביות סגנון מחלקת חלון.
GCL_WNDPROC מאחזר את הכתובת של ההליך חלון המשויכות למחלקה.

להחזיר ערכים

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

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

הערות

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

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

רק ערכים נתמכים עבור הפרמטר nIndex הם GCL_HICON ו- GCL_STYLE.

אם אתה משתמש ברכיב Windows CE Iconcurs, התומכת סמני עכבר פלטפורמות היעד המתאים, באפשרותך גם להשתמש בערך GCL_HCURSOR בפרמטר nIndex.

הערה גירסאות Windows CE התומכים סמני עכבר כוללות את הרכיבים Iconcurs ו- Mcursor במקום הסמל ורכיבים הסמן.

QuickInfo

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

ראה גם

מבט כולל על מחלקות חלון, פונקציות המחלקה חלון, GetWindowLong, RegisterClassEx, SetClassLong, WNDCLASSEX

Index