pango-miscellaneous-utilities.html

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

<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>pos</code></em>&#160;:</span></td>
<td> in/out string position
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>out</code></em>&#160;:</span></td>
<td> a <a
href="../glib/glib-Strings.html#GString"
><span class="type">GString</span></a> into which to write the result
</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 a parse error occurred.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2943497"></a><h3>
<a name="pango-scan-int"></a>pango_scan_int ()</h3>
<a class="indexterm" name="id2943509"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a>    pango_scan_int                  (const char **pos,
                                             int *out);</pre>
<p>
Scans an integer.
Leading white space is skipped.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>pos</code></em>&#160;:</span></td>
<td> in/out string position
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>out</code></em>&#160;:</span></td>
<td> an int into which to write the result
</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 a parse error occurred.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2943601"></a><h3>
<a name="pango-config-key-get"></a>pango_config_key_get ()</h3>
<a class="indexterm" name="id2943615"></a><pre class="programlisting">char*       pango_config_key_get            (const char *key);</pre>
<p>
Looks up a key in the Pango config database
(pseudo-win.ini style, read from $sysconfdir/pango/pangorc,
 ~/.pangorc, and getenv (PANGO_RC_FILE).)</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></td>
<td> Key to look up, in the form "SECTION/KEY".
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> the value, if found, otherwise <a
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a>. The value is a
newly-allocated string and must be freed with <a
href="../glib/glib-Memory-Allocation.html#g-free"
><code class="function">g_free()</code></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2943699"></a><h3>
<a name="pango-lookup-aliases"></a>pango_lookup_aliases ()</h3>
<a class="indexterm" name="id2943712"></a><pre class="programlisting">void        pango_lookup_aliases            (const char *fontname,
                                             char ***families,
                                             int *n_families);</pre>
<p>
Look up all user defined aliases for the alias <em class="parameter"><code>fontname</code></em>.
The resulting font family names will be stored in <em class="parameter"><code>families</code></em>,
and the number of families in <em class="parameter"><code>n_families</code></em>.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>fontname</code></em>&#160;:</span></td>
<td> an ascii string
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>families</code></em>&#160;:</span></td>
<td> will be set to an array of font family names.
   this array is owned by pango and should not be freed.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>n_families</code></em>&#160;:</span></td>
<td> will be set to the length of the <em class="parameter"><code>families</code></em> array.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2943833"></a><h3>
<a name="pango-parse-enum"></a>pango_parse_enum ()</h3>
<a class="indexterm" name="id2943848"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a>    pango_parse_enum                (<a
href="../gobject/gobject-Type-Information.html#GType"
>GType</a> type,
                                             const char *str,
                                             int *value,
                                             <a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> warn,
                                             char **possible_values);</pre>
<p>
Parses an enum type and stored the result in <em class="parameter"><code>value</code></em>.
</p>
<p>
If <em class="parameter"><code>str</code></em> does not match the nick name of any of the possible values for the
enum, <a
href="../glib/glib-Standard-Macros.html#FALSE:CAPS"
><code class="literal">FALSE</code></a> is returned, a warning is issued if <em class="parameter"><code>warn</code></em> is <a
href="../glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a>, and a
string representing the list of possible values is stored in
<em class="parameter"><code>possible_values</code></em>.  The list is slash-separated, eg.
"none/start/middle/end".  If failed and <em class="parameter"><code>possible_values</code></em> is not <a
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a>,
returned string should be freed using <a
href="../glib/glib-Memory-Allocation.html#g-free"
><code class="function">g_free()</code></a>.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>type</code></em>&#160;:</span></td>
<td> enum type to parse, eg. <a href="pango-Layout-Objects.html#PANGO-TYPE-ELLIPSIZE-MODE:CAPS"><code class="literal">PANGO_TYPE_ELLIPSIZE_MODE</code></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>str</code></em>&#160;:</span></td>
<td> string to parse.  May be <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>value</code></em>&#160;:</span></td>
<td> integer to store the result in, 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>warn</code></em>&#160;:</span></td>
<td> if <a
href="../glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a>, issue a <a
href="../glib/glib-Message-Logging.html#g-warning"
><code class="function">g_warning()</code></a> on bad input.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>possible_values</code></em>&#160;:</span></td>
<td> place to store list of possible values on failure, 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#TRUE:CAPS"
><code class="literal">TRUE</code></a> if <em class="parameter"><code>str</code></em> was successfully parsed.

</td>
</tr>
</tbody>
</table></div>
<p>Since  1.16
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2944159"></a><h3>
<a name="pango-parse-style"></a>pango_parse_style ()</h3>
<a class="indexterm" name="id2944172"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a>    pango_parse_style               (const char *str,
                                             <a href="pango-Fonts.html#PangoStyle">PangoStyle</a> *style,
                                             <a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> warn);</pre>
<p>
Parses a font style. The allowed values are "normal",
"italic" and "oblique", case variations being
ignored.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>str</code></em>&#160;:</span></td>
<td> a string to parse.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>style</code></em>&#160;:</span></td>
<td> a <a href="pango-Fonts.html#PangoStyle"><span class="type">PangoStyle</span></a> to store the result in.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>warn</code></em>&#160;:</span></td>
<td> if <a
href="../glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a>, issue a <a
href="../glib/glib-Message-Logging.html#g-warning"
><code class="function">g_warning()</code></a> on bad input.
</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 <em class="parameter"><code>str</code></em> was successfully parsed.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2944321"></a><h3>
<a name="pango-parse-variant"></a>pango_parse_variant ()</h3>
<a class="indexterm" name="id2944335"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a>    pango_parse_variant             (const char *str,
                                             <a href="pango-Fonts.html#PangoVariant">PangoVariant</a> *variant,
                                             <a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> warn);</pre>
<p>
Parses a font variant. The allowed values are "normal"
and "smallcaps" or "small_caps", case variations being
ignored.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>str</code></em>&#160;:</span></td>
<td> a string to parse.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>variant</code></em>&#160;:</span></td>
<td> a <a href="pango-Fonts.html#PangoVariant"><span class="type">PangoVariant</span></a> to store the result in.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>warn</code></em>&#160;:</span></td>
<td> if <a
href="../glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a>, issue a <a
href="../glib/glib-Message-Logging.html#g-warning"
><code class="function">g_warning()</code></a> on bad input.
</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 <em class="parameter"><code>str</code></em> was successfully parsed.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2944485"></a><h3>
<a name="pango-parse-weight"></a>pango_parse_weight ()</h3>
<a class="indexterm" name="id2944498"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a>    pango_parse_weight              (const char *str,
                                             <a href="pango-Fonts.html#PangoWeight">PangoWeight</a> *weight,
                                             <a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> warn);</pre>
<p>
Parses a font weight. The allowed values are "heavy",
"ultrabold", "bold", "normal", "light", "ultraleight"
and integers. Case variations are ignored.</p>
<p>

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