הפונקציה GetWindowTextLength מאחזר את אורך תווים של טקסט פס הכותרת של החלון שצוין (אם פס הכותרת של החלון). אם החלון שצוין הוא פקד, הפונקציה מאחזר את אורך הטקסט בתוך הפקד. עם זאת, GetWindowTextLength אין אפשרות לאחזר את אורך הטקסט של פקד עריכה ביישום אחר.
int GetWindowTextLength ( HWND hWnd / / לטפל לחלון או לשלוט עם טקסט);
אם הפונקציה מצליחה, הערך המוחזר הוא האורך, התווים של הטקסט. בתנאים מסוימים, ערך זה עשוי להיות למעשה גדול מהאורך של הטקסט. לקבלת מידע נוסף, עיין בסעיף הערות הבאות.
אם החלון לא טקסט, הערך המוחזר הוא אפס. כדי לקבל מידע שגיאות מורחב, לקרוא GetLastError.
אם החלון היעד נמצא בבעלות התהליך הנוכחי, GetWindowTextLength גורם הודעה WM_GETTEXTLENGTH להישלח אל החלון שצוין או פקד.
בתנאים מסוימים, הפונקציה GetWindowTextLength עשויה להחזיר ערך גדול יותר מאורך הטקסט בפועל. זו מתרחשת עם תערובות מסוימים של ANSI ו- Unicode, והיא עקב מערכת המאפשרת לקיום אפשרי של תווי DBCS בתוך הטקסט. הערך המוחזר, עם זאת, תמיד יהיה גדול לפחות כמו האורך הממשי של הטקסט; אתה וכך תמיד להשתמש בו כדי להנחות הקצאת מאגר. התנהגות זו עשויה להתרחש כאשר יישום משתמש בפונקציות ANSI והן תיבות דו-שיח משותפות, להשתמש ב- Unicode. היא יכולה להתרחש גם כאשר יישום משתמש בגירסת ANSI של GetWindowTextLength עם חלון שאת הליך חלון הוא Unicode, או גירסת Unicode GetWindowTextLength עם חלון הליך החלון שלו היא ANSI. לקבלת מידע נוסף על פונקציות של ANSI ו- Unicode, ראה טיפוס פונקציה של Win32.
כדי להשיג את האורך המדויק של הטקסט, השתמש הודעות WM_GETTEXT, LB_GETTEXTאו CB_GETLBTEXT , או בפונקציה GetWindowText.
nbsp; Windows &NT: מחייב גירסה 3.1 או גירסה מתקדמת יותר.
Windows:נדרש Windows 95 או גירסה מתקדמת יותר.
חלונות CE:דורש גירסה 1.0 ואילך.
כותרת עליונה:להצהיר על winuser.h.
ייבוא ספריית:השתמש user32.lib.
Unicode:מיושם על גירסאות Unicode ו- ANSI ב- Windows NT.
מבט כולל על Windows, פונקציות חלון, CB_GETLBTEXT, GetWindowText, LB_GETTEXT, SetWindowText, WM_GETTEXT, WM_GETTEXTLENGTH