SB_SETTEXT訊息

設定狀態視窗指定部分的文字。

參數

wParam

低序字組的LOBYTE會指定要設定之元件之以零起始的索引。 如果 LOBYTE 設定為SB_SIMPLEID，則狀態視窗會假設為簡單的模式狀態列;也就是說，只有一個部分的狀態列。

低順序字組的HIBYTE會指定繪圖作業的類型。此參數可以是下列其中一個值。

會忽略 wParam 的高序字。

值	意義
0	文字會以框線繪製，顯示低於視窗平面的框線。
SBT_NOBORDERS	文字繪製時沒有框線。
SBT_OWNERDRAW	文字是由父視窗繪製。注意：簡單模式狀態列不支持擁有者繪圖。
SBT_POPOUT	文字會以框線繪製，顯示高於視窗平面。
SBT_RTLREADING	文字會顯示在父視窗中文字的相反方向。
SBT_NOTABPARSING	會忽略製表元。

lParam

指定要設定之文字之 Null 終止字串的指標。如果 wParam 是SBT_OWNERDRAW，此參數代表 32 位的數據。父窗口必須解譯數據，並在收到 WM_DRAWITEM 訊息時繪製文字。

如果成功，則傳回 TRUE，否則傳回 FALSE。

當視窗下一次收到 WM_PAINT 訊息時，訊息會使視窗的部分變更失效，導致它顯示新的文字。

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

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
頁首	Commctrl.h
Unicode 和 ANSI 名稱	SB_SETTEXTW （Unicode）和 SB_SETTEXTA （ANSI）