Carbon


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
);
Parameter descriptions
iFONDNumber

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

iFONDStyle

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.

oFontID

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.

function result

A result code.

DISCUSSION

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.

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)