CDC::GetOutlineTextMetrics

Retrieves metric information for TrueType fonts.

UINT GetOutlineTextMetrics( 
   UINT cbData, 
   LPOUTLINETEXTMETRIC lpotm 
) const;

Parameters

  • lpotm
    Points to an array of OUTLINETEXTMETRIC structures. If this parameter is NULL, the function returns the size of the buffer required for the retrieved metric data.

  • cbData
    Specifies the size, in bytes, of the buffer to which information is returned.

  • lpotm
    Points to an OUTLINETEXTMETRIC structure. If this parameter is NULL, the function returns the size of the buffer required for the retrieved metric information.

Return Value

Nonzero if the function is successful; otherwise 0.

Remarks

The OUTLINETEXTMETRIC structure contains most of the font metric information provided with the TrueType format, including a TEXTMETRIC structure. The last four members of the OUTLINETEXTMETRIC structure are pointers to strings. Applications should allocate space for these strings in addition to the space required for the other members. Because there is no system-imposed limit to the size of the strings, the simplest method for allocating memory is to retrieve the required size by specifying NULL for lpotm in the first call to the GetOutlineTextMetrics function.

Requirements

Header: afxwin.h

See Also

Reference

CDC Class

Hierarchy Chart

GetTextMetrics

GetOutlineTextMetrics

CDC::GetTextMetrics

Other Resources

CDC Members