gtk-gtktextiter.html

最新gtk中文资料集

</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3565729"></a><h3>
<a name="gtk-text-iter-get-line-offset"></a>gtk_text_iter_get_line_offset ()</h3>
<a class="indexterm" name="id3565742"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a>                gtk_text_iter_get_line_offset       (const <a class="link" href="gtk-GtkTextIter.html#GtkTextIter">GtkTextIter</a> *iter);</pre>
<p>
Returns the character offset of the iterator,
counting from the start of a newline-terminated line.
The first character on the line has offset 0.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>iter</code></em>&#160;:</span></p></td>
<td> an iterator
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> offset from start of line
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3565805"></a><h3>
<a name="gtk-text-iter-get-line-index"></a>gtk_text_iter_get_line_index ()</h3>
<a class="indexterm" name="id3565819"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a>                gtk_text_iter_get_line_index        (const <a class="link" href="gtk-GtkTextIter.html#GtkTextIter">GtkTextIter</a> *iter);</pre>
<p>
Returns the byte index of the iterator, counting
from the start of a newline-terminated line.
Remember that <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> encodes text in
UTF-8, and that characters can require a variable
number of bytes to represent.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>iter</code></em>&#160;:</span></p></td>
<td> an iterator
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> distance from start of line, in bytes
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3565892"></a><h3>
<a name="gtk-text-iter-get-visible-line-index"></a>gtk_text_iter_get_visible_line_index ()</h3>
<a class="indexterm" name="id3565905"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a>                gtk_text_iter_get_visible_line_index
                                                        (const <a class="link" href="gtk-GtkTextIter.html#GtkTextIter">GtkTextIter</a> *iter);</pre>
<p>
Returns the number of bytes from the start of the
line to the given <em class="parameter"><code>iter</code></em>, not counting bytes that
are invisible due to tags with the "invisible" flag
toggled on.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>iter</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="gtk-GtkTextIter.html#GtkTextIter"><span class="type">GtkTextIter</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> byte index of <em class="parameter"><code>iter</code></em> with respect to the start of the line
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3565990"></a><h3>
<a name="gtk-text-iter-get-visible-line-offset"></a>gtk_text_iter_get_visible_line_offset ()</h3>
<a class="indexterm" name="id3566004"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a>                gtk_text_iter_get_visible_line_offset
                                                        (const <a class="link" href="gtk-GtkTextIter.html#GtkTextIter">GtkTextIter</a> *iter);</pre>
<p>
Returns the offset in characters from the start of the
line to the given <em class="parameter"><code>iter</code></em>, not counting characters that
are invisible due to tags with the "invisible" flag
toggled on.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>iter</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="gtk-GtkTextIter.html#GtkTextIter"><span class="type">GtkTextIter</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> offset in visible characters from the start of the line 
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3566082"></a><h3>
<a name="gtk-text-iter-get-char"></a>gtk_text_iter_get_char ()</h3>
<a class="indexterm" name="id3566096"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Unicode-Manipulation.html#gunichar"
>gunichar</a>            gtk_text_iter_get_char              (const <a class="link" href="gtk-GtkTextIter.html#GtkTextIter">GtkTextIter</a> *iter);</pre>
<p>
Returns the Unicode character at this iterator.  (Equivalent to
operator* on a C++ iterator.)  If the element at this iterator is a
non-character element, such as an image embedded in the buffer, the
Unicode "unknown" character 0xFFFC is returned. If invoked on
the end iterator, zero is returned; zero is not a valid Unicode character.
So you can write a loop which ends when <a class="link" href="gtk-GtkTextIter.html#gtk-text-iter-get-char"><code class="function">gtk_text_iter_get_char()</code></a>
returns 0.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>iter</code></em>&#160;:</span></p></td>
<td> an iterator
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> a Unicode character, or 0 if <em class="parameter"><code>iter</code></em> is not dereferenceable
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3566180"></a><h3>
<a name="gtk-text-iter-get-slice"></a>gtk_text_iter_get_slice ()</h3>
<a class="indexterm" name="id3566193"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>*              gtk_text_iter_get_slice             (const <a class="link" href="gtk-GtkTextIter.html#GtkTextIter">GtkTextIter</a> *start,
                                                         const <a class="link" href="gtk-GtkTextIter.html#GtkTextIter">GtkTextIter</a> *end);</pre>
<p>
Returns the text in the given range. A "slice" is an array of
characters encoded in UTF-8 format, including the Unicode "unknown"
character 0xFFFC for iterable non-character elements in the buffer,
such as images.  Because images are encoded in the slice, byte and
character offsets in the returned array will correspond to byte
offsets in the text buffer. Note that 0xFFFC can occur in normal
text as well, so it is not a reliable indicator that a pixbuf or
widget is in the buffer.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>start</code></em>&#160;:</span></p></td>
<td> iterator at start of a range
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>end</code></em>&#160;:</span></p></td>
<td> iterator at end of a range
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> slice of text from the buffer
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3566284"></a><h3>
<a name="gtk-text-iter-get-text"></a>gtk_text_iter_get_text ()</h3>
<a class="indexterm" name="id3566297"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>*              gtk_text_iter_get_text              (const <a class="link" href="gtk-GtkTextIter.html#GtkTextIter">GtkTextIter</a> *start,
                                                         const <a class="link" href="gtk-GtkTextIter.html#GtkTextIter">GtkTextIter</a> *end);</pre>
<p>
Returns <span class="emphasis"><em>text</em></span> in the given range.  If the range
contains non-text elements such as images, the character and byte
offsets in the returned string will not correspond to character and
byte offsets in the buffer. If you want offsets to correspond, see
<a class="link" href="gtk-GtkTextIter.html#gtk-text-iter-get-slice"><code class="function">gtk_text_iter_get_slice()</code></a>.</p>