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.

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