![]() |
ATSUSetTransientFontMatching |
||||
Header: | ATSUnicode.h | Carbon status: | Supported | |
Performs automatic font substitution when a character cannot be drawn with the assigned font.
OSStatus ATSUSetTransientFontMatching ( ATSUTextLayout iTextLayout, Boolean iTransientFontMatching );
A reference to an initialized text layout object whose automatic font substitution you wish to enable. You cannot pass NULL for this parameter.
A value that indicates whether you want ATSUI to perform font substitution for you. If you pass true, ATSUI will perform automatic font substitution.
A result code.
The ATSUSetTransientFontMatching function performs font substitution by selecting the first valid font it finds when sequentially scanning the fonts in the users system. When ATSUSetTransientFontMatching performs font substitution, it does not change the font attribute in the style object. As a result, if you wish to substitute fonts in a text layout object that you want to redraw, you should instead call the function ATSUSetFontFallbacks or ATSUMatchFontsToText.
If ATSUSetTransientFontMatching does not find a valid font during the scan, it will use the last resort font, which denotes glyphs with black boxes when a font is not installed on the users system.
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)