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 |
|
Unicode 和 ANSI 名称 |
SB_SETTEXTW (Unicode) 和 SB_SETTEXTA (ANSI) |