PolyTextOutW 函数（wingdi.h）

项目
11/20/2024

PolyTextOut 函数使用当前在指定设备上下文中选择的字体和文本颜色绘制多个字符串。

语法

BOOL PolyTextOutW(
  [in] HDC             hdc,
  [in] const POLYTEXTW *ppt,
  [in] int             nstrings
);

参数

[in] hdc

设备上下文的句柄。

[in] ppt

指向描述要绘制的字符串的 POLYTEXT 结构的指针。数组包含要绘制的每个字符串的一个结构。

[in] nstrings

pptxt 数组中 POLYTEXT 结构的数目。

返回值

如果函数成功，则返回值为非零。

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

言论

每个 POLYTEXT 结构都包含 Windows 用来对齐相应文本字符串的引用点的坐标。应用程序可以通过调用 SetTextAlign 函数来指定引用点的使用方式。应用程序可以通过调用 GetTextAlign 函数来确定指定设备上下文的当前文本对齐设置。

若要绘制单个文本字符串，应用程序应调用 ExtTextOut 函数。

PolyTextOut 不会自动处理国际脚本支持。若要获得国际脚本支持，请改用 ExtTextOut。 ExtTextOut 在必要时使用 Uniscribe，从而导致字体回退。此外，在转换为内核模式之前，ExtTextOut 将执行内部批处理，在权衡使用 PolyTextOut 与 ExtTextOut时，会降低某些性能问题。

提示

ExtTextOut 强烈建议使用 PolyTextOut 进行新式开发，因为它能够处理不同语言的显示。

注意

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

要求

要求	价值
最低支持的客户端	Windows 2000 Professional [仅限桌面应用]
支持的最低服务器	Windows 2000 Server [仅限桌面应用]
目标平台	窗户
标头	wingdi.h （包括 Windows.h）
库	Gdi32.lib
DLL	Gdi32.dll