Function

CTTypesetterCreateLine

Creates an immutable line from the typesetter.

Declaration

CTLineRef CTTypesetterCreateLine(CTTypesetterRef typesetter, CFRange stringRange);

Parameters

typesetter

The typesetter that creates the line. This parameter is required and cannot be set to NULL.

stringRange

The string range on which the line is based. If the length portion of range is set to 0, then the typesetter continues to add glyphs to the line until it runs out of characters in the string. The location and length of the range must be within the bounds of the string, or the call will fail.

Return Value

A reference to a CTLine object if the call was successful; otherwise, NULL.

Discussion

The resultant line consists of glyphs in the correct visual order, ready to draw. This function is equivalent to CTTypesetterCreateLineWithOffset with an offset of 0.0.

See Also

Creating Lines

CTTypesetterCreateLineWithOffset

Creates an immutable line from the typesetter at a specified line offset.