Method

Pango.LayoutIter.get_run_readonly

Declaration [src]

PangoLayoutRun*
pango_layout_iter_get_run_readonly (
  PangoLayoutIter* iter
)

Description [src]

Gets the current run for read-only access.

When iterating by run, at the end of each line, there’s a position with a NULL run, so this function can return NULL. The NULL run at the end of each line ensures that all lines have at least one run, even lines consisting of only a newline.

This is a faster alternative to pango_layout_iter_get_run(), but the user is not expected to modify the contents of the run (glyphs, glyph widths, etc.).

Return value

Returns: PangoLayoutRun

the current run, that should not be modified

Ownership is not transferred to the caller
Can be NULL