text-attributes.xml

Pango is a library for layout and rendering of text, with an emphasis on internationalization. Pang

<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> the newly allocated <link linkend="PangoAttribute"><type>PangoAttribute</type></link>, which should be
              freed with <link linkend="pango-attribute-destroy"><function>pango_attribute_destroy()</function></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pango-attr-stretch-new" role="function">
<title>pango_attr_stretch_new ()</title>
<indexterm zone="pango-attr-stretch-new"><primary>pango_attr_stretch_new</primary></indexterm><programlisting><link linkend="PangoAttribute">PangoAttribute</link>*     pango_attr_stretch_new              (<link linkend="PangoStretch">PangoStretch</link> stretch);</programlisting>
<para>
Create a new font stretch attribute</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>stretch</parameter>&nbsp;:</term>
<listitem><simpara> the stretch
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> the newly allocated <link linkend="PangoAttribute"><type>PangoAttribute</type></link>, which should be
              freed with <link linkend="pango-attribute-destroy"><function>pango_attribute_destroy()</function></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pango-attr-weight-new" role="function">
<title>pango_attr_weight_new ()</title>
<indexterm zone="pango-attr-weight-new"><primary>pango_attr_weight_new</primary></indexterm><programlisting><link linkend="PangoAttribute">PangoAttribute</link>*     pango_attr_weight_new               (<link linkend="PangoWeight">PangoWeight</link> weight);</programlisting>
<para>
Create a new font weight attribute.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>weight</parameter>&nbsp;:</term>
<listitem><simpara> the weight
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> the newly allocated <link linkend="PangoAttribute"><type>PangoAttribute</type></link>, which should be
              freed with <link linkend="pango-attribute-destroy"><function>pango_attribute_destroy()</function></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pango-attr-size-new" role="function">
<title>pango_attr_size_new ()</title>
<indexterm zone="pango-attr-size-new"><primary>pango_attr_size_new</primary></indexterm><programlisting><link linkend="PangoAttribute">PangoAttribute</link>*     pango_attr_size_new                 (<link linkend="int">int</link> size);</programlisting>
<para>
Create a new font-size attribute in fractional points.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>size</parameter>&nbsp;:</term>
<listitem><simpara> the font size, in <link linkend="PANGO-SCALE:CAPS"><literal>PANGO_SCALE</literal></link><!-- -->ths of a point.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> the newly allocated <link linkend="PangoAttribute"><type>PangoAttribute</type></link>, which should be
              freed with <link linkend="pango-attribute-destroy"><function>pango_attribute_destroy()</function></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pango-attr-size-new-absolute" role="function" condition="since:1.8">
<title>pango_attr_size_new_absolute ()</title>
<indexterm zone="pango-attr-size-new-absolute" role="1.8"><primary>pango_attr_size_new_absolute</primary></indexterm><programlisting><link linkend="PangoAttribute">PangoAttribute</link>*     pango_attr_size_new_absolute        (<link linkend="int">int</link> size);</programlisting>
<para>
Create a new font-size attribute in device units.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>size</parameter>&nbsp;:</term>
<listitem><simpara> the font size, in <link linkend="PANGO-SCALE:CAPS"><literal>PANGO_SCALE</literal></link><!-- -->ths of a device unit.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> the newly allocated <link linkend="PangoAttribute"><type>PangoAttribute</type></link>, which should be
              freed with <link linkend="pango-attribute-destroy"><function>pango_attribute_destroy()</function></link>.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since  1.8
</para></refsect2>
<refsect2 id="pango-attr-font-desc-new" role="function">
<title>pango_attr_font_desc_new ()</title>
<indexterm zone="pango-attr-font-desc-new"><primary>pango_attr_font_desc_new</primary></indexterm><programlisting><link linkend="PangoAttribute">PangoAttribute</link>*     pango_attr_font_desc_new            (const <link linkend="PangoFontDescription">PangoFontDescription</link> *desc);</programlisting>
<para>
Create a new font description attribute. This attribute
allows setting family, style, weight, variant, stretch,
and size simultaneously.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>desc</parameter>&nbsp;:</term>
<listitem><simpara> the font description
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>  the newly allocated <link linkend="PangoAttribute"><type>PangoAttribute</type></link>, which should be
              freed with <link linkend="pango-attribute-destroy"><function>pango_attribute_destroy()</function></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pango-attr-foreground-new" role="function">
<title>pango_attr_foreground_new ()</title>
<indexterm zone="pango-attr-foreground-new"><primary>pango_attr_foreground_new</primary></indexterm><programlisting><link linkend="PangoAttribute">PangoAttribute</link>*     pango_attr_foreground_new           (<link linkend="guint16">guint16</link> red,
                                                         <link linkend="guint16">guint16</link> green,
                                                         <link linkend="guint16">guint16</link> blue);</programlisting>
<para>
Create a new foreground color attribute.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>red</parameter>&nbsp;:</term>
<listitem><simpara> the red value (ranging from 0 to 65535)
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>green</parameter>&nbsp;:</term>
<listitem><simpara> the green value
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>blue</parameter>&nbsp;:</term>
<listitem><simpara> the blue value
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> the newly allocated <link linkend="PangoAttribute"><type>PangoAttribute</type></link>, which should be
              freed with <link linkend="pango-attribute-destroy"><function>pango_attribute_destroy()</function></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pango-attr-background-new" role="function">
<title>pango_attr_background_new ()</title>
<indexterm zone="pango-attr-background-new"><primary>pango_attr_background_new</primary></indexterm><programlisting><link linkend="PangoAttribute">PangoAttribute</link>*     pango_attr_background_new           (<link linkend="guint16">guint16</link> red,
                                                         <link linkend="guint16">guint16</link> green,
                                                         <link linkend="guint16">guint16</link> blue);</programlisting>
<para>
Create a new background color attribute.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>red</parameter>&nbsp;:</term>
<listitem><simpara> the red value (ranging from 0 to 65535)
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>green</parameter>&nbsp;:</term>
<listitem><simpara> the green value
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>blue</parameter>&nbsp;:</term>
<listitem><simpara> the blue value
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> the newly allocated <link linkend="PangoAttribute"><type>PangoAttribute</type></link>, which should be
              freed with <link linkend="pango-attribute-destroy"><function>pango_attribute_destroy()</function></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pango-attr-strikethrough-new" role="function">
<title>pango_attr_strikethrough_new ()</title>
<indexterm zone="pango-attr-strikethrough-new"><primary>pango_attr_strikethrough_new</primary></indexterm><programlisting><link linkend="PangoAttribute">PangoAttribute</link>*     pango_attr_strikethrough_new        (<link linkend="gboolean">gboolean</link> strikethrough);</programlisting>
<para>
Create a new strike-through attribute.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>strikethrough</parameter>&nbsp;:</term>
<listitem><simpara> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the text should be struck-through.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> the newly allocated <link linkend="PangoAttribute"><type>PangoAttribute</type></link>, which should be
              freed with <link linkend="pango-attribute-destroy"><function>pango_attribute_destroy()</function></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pango-attr-strikethrough-color-new" role="function" condition="since:1.8">
<title>pango_attr_strikethrough_color_new ()</title>
<indexterm zone="pango-attr-strikethrough-color-new" role="1.8"><primary>pango_attr_strikethrough_color_new</primary></indexterm><programlisting><link linkend="PangoAttribute">PangoAttribute</link>*     pango_attr_strikethrough_color_new  (<link linkend="guint16">guint16</link> red,
                                                         <link linkend="guint16">guint16</link> green,
                                                         <link linkend="guint16">guint16</link> blue);</programlisting>
<para>
Create a new strikethrough color attribute. This attribute
modifies the color of strikethrough lines. If not set, strikethrough
lines will use the foreground color.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>red</parameter>&nbsp;:</term>
<listitem><simpara> the red value (ranging from 0 to 65535)
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>green</parameter>&nbsp;:</term>
<listitem><simpara> the green value
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>blue</parameter>&nbsp;:</term>
<listitem><simpara> the blue value
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> the newly allocated <link linkend="PangoAttribute"><type>PangoAttribute</type></link>, which should be
              freed with <link linkend="pango-attribute-destroy"><function>pango_attribute_destroy()</function></link>.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since  1.8
</para></refsect2>
<refsect2 id="pango-attr-underline-new" role="function">
<title>pango_attr_underline_new ()</title>
<indexterm zone="pango-attr-underline-new"><primary>pango_attr_underline_new</primary></indexterm><programlisting><link linkend="PangoAttribute">PangoAttribute</link>*     pango_attr_underline_new            (<link linkend="PangoUnderline">PangoUnderline</link> underline);</programlisting>
<para>
Create a new underline-style attribute.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>underline</parameter>&nbsp;:</term>
<listitem><simpara> the underline style.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> the newly allocated <link linkend="PangoAttribute"><type>PangoAttribute</type></link>, which should be
              freed with <link linkend="pango-attribute-destroy"><function>pango_attribute_destroy()</function></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pango-attr-underline-color-new" role="function" condition="since:1.8">
<title>pango_attr_underline_color_new ()</title>
<indexterm zone="pango-attr-underline-color-new" role="1.8"><primary>pango_attr_underline_color_new</primary></indexterm><programlisting><link linkend="PangoAttribute">PangoAttribute</link>*     pango_attr_underline_color_new      (<link linkend="guint16">guint16</link> red,
                                                         <link linkend="guint16">guint16</link> green,
                                                         <link linkend="guint16">guint16</link> blue);</programlisting>
<para>
Create a new underline color attribute. This attribute
modifies the color of underlines. If not set, underlines
will use the foreground color.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>red</parameter>&nbsp;:</term>
<listitem><simpara> the red value (ranging from 0 to 6553