GetCharWidthI 函数 (wingdi.h)

项目
08/27/2023

GetCharWidthI 函数从当前字体检索指定范围内连续字形索引的宽度（以逻辑坐标表示）。

语法

BOOL GetCharWidthI(
  [in]  HDC    hdc,
  [in]  UINT   giFirst,
  [in]  UINT   cgi,
  [in]  LPWORD pgi,
  [out] LPINT  piWidths
);

参数

[in] hdc

设备上下文的句柄。

[in] giFirst

连续字形索引组中的第一个字形索引。

[in] cgi

字形索引的数目。

[in] pgi

指向字形索引数组的指针。如果此参数不为 NULL，则使用它而不是 giFirst 参数。

[out] piWidths

指向接收宽度（以逻辑坐标表示）的缓冲区的指针。

返回值

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

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

注解

如果 pgi 参数为 NULL，GetCharWidthI 函数将处理连续的字形索引，其 giFirst 参数指示要处理的第一个字形索引，cgi 参数指示要处理多少字形索引。否则，GetCharWidthI 函数使用指示要处理多少字形索引的 cgi 参数处理 pgi 参数指向的字形索引数组。

如果当前字体中不存在字符，则会为其分配默认字符的宽度。

要求


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