CTFrame

The CTFrame opaque type represents a frame containing multiple lines of text. The frame object is the output resulting from the text-framing process performed by a framesetter object.

Overview

You can draw the entire text frame directly into the current graphic context. The frame object contains an array of line objects that can be retrieved for individual rendering or to get glyph information.

Topics

Getting Frame Data

CTFrameGetStringRange

Returns the range of characters originally requested to fill the frame.

CTFrameGetVisibleStringRange

Returns the range of characters that actually fit in the frame.

CTFrameGetPath

Returns the path used to create the frame.

CTFrameGetFrameAttributes

Returns the frame attributes used to create the frame.

Getting Lines

CTFrameGetLines

Returns an array of lines stored in the frame.

CTFrameGetLineOrigins

Copies a range of line origins for a frame.

Drawing the Frame

CTFrameDraw

Draws an entire frame into a context.

Getting the Type Identifier

CTFrameGetTypeID

Returns the type identifier for the CTFrame opaque type.

Data Types

CTFrameRef

A reference to a Core text frame object.

CTFramePathFillRule

The type for constants that specify a fill rule used by a frame.

Constants

CTFrameProgression

These constants specify frame progression types.

CTFramePathFillRule Constants

These constants specify the fill rule used by a frame

kCTFrameProgressionAttributeName

Specifies progression for a frame.

kCTFramePathFillRuleAttributeName

The key used to specify the fill rule for a frame.

kCTFramePathWidthAttributeName

The key used to specify the frame width.

kCTFrameClippingPathsAttributeName

Specifies array of paths to clip frame.

kCTFramePathClippingPathAttributeName

Specifies clipping path. This attribute is valid only in a dictionary contained in an array specified by kCTFrameClippingPathsAttributeName.

See Also

Opaque Types

CTFont

The CTFont opaque type represents a Core Text font object. Font objects represent fonts to an application, providing access to characteristics of the font, such as point size, transform matrix, and other attributes. Fonts provide assistance in laying out glyphs relative to one another and are used to establish the current font when drawing in a graphics context.

CTFontCollection

The CTFontCollection opaque type represents a font collection, that is, a group of font descriptors taken together as a single object.

CTFontDescriptor

The CTFontDescriptor opaque type represents a font descriptor, that is, a dictionary of attributes (such as name, point size, and variation) that can completely specify a font.

CTFramesetter

The CTFramesetter opaque type is used to generate text frames. That is, CTFramesetter is an object factory for CTFrame objects.

CTGlyphInfo

The CTGlyphInfo opaque type enables you to override a font's specified mapping from Unicode to the glyph ID.

CTLine

The CTLine opaque type represents a line of text.

CTParagraphStyle

The CTParagraphStyle opaque type represents paragraph or ruler attributes in an attributed string.

CTRun

The CTRun opaque type represents a glyph run, which is a set of consecutive glyphs sharing the same attributes and direction.

CTRunDelegate

The CTRunDelegate opaque type represents a run delegate, which is assigned to a run (attribute range) to control typographic traits such glyph ascent, glyph descent, and glyph width.

CTTextTab

The CTTextTab opaque type represents a tab in a paragraph style, storing an alignment type and location.

CTTypesetter

The CTTypesetter opaque type represents a typesetter, which performs line layout.