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().

Meta