יישום שולח הודעת LB_GETTEXTLEN כדי לאחזר את האורך של מחרוזת בתיבת רשימה.
LB_GETTEXTLEN wParam = אינדקס (WPARAM); / / פריט אינדקס lParam = 0; / / לא נמצא בשימוש; חייב להיות אפס
Windows 95 ו- Windows 98: הפרמטר wParam מוגבלת לערכים של 16 סיביות. משמעות הדבר היא תיבות רשימה אינה יכולה להכיל פריטים יותר 32,767. למרות מספר הפריטים היא מוגבלת, הגודל הכולל בבתים של הפריטים בתיבת רשימה מוגבל רק על-ידי זיכרון זמין.
הערך המוחזר הוא האורך של המחרוזת, בתווים, לא כולל את התו null סיום. בתנאים מסוימים, ערך זה עשוי להיות למעשה גדול מהאורך של הטקסט. לקבלת מידע נוסף, עיין בסעיף הערות הבאות.
אם הפרמטר אינדקס לא לציין אינדקס חוקי, הערך המוחזר הוא LB_ERR.
בתנאים מסוימים, הערך המוחזר גדול יותר מאורך הטקסט בפועל. זו מתרחשת עם תערובות מסוימים של ANSI ו- Unicode, והיא עקב שמערכת ההפעלה ומאפשרת לקיום אפשרי של תווים של שני בתים (dbcs) תווים בתוך הטקסט. הערך המוחזר, עם זאת, תמיד יהיה גדול לפחות כמו האורך הממשי של הטקסט; אתה וכך תמיד להשתמש בו כדי להנחות הקצאת מאגר. התנהגות זו עשויה להתרחש כאשר יישום משתמש בפונקציות ANSI והן תיבות דו-שיח משותפות, להשתמש ב- Unicode.
כדי להשיג את האורך המדויק של הטקסט, השתמש הודעות WM_GETTEXT, LB_GETTEXT או CB_GETLBTEXT, או בפונקציה GetWindowText.
nbsp; Windows &NT: מחייב גירסה 3.1 או גירסה מתקדמת יותר.
Windows:נדרש Windows 95 או גירסה מתקדמת יותר.
חלונות CE:דורש גירסה 1.0 ואילך.
כותרת עליונה:להצהיר על winuser.h.
מבט כולל על תיבות רשימה, תיבת רשימה הודעות, CB_GETLBTEXT, GetWindowText, LB_GETTEXT, WM_GETTEXT