GetCharWidth
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