SB_SETTEXT 消息

设置状态窗口的指定部分中的文本。

参数

wParam

低序位词 LOBYTE 用于指定要设置的部件的索引（从零开始）。如果将 LOBYTE 设置为 SB_SIMPLEID，则系统会将状态窗口假定为简单模式状态栏；也就是说，只显示一部分的状态栏。

低序位词 HIBYTE 用于指定绘图操作的类型。此参数的取值可为下列值之一。

忽略高序位词 wParam。

值	含义
0	文本带有边框，显示位置低于窗口平面。
SBT_NOBORDERS	文本不带边框。
SBT_OWNERDRAW	文本由父窗口绘制。注意：简单模式状态栏不支持所有者绘图。
SBT_POPOUT	文本带有边框，显示位置高于窗口平面。
SBT_RTLREADING	系统将以与父窗口中文本相反的方向显示文本。
SBT_NOTABPARSING	将忽略 Tab 字符。

lParam

指向以 null 结尾的字符串的指针，该字符串用于指定要设置的文本。如果 wParam 是 SBT_OWNERDRAW，则此参数表示 32 位数据。父窗口必须解释数据并在收到 WM_DRAWITEM 消息时绘制文本。

如果成功，系统会返回 TRUE；否则返回 FALSE。

该消息会使已更改的窗口部分失效，从而导致该窗口在下一个窗口收到 WM_PAINT 消息时显示新文本。

普通窗口从左到右 (LTR) 显示文本。支持镜像显示窗口以显示希伯来语或阿拉伯语等从右向左 (RTL) 阅读的语言。如果设置了 SBT_RTLREADING，则 lParam 字符串将以与父窗口中的文本相反的方向读取内容。

要求	值
最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
Header	Commctrl.h
Unicode 和 ANSI 名称	SB_SETTEXTW (Unicode) 和 SB_SETTEXTA (ANSI)