Context.textExtents

void textExtents(string utf8, out cairo.types.TextExtents extents)

Gets the extents for a string of text. The extents describe a user-space rectangle that encloses the "inked" portion of the text, (as it would be drawn by cairo.context.Context.showText). Additionally, the x_advance and y_advance values indicate the amount by which the current point would be advanced by cairo.context.Context.showText.

Note that whitespace characters do not directly contribute to the size of the rectangle (extents.width and extents.height). They do contribute indirectly by changing the position of non-whitespace characters. In particular, trailing whitespace characters are likely to not affect the size of the rectangle, though they will affect the x_advance and y_advance values.

Parameters

utf8a NUL-terminated string of text encoded in UTF-8, or null
extentsa #cairo_text_extents_t object into which the results will be stored