![]() |
ATSUSetFontFallbacks |
||||
Header: | ATSUnicode.h | Carbon status: | Supported | |
Enables you to indicate the font list and search order to use when a font does not have all the glyphs for the characters it is trying to draw.
OSStatus ATSUSetFontFallbacks ( ItemCount iFontFallbacksCount, ATSUFontID iFonts, ATSUFontFallbackMethod iFontFallbackMethod );
The number of fonts you want searched. This should be equivalent to the number of elements in the iFontIDs array.
An array of the fonts you want searched.
The order that you want the fonts to be searched. See
A result code. The result code kATSUInvalidFontErr indicates that the font does not correspond to any installed font.
The ATSUSetFontFallbacks function enables you to specify the font list and search order to use when a font does not have all the glyphs for the characters it is trying to draw. If you do not call ATSUSetFontFallbacks, all the fonts on the system will be searched sequentially, and the first match valid font will be used.
If you are careful in ordering the fonts to be searched when you call ATSUSetFontFallbacks, you will minimize the time ATSUI needs to find a fallback font.
Available beginning with ATSUI 1.1.
Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.6 or later.
© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)