ExtTextOut

原文链接 -> 传送门

函数功能：

ExtTextOut 函数用于调用当前选定字体，背景色和文本色来绘制文本。你可以选择性规定剪切区域的大小和不透明区域的大小。


API 函数原型：

注释：_In_ 说明该参数是输入的。

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

参数解析：

返回值：

1. 如果字符串被绘制，返回值不为 0。但是，如果 ExtTextOut 函数的 ANSI 版本带 ETO_GLYPH_INDEX 标识被调用，函数返回 TRUE，即使该函数没有任何作用；

2. 如果函数调用失败，返回值为 0。


备注：

1. 指定设备环境当前文本的对其设置，决定如何使用参照点确定文本的位置。文本对齐设置可以调用 GetTextAlign 函数来获取。调用 SetTextAlign 来更改文本对其设置。你可以使用以下文本对齐的值。只能从中挑选一个标记来调整水平和垂直对齐。另外，两个调整当前位置的标记只能选择一个。

2. 如果 lpDx 参数为空，ExtTextOut 函数使用字符之间的默认空间。lpDx 参数指定的字符单元原点和数组内容在逻辑单元中规定。一个字符单元原点定义为字符单元的左上角。

3. 函数默认不使用或不更新当前位置。但是，每次为一个指定设备环境调用 ExtTextOut 函数时，应用程序能调用 SetTextAlign 函数与 TA_UPDATECP 的 fMode 参数设置来允许系统使用和更新当前位置。一旦设置该标记，在后面 ExtTextOut 函数的调用中，系统忽略 x 参数和 y 参数。

4. 关于 ExtTextOut 的 ANSI 版本，lpDx 数组与 INT 值相同，lpString 中存在字节。对 DBCS 字符，你可以在头尾字节中的 lpDx 分配 dx，只要两个字节的总数和与要求的 dx 一致。对 ExtTextOut 的 Unicode 版本的 DBCS 字符，每个 Unicode 字符有一个唯一的 pdx 条目。


需求：