GetCharWidthI 函数 (wingdi.h)

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 参数为 NULLGetCharWidthI 函数将处理连续的字形索引,其 giFirst 参数指示要处理的第一个字形索引,cgi 参数指示要处理多少字形索引。 否则,GetCharWidthI 函数使用指示要处理多少字形索引的 cgi 参数处理 pgi 参数指向的字形索引数组。

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

要求

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

另请参阅

字体和文本函数

字体和文本概述

GetCharABCWidths

GetCharABCWidthsFloat

GetCharWidth32

GetCharWidthFloat