GetCharWidthW 函数 (wingdi.h)

GetCharWidth 函数从当前字体检索指定范围内连续字符的宽度(以逻辑坐标为单位)。

注意 此函数仅用于与 16 位版本的 Windows 兼容。 应用程序应调用 GetCharWidth32 函数,从而提供更准确的结果。
 

语法

BOOL GetCharWidthW(
  [in]  HDC   hdc,
  [in]  UINT  iFirst,
  [in]  UINT  iLast,
  [out] LPINT lpBuffer
);

参数

[in] hdc

设备上下文的句柄。

[in] iFirst

连续字符组中的第一个字符。

[in] iLast

连续字符组中的最后一个字符,该字符不得位于指定的第一个字符之前。

[out] lpBuffer

指向以逻辑坐标形式接收字符宽度的缓冲区的指针。

返回值

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

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

言论

无法对 TrueType 字体使用 GetCharWidth。 若要检索 TrueType 字体的字符宽度,请使用 GetCharABCWidths

范围是非独占的;也就是说,返回的宽度包括由 iFirstChar 指定的字符的宽度,iLastChar 参数。

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

注意

wingdi.h 标头将 GetCharWidth 定义为一个别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息,请参阅函数原型的 约定。

要求

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

另请参阅

字体和文本功能

字体和文本概述

GetCharABCWidths

GetCharABCWidthsFloat

GetCharWidth32

GetCharWidthFloat