The GetCharWidth function retrieves the widths, in logical coordinates, of consecutive characters in a specified range from the current font.
GetCharWidth is maintained for compatibility with 16-bit versions of Windows. Win32-based applications should call the GetCharWidth32 function, which provides more accurate results.
BOOL GetCharWidth(
| HDC hdc, | // handle of device context |
| UINT iFirstChar, | // first character in range to query |
| UINT iLastChar, | // last character in range to query |
| LPINT lpBuffer | // address of buffer for widths |
| ); |
Parameters
hdc
Identifies the device context.
iFirstChar
Specifies the first character in the group of consecutive characters.
iLastChar
Specifies the last character in the group of consecutive characters, which must not precede the specified first character.
lpBuffer
Points to a buffer to receive the widths.
Return Values
If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero. To get extended error information, call GetLastError.
Remarks
The range is inclusive; that is, the returned widths include the widths of the characters specified by the iFirstChar and iLastChar parameters.
If a character does not exist in the current font, it is assigned the width of the default character.
See Also
GetCharABCWidths, GetCharABCWidthsFloat, GetCharWidth32, GetCharWidthFloat