Carbon


ATSUCountFontInstances

Header: ATSUnicode.h Carbon status: Supported

Counts the number of font instances in a font.

OSStatus ATSUCountFontInstances (
    ATSUFontID iFont, 
    ItemCount *oInstances
);
Parameter descriptions
iFont

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

oInstances

On return, a pointer to the number of font instances defined in the font. You cannot pass NULL for this parameter.

function result

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

DISCUSSION

The ATSUCountFontInstances function determines the number of font instances that are defined in a font. You can pass one less than this count in the iFontInstanceIndex parameter of the function ATSUGetFontInstance.

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)