GETEXTENDEDTEXTMETRICS

Syntax

short Escape(hDC, GETEXTENDEDTEXTMETRICS, sizeof(WORD),lpInData,lpOutData)

This escape fills the buffer pointed to by the lpOutData parameter with the extended text metrics for the selected font.

Return Value

The return value specifies the number of bytes copied to the buffer pointed to by the lpOutData parameter. This value will never exceed that specified in the nSize field pointed to by the lpInData parameter. The return value is zero if the escape fails or is not implemented.

Comments

The lpOutData parameter points to an EXTTEXTMETRIC data structure which has the following format:

typedef struc{

short etmSize;

short etmPointSize;

short etmOrientation;

short etmMasterHeight;

short etmMinScale;

short etmMaxScale;

short etmMasterUnits;

short etmCapHeight;

short etmXHeight;

short etmLowerCaseAscent;

short etmLowerCaseDescent;

short etmSlant;

short etmSuperScript;

short etmSubScript;

short etmSuperScriptSize;

short etmSubScriptSize;

short etmUnderlineOffset;

short etmUnderlineWidth;

short etmDoubleUpperUnderlineOffset;

short etmDoubleLowerUnderlineOffset;

short etmDoubleUpperUnderlineWidth;

short etmDoubleLowerUnderlineWidth;

short etmStrikeOutOffset;

short etmStrikeOutWidth;

WORD etmKernPairs;

WORD etmKernTracks;

}EXTTEXTMETRIC;

The EXTTEXTMETRIC data structure has the following fields:

The values returned in many of the fields of the EXTTEXTMETRIC structure are affected by whether relative character widths are enabled or disabled. For more information, see the description of ENABLERELATIVEWIDTHS escape earlier in this chapter.