layout.xml

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

</variablelist></refsect2>
<refsect2>
<title><anchor id="pango-layout-is-wrapped" role="function" condition="since:1.16"/>pango_layout_is_wrapped ()</title>
<indexterm role="1.16"><primary>pango_layout_is_wrapped</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>    pango_layout_is_wrapped         (<link linkend="PangoLayout">PangoLayout</link> *layout);</programlisting>
<para>
Queries whether the layout had to wrap any paragraphs.
</para>
<para>
This returns <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if a positive width is set on <parameter>layout</parameter>,
ellipsization mode of <parameter>layout</parameter> is set to <link linkend="PANGO-ELLIPSIZE-NONE:CAPS"><literal>PANGO_ELLIPSIZE_NONE</literal></link>,
and there are paragraphs exceeding the layout width that have
to be wrapped.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>layout</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="PangoLayout"><type>PangoLayout</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if any paragraphs had to be wrapped, <link linkend="FALSE:CAPS"><literal>FALSE</literal></link>
otherwise.

</simpara></listitem></varlistentry>
</variablelist><para>Since  1.16
</para></refsect2>
<refsect2>
<title><anchor id="PangoWrapMode" role="enum"/>enum PangoWrapMode</title>
<indexterm><primary>PangoWrapMode</primary></indexterm><programlisting>typedef enum {
  PANGO_WRAP_WORD,
  PANGO_WRAP_CHAR,
  PANGO_WRAP_WORD_CHAR
} PangoWrapMode;
</programlisting>
<para>
A <link linkend="PangoWrapMode"><type>PangoWrapMode</type></link> describes how to wrap the lines of a <link linkend="PangoLayout"><type>PangoLayout</type></link> to the desired width.
</para><variablelist role="enum">
<varlistentry>
<term><anchor id="PANGO-WRAP-WORD:CAPS" role="constant"/><literal>PANGO_WRAP_WORD</literal></term>
<listitem><simpara>wrap lines at word boundaries.
</simpara></listitem>
</varlistentry>
<varlistentry>
<term><anchor id="PANGO-WRAP-CHAR:CAPS" role="constant"/><literal>PANGO_WRAP_CHAR</literal></term>
<listitem><simpara>wrap lines at character boundaries.
</simpara></listitem>
</varlistentry>
<varlistentry>
<term><anchor id="PANGO-WRAP-WORD-CHAR:CAPS" role="constant"/><literal>PANGO_WRAP_WORD_CHAR</literal></term>
<listitem><simpara>wrap lines at word boundaries, but fall back to character boundaries if there is not 
enough space for a full word.

</simpara></listitem>
</varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="PANGO-TYPE-WRAP-MODE:CAPS" role="macro"/>PANGO_TYPE_WRAP_MODE</title>
<indexterm><primary>PANGO_TYPE_WRAP_MODE</primary></indexterm><programlisting>#define PANGO_TYPE_WRAP_MODE (pango_wrap_mode_get_type())
</programlisting>
<para>
The <link linkend="GObject"><type>GObject</type></link> type for <link linkend="PangoWrapMode"><type>PangoWrapMode</type></link>.
</para></refsect2>
<refsect2>
<title><anchor id="pango-layout-set-ellipsize" role="function" condition="since:1.6"/>pango_layout_set_ellipsize ()</title>
<indexterm role="1.6"><primary>pango_layout_set_ellipsize</primary></indexterm><programlisting><link linkend="void">void</link>        pango_layout_set_ellipsize      (<link linkend="PangoLayout">PangoLayout</link> *layout,
                                             <link linkend="PangoEllipsizeMode">PangoEllipsizeMode</link> ellipsize);</programlisting>
<para>
Sets the type of ellipsization being performed for <parameter>layout</parameter>.
Depending on the ellipsization mode <parameter>ellipsize</parameter> text is
removed from the start, middle, or end of lines so they
fit within the width of layout set with <link linkend="pango-layout-set-width"><function>pango_layout_set_width()</function></link>.
</para>
<para>
If the layout contains characters such as newlines that
force it to be layed out in multiple lines, then each line
is ellipsized separately.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>layout</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="PangoLayout"><type>PangoLayout</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>ellipsize</parameter>&nbsp;:</term>
<listitem><simpara> the new ellipsization mode for <parameter>layout</parameter>
</simpara></listitem></varlistentry>
</variablelist><para>Since  1.6
</para></refsect2>
<refsect2>
<title><anchor id="pango-layout-get-ellipsize" role="function" condition="since:1.6"/>pango_layout_get_ellipsize ()</title>
<indexterm role="1.6"><primary>pango_layout_get_ellipsize</primary></indexterm><programlisting><link linkend="PangoEllipsizeMode">PangoEllipsizeMode</link> pango_layout_get_ellipsize
                                            (<link linkend="PangoLayout">PangoLayout</link> *layout);</programlisting>
<para>
Gets the type of ellipsization being performed for <parameter>layout</parameter>.
See <link linkend="pango-layout-set-ellipsize"><function>pango_layout_set_ellipsize()</function></link></para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>layout</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="PangoLayout"><type>PangoLayout</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> the current ellipsization mode for <parameter>layout</parameter>.

Use <link linkend="pango-layout-is-ellipsized"><function>pango_layout_is_ellipsized()</function></link> to query whether any paragraphs
were actually ellipsized.

</simpara></listitem></varlistentry>
</variablelist><para>Since  1.6
</para></refsect2>
<refsect2>
<title><anchor id="pango-layout-is-ellipsized" role="function" condition="since:1.16"/>pango_layout_is_ellipsized ()</title>
<indexterm role="1.16"><primary>pango_layout_is_ellipsized</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>    pango_layout_is_ellipsized      (<link linkend="PangoLayout">PangoLayout</link> *layout);</programlisting>
<para>
Queries whether the layout had to ellipsize any paragraphs.
</para>
<para>
This returns <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the ellipsization mode for <parameter>layout</parameter>
is not <link linkend="PANGO-ELLIPSIZE-NONE:CAPS"><literal>PANGO_ELLIPSIZE_NONE</literal></link>, a positive width is set on <parameter>layout</parameter>,
and there are paragraphs exceeding that width that have to be
ellipsized.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>layout</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="PangoLayout"><type>PangoLayout</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if any paragraphs had to be ellipsized, <link linkend="FALSE:CAPS"><literal>FALSE</literal></link>
otherwise.

</simpara></listitem></varlistentry>
</variablelist><para>Since  1.16
</para></refsect2>
<refsect2>
<title><anchor id="PangoEllipsizeMode" role="enum"/>enum PangoEllipsizeMode</title>
<indexterm><primary>PangoEllipsizeMode</primary></indexterm><programlisting>typedef enum {
  PANGO_ELLIPSIZE_NONE,
  PANGO_ELLIPSIZE_START,
  PANGO_ELLIPSIZE_MIDDLE,
  PANGO_ELLIPSIZE_END
} PangoEllipsizeMode;
</programlisting>
<para>
The <link linkend="PangoEllipsizeMode"><type>PangoEllipsizeMode</type></link> type describes what sort of (if any)
ellipsization should be applied to a line of text. In
the ellipsization process characters are removed from the
text in order to make it fit to a given width and replaced
with an ellipsis.</para>
<para>

</para><variablelist role="enum">
<varlistentry>
<term><anchor id="PANGO-ELLIPSIZE-NONE:CAPS" role="constant"/><literal>PANGO_ELLIPSIZE_NONE</literal></term>
<listitem><simpara> No ellipsization
</simpara></listitem>
</varlistentry>
<varlistentry>
<term><anchor id="PANGO-ELLIPSIZE-START:CAPS" role="constant"/><literal>PANGO_ELLIPSIZE_START</literal></term>
<listitem><simpara> Omit characters at the start of the text
</simpara></listitem>
</varlistentry>
<varlistentry>
<term><anchor id="PANGO-ELLIPSIZE-MIDDLE:CAPS" role="constant"/><literal>PANGO_ELLIPSIZE_MIDDLE</literal></term>
<listitem><simpara> Omit characters in the middle of the text
</simpara></listitem>
</varlistentry>
<varlistentry>
<term><anchor id="PANGO-ELLIPSIZE-END:CAPS" role="constant"/><literal>PANGO_ELLIPSIZE_END</literal></term>
<listitem><simpara> Omit characters at the end of the text
</simpara></listitem>
</varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="PANGO-TYPE-ELLIPSIZE-MODE:CAPS" role="macro"/>PANGO_TYPE_ELLIPSIZE_MODE</title>
<indexterm><primary>PANGO_TYPE_ELLIPSIZE_MODE</primary></indexterm><programlisting>#define PANGO_TYPE_ELLIPSIZE_MODE (pango_ellipsize_mode_get_type())
</programlisting>
<para>
The <link linkend="GObject"><type>GObject</type></link> type for <link linkend="PangoEllipsizeMode"><type>PangoEllipsizeMode</type></link>.
</para></refsect2>
<refsect2>
<title><anchor id="pango-layout-set-indent" role="function"/>pango_layout_set_indent ()</title>
<indexterm><primary>pango_layout_set_indent</primary></indexterm><programlisting><link linkend="void">void</link>        pango_layout_set_indent         (<link linkend="PangoLayout">PangoLayout</link> *layout,
                                             <link linkend="int">int</link> indent);</programlisting>
<para>
Sets the width in Pango units to indent each paragraph. A negative value
of <parameter>indent</parameter> will produce a hanging indentation. That is, the first line will
have the full width, and subsequent lines will be indented by the
absolute value of <parameter>indent</parameter>.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>layout</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="PangoLayout"><type>PangoLayout</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>indent</parameter>&nbsp;:</term>