GetOutlineTextMetricsA 函数（wingdi.h）

项目
11/20/2024

GetOutlineTextMetrics 函数检索 TrueType 字体的文本指标。

语法

UINT GetOutlineTextMetricsA(
  [in]            HDC                  hdc,
  [in]            UINT                 cjCopy,
  [out, optional] LPOUTLINETEXTMETRICA potm
);

参数

[in] hdc

设备上下文的句柄。

[in] cjCopy

接收文本指标的数组的大小（以字节为单位）。

[out, optional] potm

指向 OUTLINETEXTMETRIC 结构的指针。如果此参数 NULL，则该函数将返回检索的指标数据所需的缓冲区大小。

返回值

如果函数成功，则返回值为非零或所需缓冲区的大小。

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

言论

OUTLINETEXTMETRIC 结构包含为 TrueType 字体提供的大部分文本指标信息（包括 TEXTMETRIC 结构）。 OUTLINETEXTMETRIC 中返回的大小采用逻辑单元;它们依赖于当前映射模式。

注意

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

要求

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