DrawShadowText 函数 (commctrl.h)

绘制具有阴影的文本。

语法

int DrawShadowText(
  HDC      hdc,
  LPCWSTR  pszText,
  UINT     cch,
  RECT     *prc,
  DWORD    dwFlags,
  COLORREF crText,
  COLORREF crShadow,
  int      ixOffset,
  int      iyOffset
);

参数

hdc

类型： HDC

HDC。

pszText

类型： LPCWSTR

指向包含要绘制的文本的字符串的指针。

cch

类型： UINT

一个 UINT ，指定要绘制的字符串中的字符数。

prc

类型： const RECT*

指向 RECT 结构的指针，该结构包含要在其中绘制文本的矩形（以逻辑坐标表示）。

dwFlags

类型： DWORD

指定如何绘制文本的 DWORD 。 有关可能的参数值，请参阅 设置值格式 。

crText

类型： COLORREF

包含文本颜色的 COLORREF 结构。

crShadow

类型： COLORREF

包含文本阴影颜色的 COLORREF 结构。

ixOffset

类型： int

一个 int 类型的值，该值指定文本应开始位置的 x 坐标。

iyOffset

类型： int

int 类型的值，该值指定文本应开始位置的 y 坐标。

返回值

类型： int

如果函数成功，则以逻辑单位返回文本的高度，否则返回零。

注解

若要使用 DrawShadowText，请在清单中指定 Comctl32.dll 版本 6。 有关清单的详细信息，请参阅 启用视觉样式。

要求

最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
目标平台	Windows
标头	commctrl.h
Library	Comctl32.lib
DLL	ComCtl32.dll (版本 6 或更高版本)