get_outline_text_metrics


template <class character>
unsigned get_outline_text_metrics(handle device,
                                  unsigned size,
                                  outline_text_metrics<character>* metrics)

This function obtains the metrics of the currently selected true type font.

Parameters

handle device

The handle of the device context.

unsigned size

The size (in bytes) of the buffer pointed to by the next parameter.

outline_text_metrics<character>* metrics

A pointer to a buffer to hold the array of true type font metric structures. If null is specified, the required buffer size is returned.

Return

unsigned

Zero The call failed.
Other Either the number of bytes transferred to the buffer or the required buffer size (when the given buffer pointer is null).

Notes

The currently selected font must be a true type font.

The sizes in the returned structures are in logical units and are dependent upon the current unit mapping mode.