Carbon


ATSUCountFontNames

Header: ATSUnicode.h Carbon status: Supported

Determines the number of font names in a font name table.

OSStatus ATSUCountFontNames (
    ATSUFontID iFontID, 
    ItemCount *oFontNameCount
);
Parameter descriptions
iFontID

The ID of the font whose font names you want to count.

oFontNameCount

On return, a pointer to the number of entries in the font name table. This number includes repetitions of the same name in different platforms, languages, and scripts; names of font features, variations, tracking settings, and instances; and font names identified by name code constants that are not enumerated. You cannot pass a NULL pointer for this parameter.

function result

A result code. The result code kATSUInvalidFontErr indicates that the ID does not correspond to an installed font.

DISCUSSION

The ATSUCountFontNames function determines the number of font names defined in a font name table. This number includes repetitions of the same name in different platforms, languages, and scripts; names of font features, variations, tracking settings, and instances; and font names identified by name code constants that are not enumerated. You can pass one less than this count in the iFontNameIndex parameter of the function ATSUGetIndFontName to iterate through the entries of a font name table.

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)