<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/> <meta http-equiv="X-UA-Compatible" content="IE=9"/> <meta name="generator" content="Doxygen 1.8.3.1"/> <title>pangomm: Pango::Item Class Reference</title> <link href="tabs.css" rel="stylesheet" type="text/css"/> <script type="text/javascript" src="jquery.js"></script> <script type="text/javascript" src="dynsections.js"></script> <link href="doxygen.css" rel="stylesheet" type="text/css" /> </head> <body> <div id="top"><!-- do not remove this div, it is closed by doxygen! --> <div id="titlearea"> <table cellspacing="0" cellpadding="0"> <tbody> <tr style="height: 56px;"> <td style="padding-left: 0.5em;"> <div id="projectname">pangomm  <span id="projectnumber">2.34.0</span> </div> </td> </tr> </tbody> </table> </div> <!-- end header part --> <!-- Generated by Doxygen 1.8.3.1 --> <div id="navrow1" class="tabs"> <ul class="tablist"> <li><a href="index.html"><span>Main Page</span></a></li> <li><a href="pages.html"><span>Related Pages</span></a></li> <li><a href="modules.html"><span>Modules</span></a></li> <li><a href="namespaces.html"><span>Namespaces</span></a></li> <li class="current"><a href="annotated.html"><span>Classes</span></a></li> </ul> </div> <div id="navrow2" class="tabs2"> <ul class="tablist"> <li><a href="annotated.html"><span>Class List</span></a></li> <li><a href="classes.html"><span>Class Index</span></a></li> <li><a href="inherits.html"><span>Class Hierarchy</span></a></li> <li><a href="functions.html"><span>Class Members</span></a></li> </ul> </div> <div id="nav-path" class="navpath"> <ul> <li class="navelem"><a class="el" href="namespacePango.html">Pango</a></li><li class="navelem"><a class="el" href="classPango_1_1Item.html">Item</a></li> </ul> </div> </div><!-- top --> <div class="header"> <div class="summary"> <a href="#pub-methods">Public Member Functions</a> | <a href="#pro-attribs">Protected Attributes</a> | <a href="#related">Related Functions</a> | <a href="classPango_1_1Item-members.html">List of all members</a> </div> <div class="headertitle"> <div class="title">Pango::Item Class Reference</div> </div> </div><!--header--> <div class="contents"> <p>A <a class="el" href="classPango_1_1Item.html" title="A Pango::Item stores information about a segment of text.">Pango::Item</a> stores information about a segment of text. <a href="classPango_1_1Item.html#details">More...</a></p> <div class="dynheader"> Collaboration diagram for Pango::Item:</div> <div class="dyncontent"> <div class="center"><img src="classPango_1_1Item__coll__graph.png" border="0" usemap="#Pango_1_1Item_coll__map" alt="Collaboration graph"/></div> <map name="Pango_1_1Item_coll__map" id="Pango_1_1Item_coll__map"> </map> <center><span class="legend">[<a href="graph_legend.html">legend</a>]</span></center></div> <table class="memberdecls"> <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-methods"></a> Public Member Functions</h2></td></tr> <tr class="memitem:a7ff3040861b1c2ef264dae5fa41b0a74"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classPango_1_1Item.html#a7ff3040861b1c2ef264dae5fa41b0a74">Item</a> (PangoItem* castitem, bool make_a_copy=true)</td></tr> <tr class="separator:a7ff3040861b1c2ef264dae5fa41b0a74"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a7f865d28fec2317d19c2b0a9b702dda5"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classPango_1_1Item.html#a7f865d28fec2317d19c2b0a9b702dda5">Item</a> (const <a class="el" href="classPango_1_1Item.html">Item</a>& src)</td></tr> <tr class="separator:a7f865d28fec2317d19c2b0a9b702dda5"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a763c8d9b1941e1809a61d5e1ed7acea5"><td class="memItemLeft" align="right" valign="top"><a class="el" href="classPango_1_1Item.html">Item</a>& </td><td class="memItemRight" valign="bottom"><a class="el" href="classPango_1_1Item.html#a763c8d9b1941e1809a61d5e1ed7acea5">operator=</a> (const <a class="el" href="classPango_1_1Item.html">Item</a>& src)</td></tr> <tr class="separator:a763c8d9b1941e1809a61d5e1ed7acea5"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:ace0c5a723379b901bb84050f7f04b634"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classPango_1_1Item.html#ace0c5a723379b901bb84050f7f04b634">~Item</a> ()</td></tr> <tr class="separator:ace0c5a723379b901bb84050f7f04b634"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a798fe6542c0fe91339aae8b7c0dd064e"><td class="memItemLeft" align="right" valign="top">PangoItem* </td><td class="memItemRight" valign="bottom"><a class="el" href="classPango_1_1Item.html#a798fe6542c0fe91339aae8b7c0dd064e">gobj_copy</a> () const </td></tr> <tr class="memdesc:a798fe6542c0fe91339aae8b7c0dd064e"><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C GObject. The caller is responsible for freeing it. Use when directly setting fields in structs. <a href="#a798fe6542c0fe91339aae8b7c0dd064e">More...</a><br/></td></tr> <tr class="separator:a798fe6542c0fe91339aae8b7c0dd064e"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:ad2ef5f06db85d880c3364435e882c2eb"><td class="memItemLeft" align="right" valign="top"><a class="el" href="classPango_1_1Item.html">Item</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classPango_1_1Item.html#ad2ef5f06db85d880c3364435e882c2eb">split</a> (int split_index, int split_offset)</td></tr> <tr class="memdesc:ad2ef5f06db85d880c3364435e882c2eb"><td class="mdescLeft"> </td><td class="mdescRight">Modifies <em>orig</em> to cover only the text after <em>split_index</em>, and returns a new item that covers the text before <em>split_index</em> that used to be in <em>orig</em>. <a href="#ad2ef5f06db85d880c3364435e882c2eb">More...</a><br/></td></tr> <tr class="separator:ad2ef5f06db85d880c3364435e882c2eb"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a8dddd9eab0622cc2648d9ccbffe5bfd4"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="classPango_1_1Item.html#a8dddd9eab0622cc2648d9ccbffe5bfd4">get_offset</a> () const </td></tr> <tr class="memdesc:a8dddd9eab0622cc2648d9ccbffe5bfd4"><td class="mdescLeft"> </td><td class="mdescRight">Gets the offset of the segment from the beginning of the string in bytes. <a href="#a8dddd9eab0622cc2648d9ccbffe5bfd4">More...</a><br/></td></tr> <tr class="separator:a8dddd9eab0622cc2648d9ccbffe5bfd4"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a75f33d0905301c1002060fbccb3ca642"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="classPango_1_1Item.html#a75f33d0905301c1002060fbccb3ca642">get_length</a> () const </td></tr> <tr class="memdesc:a75f33d0905301c1002060fbccb3ca642"><td class="mdescLeft"> </td><td class="mdescRight">Gets the length of the segment in bytes. <a href="#a75f33d0905301c1002060fbccb3ca642">More...</a><br/></td></tr> <tr class="separator:a75f33d0905301c1002060fbccb3ca642"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:afeabaf3536b62cc0928b60476190bd3f"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="classPango_1_1Item.html#afeabaf3536b62cc0928b60476190bd3f">get_num_chars</a> () const </td></tr> <tr class="memdesc:afeabaf3536b62cc0928b60476190bd3f"><td class="mdescLeft"> </td><td class="mdescRight">Gets the length of the segment in characters. <a href="#afeabaf3536b62cc0928b60476190bd3f">More...</a><br/></td></tr> <tr class="separator:afeabaf3536b62cc0928b60476190bd3f"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:ae82eafebde284407501321973cfcdc93"><td class="memItemLeft" align="right" valign="top"><a class="el" href="classPango_1_1Analysis.html">Analysis</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classPango_1_1Item.html#ae82eafebde284407501321973cfcdc93">get_analysis</a> () const </td></tr> <tr class="memdesc:ae82eafebde284407501321973cfcdc93"><td class="mdescLeft"> </td><td class="mdescRight">Gets the properties of the segment. <a href="#ae82eafebde284407501321973cfcdc93">More...</a><br/></td></tr> <tr class="separator:ae82eafebde284407501321973cfcdc93"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:ad9f9e82370ea93a82dc187f6901b1598"><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classPango_1_1Item.html#ad9f9e82370ea93a82dc187f6901b1598">get_segment</a> (const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>& text) const </td></tr> <tr class="memdesc:ad9f9e82370ea93a82dc187f6901b1598"><td class="mdescLeft"> </td><td class="mdescRight">Computes the segment of text that is represented by the item. <a href="#ad9f9e82370ea93a82dc187f6901b1598">More...</a><br/></td></tr> <tr class="separator:ad9f9e82370ea93a82dc187f6901b1598"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a6128734fbdbbe38eda90733048720901"><td class="memItemLeft" align="right" valign="top"><a class="el" href="classPango_1_1GlyphString.html">GlyphString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classPango_1_1Item.html#a6128734fbdbbe38eda90733048720901">shape</a> (const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>& text) const </td></tr> <tr class="memdesc:a6128734fbdbbe38eda90733048720901"><td class="mdescLeft"> </td><td class="mdescRight">Convert a segment of text into a string of glyphs. <a href="#a6128734fbdbbe38eda90733048720901">More...</a><br/></td></tr> <tr class="separator:a6128734fbdbbe38eda90733048720901"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a1140aa02f7f8cbd0940c499cafa000bc"><td class="memItemLeft" align="right" valign="top">PangoItem* </td><td class="memItemRight" valign="bottom"><a class="el" href="classPango_1_1Item.html#a1140aa02f7f8cbd0940c499cafa000bc">gobj</a> ()</td></tr> <tr class="memdesc:a1140aa02f7f8cbd0940c499cafa000bc"><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C GObject. <a href="#a1140aa02f7f8cbd0940c499cafa000bc">More...</a><br/></td></tr> <tr class="separator:a1140aa02f7f8cbd0940c499cafa000bc"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:ad47b94db2ef84fa14312809ce87e1f75"><td class="memItemLeft" align="right" valign="top">const PangoItem* </td><td class="memItemRight" valign="bottom"><a class="el" href="classPango_1_1Item.html#ad47b94db2ef84fa14312809ce87e1f75">gobj</a> () const </td></tr> <tr class="memdesc:ad47b94db2ef84fa14312809ce87e1f75"><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C GObject. <a href="#ad47b94db2ef84fa14312809ce87e1f75">More...</a><br/></td></tr> <tr class="separator:ad47b94db2ef84fa14312809ce87e1f75"><td class="memSeparator" colspan="2"> </td></tr> </table><table class="memberdecls"> <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pro-attribs"></a> Protected Attributes</h2></td></tr> <tr class="memitem:a6b8aa5b21eb343192bbe1485c237ef4a"><td class="memItemLeft" align="right" valign="top">PangoItem* </td><td class="memItemRight" valign="bottom"><a class="el" href="classPango_1_1Item.html#a6b8aa5b21eb343192bbe1485c237ef4a">gobject_</a></td></tr> <tr class="separator:a6b8aa5b21eb343192bbe1485c237ef4a"><td class="memSeparator" colspan="2"> </td></tr> </table><table class="memberdecls"> <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="related"></a> Related Functions</h2></td></tr> <tr><td class="ititle" colspan="2"><p>(Note that these are not member functions.) </p> </td></tr> <tr class="memitem:a012951ae7481f7683f79b56c13df50c2"><td class="memItemLeft" align="right" valign="top"><a class="el" href="classPango_1_1Item.html">Pango::Item</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classPango_1_1Item.html#a012951ae7481f7683f79b56c13df50c2">wrap</a> (PangoItem* object, bool take_copy=true)</td></tr> <tr class="separator:a012951ae7481f7683f79b56c13df50c2"><td class="memSeparator" colspan="2"> </td></tr> </table> <a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2> <div class="textblock"><p>A <a class="el" href="classPango_1_1Item.html" title="A Pango::Item stores information about a segment of text.">Pango::Item</a> stores information about a segment of text. </p> <p><a class="el" href="classPango_1_1Item.html" title="A Pango::Item stores information about a segment of text.">Pango::Item</a> is used as an output type only so there is no public default constructor. You retrieve objects of this type by calling <a class="el" href="classPango_1_1Context.html#ab80e5e65f30473eb4db512fb7eab042c" title="Breaks a piece of text into segments with consistent directional level and shaping engine...">Pango::Context::itemize()</a> with some text. The actual rendering of the segment of text that corresponds to a particular <a class="el" href="classPango_1_1Item.html" title="A Pango::Item stores information about a segment of text.">Pango::Item</a> (or some sub-string) into a string of glyphs is done with <a class="el" href="classPango_1_1Item.html#a6128734fbdbbe38eda90733048720901" title="Convert a segment of text into a string of glyphs.">shape()</a>. The segment of text that corresponds to a <a class="el" href="classPango_1_1Item.html" title="A Pango::Item stores information about a segment of text.">Pango::Item</a> can be computed from the text passed into <a class="el" href="classPango_1_1Context.html#ab80e5e65f30473eb4db512fb7eab042c" title="Breaks a piece of text into segments with consistent directional level and shaping engine...">Pango::Context::itemize()</a> with <a class="el" href="classPango_1_1Item.html#ad9f9e82370ea93a82dc187f6901b1598" title="Computes the segment of text that is represented by the item.">get_segment()</a>. Together with the <a class="el" href="classPango_1_1Analysis.html" title="A Pango::Analysis stores information about the properties of a segment of text.">Pango::Analysis</a> data member that can be accessed with <a class="el" href="classPango_1_1Item.html#ae82eafebde284407501321973cfcdc93" title="Gets the properties of the segment.">get_analysis()</a> it is needed for further calculations in <a class="el" href="classPango_1_1GlyphString.html" title="A Pango::GlyphString is used to store strings of glyphs with geometry and visual attribute informatio...">Pango::GlyphString</a>. </p> </div><h2 class="groupheader">Constructor & Destructor Documentation</h2> <a class="anchor" id="a7ff3040861b1c2ef264dae5fa41b0a74"></a> <div class="memitem"> <div class="memproto"> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname">Pango::Item::Item </td> <td>(</td> <td class="paramtype">PangoItem * </td> <td class="paramname"><em>castitem</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">bool </td> <td class="paramname"><em>make_a_copy</em> = <code>true</code> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">explicit</span></span> </td> </tr> </table> </div><div class="memdoc"> </div> </div> <a class="anchor" id="a7f865d28fec2317d19c2b0a9b702dda5"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">Pango::Item::Item </td> <td>(</td> <td class="paramtype">const <a class="el" href="classPango_1_1Item.html">Item</a>& </td> <td class="paramname"><em>src</em></td><td>)</td> <td></td> </tr> </table> </div><div class="memdoc"> </div> </div> <a class="anchor" id="ace0c5a723379b901bb84050f7f04b634"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">Pango::Item::~Item </td> <td>(</td> <td class="paramname"></td><td>)</td> <td></td> </tr> </table> </div><div class="memdoc"> </div> </div> <h2 class="groupheader">Member Function Documentation</h2> <a class="anchor" id="ae82eafebde284407501321973cfcdc93"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname"><a class="el" href="classPango_1_1Analysis.html">Analysis</a> Pango::Item::get_analysis </td> <td>(</td> <td class="paramname"></td><td>)</td> <td> const</td> </tr> </table> </div><div class="memdoc"> <p>Gets the properties of the segment. </p> <dl class="section return"><dt>Returns</dt><dd>The properties of the segment. </dd></dl> </div> </div> <a class="anchor" id="a75f33d0905301c1002060fbccb3ca642"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">int Pango::Item::get_length </td> <td>(</td> <td class="paramname"></td><td>)</td> <td> const</td> </tr> </table> </div><div class="memdoc"> <p>Gets the length of the segment in bytes. </p> <dl class="section return"><dt>Returns</dt><dd>The length of the segment in bytes. </dd></dl> </div> </div> <a class="anchor" id="afeabaf3536b62cc0928b60476190bd3f"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">int Pango::Item::get_num_chars </td> <td>(</td> <td class="paramname"></td><td>)</td> <td> const</td> </tr> </table> </div><div class="memdoc"> <p>Gets the length of the segment in characters. </p> <dl class="section return"><dt>Returns</dt><dd>The length of the semgment in characters. </dd></dl> </div> </div> <a class="anchor" id="a8dddd9eab0622cc2648d9ccbffe5bfd4"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">int Pango::Item::get_offset </td> <td>(</td> <td class="paramname"></td><td>)</td> <td> const</td> </tr> </table> </div><div class="memdoc"> <p>Gets the offset of the segment from the beginning of the string in bytes. </p> <dl class="section return"><dt>Returns</dt><dd>The offset of the segment from the beginning of the string in bytes. </dd></dl> </div> </div> <a class="anchor" id="ad9f9e82370ea93a82dc187f6901b1598"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> Pango::Item::get_segment </td> <td>(</td> <td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td> <td class="paramname"><em>text</em></td><td>)</td> <td> const</td> </tr> </table> </div><div class="memdoc"> <p>Computes the segment of text that is represented by the item. </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">text</td><td>The text that has been passed into <a class="el" href="classPango_1_1Context.html#ab80e5e65f30473eb4db512fb7eab042c" title="Breaks a piece of text into segments with consistent directional level and shaping engine...">Pango::Context::itemize()</a>. </td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>The sub-string of <em>text</em> that corresponds to the item. </dd></dl> </div> </div> <a class="anchor" id="a1140aa02f7f8cbd0940c499cafa000bc"></a> <div class="memitem"> <div class="memproto"> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname">PangoItem* Pango::Item::gobj </td> <td>(</td> <td class="paramname"></td><td>)</td> <td></td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">inline</span></span> </td> </tr> </table> </div><div class="memdoc"> <p>Provides access to the underlying C GObject. </p> </div> </div> <a class="anchor" id="ad47b94db2ef84fa14312809ce87e1f75"></a> <div class="memitem"> <div class="memproto"> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname">const PangoItem* Pango::Item::gobj </td> <td>(</td> <td class="paramname"></td><td>)</td> <td> const</td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">inline</span></span> </td> </tr> </table> </div><div class="memdoc"> <p>Provides access to the underlying C GObject. </p> </div> </div> <a class="anchor" id="a798fe6542c0fe91339aae8b7c0dd064e"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">PangoItem* Pango::Item::gobj_copy </td> <td>(</td> <td class="paramname"></td><td>)</td> <td> const</td> </tr> </table> </div><div class="memdoc"> <p>Provides access to the underlying C GObject. The caller is responsible for freeing it. Use when directly setting fields in structs. </p> </div> </div> <a class="anchor" id="a763c8d9b1941e1809a61d5e1ed7acea5"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname"><a class="el" href="classPango_1_1Item.html">Item</a>& Pango::Item::operator= </td> <td>(</td> <td class="paramtype">const <a class="el" href="classPango_1_1Item.html">Item</a>& </td> <td class="paramname"><em>src</em></td><td>)</td> <td></td> </tr> </table> </div><div class="memdoc"> </div> </div> <a class="anchor" id="a6128734fbdbbe38eda90733048720901"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname"><a class="el" href="classPango_1_1GlyphString.html">GlyphString</a> Pango::Item::shape </td> <td>(</td> <td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td> <td class="paramname"><em>text</em></td><td>)</td> <td> const</td> </tr> </table> </div><div class="memdoc"> <p>Convert a segment of text into a string of glyphs. </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">text</td><td>The text to process. This must either be the whole segment of text that corresponds to the item as returned by <a class="el" href="classPango_1_1Item.html#ad9f9e82370ea93a82dc187f6901b1598" title="Computes the segment of text that is represented by the item.">get_segment()</a> or a sub-string of that segment. You need to pass the same text to the member functions of <a class="el" href="classPango_1_1GlyphString.html" title="A Pango::GlyphString is used to store strings of glyphs with geometry and visual attribute informatio...">Pango::GlyphString</a> for further calculations. </td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>A <a class="el" href="classPango_1_1GlyphString.html" title="A Pango::GlyphString is used to store strings of glyphs with geometry and visual attribute informatio...">Pango::GlyphString</a> object that can be measured or drawn. </dd></dl> </div> </div> <a class="anchor" id="ad2ef5f06db85d880c3364435e882c2eb"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname"><a class="el" href="classPango_1_1Item.html">Item</a> Pango::Item::split </td> <td>(</td> <td class="paramtype">int </td> <td class="paramname"><em>split_index</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">int </td> <td class="paramname"><em>split_offset</em> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td> </tr> </table> </div><div class="memdoc"> <p>Modifies <em>orig</em> to cover only the text after <em>split_index</em>, and returns a new item that covers the text before <em>split_index</em> that used to be in <em>orig</em>. </p> <p>You can think of <em>split_index</em> as the length of the returned item. <em>split_index</em> may not be 0, and it may not be greater than or equal to the length of <em>orig</em> (that is, there must be at least one byte assigned to each item, you can't create a zero-length item). <em>split_offset</em> is the length of the first item in chars, and must be provided because the text used to generate the item isn't available, so <a class="el" href="classPango_1_1Item.html#ad2ef5f06db85d880c3364435e882c2eb" title="Modifies orig to cover only the text after split_index, and returns a new item that covers the text b...">split()</a> can't count the char length of the split items itself. </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">split_index</td><td>Byte index of position to split item, relative to the start of the item. </td></tr> <tr><td class="paramname">split_offset</td><td>Number of chars between start of <em>orig</em> and <em>split_index</em>. </td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>New item representing text before <em>split_index</em>, which should be freed with free(). </dd></dl> </div> </div> <h2 class="groupheader">Friends And Related Function Documentation</h2> <a class="anchor" id="a012951ae7481f7683f79b56c13df50c2"></a> <div class="memitem"> <div class="memproto"> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname"><a class="el" href="classPango_1_1Item.html">Pango::Item</a> wrap </td> <td>(</td> <td class="paramtype">PangoItem * </td> <td class="paramname"><em>object</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">bool </td> <td class="paramname"><em>take_copy</em> = <code>true</code> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">related</span></span> </td> </tr> </table> </div><div class="memdoc"> </div> </div> <h2 class="groupheader">Member Data Documentation</h2> <a class="anchor" id="a6b8aa5b21eb343192bbe1485c237ef4a"></a> <div class="memitem"> <div class="memproto"> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname">PangoItem* Pango::Item::gobject_</td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">protected</span></span> </td> </tr> </table> </div><div class="memdoc"> </div> </div> <hr/>The documentation for this class was generated from the following file:<ul> <li>pangomm/item.h</li> </ul> </div><!-- contents --> <!-- start footer part --> <hr class="footer"/><address class="footer"><small> Generated on Wed Apr 24 2013 11:02:59 for pangomm by  <a href="http://www.doxygen.org/index.html"> <img class="footer" src="doxygen.png" alt="doxygen"/> </a> 1.8.3.1 </small></address> </body> </html>