PgContext.itemize

Breaks a piece of text into segments with consistent directional level and shaping engine. Each byte of text will be contained in exactly one of the items in the returned list; the generated list of items will be in logical order (the start offsets of the items are ascending).

cached_iter should be an iterator over attrs currently positioned at a range before or containing start_index; cached_iter will be advanced to the range covering the position just after start_index + length. (i.e. if itemizing in a loop, just keep passing in the same cached_iter).

Parameters

context PgContext

a structure holding information that affects the itemization process.

text string

the text to itemize.

startIndex int

first byte in text to process

length int

the number of bytes (not characters) to process after start_index. This must be >= 0.

attrs PgAttributeList

the set of attributes that apply to text.

cachedIter PgAttributeIterator

Cached attribute iterator, or NULL

Return Value

Type: ListG

a GList of PangoItem structures. The items should be freed using pango_item_free() probably in combination with g_list_foreach(), and the list itself using g_list_free().