Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
GetCharABCWidths

GetCharABCWidths function

The GetCharABCWidths function retrieves the widths, in logical units, of consecutive characters in a specified range from the current TrueType font. This function succeeds only with TrueType fonts.

Syntax


BOOL GetCharABCWidths(
  _In_  HDC   hdc,
  _In_  UINT  uFirstChar,
  _In_  UINT  uLastChar,
  _Out_ LPABC lpabc
);

Parameters

hdc [in]

A handle to the device context.

uFirstChar [in]

The first character in the group of consecutive characters from the current font.

uLastChar [in]

The last character in the group of consecutive characters from the current font.

lpabc [out]

A pointer to an array of ABC structures that receives the character widths, in logical units. This array must contain at least as many ABC structures as there are characters in the range specified by the uFirstChar and uLastChar parameters.

Return value

If the function succeeds, the return value is nonzero

If the function fails, the return value is zero.

Remarks

The TrueType rasterizer provides ABC character spacing after a specific point size has been selected. 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 specified by A+B+C.

When the GetCharABCWidths function retrieves negative A or C widths for a character, that character includes underhangs or overhangs.

To convert the ABC widths to font design units, an application should use the value stored in the otmEMSquare member of a OUTLINETEXTMETRIC structure. This value can be retrieved by calling the GetOutlineTextMetrics function.

The ABC widths of the default character are used for characters outside the range of the currently selected font.

To retrieve the widths of characters in non-TrueType fonts, applications should use the GetCharWidth function.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Wingdi.h (include Windows.h)

Library

Gdi32.lib

DLL

Gdi32.dll

Unicode and ANSI names

GetCharABCWidthsW (Unicode) and GetCharABCWidthsA (ANSI)

See also

Fonts and Text Overview
Font and Text Functions
GetCharWidth
GetOutlineTextMetrics
OUTLINETEXTMETRIC
ABC

 

 

Community Additions

ADD
Show:
© 2015 Microsoft