The GetTextExtentExPoint function retrieves the number of characters in a specified string that will fit within a specified space and fills an array with the text extent for each of those characters. (A text extent is the distance between the beginning of the space and a character that will fit in the space.) This information is useful for word-wrapping calculations.
BOOL GetTextExtentExPoint(
HDC hdc, // handle to device context
LPCTSTR lpszStr, // pointer to character string
int cchString, // number of characters in string
int nMaxExtent, // maximum width for formatted string
LPINT lpnFit, // pointer to value specifying max. number of
// chars.
LPINT alpDx, // pointer to array for partial string widths
LPSIZE lpSize // pointer to structure with string dimensions
);
If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero.
Windows NT: To get extended error information, call GetLastError.
If both the lpnFit and alpDx parameters are NULL, calling the GetTextExtentExPoint function is equivalent to calling the GetTextExtentPoint function.
Windows CE: The cchString parameter specifies the number of characters, not bytes, in the string pointed to by the lpszStr parameter. This is true in Windows desktop platforms as well as in Windows CE.
Windows NT: Requires version 3.1 or later.
Windows: Requires Windows 95 or later.
Windows CE: Requires version 1.0 or later.
Header: Declared in wingdi.h.
Import Library: Use gdi32.lib.
Unicode: Implemented as Unicode and ANSI versions on Windows NT.
Fonts and Text Overview, Font and Text Functions, GetTextExtentPoint, SIZE