void pango_attr_list_splice ( PangoAttrList* list, PangoAttrList* other, int pos, int len )
This function opens up a hole in
list, fills it
in with attributes from the left, and then merges
other on top of the hole.
This operation is equivalent to stretching every attribute
that applies at position
list by an amount
and then calling
pango_attr_list_change() with a copy
of each attribute in
other in sequence (offset in position
pos, and limited in length to
This operation proves useful for, for instance, inserting a pre-edit string in the middle of an edit buffer.
For backwards compatibility, the function behaves differently
len is 0. In this case, the attributes from
not imited to
len, and are just overlayed on top of
This mode is useful for merging two lists of attributes together.
The data is owned by the caller of the method.
The position in
listat which to insert
The length of the spliced segment. (Note that this must be specified since the attributes in
othermay only be present at some subsection of this range)