Function

Pango-1.0 ▶ Pango ▶ itemize

  • Breaks a piece of text into segments with consistent directional level and font.

    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: Pango.Context

      a structure holding information that affects the itemization process.

    • text: string

      the text to itemize. Must be valid UTF-8

    • start_index: number

      first byte in text to process

    • length: number

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

    • attrs: AttrList

      the set of attributes that apply to text.

    • Optionalcached_iter: AttrIterator

      Cached attribute iterator

    Returns Pango.Item[]

    a GLib.List of Pango.Item structures. The items should be freed using Pango.Item.free in combination with GLib.List.free_full.