Carbon


ATSUFontIDtoFOND

Header: ATSUnicode.h Carbon status: Supported

Finds the font family number corresponding to an ATSUI font ID.

OSStatus ATSUFontIDtoFOND (
    ATSUFontID iFontID, 
    SInt16 *oFONDNumber, 
    Style *oFONDStyle
);
Parameter descriptions
iFontID

The ATSUI font ID of the font whose font family number you want to obtain.

oFONDNumber

On return, a pointer to the font family number corresponding to the specified font ID. You cannot pass NULL for this parameter.

oFONDStyle

On return, a pointer to the font family style of the font family number. This only exists for fonts that split a font family into several font family numbers. You cannot pass NULL for this parameter.

function result

A result code. If the font does not correspond to an installed font, ATSUFontIDtoFOND passes back kATSUInvalidFontID in the oFONDNumber parameter and returns the result code kATSUInvalidFontErr. If you the font is incompatible with ATSUI, ATSUFONDtoFontID passes back kATSUInvalidFontID in the oFONDNumber parameter and returns the result code kATSUNoCorrespondingFontErr.

DISCUSSION

The ATSUFontIDtoFOND function finds the font family number that corresponds to a ATSUI font ID, if one exists. Font family numbers were used by QuickDraw to represent fonts to the Font Manager. Some of these fonts, even those that are compatible with ATSUI, do not have font IDs.

Note that ATSUI assigns font IDs at run-time. As a result, these font IDs can change across installs.

VERSION NOTES

Available beginning with ATSUI 1.0.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.


© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)