pango-text-processing.html

GTK+-2.0源码之pango-1.15.6.tar.gz

<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>context</code></em>&#160;:</span></td>
<td>   a structure holding information that affects
	       the itemization process.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>base_dir</code></em>&#160;:</span></td>
<td>  base direction to use for bidirectional processing
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>text</code></em>&#160;:</span></td>
<td>      the text to itemize.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>start_index</code></em>&#160;:</span></td>
<td> first byte in <em class="parameter"><code>text</code></em> to process
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>length</code></em>&#160;:</span></td>
<td>    the number of bytes (not characters) to process
            after <em class="parameter"><code>start_index</code></em>.
            This must be &gt;= 0.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>attrs</code></em>&#160;:</span></td>
<td>     the set of attributes that apply to <em class="parameter"><code>text</code></em>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>cached_iter</code></em>&#160;:</span></td>
<td>      Cached attribute iterator, or <a
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a>
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> a <a
href="../glib/glib-Doubly-Linked-Lists.html#GList"
><span class="type">GList</span></a> of <a href="pango-Text-Processing.html#PangoItem"><span class="type">PangoItem</span></a> structures.

</td>
</tr>
</tbody>
</table></div>
<p>Since  1.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2756295"></a><h3>
<a name="pango-item-free"></a>pango_item_free ()</h3>
<a class="indexterm" name="id2756307"></a><pre class="programlisting">void        pango_item_free                 (<a href="pango-Text-Processing.html#PangoItem">PangoItem</a> *item);</pre>
<p>
Free a <a href="pango-Text-Processing.html#PangoItem"><span class="type">PangoItem</span></a> and all associated memory.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><em class="parameter"><code>item</code></em>&#160;:</span></td>
<td> a <a href="pango-Text-Processing.html#PangoItem"><span class="type">PangoItem</span></a>
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2756373"></a><h3>
<a name="pango-item-copy"></a>pango_item_copy ()</h3>
<a class="indexterm" name="id2756385"></a><pre class="programlisting"><a href="pango-Text-Processing.html#PangoItem">PangoItem</a>*  pango_item_copy                 (<a href="pango-Text-Processing.html#PangoItem">PangoItem</a> *item);</pre>
<p>
Copy an existing <a href="pango-Text-Processing.html#PangoItem"><span class="type">PangoItem</span></a> structure.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>item</code></em>&#160;:</span></td>
<td> a <a href="pango-Text-Processing.html#PangoItem"><span class="type">PangoItem</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> the newly allocated <a href="pango-Text-Processing.html#PangoItem"><span class="type">PangoItem</span></a>, which should
              be freed with <a href="pango-Text-Processing.html#pango-item-free"><code class="function">pango_item_free()</code></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2756480"></a><h3>
<a name="pango-item-new"></a>pango_item_new ()</h3>
<a class="indexterm" name="id2756492"></a><pre class="programlisting"><a href="pango-Text-Processing.html#PangoItem">PangoItem</a>*  pango_item_new                  (void);</pre>
<p>
Creates a new <a href="pango-Text-Processing.html#PangoItem"><span class="type">PangoItem</span></a> structure initialized to default values.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> the newly allocated <a href="pango-Text-Processing.html#PangoItem"><span class="type">PangoItem</span></a>, which should
              be freed with <a href="pango-Text-Processing.html#pango-item-free"><code class="function">pango_item_free()</code></a>.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2756560"></a><h3>
<a name="pango-item-split"></a>pango_item_split ()</h3>
<a class="indexterm" name="id2756572"></a><pre class="programlisting"><a href="pango-Text-Processing.html#PangoItem">PangoItem</a>*  pango_item_split                (<a href="pango-Text-Processing.html#PangoItem">PangoItem</a> *orig,
                                             int split_index,
                                             int split_offset);</pre>
<p>
Modifies <em class="parameter"><code>orig</code></em> to cover only the text after <em class="parameter"><code>split_index</code></em>, and
returns a new item that covers the text before <em class="parameter"><code>split_index</code></em> that
used to be in <em class="parameter"><code>orig</code></em>. You can think of <em class="parameter"><code>split_index</code></em> as the length of
the returned item. <em class="parameter"><code>split_index</code></em> may not be 0, and it may not be
greater than or equal to the length of <em class="parameter"><code>orig</code></em> (that is, there must
be at least one byte assigned to each item, you can't create a
zero-length item). <em class="parameter"><code>split_offset</code></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 href="pango-Text-Processing.html#pango-item-split"><code class="function">pango_item_split()</code></a> can't count the char
length of the split items itself.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>orig</code></em>&#160;:</span></td>
<td> a <a href="pango-Text-Processing.html#PangoItem"><span class="type">PangoItem</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>split_index</code></em>&#160;:</span></td>
<td> byte index of position to split item, relative to the start of the item
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>split_offset</code></em>&#160;:</span></td>
<td> number of chars between start of <em class="parameter"><code>orig</code></em> and <em class="parameter"><code>split_index</code></em>
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> new item representing text before <em class="parameter"><code>split_index</code></em>, which
              should be freed with <a href="pango-Text-Processing.html#pango-item-free"><code class="function">pango_item_free()</code></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2756778"></a><h3>
<a name="pango-reorder-items"></a>pango_reorder_items ()</h3>
<a class="indexterm" name="id2756791"></a><pre class="programlisting"><a
href="../glib/glib-Doubly-Linked-Lists.html#GList"
>GList</a>*      pango_reorder_items             (<a
href="../glib/glib-Doubly-Linked-Lists.html#GList"
>GList</a> *logical_items);</pre>
<p>
From a list of items in logical order and the associated
directional levels, produce a list in visual order.
The original list is unmodified.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>logical_items</code></em>&#160;:</span></td>
<td>  a <a
href="../glib/glib-Doubly-Linked-Lists.html#GList"
><span class="type">GList</span></a> of <a href="pango-Text-Processing.html#PangoItem"><span class="type">PangoItem</span></a> in logical order.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td>a <a
href="../glib/glib-Doubly-Linked-Lists.html#GList"
><span class="type">GList</span></a> of <a href="pango-Text-Processing.html#PangoItem"><span class="type">PangoItem</span></a> structures in visual order.

(Please open a bug if you use this function.
 It is not a particularly convenient interface, and the code
 is duplicated elsewhere in Pango for that reason.)
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2756888"></a><h3>
<a name="pango-context-new"></a>pango_context_new ()</h3>
<a class="indexterm" name="id2756901"></a><pre class="programlisting"><a href="pango-Text-Processing.html#PangoContext">PangoContext</a>* pango_context_new             (void);</pre>
<p>
Creates a new <a href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a> initialized to default value.
</p>
<p>
This function is only useful when implementing a new backend
for Pango, something applications won't do. You should use
the context creation function for the backend you are using,
for example, <a href="pango-Cairo-Rendering.html#pango-cairo-font-map-create-context"><code class="function">pango_cairo_font_map_create_context()</code></a>, <a href="pango-Xft-Fonts-and-Rendering.html#pango-xft-get-context"><code class="function">pango_xft_get_context()</code></a>,
<a href="pango-Win32-Fonts-and-Rendering.html#pango-win32-get-context"><code class="function">pango_win32_get_context()</code></a> or, <a href="pango-FreeType-Fonts-and-Rendering.html#pango-ft2-font-map-create-context"><code class="function">pango_ft2_font_map_create_context()</code></a>.
</p>
<p>
If you are using Pango as part of a higher-level system,
that system may have it's own ways of create a <a href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>.
For instance, the GTK+ toolkit has, among others,
<code class="function">gdk_pango_context_get_for_screen()</code>, and
<code class="function">gtk_widget_get_pango_context()</code>.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> the newly allocated <a href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>, which should
              be freed with <a
href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"
><code class="function">g_object_unref()</code></a>.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2757064"></a><h3>
<a name="pango-context-set-font-map"></a>pango_context_set_font_map ()</h3>
<a class="indexterm" name="id2757078"></a><pre class="programlisting">void        pango_context_set_font_map      (<a href="pango-Text-Processing.html#PangoContext">PangoContext</a> *context,
                                             <a href="pango-Fonts.html#PangoFontMap">PangoFontMap</a> *font_map);</pre>
<p>
Sets the font map to be searched when fonts are looked-up in this context.
This is only for internal use by Pango backends, a <a href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a> obtained
via one of the recommended methods should already have a suitable font map.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>context</code></em>&#160;:</span></td>
<td> a <a href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>
</td>
</tr>
<tr>
<td>