![]() |
ATSUSetFontFeatures |
||||
Header: | ATSUnicode.h | Carbon status: | Supported | |
Sets font features in a style object.
OSStatus ATSUSetFontFeatures ( ATSUStyle iStyle, ItemCount iFeatureCount, ATSUFontFeatureType iType[], ATSUFontFeatureSelector iSelector[] );
A reference to a valid style object whose font features you want to set. You cannot pass NULL for this parameter.
The number of font features you want to set. This value should correspond to the number of elements in the iType and iSelector arrays.
An array of feature types. Each element in the array must contain a valid feature type that corresponds to a feature selector in the iSelector array. You cannot pass NULL for this parameter.
An array of feature selectors. Each element in the array must contain a valid feature selector that corresponds to a feature type in the iType array. You cannot pass NULL for this parameter.
A result code.
The ATSUSetFontFeatures function enables you to set multiple font features. Unset font features retain their font-defined default values. Note that to set a particular font feature, you must specify both the feature type and selector.
The order that ATSUSetFontFeatures sets font features depends on the font-defined order, not the chronological order in which they were set in a call to ATSUSetFontFeatures.
ATSUSetFontFeatures may allocate memory in your application heap, unless you designate a different heap by calling the function ATSUCreateMemorySetting.
Available beginning with ATSUI 1.0. Prior to ATSUI 1.2, ATSUSetFontFeature does not remove contradictory font features. You are responsible for maintaining your own list and remove contradictory settings when they occur. Beginning with ATSUI 1.2, ATSUSetFontFeatures will remove contradictory font features if they are set.
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)