通过

ExtTextOutWrap 函数

  • 项目

[ExtTextOutWrap 可通过 Windows XP 与 Service Pack 2 (SP2) 。 它在后续版本中可能已更改或不可用。 建议改为直接使用 ExtTextOut 。]

使用当前所选字体、背景色和文本颜色绘制文本。 可以选择提供用于剪裁和/或不透明度的维度。 此函数包装对 ExtTextOut 的调用。

语法

BOOL ExtTextOutWrap(
  _In_       HDC     hdc,
  _In_       int     X,
  _In_       int     Y,
  _In_       UINT    uOptions,
  _In_ const RECT    *lprc,
  _In_       LPCTSTR lpString,
  _In_       UINT    cbCount,
  _In_ const INT     *lpDx
);

parameters

hdc [in]

类型： HDC

设备上下文的句柄。

X [in]

类型： int

用于定位字符串的参考点的 x 坐标（以逻辑坐标为单位）。

Y [in]

类型： int

用于定位字符串的参考点的 y 坐标（以逻辑坐标为单位）。

uOptions [in]

类型： UINT

指定如何使用应用程序定义的矩形的值。 有关选项的完整列表，请参阅 ExtTextOut 。

lprc [in]

类型： const RECT*

指向可选 RECT 结构的指针，该结构指定用于剪裁和/或不透明度的矩形的尺寸（以逻辑坐标表示）。

lpString [in]

类型： LPCTSTR

指向包含要绘制的文本的缓冲区的指针。 字符串不需要以零结尾，因为 cbCount 指定字符串的长度。

cbCount [in]

类型： UINT

lpString 指向的字符串的长度（以字节为单位）。

lpDx [in]

类型： const INT*

指向可选值数组的指针，这些值指示相邻字符单元格的原点之间的距离。 例如， lpDx[x] 逻辑单元将字符单元格 x 和字符单元格的原点分隔 (x + 1) 。

返回值

类型： BOOL

如果成功绘制字符串，则返回非零值。 但是，如果使用 ETO_GLYPH_INDEX 调用 ExtTextOut 的 ANSI 版本，则即使函数不执行任何操作，该函数也会返回 TRUE 。

如果函数失败，则返回值为零。

要获得更多的错误信息，请调用 GetLastError。

备注

ExtTextOutWrap 不按名称导出，也不在公共头文件中声明。 若要使用它，必须使用 GetProcAddress 并从 ComCtl32.dll 请求序号 417 来获取函数指针。

有关其他备注，请参阅 ExtTextOut。

要求

要求 值
最低受支持的客户端
 Windows Vista [仅限桌面应用]
最低受支持的服务器
 Windows Server 2003 [仅限桌面应用]
DLL
Comctl32.dll (6.0 或更高版本)