getTextExtentExPointI 函数 (wingdi.h)

项目
08/27/2023

GetTextExtentExPointI 函数检索指定字符串中适合指定空格的字符数，并使用其中每个字符的文本范围填充数组。 (文本范围是空格的开头与空间中适合的字符之间的距离。) 此信息对换行计算很有用。

语法

BOOL GetTextExtentExPointI(
  [in]  HDC    hdc,
  [in]  LPWORD lpwszString,
  [in]  int    cwchString,
  [in]  int    nMaxExtent,
  [out] LPINT  lpnFit,
  [out] LPINT  lpnDx,
  [out] LPSIZE lpSize
);

参数

[in] hdc

设备上下文的句柄。

[in] lpwszString

指向要检索其范围的字形索引数组的指针。

[in] cwchString

pgiIn 参数指向的数组中的字形数。

[in] nMaxExtent

格式化字符串允许的最大宽度（以逻辑单位为单位）。

[out] lpnFit

指向整数的指针，该整数接收将容纳在 nMaxExtent 参数指定的空格中的最大字符数的计数。当 lpnFit 参数为 NULL 时，将忽略 nMaxExtent 参数。

[out] lpnDx

指向接收部分字形范围的整数数组的指针。数组中的每个元素都提供字形索引数组的开头和适合 nMaxExtent 参数指定空间的标志符号之一之间的距离（以逻辑单元为单位）。尽管此数组的元素数至少应与 cgi 参数指定的字形索引数量相同，但函数仅使用 lpnFit 参数指定的字形索引的区数填充数组。如果 lpnFit 为 NULL，则该函数不计算部分字符串宽度。

[out] lpSize

指向 SIZE 结构的指针，该结构接收标志符号索引数组的维度（以逻辑单元为单位）。此值不能为 NULL。

返回值

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

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

注解

如果 lpnFit 和 alpDx 参数均为 NULL，则调用 GetTextExtentExPointI 函数等效于调用 GetTextExtentPointI 函数。

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

要求

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

另请参阅

getTextExtentExPointI 函数 (wingdi.h)

语法

参数

返回值

注解

要求

另请参阅

反馈

反馈

其他资源