![]() |
ATSUGetFontFeatureNameCode |
||||
Header: | ATSUnicode.h | Carbon status: | Supported | |
Obtains the name code of a feature selector or type.
OSStatus ATSUGetFontFeatureNameCode ( ATSUFontID iFont, ATSUFontFeatureType iType, ATSUFontFeatureSelector iSelector, FontNameCode *oNameCode );
The ID of the font whose feature type or selector you want to determine the name code for.
A valid feature type whose name code you want to obtain.
The feature selector whose name code you want to obtain. If you pass the constant kATSUNoSelector, the value passed back in the oNameCode parameter represents the name code of the feature type.
On return, a pointer to the name code of the feature selector name. If you pass the constant kATSUNoSelector in the iSelector parameter, the value passed back represents the name code of the feature type. See Font Name Code Constants in the Font Manager for a description of possible values. You cannot pass NULL for this parameter.
A result code. The result code kATSUInvalidFontErr indicates that the ID does not correspond to any installed font. The result code kATSUNotSetErr indicates that the font has no name in its name table for the indicated font feature.
By default, ATSUGetFontFeatureNameCode function obtains the name code of a particular feature selector. If you wish to determine the name code of the feature type, pass the constant kATSUNoSelector in the iSelector parameter. You can pass the value passed back in the oNameCode parameter to the function ATSUFindFontName to find the localized feature selector or feature type name identified by this name code.
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)