CTLine

A line of text.

Overview

A CTLine object contains an array of glyph runs. Line objects are created by the typesetter during a framesetting operation and can draw themselves directly into a graphics context.

Topics

Creating Lines

CTLineCreateWithAttributedString

Creates a single immutable line object directly from an attributed string.

CTLineCreateTruncatedLine

Creates a truncated line from an existing line.

CTLineCreateJustifiedLine

Creates a justified line from an existing line.

Drawing the Line

CTLineDraw

Draws a complete line.

Getting Line Data

CTLineGetGlyphCount

Returns the total glyph count for the line object.

CTLineGetGlyphRuns

Returns the array of glyph runs that make up the line object.

CTLineGetStringRange

Gets the range of characters that originally spawned the glyphs in the line.

CTLineGetPenOffsetForFlush

Gets the pen offset required to draw flush text.

Measuring Lines

CTLineGetImageBounds

Calculates the image bounds for a line.

CTLineGetTypographicBounds

Calculates the typographic bounds of a line.

CTLineGetTrailingWhitespaceWidth

Returns the trailing whitespace width for a line.

Getting Line Positioning

CTLineGetStringIndexForPosition

Performs hit testing.

CTLineGetOffsetForStringIndex

Determines the graphical offset or offsets for a string index.

Getting the Type Identifier

CTLineGetTypeID

Returns the Core Foundation type identifier of the line object.

Data Types

CTLineRef

A reference to a line object.

Constants

CTLineTruncationType

Truncation types required by the CTLineCreateTruncatedLine function to tell the truncation engine which type of truncation is being requested.

See Also

Opaque Types

CTFont

A font object.

CTFramesetter

Generate text frames.

CTGlyphInfo

Override a font's specified mapping from Unicode to the glyph ID.

CTParagraphStyle

Paragraph or ruler attributes in an attributed string.

CTTextTab

A tab in a paragraph style, storing an alignment type and location.

CTTypesetter

A typesetter which performs line layout.