getTextExtentPointI 函数 (wingdi.h)

项目
08/27/2023

GetTextExtentPointI 函数计算指定字形索引数组的宽度和高度。

语法

BOOL GetTextExtentPointI(
  [in]  HDC    hdc,
  [in]  LPWORD pgiIn,
  [in]  int    cgi,
  [out] LPSIZE psize
);

参数

[in] hdc

设备上下文的句柄。

[in] pgiIn

指向字形索引数组的指针。

[in] cgi

指定字形索引的数量。

[out] psize

指向 SIZE 结构的指针，该结构接收字符串的维度（以逻辑单元为单位）。

返回值

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

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

注解

GetTextExtentPointI 函数使用当前所选字体来计算字形索引数组的尺寸。宽度和高度（以逻辑单元为单位）是在不考虑任何剪裁的情况下计算的。

当此函数返回文本范围时，它假定文本水平，即转义始终为 0。这适用于文本的水平和垂直度量。即使使用指定非零转义符的字体，此函数也不会在计算文本范围时使用角度。应用必须显式转换它。但是，当图形模式设置为 GM_ADVANCED 并且字符方向与打印方向为 90 度时，此函数返回的值不遵循此规则。当给定字符串的字符方向和打印方向匹配时，此函数在 SIZE 结构中返回字符串的尺寸为 { cx ： 116， cy ： 18 }。如果同一字符串的字符方向和打印方向相距 90 度，则此函数返回 SIZE 结构中字符串的尺寸为 { cx ： 18， cy ： 116 }。

由于某些设备包含字符，因此各个字形索引的范围之和可能不等于整个字形索引数组的范围。

计算的字符串宽度考虑 SetTextCharacterExtra 函数设置的字符间间距。

要求


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