SB_GETTEXTLENGTH訊息

從狀態視窗的指定部分擷取文字的長度，以字元為單位。

參數

wParam

要從中擷取文字之元件的以零起始的索引。

lParam

必須為零。

傳回值

傳回包含兩個 16 位值的 32 位值。 低字會指定文字的長度，以字元為單位。 高字會指定用來繪製文字的作業類型。 此類型可以是下列其中一個值：

傳回碼	描述
0	文字會以框線繪製，使其出現在視窗平面下方。
SBT_NOBORDERS	文字會繪製而不加上框線。
SBT_OWNERDRAW	文字是由父視窗繪製。
SBT_POPOUT	文字會以框線繪製，以顯示高於視窗平面。
SBT_RTLREADING	文字會以與父視窗中文字相反的方向顯示。

備註

一般視窗會顯示由左至右 (LTR) 的文字。 Windows 可以 鏡像 來顯示希伯來文或阿拉伯文等語言，該語言讀取由右至左 (RTL) 。 如果已設定SBT_RTLREADING，則指定的狀態視窗文字會從父視窗中的文字相反方向讀取。

此訊息會傳回最多 65，535 個字元的字串長度。 如果實際的文字字串超過該字串， 則SB_GETTEXT 訊息會截斷它。

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
標頭	Commctrl.h
Unicode 與 ANSI 名稱	SB_GETTEXTLENGTHW (Unicode ) 和 SB_GETTEXTLENGTHA (ANSI)