Prev Next

GetCharWidth info Overview Group

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.

GetCharWidth info Overview Group

Parameters

Return Values

Remarks

See Also