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_GETTEXT、 LB_GETTEXT或 CB_GETLBTEXT 訊息,或 GetWindowText 函式。
如果清單方塊具有擁有者繪製的樣式,但不是 LBS_HASSTRINGS 樣式,則傳回值一律是 DWORD的大小,以位元組為單位。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 |
Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 |
Windows Server 2003 [僅限桌面應用程式] |
標頭 |
|