polyTextOutA 函数 (wingdi.h)

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

语法

BOOL PolyTextOutA(
  [in] HDC             hdc,
  [in] const POLYTEXTA *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 [仅限桌面应用]
目标平台	Windows
标头	wingdi.h (包括 Windows.h)
Library	Gdi32.lib
DLL	Gdi32.dll

另请参阅

ExtTextOut

字体和文本函数

字体和文本概述

GetTextAlign

POLYTEXT

SetTextAlign