Function

CTFontCopyDefaultCascadeListForLanguages

Retrieves an ordered list of font substitution preferences.

Declaration

CFArrayRef CTFontCopyDefaultCascadeListForLanguages(CTFontRef font, CFArrayRef languagePrefList);

Parameters

font

The font reference.

languagePrefList

The language preference list, an ordered array of CFStrings of ISO language codes.

Return Value

An ordered list of CTFontDescriptors for font fallback according to the given language preferences.

Discussion

When the original font used for text layout and rendering does not support a certain Unicode character from the provided text, the system follows this list to pick a fallback font that includes the character.

The font alternatives in the cascade list match the original font's style, weight, and width.

See Also

Getting Font Data

CTFontCopyFontDescriptor

Returns the normalized font descriptor for the given font reference.

CTFontCopyAttribute

Returns the value associated with an arbitrary attribute of the given font.

CTFontGetSize

Returns the point size of the given font.

CTFontGetMatrix

Returns the transformation matrix of the given font.

CTFontGetSymbolicTraits

Returns the symbolic traits of the given font.

CTFontCopyTraits

Returns the traits dictionary of the given font.