fonts.xml

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

<para>
Sets the variant field of a font description. The <link linkend="PangoVariant"><type>PangoVariant</type></link>
can either be <link linkend="PANGO-VARIANT-NORMAL:CAPS"><literal>PANGO_VARIANT_NORMAL</literal></link> or <link linkend="PANGO-VARIANT-SMALL-CAPS:CAPS"><literal>PANGO_VARIANT_SMALL_CAPS</literal></link>.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>desc</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="PangoFontDescription"><type>PangoFontDescription</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>variant</parameter>&nbsp;:</term>
<listitem><simpara> the variant type for the font description.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="pango-font-description-get-variant" role="function"/>pango_font_description_get_variant ()</title>
<indexterm><primary>pango_font_description_get_variant</primary></indexterm><programlisting><link linkend="PangoVariant">PangoVariant</link> pango_font_description_get_variant
                                            (const <link linkend="PangoFontDescription">PangoFontDescription</link> *desc);</programlisting>
<para>
Gets the variant field of a <link linkend="PangoFontDescription"><type>PangoFontDescription</type></link>. See
<link linkend="pango-font-description-set-variant"><function>pango_font_description_set_variant()</function></link>.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>desc</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="PangoFontDescription"><type>PangoFontDescription</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> the variant field for the font description. Use
  <link linkend="pango-font-description-get-set-fields"><function>pango_font_description_get_set_fields()</function></link> to find out if
  the field was explicitly set or not.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="pango-font-description-set-weight" role="function"/>pango_font_description_set_weight ()</title>
<indexterm><primary>pango_font_description_set_weight</primary></indexterm><programlisting><link linkend="void">void</link>        pango_font_description_set_weight
                                            (<link linkend="PangoFontDescription">PangoFontDescription</link> *desc,
                                             <link linkend="PangoWeight">PangoWeight</link> weight);</programlisting>
<para>
Sets the weight field of a font description. The weight field
specifies how bold or light the font should be. In addition
to the values of the <link linkend="PangoWeight"><type>PangoWeight</type></link> enumeration, other intermediate
numeric values are possible.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>desc</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="PangoFontDescription"><type>PangoFontDescription</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>weight</parameter>&nbsp;:</term>
<listitem><simpara> the weight for the font description.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="pango-font-description-get-weight" role="function"/>pango_font_description_get_weight ()</title>
<indexterm><primary>pango_font_description_get_weight</primary></indexterm><programlisting><link linkend="PangoWeight">PangoWeight</link> pango_font_description_get_weight
                                            (const <link linkend="PangoFontDescription">PangoFontDescription</link> *desc);</programlisting>
<para>
Gets the weight field of a font description. See
<link linkend="pango-font-description-set-weight"><function>pango_font_description_set_weight()</function></link>.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>desc</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="PangoFontDescription"><type>PangoFontDescription</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> the weight field for the font description. Use
  <link linkend="pango-font-description-get-set-fields"><function>pango_font_description_get_set_fields()</function></link> to find out if
  the field was explicitly set or not.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="pango-font-description-set-stretch" role="function"/>pango_font_description_set_stretch ()</title>
<indexterm><primary>pango_font_description_set_stretch</primary></indexterm><programlisting><link linkend="void">void</link>        pango_font_description_set_stretch
                                            (<link linkend="PangoFontDescription">PangoFontDescription</link> *desc,
                                             <link linkend="PangoStretch">PangoStretch</link> stretch);</programlisting>
<para>
Sets the stretch field of a font description. The stretch field
specifies how narrow or wide the font should be.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>desc</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="PangoFontDescription"><type>PangoFontDescription</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>stretch</parameter>&nbsp;:</term>
<listitem><simpara> the stretch for the font description
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="pango-font-description-get-stretch" role="function"/>pango_font_description_get_stretch ()</title>
<indexterm><primary>pango_font_description_get_stretch</primary></indexterm><programlisting><link linkend="PangoStretch">PangoStretch</link> pango_font_description_get_stretch
                                            (const <link linkend="PangoFontDescription">PangoFontDescription</link> *desc);</programlisting>
<para>
Gets the stretch field of a font description.
See <link linkend="pango-font-description-set-stretch"><function>pango_font_description_set_stretch()</function></link>.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>desc</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="PangoFontDescription"><type>PangoFontDescription</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> the stretch field for the font description. Use
  <link linkend="pango-font-description-get-set-fields"><function>pango_font_description_get_set_fields()</function></link> to find out if
  the field was explicitly set or not.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="pango-font-description-set-size" role="function"/>pango_font_description_set_size ()</title>
<indexterm><primary>pango_font_description_set_size</primary></indexterm><programlisting><link linkend="void">void</link>        pango_font_description_set_size (<link linkend="PangoFontDescription">PangoFontDescription</link> *desc,
                                             <link linkend="gint">gint</link> size);</programlisting>
<para>
Sets the size field of a font description in fractional points. This is mutually
exclusive with <link linkend="pango-font-description-set-absolute-size"><function>pango_font_description_set_absolute_size()</function></link>.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>desc</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="PangoFontDescription"><type>PangoFontDescription</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>size</parameter>&nbsp;:</term>
<listitem><simpara> the size of the font in points, scaled by PANGO_SCALE. (That is,
       a <parameter>size</parameter> value of 10 * PANGO_SCALE is a 10 point font. The conversion
       factor between points and device units depends on system configuration
       and the output device. For screen display, a logical DPI of 96 is
       common, in which case a 10 point font corresponds to a 10 * (96 / 72) = 13.3
       pixel font. Use <link linkend="pango-font-description-set-absolute-size"><function>pango_font_description_set_absolute_size()</function></link> if you need
       a particular size in device units.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="pango-font-description-get-size" role="function"/>pango_font_description_get_size ()</title>
<indexterm><primary>pango_font_description_get_size</primary></indexterm><programlisting><link linkend="gint">gint</link>        pango_font_description_get_size (const <link linkend="PangoFontDescription">PangoFontDescription</link> *desc);</programlisting>
<para>
Gets the size field of a font description.
See <link linkend="pango-font-description-set-size"><function>pango_font_description_set_size()</function></link>.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>desc</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="PangoFontDescription"><type>PangoFontDescription</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> the size field for the font description in points or device units.
  You must call <link linkend="pango-font-description-get-size-is-absolute"><function>pango_font_description_get_size_is_absolute()</function></link>
  to find out which is the case. Returns 0 if the size field has not
  previously been set or it has been set to 0 explicitly.
  Use <link linkend="pango-font-description-get-set-fields"><function>pango_font_description_get_set_fields()</function></link> to
  find out if the field was explicitly set or not.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="pango-font-description-set-absolute-size" role="function" condition="since:1.8"/>pango_font_description_set_absolute_size ()</title>
<indexterm role="1.8"><primary>pango_font_description_set_absolute_size</primary></indexterm><programlisting><link linkend="void">void</link>        pango_font_description_set_absolute_size
                                            (<link linkend="PangoFontDescription">PangoFontDescription</link> *desc,
                                             <link linkend="double">double</link> size);</programlisting>
<para>
Sets the size field of a font description, in device units. This is mutually
exclusive with <link linkend="pango-font-description-set-size"><function>pango_font_description_set_size()</function></link>.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>desc</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="PangoFontDescription"><type>PangoFontDescription</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>size</parameter>&nbsp;:</term>
<listitem><simpara> the new size, in Pango units. There are <link linkend="PANGO-SCALE:CAPS"><literal>PANGO_SCALE</literal></link> Pango units in one
  device unit. For an output backend where a device unit is a pixel, a <parameter>size</parameter>
  value of 10 * PANGO_SCALE gives a 10 pixel font.
</simpara></listitem></varlistentry>
</variablelist><para>Since  1.8
</para></refsect2>
<refsect2>
<title><anchor id="pango-font-description-get-size-is-absolute" role="function" condition="since:1.8"/>pango_font_description_get_size_is_absolute ()</title>
<indexterm role="1.8"><primary>pango_font_description_get_size_is_absolute</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>    pango_font_description_get_size_is_absolute
                                            (const <link linkend="PangoFontDescription">PangoFontDescription</link> *desc);</programlisting>
<para>
Determines whether the size of the font is in points or device units.
See <link linkend="pango-font-description-set-size"><function>pango_font_description_set_size()</function></link> and <link linkend="pango-font-description-set-absolute-size"><function>pango_font_description_set_absolute_size()</function></link>.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>desc</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="PangoFontDescription"><type>PangoFontDescription</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> whether the size for the font description is in
  points or device units.  Use <link linkend="pango-font-description-get-set-fields"><function>pango_font_description_get_set_fields()</function></link> to
  find out if the size field of the font description was explicitly set or not.

</simpara></listitem></varlistentry>
</variablelist><para>Since  1.8
</para></refsect2>
<refsect2>
<title><anchor id="pango-font-description-set-gravity" role="function" condition="since:1.16"/>pango_font_description_set_gravity ()</title>
<indexterm role="1.16"><primary>pango_font_description_set_gravity</primary></indexterm><programlisting><link linkend="void">void</link>        pango_font_description_set_gravity