<ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the <linklocation="node:gtk-sharp/programming/threads">Gtk# Thread Programming</link> for details.</ThreadSafetyStatement>
<summary>A pair of a <seecref="T:Pango.Item"/> and the glyphs resulting from shaping the text corresponding to an item.</summary>
<remarks>As an example of the usage of <seecref="T:Pango.GlyphItem"/>, the results of shaping text with <seecref="T:Pango.Layout"/> is a list of <seecref="T:Pango.LayoutLine"/>, each of which contains a list of <seecref="T:Pango.GlyphItem"/>.</remarks>
<paramname="text"> text to which positions in orig apply.</param>
<paramname="split_index"> byte index of position to split item, relative to the start of the item</param>
<returns>a <seecref="T:Pango.GlyphItem"/> representing the text before <paramrefname="split_index"/></returns>
<remarks>
<para>
Modifies orig to cover only the text after <paramrefname="split_index"/>, and returns a new item that covers the text before <paramrefname="split_index"/> that used to be in orig. You can think of <paramrefname="split_index"/> as the length of the returned item. <paramrefname="split_index"/> may not be 0, and it may not be greater than or equal to the length of orig (that is, there must be at least one byte assigned to each item, you cannot create a zero-length item).
</para>
This function is similar in function to <seecref="M:Pango.Item.Split()"/> (and uses it internally)</remarks>
The idea is that if you have attributes that do not affect shaping, such as color or underline, to avoid affecting shaping, you filter them out (<seecref="M:Pango.AttrList.Filter()"/>), apply the shaping process and then re-apply them to the result using this function.
</para>
<para>
All attributes that start or end inside a cluster are applied to that cluster; for instance, if half of a cluster is underlined and the other-half strikethough, then the cluster will end up with both underline and strikethrough attributes. In these cases, it may happen that item->extra_attrs for some of the result items can have multiple attributes of the same type.