GETTRACKKERNTABLE

The GETTRACKKERNTABLE escape fills the buffer pointed to by the lpOutData parameter with the track-kerning table for the currently selected font.

Parameters

lpDevice

Points to a PDEVICE structure specifying the destination device.

lpOutData

Points to an array of KERNTRACK structures. This array must be large enough to accommodate all the font's kerning tracks. The number of tracks in the font can be obtained from the EXTTEXTMETRIC structure returned by the GETEXTENDEDTEXTMETRICS escape. If lpOutData is NULL, GETTRACKKERNTABLE returns the number of table entries. The KERNTRACK structure has the following form:

typedef struct tagKERNTRACK {

short ktDegree;

short ktMinSize;

short ktMinAmount;

short ktMaxSize;

short ktMaxAmount;

} KERNTRACK;

Return Value

The return value is the number of KERNTRACK structures copied to the buffer. The return value is zero if the font does not have kerning tracks defined, if the function fails, or if the escape is not implemented.

Comments

The values returned in the KERNTRACK structures are affected by whether relative character widths are enabled or disabled.

See Also

ENABLERELATIVEWIDTHS, GETEXTENDEDTEXTMETRICS