SB_GETTEXT訊息

從狀態視窗的指定部分擷取文字。

參數

wParam

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

lParam

緩衝區的指標，以 Null 終止字串的形式接收文字。 使用 SB_GETTEXTLENGTH 訊息來判斷緩衝區的必要大小。

傳回值

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

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

備註

安全性警告： 使用此訊息不正確可能會危害程式的安全性。 此訊息不會提供一種方式讓您知道緩衝區的大小。 如果您使用此訊息，請先呼叫 SB_GETTEXTLENGTH 以取得所需的字元數，然後呼叫訊息以擷取字串。 如果您在呼叫 SB_GETTEXT 文字可能變更之前等候，因而使 SB_GETTEXTLENGTH的傳回值失效。 您應該先檢閱 安全性考慮：Microsoft Windows 控制項 ，再繼續進行。

此訊息最多會傳回 65，535 個字元。 如果文字字串超過該字串，則會被截斷。

如果文字具有SBT_OWNERDRAW繪圖類型，則此訊息會傳回與文字相關聯的 32 位值，而不是長度和作業類型。

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

規格需求

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

另請參閱

SB_SETTEXT