Share via


LB_GETTEXTLEN訊息

取得清單方塊中的字串長度。

參數

wParam

以零起始的字串索引。

Windows 95/Windows 98/Windows Edition (Windows Me) : wParam 參數限制為 16 位值。 這表示清單方塊不能包含超過 32,767 個專案。 雖然專案數目受到限制,但是清單方塊中專案的總大小以位元組為單位,只會受限於可用的記憶體。

lParam

不使用這個參數。

傳回值

傳回值是 TCHAR中字串的長度,不包括終止的 Null 字元。 在某些情況下,此值實際上可能大於文字的長度。 如需詳細資訊,請參閱接下來的<備註>一節。

如果 wParam 參數未指定有效的索引,則會LB_ERR傳回值。

備註

在某些情況下,傳回值會大於文字的實際長度。 這會與 ANSI 和 Unicode 的特定混合發生,這是因為作業系統允許在文字內 (DBCS) 字元的情況下,可能存在雙位元組字元集。 不過,傳回值一律會至少與文字的實際長度相同;因此,您一律可以使用它來引導緩衝區配置。 當應用程式同時使用 ANSI 函式和使用 Unicode 的一般對話時,就會發生這種行為。

若要取得文字的確切長度,請使用 WM_GETTEXTLB_GETTEXTCB_GETLBTEXT 訊息,或 GetWindowText 函式。

如果清單方塊具有擁有者繪製的樣式,但不是 LBS_HASSTRINGS 樣式,則傳回值一律是 DWORD的大小,以位元組為單位。

規格需求

需求
最低支援的用戶端
Windows Vista [僅限傳統型應用程式]
最低支援的伺服器
Windows Server 2003 [僅限桌面應用程式]
標頭
Winuser.h (包括 Windows.h)

另請參閱

參考

CB_GETLBTEXT

LB_GETTEXT

其他資源

GetWindowText

WM_GETTEXT