![]() |
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 );
The ATSUI font ID of the font whose font family number you want to obtain.
On return, a pointer to the font family number corresponding to the specified font ID. You cannot pass NULL for this parameter.
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.
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.
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.
Available beginning with ATSUI 1.0.
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)