![]() |
ATSUFONDtoFontID |
||||
Header: | ATSUnicode.h | Carbon status: | Supported | |
Converts a font family number to an ATSUI font ID.
OSStatus ATSUFONDtoFontID ( SInt16 iFONDNumber, Style iFONDStyle, ATSUFontID *oFontID );
The font family number of the font whose ATSUI font ID you want to obtain.
The font family style of the font whose ID you want to obtain. This only exists for fonts that split a font family into several font family numbers.
On return, a pointer to the corresponding ATSUI ID. If there are no installed fonts with the matching the specified font family number, ATSUFONDtoFontID passes back the constant kATSUInvalidFontID and returns the result code kATSUInvalidFontErr. If a font exists with the specified font family number and style, but it is incompatible with ATSUI, ATSUFONDtoFontID passes back the constant kATSUInvalidFontID and returns the result code kATSUNoCorrespondingFontErr. You cannot pass NULL for this parameter.
A result code.
The ATSUFONDtoFontID function finds the ATSUI font ID that corresponds to a font family number, 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)