getTextMetrics 函数 (wingdi.h)

项目
08/27/2023

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

语法

BOOL GetTextMetrics(
  [in]  HDC          hdc,
  [out] LPTEXTMETRIC lptm
);

参数

[in] hdc

设备上下文的句柄。

[out] lptm

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

返回值

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

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

注解

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

示例

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

要求

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