getCharWidth32A 函数 (wingdi.h)

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

语法

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

参数

[in] hdc

设备上下文的句柄。

[in] iFirst

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

[in] iLast

连续字符组中的最后一个字符,不能在指定的第一个字符之前。

[out] lpBuffer

指向接收字符宽度(以逻辑坐标表示)的缓冲区的指针。

返回值

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

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

注解

GetCharWidth32 不能用于 TrueType 字体。 若要检索 TrueType 字体的字符宽度,请使用 GetCharABCWidths

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

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

示例

有关示例,请参阅使用键盘输入中的“显示 键盘输入”。

注意

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

要求

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

另请参阅

字体和文本函数

字体和文本概述

GetCharABCWidths

GetCharABCWidthsFloat

GetCharWidthFloat