GetCharABCWidthsFloat
The GetCharABCWidthsFloat
function retrieves the widths, in logical units, of consecutive characters in a
specified range from the current font.
BOOL GetCharABCWidthsFloat(
|
HDC hdc, |
// handle of device
context |
|
UINT iFirstChar, |
// first character
in range to query |
|
UINT iLastChar, |
// last character
in range to query |
|
LPABCFLOAT lpABCF |
// address of
character-width structure |
|
); |
|
Parameters
hdc
Identifies
the device context.
iFirstChar
Specifies the
code point of the first character in the group of consecutive characters where
the ABC widths are sought.
iLastChar
Specifies the
code point of the last character in the group of consecutive characters where
the ABC widths are sought. This range is inclusive. An error is returned if the
specified last character precedes the specified first character.
lpABCF
Points to an
application-defined buffer with an array of ABCFLOAT structures to receive the
character widths when the function returns.
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
Unlike the GetCharABCWidths function that returns widths
only for TrueType fonts, the GetCharABCWidthsFloat function retrieves
widths for any font. The widths returned by this function are in the IEEE
floating-point format.
If the
current world-to-device transformation is not identified, the returned widths may
be noninteger values, even if the corresponding values in the device space are
integers.
A spacing
is the distance added to the current position before placing the glyph. B
spacing is the width of the black part of the glyph. C spacing is the distance
added to the current position to provide white space to the right of the glyph.
The total advanced width is given by A+B+C.
The ABC
spaces are measured along the character base line of the selected font.
The ABC
widths of the default character are used for characters outside the range of
the currently selected font.
See Also