Sophie

Sophie

distrib > Mandriva > 9.1 > ppc > by-pkgid > e0521f28751d07a87e3a3d6c7d15a1ac > files > 1455

libgtkmm2.0_1-devel-2.2.1-2mdk.ppc.rpm

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1">
<title>Pango::GlyphString class Reference</title>
<link href="doxygen.css" rel="stylesheet" type="text/css">
</head>
<body bgcolor="#ffffff">
<table border="0" width="100%">
<tr>
    <td width="10%" height="40"><img src="../../images/gtkmm_logo.gif" alt="logo" border="0" width="100%" height="100%"/></td>
    <td width="90%" height="40"><img src="../../images/top.gif" alt="top" width="100%" height="40"/></td>
</tr>
</table>
<center>
  <a class="qindex" href="../../index.html">Main Page</a> &nbsp;
  <a href="group__Widgets.html">Widgets</a> &nbsp;
  <a class="qindex" href="namespaces.html"> Namespaces</a> &nbsp;
  <a href="../../tutorial/html/index.html"> Book</a> &nbsp;
</center>
<hr width="100%"/>

<!-- Generated by Doxygen 1.3-rc1 -->
<h1>Pango::GlyphString Class Reference</h1>A Pango::GlyphString is used to store strings of glyphs with geometry and visual attribute information. 
<a href="#_details">More...</a>
<p>
<a href="classPango_1_1GlyphString-members.html">List of all members.</a><table border=0 cellpadding=0 cellspacing=0>
<tr><td></td></tr>
<tr><td colspan=2><br><h2>Public Methods</h2></td></tr>
<tr><td nowrap align=right valign=top>&nbsp;</td><td valign=bottom><a class="el" href="classPango_1_1GlyphString.html#a0">GlyphString</a> ()</td></tr>
<tr><td nowrap align=right valign=top>&nbsp;</td><td valign=bottom><a class="el" href="classPango_1_1GlyphString.html#a1">GlyphString</a> (PangoGlyphString* gobject, bool make_a_copy=true)</td></tr>
<tr><td nowrap align=right valign=top>&nbsp;</td><td valign=bottom><a class="el" href="classPango_1_1GlyphString.html#a2">GlyphString</a> (const GlyphString&amp; other)</td></tr>
<tr><td nowrap align=right valign=top>GlyphString&amp;&nbsp;</td><td valign=bottom><a class="el" href="classPango_1_1GlyphString.html#a3">operator=</a> (const GlyphString&amp; other)</td></tr>
<tr><td nowrap align=right valign=top>&nbsp;</td><td valign=bottom><a class="el" href="classPango_1_1GlyphString.html#a4">~GlyphString</a> ()</td></tr>
<tr><td nowrap align=right valign=top>void&nbsp;</td><td valign=bottom><a class="el" href="classPango_1_1GlyphString.html#a5">swap</a> (GlyphString&amp; other)</td></tr>
<tr><td nowrap align=right valign=top>PangoGlyphString*&nbsp;</td><td valign=bottom><a class="el" href="classPango_1_1GlyphString.html#a6">gobj</a> ()</td></tr>
<tr><td nowrap align=right valign=top>const PangoGlyphString*&nbsp;</td><td valign=bottom><a class="el" href="classPango_1_1GlyphString.html#a7">gobj</a> () const</td></tr>
<tr><td nowrap align=right valign=top>PangoGlyphString*&nbsp;</td><td valign=bottom><a class="el" href="classPango_1_1GlyphString.html#a8">gobj_copy</a> () const</td></tr>
<tr><td nowrap align=right valign=top>&nbsp;</td><td valign=bottom><a class="el" href="classPango_1_1GlyphString.html#a9">GlyphString</a> (const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>&amp; text, const <a class="el" href="classPango_1_1Analysis.html">Analysis</a>&amp; analysis)</td></tr>
<tr><td>&nbsp;</td><td><font size=-1><em>Construct a string of glyphs from a string of characters.</em> <a href="#a9"></a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>void&nbsp;</td><td valign=bottom><a class="el" href="classPango_1_1GlyphString.html#a10">set_size</a> (int new_len)</td></tr>
<tr><td>&nbsp;</td><td><font size=-1><em>Resize a glyph string to the given length.</em> <a href="#a10"></a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>void&nbsp;</td><td valign=bottom><a class="el" href="classPango_1_1GlyphString.html#a11">get_extents</a> (const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;const <a class="el" href="classPango_1_1Font.html">Font</a>&gt;&amp; font, <a class="el" href="classPango_1_1Rectangle.html">Rectangle</a>&amp; ink_rect, <a class="el" href="classPango_1_1Rectangle.html">Rectangle</a>&amp; logical_rect) const</td></tr>
<tr><td>&nbsp;</td><td><font size=-1><em>Compute the logical and ink extents of a glyph string.</em> <a href="#a11"></a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>void&nbsp;</td><td valign=bottom><a class="el" href="classPango_1_1GlyphString.html#a12">get_extents</a> (int start, int end, const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;const <a class="el" href="classPango_1_1Font.html">Font</a>&gt;&amp; font, <a class="el" href="classPango_1_1Rectangle.html">Rectangle</a>&amp; ink_rect, <a class="el" href="classPango_1_1Rectangle.html">Rectangle</a>&amp; logical_rect) const</td></tr>
<tr><td>&nbsp;</td><td><font size=-1><em>Computes the extents of a sub-portion of a glyph string.</em> <a href="#a12"></a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="classPango_1_1Rectangle.html">Rectangle</a>&nbsp;</td><td valign=bottom><a class="el" href="classPango_1_1GlyphString.html#a13">get_ink_extents</a> (const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;const <a class="el" href="classPango_1_1Font.html">Font</a>&gt;&amp; font) const</td></tr>
<tr><td>&nbsp;</td><td><font size=-1><em>Computes the extents of the glyph string as drawn.</em> <a href="#a13"></a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="classPango_1_1Rectangle.html">Rectangle</a>&nbsp;</td><td valign=bottom><a class="el" href="classPango_1_1GlyphString.html#a14">get_ink_extents</a> (int start, int end, const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;const <a class="el" href="classPango_1_1Font.html">Font</a>&gt;&amp; font) const</td></tr>
<tr><td>&nbsp;</td><td><font size=-1><em>Computes the extents of a sub-portion of the glyph string as drawn.</em> <a href="#a14"></a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="classPango_1_1Rectangle.html">Rectangle</a>&nbsp;</td><td valign=bottom><a class="el" href="classPango_1_1GlyphString.html#a15">get_logical_extents</a> (const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;const <a class="el" href="classPango_1_1Font.html">Font</a>&gt;&amp; font) const</td></tr>
<tr><td>&nbsp;</td><td><font size=-1><em>Computes the logical extents of a sub-portion of the glyph string.</em> <a href="#a15"></a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="classPango_1_1Rectangle.html">Rectangle</a>&nbsp;</td><td valign=bottom><a class="el" href="classPango_1_1GlyphString.html#a16">get_logical_extents</a> (int start, int end, const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;const <a class="el" href="classPango_1_1Font.html">Font</a>&gt;&amp; font) const</td></tr>
<tr><td>&nbsp;</td><td><font size=-1><em>Computes the logical extents of a sub-portion of the glyph string.</em> <a href="#a16"></a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="classGlib_1_1ArrayHandle.html">Glib::ArrayHandle</a>&lt;int&gt;&nbsp;</td><td valign=bottom><a class="el" href="classPango_1_1GlyphString.html#a17">get_logical_widths</a> (const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>&amp; text, int embedding_level) const</td></tr>
<tr><td>&nbsp;</td><td><font size=-1><em>Determine the screen width corresponding to each character.</em> <a href="#a17"></a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>int&nbsp;</td><td valign=bottom><a class="el" href="classPango_1_1GlyphString.html#a18">index_to_x</a> (const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>&amp; text, const <a class="el" href="classPango_1_1Analysis.html">Analysis</a>&amp; analysis, int index, bool trailing) const</td></tr>
<tr><td>&nbsp;</td><td><font size=-1><em>Converts from character position to x position.</em> <a href="#a18"></a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>void&nbsp;</td><td valign=bottom><a class="el" href="classPango_1_1GlyphString.html#a19">x_to_index</a> (const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>&amp; text, const <a class="el" href="classPango_1_1Analysis.html">Analysis</a>&amp; analysis, int x_pos, int&amp; index, bool&amp; trailing) const</td></tr>
<tr><td>&nbsp;</td><td><font size=-1><em>Convert from x offset to character position.</em> <a href="#a19"></a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="classGlib_1_1ArrayHandle.html">Glib::ArrayHandle</a>&lt;<a class="el" href="classPango_1_1GlyphInfo.html">GlyphInfo</a>&gt;&nbsp;</td><td valign=bottom><a class="el" href="classPango_1_1GlyphString.html#a20">get_glyphs</a> () const</td></tr>
<tr><td>&nbsp;</td><td><font size=-1><em>Gharacter positions are computed by dividing up each cluster into equal portions.</em> <a href="#a20"></a><em></em></font><br><br></td></tr>
<tr><td colspan=2><br><h2>Protected Attributes</h2></td></tr>
<tr><td nowrap align=right valign=top>PangoGlyphString*&nbsp;</td><td valign=bottom><a class="el" href="classPango_1_1GlyphString.html#n0">gobject_</a></td></tr>
<tr><td colspan=2><br><h2>Related Functions</h2></td></tr>
<tr><td colspan=2>(Note that these are not member functions.)<br><br></td></tr>
<tr><td nowrap align=right valign=top>void&nbsp;</td><td valign=bottom><a class="el" href="classPango_1_1GlyphString.html#k0">swap</a> (GlyphString&amp; lhs, GlyphString&amp; rhs)</td></tr>
<tr><td nowrap align=right valign=top>Pango::GlyphString&nbsp;</td><td valign=bottom><a class="el" href="classPango_1_1GlyphString.html#k1">wrap</a> (PangoGlyphString* object, bool take_copy=false)</td></tr>
</table>
<hr><a name="_details"></a><h2>Detailed Description</h2>
A Pango::GlyphString is used to store strings of glyphs with geometry and visual attribute information.
<p>
It can be measured or drawn to the screen. 
<p>
<hr><h2>Constructor &amp; Destructor Documentation</h2>
<a name="a0" doxytag="Pango::GlyphString::GlyphString"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
  <tr>
    <td class="md">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"> Pango::GlyphString::GlyphString </td>
          <td class="md" valign="top">(</td>
          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
          <td class="md" valign="top">)&nbsp;</td>
          <td class="md" nowrap></td>
        </tr>

      </table>
    </td>
  </tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
    </td>
  </tr>
</table>
<a name="a1" doxytag="Pango::GlyphString::GlyphString"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
  <tr>
    <td class="md">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"> Pango::GlyphString::GlyphString </td>
          <td class="md" valign="top">(</td>
          <td class="md" nowrap valign="top">PangoGlyphString*&nbsp;</td>
          <td class="mdname" nowrap>&nbsp; <em>gobject</em>, </td>
        </tr>
        <tr>
          <td></td>
          <td></td>
          <td class="md" nowrap>bool&nbsp;</td>
          <td class="mdname" nowrap>&nbsp; <em>make_a_copy</em> = true</td>
        </tr>
        <tr>
          <td></td>
          <td class="md">)&nbsp;</td>
          <td class="md" colspan="2"><code> [explicit]</code></td>
        </tr>

      </table>
    </td>
  </tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
    </td>
  </tr>
</table>
<a name="a2" doxytag="Pango::GlyphString::GlyphString"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
  <tr>
    <td class="md">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"> Pango::GlyphString::GlyphString </td>
          <td class="md" valign="top">(</td>
          <td class="md" nowrap valign="top">const GlyphString&amp;&nbsp;</td>
          <td class="mdname1" valign="top" nowrap>&nbsp; <em>other</em>          </td>
          <td class="md" valign="top">)&nbsp;</td>
          <td class="md" nowrap></td>
        </tr>

      </table>
    </td>
  </tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
    </td>
  </tr>
</table>
<a name="a4" doxytag="Pango::GlyphString::~GlyphString"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
  <tr>
    <td class="md">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"> Pango::GlyphString::~GlyphString </td>
          <td class="md" valign="top">(</td>
          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
          <td class="md" valign="top">)&nbsp;</td>
          <td class="md" nowrap></td>
        </tr>

      </table>
    </td>
  </tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
    </td>
  </tr>
</table>
<a name="a9" doxytag="Pango::GlyphString::GlyphString"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
  <tr>
    <td class="md">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"> Pango::GlyphString::GlyphString </td>
          <td class="md" valign="top">(</td>
          <td class="md" nowrap valign="top">const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>&amp;&nbsp;</td>
          <td class="mdname" nowrap>&nbsp; <em>text</em>, </td>
        </tr>
        <tr>
          <td></td>
          <td></td>
          <td class="md" nowrap>const <a class="el" href="classPango_1_1Analysis.html">Analysis</a>&amp;&nbsp;</td>
          <td class="mdname" nowrap>&nbsp; <em>analysis</em></td>
        </tr>
        <tr>
          <td></td>
          <td class="md">)&nbsp;</td>
          <td class="md" colspan="2"></td>
        </tr>

      </table>
    </td>
  </tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Construct a string of glyphs from a string of characters.
<p>
Given a segment of text and the corresponding <a class="el" href="classPango_1_1Analysis.html">Pango::Analysis</a> structure returned from <a class="el" href="classPango_1_1Context.html#a15">Pango::Context::itemize()</a>, convert the characters into glyphs. You may also pass in only a sub-string of the item. <dl compact><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign=top><em>text</em>&nbsp;</td><td>The text to process. You must pass the same string into those member functions expecting a const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>&amp;. </td></tr>
    <tr><td valign=top><em>analysis</em>&nbsp;</td><td>The analysis information return from <a class="el" href="classPango_1_1Context.html#a15">Pango::Context::itemize()</a>. </td></tr>
  </table>
</dl>
    </td>
  </tr>
</table>
<hr><h2>Member Function Documentation</h2>
<a name="a12" doxytag="Pango::GlyphString::get_extents"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
  <tr>
    <td class="md">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"> void Pango::GlyphString::get_extents </td>
          <td class="md" valign="top">(</td>
          <td class="md" nowrap valign="top">int&nbsp;</td>
          <td class="mdname" nowrap>&nbsp; <em>start</em>, </td>
        </tr>
        <tr>
          <td></td>
          <td></td>
          <td class="md" nowrap>int&nbsp;</td>
          <td class="mdname" nowrap>&nbsp; <em>end</em>, </td>
        </tr>
        <tr>
          <td></td>
          <td></td>
          <td class="md" nowrap>const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;const <a class="el" href="classPango_1_1Font.html">Font</a>&gt;&amp;&nbsp;</td>
          <td class="mdname" nowrap>&nbsp; <em>font</em>, </td>
        </tr>
        <tr>
          <td></td>
          <td></td>
          <td class="md" nowrap><a class="el" href="classPango_1_1Rectangle.html">Rectangle</a>&amp;&nbsp;</td>
          <td class="mdname" nowrap>&nbsp; <em>ink_rect</em>, </td>
        </tr>
        <tr>
          <td></td>
          <td></td>
          <td class="md" nowrap><a class="el" href="classPango_1_1Rectangle.html">Rectangle</a>&amp;&nbsp;</td>
          <td class="mdname" nowrap>&nbsp; <em>logical_rect</em></td>
        </tr>
        <tr>
          <td></td>
          <td class="md">)&nbsp;</td>
          <td class="md" colspan="2"> const</td>
        </tr>

      </table>
    </td>
  </tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Computes the extents of a sub-portion of a glyph string.
<p>
The extents are relative to the start of the glyph string range (the origin of their coordinate system is at the start of the range, not at the start of the entire glyph string). <dl compact><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign=top><em>start</em>&nbsp;</td><td>Start index. </td></tr>
    <tr><td valign=top><em>end</em>&nbsp;</td><td>End index (the range is the set of bytes with indices such that start &lt;= index &lt; end). </td></tr>
    <tr><td valign=top><em>font</em>&nbsp;</td><td>A <a class="el" href="classPango_1_1Font.html">Pango::Font</a>. </td></tr>
    <tr><td valign=top><em>ink_rect</em>&nbsp;</td><td><a class="el" href="classPango_1_1Rectangle.html">Rectangle</a> used to store the extents of the glyph string range as drawn or <code>0</code> to indicate that the result is not needed. </td></tr>
    <tr><td valign=top><em>logical_rect</em>&nbsp;</td><td><a class="el" href="classPango_1_1Rectangle.html">Rectangle</a> used to store the logical extents of the glyph string range or <code>0</code> to indicate that the result is not needed. </td></tr>
  </table>
</dl>
    </td>
  </tr>
</table>
<a name="a11" doxytag="Pango::GlyphString::get_extents"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
  <tr>
    <td class="md">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"> void Pango::GlyphString::get_extents </td>
          <td class="md" valign="top">(</td>
          <td class="md" nowrap valign="top">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;const <a class="el" href="classPango_1_1Font.html">Font</a>&gt;&amp;&nbsp;</td>
          <td class="mdname" nowrap>&nbsp; <em>font</em>, </td>
        </tr>
        <tr>
          <td></td>
          <td></td>
          <td class="md" nowrap><a class="el" href="classPango_1_1Rectangle.html">Rectangle</a>&amp;&nbsp;</td>
          <td class="mdname" nowrap>&nbsp; <em>ink_rect</em>, </td>
        </tr>
        <tr>
          <td></td>
          <td></td>
          <td class="md" nowrap><a class="el" href="classPango_1_1Rectangle.html">Rectangle</a>&amp;&nbsp;</td>
          <td class="mdname" nowrap>&nbsp; <em>logical_rect</em></td>
        </tr>
        <tr>
          <td></td>
          <td class="md">)&nbsp;</td>
          <td class="md" colspan="2"> const</td>
        </tr>

      </table>
    </td>
  </tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Compute the logical and ink extents of a glyph string.
<p>
See the documentation for <a class="el" href="classPango_1_1Font.html#a8">Pango::Font::get_glyph_extents()</a> for details about the interpretation of the rectangles. <dl compact><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign=top><em>font</em>&nbsp;</td><td>A <a class="el" href="classPango_1_1Font.html">Pango::Font</a>. </td></tr>
    <tr><td valign=top><em>ink_rect</em>&nbsp;</td><td><a class="el" href="classPango_1_1Rectangle.html">Rectangle</a> used to store the extents of the glyph string as drawn or <code>0</code> to indicate that the result is not needed. </td></tr>
    <tr><td valign=top><em>logical_rect</em>&nbsp;</td><td><a class="el" href="classPango_1_1Rectangle.html">Rectangle</a> used to store the logical extents of the glyph string or <code>0</code> to indicate that the result is not needed. </td></tr>
  </table>
</dl>
    </td>
  </tr>
</table>
<a name="a20" doxytag="Pango::GlyphString::get_glyphs"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
  <tr>
    <td class="md">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"> <a class="el" href="classGlib_1_1ArrayHandle.html">Glib::ArrayHandle</a>&lt;<a class="el" href="classPango_1_1GlyphInfo.html">GlyphInfo</a>&gt; Pango::GlyphString::get_glyphs </td>
          <td class="md" valign="top">(</td>
          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
          <td class="md" valign="top">)&nbsp;</td>
          <td class="md" nowrap> const</td>
        </tr>

      </table>
    </td>
  </tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Gharacter positions are computed by dividing up each cluster into equal portions.
<p>
<dl compact><dt><b>Returns:</b></dt><dd>An array of <a class="el" href="classPango_1_1GlyphInfo.html">Pango::GlyphInfo</a> objects. </dd></dl>
    </td>
  </tr>
</table>
<a name="a14" doxytag="Pango::GlyphString::get_ink_extents"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
  <tr>
    <td class="md">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"> <a class="el" href="classPango_1_1Rectangle.html">Rectangle</a> Pango::GlyphString::get_ink_extents </td>
          <td class="md" valign="top">(</td>
          <td class="md" nowrap valign="top">int&nbsp;</td>
          <td class="mdname" nowrap>&nbsp; <em>start</em>, </td>
        </tr>
        <tr>
          <td></td>
          <td></td>
          <td class="md" nowrap>int&nbsp;</td>
          <td class="mdname" nowrap>&nbsp; <em>end</em>, </td>
        </tr>
        <tr>
          <td></td>
          <td></td>
          <td class="md" nowrap>const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;const <a class="el" href="classPango_1_1Font.html">Font</a>&gt;&amp;&nbsp;</td>
          <td class="mdname" nowrap>&nbsp; <em>font</em></td>
        </tr>
        <tr>
          <td></td>
          <td class="md">)&nbsp;</td>
          <td class="md" colspan="2"> const</td>
        </tr>

      </table>
    </td>
  </tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Computes the extents of a sub-portion of the glyph string as drawn.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign=top><em>start</em>&nbsp;</td><td>The start index. </td></tr>
    <tr><td valign=top><em>end</em>&nbsp;</td><td>The end index. </td></tr>
    <tr><td valign=top><em>font</em>&nbsp;</td><td>A Panog::Font </td></tr>
  </table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The extents of the sub-portion of the glyph string as drawn. </dd></dl>
    </td>
  </tr>
</table>
<a name="a13" doxytag="Pango::GlyphString::get_ink_extents"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
  <tr>
    <td class="md">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"> <a class="el" href="classPango_1_1Rectangle.html">Rectangle</a> Pango::GlyphString::get_ink_extents </td>
          <td class="md" valign="top">(</td>
          <td class="md" nowrap valign="top">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;const <a class="el" href="classPango_1_1Font.html">Font</a>&gt;&amp;&nbsp;</td>
          <td class="mdname1" valign="top" nowrap>&nbsp; <em>font</em>          </td>
          <td class="md" valign="top">)&nbsp;</td>
          <td class="md" nowrap> const</td>
        </tr>

      </table>
    </td>
  </tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Computes the extents of the glyph string as drawn.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign=top><em>font</em>&nbsp;</td><td>A <a class="el" href="classPango_1_1Font.html">Pango::Font</a>. </td></tr>
  </table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The extents of the glyph string as drawn. </dd></dl>
    </td>
  </tr>
</table>
<a name="a16" doxytag="Pango::GlyphString::get_logical_extents"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
  <tr>
    <td class="md">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"> <a class="el" href="classPango_1_1Rectangle.html">Rectangle</a> Pango::GlyphString::get_logical_extents </td>
          <td class="md" valign="top">(</td>
          <td class="md" nowrap valign="top">int&nbsp;</td>
          <td class="mdname" nowrap>&nbsp; <em>start</em>, </td>
        </tr>
        <tr>
          <td></td>
          <td></td>
          <td class="md" nowrap>int&nbsp;</td>
          <td class="mdname" nowrap>&nbsp; <em>end</em>, </td>
        </tr>
        <tr>
          <td></td>
          <td></td>
          <td class="md" nowrap>const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;const <a class="el" href="classPango_1_1Font.html">Font</a>&gt;&amp;&nbsp;</td>
          <td class="mdname" nowrap>&nbsp; <em>font</em></td>
        </tr>
        <tr>
          <td></td>
          <td class="md">)&nbsp;</td>
          <td class="md" colspan="2"> const</td>
        </tr>

      </table>
    </td>
  </tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Computes the logical extents of a sub-portion of the glyph string.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign=top><em>start</em>&nbsp;</td><td>The start index. </td></tr>
    <tr><td valign=top><em>end</em>&nbsp;</td><td>The end index. </td></tr>
    <tr><td valign=top><em>font</em>&nbsp;</td><td>A <a class="el" href="classPango_1_1Font.html">Pango::Font</a>. </td></tr>
  </table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The logical extents of the sub-portion of the glyph string. </dd></dl>
    </td>
  </tr>
</table>
<a name="a15" doxytag="Pango::GlyphString::get_logical_extents"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
  <tr>
    <td class="md">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"> <a class="el" href="classPango_1_1Rectangle.html">Rectangle</a> Pango::GlyphString::get_logical_extents </td>
          <td class="md" valign="top">(</td>
          <td class="md" nowrap valign="top">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;const <a class="el" href="classPango_1_1Font.html">Font</a>&gt;&amp;&nbsp;</td>
          <td class="mdname1" valign="top" nowrap>&nbsp; <em>font</em>          </td>
          <td class="md" valign="top">)&nbsp;</td>
          <td class="md" nowrap> const</td>
        </tr>

      </table>
    </td>
  </tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Computes the logical extents of a sub-portion of the glyph string.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign=top><em>font</em>&nbsp;</td><td>A <a class="el" href="classPango_1_1Font.html">Pango::Font</a>. </td></tr>
  </table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The logical extents of the glyph string. </dd></dl>
    </td>
  </tr>
</table>
<a name="a17" doxytag="Pango::GlyphString::get_logical_widths"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
  <tr>
    <td class="md">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"> <a class="el" href="classGlib_1_1ArrayHandle.html">Glib::ArrayHandle</a>&lt;int&gt; Pango::GlyphString::get_logical_widths </td>
          <td class="md" valign="top">(</td>
          <td class="md" nowrap valign="top">const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>&amp;&nbsp;</td>
          <td class="mdname" nowrap>&nbsp; <em>text</em>, </td>
        </tr>
        <tr>
          <td></td>
          <td></td>
          <td class="md" nowrap>int&nbsp;</td>
          <td class="mdname" nowrap>&nbsp; <em>embedding_level</em></td>
        </tr>
        <tr>
          <td></td>
          <td class="md">)&nbsp;</td>
          <td class="md" colspan="2"> const</td>
        </tr>

      </table>
    </td>
  </tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Determine the screen width corresponding to each character.
<p>
When multiple characters compose a single cluster, the width of the entire cluster is divided equally among the characters. <dl compact><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign=top><em>text</em>&nbsp;</td><td>The text corresponding to the glyphs. </td></tr>
    <tr><td valign=top><em>embedding_level</em>&nbsp;</td><td>The embedding level of the string. </td></tr>
  </table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>An array of integers representing the resulting character widths. </dd></dl>
    </td>
  </tr>
</table>
<a name="a7" doxytag="Pango::GlyphString::gobj"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
  <tr>
    <td class="md">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"> const PangoGlyphString* Pango::GlyphString::gobj </td>
          <td class="md" valign="top">(</td>
          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
          <td class="md" valign="top">)&nbsp;</td>
          <td class="md" nowrap> const<code> [inline]</code></td>
        </tr>

      </table>
    </td>
  </tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
    </td>
  </tr>
</table>
<a name="a6" doxytag="Pango::GlyphString::gobj"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
  <tr>
    <td class="md">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"> PangoGlyphString* Pango::GlyphString::gobj </td>
          <td class="md" valign="top">(</td>
          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
          <td class="md" valign="top">)&nbsp;</td>
          <td class="md" nowrap><code> [inline]</code></td>
        </tr>

      </table>
    </td>
  </tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
    </td>
  </tr>
</table>
<a name="a8" doxytag="Pango::GlyphString::gobj_copy"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
  <tr>
    <td class="md">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"> PangoGlyphString* Pango::GlyphString::gobj_copy </td>
          <td class="md" valign="top">(</td>
          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
          <td class="md" valign="top">)&nbsp;</td>
          <td class="md" nowrap> const</td>
        </tr>

      </table>
    </td>
  </tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
    </td>
  </tr>
</table>
<a name="a18" doxytag="Pango::GlyphString::index_to_x"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
  <tr>
    <td class="md">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"> int Pango::GlyphString::index_to_x </td>
          <td class="md" valign="top">(</td>
          <td class="md" nowrap valign="top">const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>&amp;&nbsp;</td>
          <td class="mdname" nowrap>&nbsp; <em>text</em>, </td>
        </tr>
        <tr>
          <td></td>
          <td></td>
          <td class="md" nowrap>const <a class="el" href="classPango_1_1Analysis.html">Analysis</a>&amp;&nbsp;</td>
          <td class="mdname" nowrap>&nbsp; <em>analysis</em>, </td>
        </tr>
        <tr>
          <td></td>
          <td></td>
          <td class="md" nowrap>int&nbsp;</td>
          <td class="mdname" nowrap>&nbsp; <em>index</em>, </td>
        </tr>
        <tr>
          <td></td>
          <td></td>
          <td class="md" nowrap>bool&nbsp;</td>
          <td class="mdname" nowrap>&nbsp; <em>trailing</em></td>
        </tr>
        <tr>
          <td></td>
          <td class="md">)&nbsp;</td>
          <td class="md" colspan="2"> const</td>
        </tr>

      </table>
    </td>
  </tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Converts from character position to x position.
<p>
(X position is measured from the left edge of the run). Character positions are computed by dividing up each cluster into equal portions. <dl compact><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign=top><em>text</em>&nbsp;</td><td>The text corresponding to the glyphs. </td></tr>
    <tr><td valign=top><em>analysis</em>&nbsp;</td><td>The analysis information return from <a class="el" href="classPango_1_1Context.html#a15">Pango::Context::itemize()</a>. </td></tr>
    <tr><td valign=top><em>index</em>&nbsp;</td><td>The byte index within text. </td></tr>
    <tr><td valign=top><em>trailing</em>&nbsp;</td><td>Whether we should compute the result for the beginning or end of the character. </td></tr>
  </table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The x position. </dd></dl>
    </td>
  </tr>
</table>
<a name="a3" doxytag="Pango::GlyphString::operator="></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
  <tr>
    <td class="md">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"> GlyphString&amp; Pango::GlyphString::operator= </td>
          <td class="md" valign="top">(</td>
          <td class="md" nowrap valign="top">const GlyphString&amp;&nbsp;</td>
          <td class="mdname1" valign="top" nowrap>&nbsp; <em>other</em>          </td>
          <td class="md" valign="top">)&nbsp;</td>
          <td class="md" nowrap></td>
        </tr>

      </table>
    </td>
  </tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
    </td>
  </tr>
</table>
<a name="a10" doxytag="Pango::GlyphString::set_size"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
  <tr>
    <td class="md">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"> void Pango::GlyphString::set_size </td>
          <td class="md" valign="top">(</td>
          <td class="md" nowrap valign="top">int&nbsp;</td>
          <td class="mdname1" valign="top" nowrap>&nbsp; <em>new_len</em>          </td>
          <td class="md" valign="top">)&nbsp;</td>
          <td class="md" nowrap></td>
        </tr>

      </table>
    </td>
  </tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Resize a glyph string to the given length.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign=top><em>new_len</em>&nbsp;</td><td>The new length of the string. </td></tr>
  </table>
</dl>
    </td>
  </tr>
</table>
<a name="a5" doxytag="Pango::GlyphString::swap"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
  <tr>
    <td class="md">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"> void Pango::GlyphString::swap </td>
          <td class="md" valign="top">(</td>
          <td class="md" nowrap valign="top">GlyphString&amp;&nbsp;</td>
          <td class="mdname1" valign="top" nowrap>&nbsp; <em>other</em>          </td>
          <td class="md" valign="top">)&nbsp;</td>
          <td class="md" nowrap></td>
        </tr>

      </table>
    </td>
  </tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
    </td>
  </tr>
</table>
<a name="a19" doxytag="Pango::GlyphString::x_to_index"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
  <tr>
    <td class="md">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"> void Pango::GlyphString::x_to_index </td>
          <td class="md" valign="top">(</td>
          <td class="md" nowrap valign="top">const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>&amp;&nbsp;</td>
          <td class="mdname" nowrap>&nbsp; <em>text</em>, </td>
        </tr>
        <tr>
          <td></td>
          <td></td>
          <td class="md" nowrap>const <a class="el" href="classPango_1_1Analysis.html">Analysis</a>&amp;&nbsp;</td>
          <td class="mdname" nowrap>&nbsp; <em>analysis</em>, </td>
        </tr>
        <tr>
          <td></td>
          <td></td>
          <td class="md" nowrap>int&nbsp;</td>
          <td class="mdname" nowrap>&nbsp; <em>x_pos</em>, </td>
        </tr>
        <tr>
          <td></td>
          <td></td>
          <td class="md" nowrap>int&amp;&nbsp;</td>
          <td class="mdname" nowrap>&nbsp; <em>index</em>, </td>
        </tr>
        <tr>
          <td></td>
          <td></td>
          <td class="md" nowrap>bool&amp;&nbsp;</td>
          <td class="mdname" nowrap>&nbsp; <em>trailing</em></td>
        </tr>
        <tr>
          <td></td>
          <td class="md">)&nbsp;</td>
          <td class="md" colspan="2"> const</td>
        </tr>

      </table>
    </td>
  </tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Convert from x offset to character position.
<p>
Character positions are computed by dividing up each cluster into equal portions. In scripts where positioning within a cluster is not allowed (such as Thai), the returned value may not be a valid cursor position; the caller must combine the result with the logical attributes for the text to compute the valid cursor position. <dl compact><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign=top><em>text</em>&nbsp;</td><td>The text corresponding to the glyphs. </td></tr>
    <tr><td valign=top><em>analysis</em>&nbsp;</td><td>The analysis information return from <a class="el" href="classPango_1_1Context.html#a15">Pango::Context::itemize()</a>. </td></tr>
    <tr><td valign=top><em>x_pos</em>&nbsp;</td><td>The x offset (in thousands of a device unit). </td></tr>
    <tr><td valign=top><em>index</em>&nbsp;</td><td>The location to store calculated byte index within. </td></tr>
    <tr><td valign=top><em>trailing</em>&nbsp;</td><td>The location to store a boolean indicating whether the user clicked on the leading or trailing edge of the character. </td></tr>
  </table>
</dl>
    </td>
  </tr>
</table>
<hr><h2>Friends And Related Function Documentation</h2>
<a name="k0" doxytag="Pango::GlyphString::swap"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
  <tr>
    <td class="md">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"> void swap </td>
          <td class="md" valign="top">(</td>
          <td class="md" nowrap valign="top">GlyphString&amp;&nbsp;</td>
          <td class="mdname" nowrap>&nbsp; <em>lhs</em>, </td>
        </tr>
        <tr>
          <td></td>
          <td></td>
          <td class="md" nowrap>GlyphString&amp;&nbsp;</td>
          <td class="mdname" nowrap>&nbsp; <em>rhs</em></td>
        </tr>
        <tr>
          <td></td>
          <td class="md">)&nbsp;</td>
          <td class="md" colspan="2"><code> [related]</code></td>
        </tr>

      </table>
    </td>
  </tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
    </td>
  </tr>
</table>
<a name="k1" doxytag="Pango::GlyphString::wrap"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
  <tr>
    <td class="md">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"> Pango::GlyphString wrap </td>
          <td class="md" valign="top">(</td>
          <td class="md" nowrap valign="top">PangoGlyphString*&nbsp;</td>
          <td class="mdname" nowrap>&nbsp; <em>object</em>, </td>
        </tr>
        <tr>
          <td></td>
          <td></td>
          <td class="md" nowrap>bool&nbsp;</td>
          <td class="mdname" nowrap>&nbsp; <em>take_copy</em> = false</td>
        </tr>
        <tr>
          <td></td>
          <td class="md">)&nbsp;</td>
          <td class="md" colspan="2"><code> [related]</code></td>
        </tr>

      </table>
    </td>
  </tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
    </td>
  </tr>
</table>
<hr><h2>Member Data Documentation</h2>
<a name="n0" doxytag="Pango::GlyphString::gobject_"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
  <tr>
    <td class="md">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"> PangoGlyphString* Pango::GlyphString::gobject_<code> [protected]</code>
      </table>
    </td>
  </tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
    </td>
  </tr>
</table>
<hr>The documentation for this class was generated from the following file:<ul>
<li><a class="el" href="glyphstring_8h.html">glyphstring.h</a></ul>
<hr><address><small>
Generated for gtkmm by <a href="http://www.doxygen.org/index.html">
Doxygen</a> 1.3-rc1 &copy;&nbsp;1997-2001</small></address>
</body>
</html>