pango-layout-objects.html

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

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>layout</code></em>&#160;:</span></td>
<td> a <a href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>width</code></em>&#160;:</span></td>
<td> the desired width in Pango units, or -1 to indicate that no
        wrapping should be performed.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2840841"></a><h3>
<a name="pango-layout-get-width"></a>pango_layout_get_width ()</h3>
<a class="indexterm" name="id2840854"></a><pre class="programlisting">int         pango_layout_get_width          (<a href="pango-Layout-Objects.html#PangoLayout">PangoLayout</a> *layout);</pre>
<p>
Gets the width to which the lines of the <a href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> should wrap.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>layout</code></em>&#160;:</span></td>
<td> a <a href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> the width, or -1 if no width set.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2840930"></a><h3>
<a name="pango-layout-set-wrap"></a>pango_layout_set_wrap ()</h3>
<a class="indexterm" name="id2840944"></a><pre class="programlisting">void        pango_layout_set_wrap           (<a href="pango-Layout-Objects.html#PangoLayout">PangoLayout</a> *layout,
                                             <a href="pango-Layout-Objects.html#PangoWrapMode">PangoWrapMode</a> wrap);</pre>
<p>
Sets the wrap mode; the wrap mode only has effect if a width
is set on the layout with <a href="pango-Layout-Objects.html#pango-layout-set-width"><code class="function">pango_layout_set_width()</code></a>. To turn off wrapping,
set the width to -1.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>layout</code></em>&#160;:</span></td>
<td> a <a href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>wrap</code></em>&#160;:</span></td>
<td> the wrap mode
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2841036"></a><h3>
<a name="pango-layout-get-wrap"></a>pango_layout_get_wrap ()</h3>
<a class="indexterm" name="id2841049"></a><pre class="programlisting"><a href="pango-Layout-Objects.html#PangoWrapMode">PangoWrapMode</a> pango_layout_get_wrap         (<a href="pango-Layout-Objects.html#PangoLayout">PangoLayout</a> *layout);</pre>
<p>
Gets the wrap mode for the layout.
</p>
<p>
Use <a href="pango-Layout-Objects.html#pango-layout-is-wrapped"><code class="function">pango_layout_is_wrapped()</code></a> to query whether any paragraphs
were actually wrapped.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>layout</code></em>&#160;:</span></td>
<td> a <a href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> active wrap mode.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2841133"></a><h3>
<a name="pango-layout-is-wrapped"></a>pango_layout_is_wrapped ()</h3>
<a class="indexterm" name="id2841148"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a>    pango_layout_is_wrapped         (<a href="pango-Layout-Objects.html#PangoLayout">PangoLayout</a> *layout);</pre>
<p>
Queries whether the layout had to wrap any paragraphs.
</p>
<p>
This returns <a
href="../glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> if a positive width is set on <em class="parameter"><code>layout</code></em>,
ellipsization mode of <em class="parameter"><code>layout</code></em> is set to <a href="pango-Layout-Objects.html#PANGO-ELLIPSIZE-NONE:CAPS"><code class="literal">PANGO_ELLIPSIZE_NONE</code></a>,
and there are paragraphs exceeding the layout width that have
to be wrapped.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>layout</code></em>&#160;:</span></td>
<td> a <a href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</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 any paragraphs had to be wrapped, <a
href="../glib/glib-Standard-Macros.html#FALSE:CAPS"
><code class="literal">FALSE</code></a>
otherwise.

</td>
</tr>
</tbody>
</table></div>
<p>Since  1.16
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2841282"></a><h3>
<a name="PangoWrapMode"></a>enum PangoWrapMode</h3>
<a class="indexterm" name="id2841295"></a><pre class="programlisting">typedef enum {
  PANGO_WRAP_WORD,
  PANGO_WRAP_CHAR,
  PANGO_WRAP_WORD_CHAR
} PangoWrapMode;
</pre>
<p>
A <a href="pango-Layout-Objects.html#PangoWrapMode"><span class="type">PangoWrapMode</span></a> describes how to wrap the lines of a <a href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> to the desired width.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><a name="PANGO-WRAP-WORD:CAPS"></a><code class="literal">PANGO_WRAP_WORD</code></span></td>
<td>wrap lines at word boundaries.
</td>
</tr>
<tr>
<td>
<span class="term"><a name="PANGO-WRAP-CHAR:CAPS"></a><code class="literal">PANGO_WRAP_CHAR</code></span></td>
<td>wrap lines at character boundaries.
</td>
</tr>
<tr>
<td>
<span class="term"><a name="PANGO-WRAP-WORD-CHAR:CAPS"></a><code class="literal">PANGO_WRAP_WORD_CHAR</code></span></td>
<td>wrap lines at word boundaries, but fall back to character boundaries if there is not 
enough space for a full word.

</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2841403"></a><h3>
<a name="PANGO-TYPE-WRAP-MODE:CAPS"></a>PANGO_TYPE_WRAP_MODE</h3>
<a class="indexterm" name="id2841417"></a><pre class="programlisting">#define PANGO_TYPE_WRAP_MODE (pango_wrap_mode_get_type())
</pre>
<p>
The <a
href="../gobject/gobject-The-Base-Object-Type.html#GObject"
><span class="type">GObject</span></a> type for <a href="pango-Layout-Objects.html#PangoWrapMode"><span class="type">PangoWrapMode</span></a>.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2841449"></a><h3>
<a name="pango-layout-set-ellipsize"></a>pango_layout_set_ellipsize ()</h3>
<a class="indexterm" name="id2841465"></a><pre class="programlisting">void        pango_layout_set_ellipsize      (<a href="pango-Layout-Objects.html#PangoLayout">PangoLayout</a> *layout,
                                             <a href="pango-Layout-Objects.html#PangoEllipsizeMode">PangoEllipsizeMode</a> ellipsize);</pre>
<p>
Sets the type of ellipsization being performed for <em class="parameter"><code>layout</code></em>.
Depending on the ellipsization mode <em class="parameter"><code>ellipsize</code></em> text is
removed from the start, middle, or end of lines so they
fit within the width of layout set with <a href="pango-Layout-Objects.html#pango-layout-set-width"><code class="function">pango_layout_set_width()</code></a>.
</p>
<p>
If the layout contains characters such as newlines that
force it to be layed out in multiple lines, then each line
is ellipsized separately.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>layout</code></em>&#160;:</span></td>
<td> a <a href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>ellipsize</code></em>&#160;:</span></td>
<td> the new ellipsization mode for <em class="parameter"><code>layout</code></em>
</td>
</tr>
</tbody>
</table></div>
<p>Since  1.6
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2841586"></a><h3>
<a name="pango-layout-get-ellipsize"></a>pango_layout_get_ellipsize ()</h3>
<a class="indexterm" name="id2841602"></a><pre class="programlisting"><a href="pango-Layout-Objects.html#PangoEllipsizeMode">PangoEllipsizeMode</a> pango_layout_get_ellipsize
                                            (<a href="pango-Layout-Objects.html#PangoLayout">PangoLayout</a> *layout);</pre>
<p>
Gets the type of ellipsization being performed for <em class="parameter"><code>layout</code></em>.
See <a href="pango-Layout-Objects.html#pango-layout-set-ellipsize"><code class="function">pango_layout_set_ellipsize()</code></a></p>
<p>

</p>