CDC::GetTextExtentExPointI
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.
BOOL GetTextExtentExPointI(
LPWORD pgiIn,
int cgi,
int nMaxExtent,
LPINT lpnFit,
LPINT alpDx,
LPSIZE lpSize
) const;
Parameters
pgiIn
A pointer to an array of glyph indices for which extents are to be retrieved.cgi
Specifies the number of glyphs in the array pointed to by pgiIn.nMaxExtent
Specifies the maximum allowable width, in logical units, of the formatted string.lpnFit
A pointer to an integer that receives a count of the maximum number of characters that will fit in the space specified by nMaxExtent. When lpnFit is NULL, nMaxExtent is ignored.alpDx
A pointer to an array of integers that receives partial glyph extents. Each element in the array gives the distance, in logical units, between the beginning of the glyph indices array and one of the glyphs that fits in the space specified by nMaxExtent. Although this array should have at least as many elements as glyph indices specified by cgi, the function fills the array with extents only for as many glyph indices as are specified by lpnFit. If lpnDx is NULL, the function does not compute partial string widths.lpSize
Pointer to a SIZE structure that receives the dimensions of the glyph indices array, in logical units. This value cannot be NULL.
Return Value
Nonzero if the function is successful; otherwise 0.
Remarks
This member function emulates the functionality of the function GetTextExtentExPointI, as described in the Windows SDK.
Requirements
Header: afxwin.h