GetTextMetricsA 函数（wingdi.h）

项目
11/20/2024

GetTextMetrics 函数使用当前所选字体的指标填充指定的缓冲区。

语法

BOOL GetTextMetricsA(
  [in]  HDC           hdc,
  [out] LPTEXTMETRICA lptm
);

参数

[in] hdc

设备上下文的句柄。

[out] lptm

指向接收文本指标的 TEXTMETRIC 结构的指针。

返回值

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

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

言论

若要确定字体是否为 TrueType 字体，请先将其选中 DC，然后调用 GetTextMetrics，然后在 TEXTMETRIC.tmPitchAndFamily 中检查TMPF_TRUETYPE。请注意，GetDC 返回未初始化的 DC，该 DC 将“系统”（位图字体）作为默认字体;因此，需要在 DC 中选择字体。

例子

有关示例，请参阅使用键盘输入或在同一行上绘制不同字体的文本中的“显示键盘输入”。

注意

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

要求

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