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 |
|