pango-text-attributes.html

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

<tr>
<td>
<span class="term"><a
href="../glib/glib-Basic-Types.html#guint"
>guint</a>&#160;<em class="structfield"><code>absolute</code></em>&#160;:&#160;1;</span></td>
<td>whether the font size is in device units or points.
   This field is only present for compatibility with Pango-1.8.0
   (<a href="pango-Text-Attributes.html#PANGO-ATTR-ABSOLUTE-SIZE:CAPS"><code class="literal">PANGO_ATTR_ABSOLUTE_SIZE</code></a> was added in 1.8.1); and always will
   be <a
href="../glib/glib-Standard-Macros.html#FALSE:CAPS"
><code class="literal">FALSE</code></a> for <a href="pango-Text-Attributes.html#PANGO-ATTR-SIZE:CAPS"><code class="literal">PANGO_ATTR_SIZE</code></a> and <a
href="../glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> for <a href="pango-Text-Attributes.html#PANGO-ATTR-ABSOLUTE-SIZE:CAPS"><code class="literal">PANGO_ATTR_ABSOLUTE_SIZE</code></a>.

</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2813861"></a><h3>
<a name="pango-parse-markup"></a>pango_parse_markup ()</h3>
<a class="indexterm" name="id2813874"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a>    pango_parse_markup              (const char *markup_text,
                                             int length,
                                             <a
href="../glib/glib-Unicode-Manipulation.html#gunichar"
>gunichar</a> accel_marker,
                                             <a href="pango-Text-Attributes.html#PangoAttrList">PangoAttrList</a> **attr_list,
                                             char **text,
                                             <a
href="../glib/glib-Unicode-Manipulation.html#gunichar"
>gunichar</a> *accel_char,
                                             <a
href="../glib/glib-Error-Reporting.html#GError"
>GError</a> **error);</pre>
<p>
Parses marked-up text (see
<a href="PangoMarkupFormat.html" title="Text Attribute Markup">markup format</a>) to create
a plain-text string and an attribute list.
</p>
<p>
If <em class="parameter"><code>accel_marker</code></em> is nonzero, the given character will mark the
character following it as an accelerator. For example, <em class="parameter"><code>accel_marker</code></em>
might be an ampersand or underscore. All characters marked
as an accelerator will receive a <a href="pango-Text-Attributes.html#PANGO-UNDERLINE-LOW:CAPS"><code class="literal">PANGO_UNDERLINE_LOW</code></a> attribute,
and the first character so marked will be returned in <em class="parameter"><code>accel_char</code></em>.
Two <em class="parameter"><code>accel_marker</code></em> characters following each other produce a single
literal <em class="parameter"><code>accel_marker</code></em> character.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>markup_text</code></em>&#160;:</span></td>
<td> markup to parse (see <a href="PangoMarkupFormat.html" title="Text Attribute Markup">markup format</a>)
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>length</code></em>&#160;:</span></td>
<td> length of <em class="parameter"><code>markup_text</code></em>, or -1 if nul-terminated
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>accel_marker</code></em>&#160;:</span></td>
<td> character that precedes an accelerator, or 0 for none
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>attr_list</code></em>&#160;:</span></td>
<td> address of return location for a <a href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a>, or <a
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>text</code></em>&#160;:</span></td>
<td> address of return location for text with tags stripped, or <a
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>accel_char</code></em>&#160;:</span></td>
<td> address of return location for accelerator char, or <a
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
<td> address of return location for errors, 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
href="../glib/glib-Standard-Macros.html#FALSE:CAPS"
><code class="literal">FALSE</code></a> if <em class="parameter"><code>error</code></em> is set, otherwise <a
href="../glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2814214"></a><h3>
<a name="pango-attr-type-register"></a>pango_attr_type_register ()</h3>
<a class="indexterm" name="id2814227"></a><pre class="programlisting"><a href="pango-Text-Attributes.html#PangoAttrType">PangoAttrType</a> pango_attr_type_register      (const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *name);</pre>
<p>
Allocate a new attribute type ID.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>name</code></em>&#160;:</span></td>
<td> an identifier for the type (currently unused.)
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> the new type ID.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2814289"></a><h3>
<a name="pango-attribute-copy"></a>pango_attribute_copy ()</h3>
<a class="indexterm" name="id2814301"></a><pre class="programlisting"><a href="pango-Text-Attributes.html#PangoAttribute">PangoAttribute</a>* pango_attribute_copy        (const <a href="pango-Text-Attributes.html#PangoAttribute">PangoAttribute</a> *attr);</pre>
<p>
Make a copy of an attribute.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>attr</code></em>&#160;:</span></td>
<td> a <a href="pango-Text-Attributes.html#PangoAttribute"><span class="type">PangoAttribute</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-Attributes.html#PangoAttribute"><span class="type">PangoAttribute</span></a>, which should be
              freed with <a href="pango-Text-Attributes.html#pango-attribute-destroy"><code class="function">pango_attribute_destroy()</code></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2814391"></a><h3>
<a name="pango-attribute-equal"></a>pango_attribute_equal ()</h3>
<a class="indexterm" name="id2814404"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a>    pango_attribute_equal           (const <a href="pango-Text-Attributes.html#PangoAttribute">PangoAttribute</a> *attr1,
                                             const <a href="pango-Text-Attributes.html#PangoAttribute">PangoAttribute</a> *attr2);</pre>
<p>
Compare two attributes for equality. This compares only the
actual value of the two attributes and not the ranges that the
attributes apply to.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>attr1</code></em>&#160;:</span></td>
<td> a <a href="pango-Text-Attributes.html#PangoAttribute"><span class="type">PangoAttribute</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>attr2</code></em>&#160;:</span></td>
<td> another <a href="pango-Text-Attributes.html#PangoAttribute"><span class="type">PangoAttribute</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> <a
href="../glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> if the two attributes have the same value.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2814515"></a><h3>
<a name="pango-attribute-destroy"></a>pango_attribute_destroy ()</h3>
<a class="indexterm" name="id2814528"></a><pre class="programlisting">void        pango_attribute_destroy         (<a href="pango-Text-Attributes.html#PangoAttribute">PangoAttribute</a> *attr);</pre>
<p>
Destroy a <a href="pango-Text-Attributes.html#PangoAttribute"><span class="type">PangoAttribute</span></a> and free 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>attr</code></em>&#160;:</span></td>
<td> a <a href="pango-Text-Attributes.html#PangoAttribute"><span class="type">PangoAttribute</span></a>.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2814595"></a><h3>
<a name="pango-attr-language-new"></a>pango_attr_language_new ()</h3>
<a class="indexterm" name="id2814608"></a><pre class="programlisting"><a href="pango-Text-Attributes.html#PangoAttribute">PangoAttribute</a>* pango_attr_language_new     (<a href="pango-Text-Attributes.html#PangoLanguage">PangoLanguage</a> *language);</pre>
<p>
Create a new language tag attribute.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>language</code></em>&#160;:</span></td>
<td> language tag
</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-Attributes.html#PangoAttribute"><span class="type">PangoAttribute</span></a>, which should be
              freed with <a href="pango-Text-Attributes.html#pango-attribute-destroy"><code class="function">pango_attribute_destroy()</code></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2814689"></a><h3>
<a name="pango-attr-family-new"></a>pango_attr_family_new ()</h3>
<a class="indexterm" name="id2814702"></a><pre class="programlisting"><a href="pango-Text-Attributes.html#PangoAttribute">PangoAttribute</a>* pango_attr_family_new       (const char *family);</pre>
<p>
Create a new font family attribute.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>