# IFont::QueryTextMetrics

Fills a caller-allocated TEXTMETRIC structure for the font. The TEXTMETRICOLE structure is defined as a TEXTMETRICW structure on Win32 platforms. For more information on this structure, consult the Win32 Programmer’s Reference.

HRESULT QueryTextMetrics(

TEXTMETRICOLE* ptm | //Pointer to font information structure to be filled
); |

Parameters

ptm
  [out] Pointer to the caller-allocated structure that receives the font information.

Return Values

The method supports the standard return value E_UNEXPECTED, as well as the following:

S_OK
  The text metrics were returned successfully.
E_POINTER
  The address in ptm is not valid. For example, it may be NULL.

Remarks

#### Notes to Implementers

E_NOTIMPL is not a valid return value. Font objects must always provide their font information through this call unless other errors occur.