<!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.9.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" />
<link href="doxygen-extra.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.40.1</span>
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.9.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>
<p><code>#include <pangomm/item.h></code></p>
<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" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/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" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/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" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/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" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ustring.html">Glib::ustring</a> Pango::Item::get_segment </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/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" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/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>
</div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Generated on Fri Aug 19 2016 15:59:16 for pangomm by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.8.9.1
</small></address>
</body>
</html>