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