Share via

DrawStatusTextA 函数 (commctrl.h)

  • 项目

DrawStatusText 函数以带有边框的状态窗口的样式绘制指定文本。

语法

void DrawStatusTextA(
  HDC     hDC,
  LPCRECT lprc,
  LPCSTR  pszText,
  UINT    uFlags
);

参数

hDC

类型： HDC

窗口的显示上下文的句柄。

lprc

类型： LPCRECT

指向 RECT 结构的指针，该结构包含绘制文本的矩形的位置（以客户端坐标为单位）。 函数在指定矩形的边缘内绘制边框。

pszText

类型： LPCTSTR

指向以 null 结尾的字符串的指针，该字符串指定要显示的文本。 字符串中的制表符确定字符串是左对齐、右对齐还是居中。

uFlags

类型： UINT

文本绘制标志。 此参数可以是以下值的组合：

值 含义
SBT_NOBORDERS
 防止在指定文本周围绘制边框。
SBT_POPOUT
 绘制突出显示的边框，使文本突出。
SBT_RTLREADING
 指示 pszText 指向的字符串将以与父窗口中的文本相反的方向显示。

返回值

无

备注

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

注意

commctrl.h 标头将 DrawStatusText 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名的使用与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。 有关详细信息，请参阅 函数原型的约定。

要求

要求 值
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 commctrl.h
Library Comctl32.lib
DLL Comctl32.dll