Function

CGContextShowTextAtPoint

Displays a character string at a position you specify.

Declaration

void CGContextShowTextAtPoint(CGContextRef c, CGFloat x, CGFloat y, const char *string, size_t length);

Parameters

c

A graphics context .

x

A value for the x-coordinate (in user space) at which to display the text.

y

A value for the y-coordinate (in user space) at which to display the text.

string

An array of characters to draw.

length

The length of the array specified in the string parameter.

Discussion

Core Graphics uses font data provided by the system to map each byte of the array through the encoding vector of the current font to obtain the glyph to display. Note that the font must have been set using CGContextSelectFont. Don’t use CGContextShowTextAtPoint in conjunction with CGContextSetFont.

See Also

Drawing Text

CGContextGetTextMatrix

Returns the current text matrix.

CGContextGetTextPosition

Returns the location at which text is drawn.

CGContextSelectFont

Sets the font and font size in a graphics context.

Deprecated
CGContextSetCharacterSpacing

Sets the current character spacing.

CGContextSetFont

Sets the platform font in a graphics context.

CGContextSetFontSize

Sets the current font size.

CGContextSetTextDrawingMode

Sets the current text drawing mode.

CGContextSetTextMatrix

Sets the current text matrix.

CGContextSetTextPosition

Sets the location at which text is drawn.

CGContextShowText

Displays a character array at the current text position, a point specified by the current text matrix.

Deprecated