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)

另请参阅

SB_GETTEXT