Function CTFontCreateForString

Source
pub unsafe extern "C-unwind" fn CTFontCreateForString(
    current_font: &CTFont,
    string: &CFString,
    range: CFRange,
) -> CFRetained<CTFont>
Available on crate feature CTFont only.
Expand description

Returns a new font reference that can best map the given string range based on the current font.

This function is to be used when the current font does not cover the given range of the string. The current font itself will not be returned, but preference is given to fonts in its cascade list.

Parameter currentFont: The current font that contains a valid cascade list.

Parameter string: A unicode string containing characters that cannot be encoded by the current font.

Parameter range: A CFRange specifying the range of the string that needs to be mapped.

Returns: This function returns the best substitute font that can encode the specified string range.

See also: CTFontCopyCharacterSet

See also: CTFontGetGlyphsForCharacters

See also: kCTFontCascadeListAttribute