4295 lines
206 KiB
HTML
4295 lines
206 KiB
HTML
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
||
<html>
|
||
<head>
|
||
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
||
<title>GtkTextIter: GTK+ 3 Reference Manual</title>
|
||
<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
|
||
<link rel="home" href="index.html" title="GTK+ 3 Reference Manual">
|
||
<link rel="up" href="TextWidgetObjects.html" title="Multiline Text Editor">
|
||
<link rel="prev" href="TextWidget.html" title="Text Widget Overview">
|
||
<link rel="next" href="GtkTextMark.html" title="GtkTextMark">
|
||
<meta name="generator" content="GTK-Doc V1.33.1 (XML mode)">
|
||
<link rel="stylesheet" href="style.css" type="text/css">
|
||
</head>
|
||
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
|
||
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
|
||
<td width="100%" align="left" class="shortcuts">
|
||
<a href="#" class="shortcut">Top</a><span id="nav_description"> <span class="dim">|</span>
|
||
<a href="#GtkTextIter.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span>
|
||
<a href="#GtkTextIter.object-hierarchy" class="shortcut">Object Hierarchy</a></span>
|
||
</td>
|
||
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
|
||
<td><a accesskey="u" href="TextWidgetObjects.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
|
||
<td><a accesskey="p" href="TextWidget.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
|
||
<td><a accesskey="n" href="GtkTextMark.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
|
||
</tr></table>
|
||
<div class="refentry">
|
||
<a name="GtkTextIter"></a><div class="titlepage"></div>
|
||
<div class="refnamediv"><table width="100%"><tr>
|
||
<td valign="top">
|
||
<h2><span class="refentrytitle"><a name="GtkTextIter.top_of_page"></a>GtkTextIter</span></h2>
|
||
<p>GtkTextIter — Text buffer iterator</p>
|
||
</td>
|
||
<td class="gallery_image" valign="top" align="right"></td>
|
||
</tr></table></div>
|
||
<div class="refsect1">
|
||
<a name="GtkTextIter.functions"></a><h2>Functions</h2>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="functions_proto_type">
|
||
<col class="functions_proto_name">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="returnvalue">GtkTextBuffer</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-get-buffer" title="gtk_text_iter_get_buffer ()">gtk_text_iter_get_buffer</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="returnvalue">GtkTextIter</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-copy" title="gtk_text_iter_copy ()">gtk_text_iter_copy</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-assign" title="gtk_text_iter_assign ()">gtk_text_iter_assign</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-free" title="gtk_text_iter_free ()">gtk_text_iter_free</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gint</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-get-offset" title="gtk_text_iter_get_offset ()">gtk_text_iter_get_offset</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gint</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-get-line" title="gtk_text_iter_get_line ()">gtk_text_iter_get_line</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gint</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-get-line-offset" title="gtk_text_iter_get_line_offset ()">gtk_text_iter_get_line_offset</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gint</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-get-line-index" title="gtk_text_iter_get_line_index ()">gtk_text_iter_get_line_index</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gint</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-get-visible-line-index" title="gtk_text_iter_get_visible_line_index ()">gtk_text_iter_get_visible_line_index</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gint</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-get-visible-line-offset" title="gtk_text_iter_get_visible_line_offset ()">gtk_text_iter_get_visible_line_offset</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gunichar</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-get-char" title="gtk_text_iter_get_char ()">gtk_text_iter_get_char</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gchar</span> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-get-slice" title="gtk_text_iter_get_slice ()">gtk_text_iter_get_slice</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gchar</span> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-get-text" title="gtk_text_iter_get_text ()">gtk_text_iter_get_text</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gchar</span> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-get-visible-slice" title="gtk_text_iter_get_visible_slice ()">gtk_text_iter_get_visible_slice</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gchar</span> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-get-visible-text" title="gtk_text_iter_get_visible_text ()">gtk_text_iter_get_visible_text</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">GdkPixbuf</span> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-get-pixbuf" title="gtk_text_iter_get_pixbuf ()">gtk_text_iter_get_pixbuf</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">GSList</span> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-get-marks" title="gtk_text_iter_get_marks ()">gtk_text_iter_get_marks</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">GSList</span> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-get-toggled-tags" title="gtk_text_iter_get_toggled_tags ()">gtk_text_iter_get_toggled_tags</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="GtkTextView.html#GtkTextChildAnchor"><span class="returnvalue">GtkTextChildAnchor</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-get-child-anchor" title="gtk_text_iter_get_child_anchor ()">gtk_text_iter_get_child_anchor</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-starts-tag" title="gtk_text_iter_starts_tag ()">gtk_text_iter_starts_tag</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-begins-tag" title="gtk_text_iter_begins_tag ()">gtk_text_iter_begins_tag</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-ends-tag" title="gtk_text_iter_ends_tag ()">gtk_text_iter_ends_tag</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-toggles-tag" title="gtk_text_iter_toggles_tag ()">gtk_text_iter_toggles_tag</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-has-tag" title="gtk_text_iter_has_tag ()">gtk_text_iter_has_tag</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">GSList</span> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-get-tags" title="gtk_text_iter_get_tags ()">gtk_text_iter_get_tags</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-editable" title="gtk_text_iter_editable ()">gtk_text_iter_editable</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-can-insert" title="gtk_text_iter_can_insert ()">gtk_text_iter_can_insert</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-starts-word" title="gtk_text_iter_starts_word ()">gtk_text_iter_starts_word</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-ends-word" title="gtk_text_iter_ends_word ()">gtk_text_iter_ends_word</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-inside-word" title="gtk_text_iter_inside_word ()">gtk_text_iter_inside_word</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-starts-line" title="gtk_text_iter_starts_line ()">gtk_text_iter_starts_line</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-ends-line" title="gtk_text_iter_ends_line ()">gtk_text_iter_ends_line</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-starts-sentence" title="gtk_text_iter_starts_sentence ()">gtk_text_iter_starts_sentence</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-ends-sentence" title="gtk_text_iter_ends_sentence ()">gtk_text_iter_ends_sentence</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-inside-sentence" title="gtk_text_iter_inside_sentence ()">gtk_text_iter_inside_sentence</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-is-cursor-position" title="gtk_text_iter_is_cursor_position ()">gtk_text_iter_is_cursor_position</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gint</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-get-chars-in-line" title="gtk_text_iter_get_chars_in_line ()">gtk_text_iter_get_chars_in_line</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gint</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-get-bytes-in-line" title="gtk_text_iter_get_bytes_in_line ()">gtk_text_iter_get_bytes_in_line</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-get-attributes" title="gtk_text_iter_get_attributes ()">gtk_text_iter_get_attributes</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">PangoLanguage</span> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-get-language" title="gtk_text_iter_get_language ()">gtk_text_iter_get_language</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-is-end" title="gtk_text_iter_is_end ()">gtk_text_iter_is_end</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-is-start" title="gtk_text_iter_is_start ()">gtk_text_iter_is_start</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-forward-char" title="gtk_text_iter_forward_char ()">gtk_text_iter_forward_char</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-backward-char" title="gtk_text_iter_backward_char ()">gtk_text_iter_backward_char</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-forward-chars" title="gtk_text_iter_forward_chars ()">gtk_text_iter_forward_chars</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-backward-chars" title="gtk_text_iter_backward_chars ()">gtk_text_iter_backward_chars</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-forward-line" title="gtk_text_iter_forward_line ()">gtk_text_iter_forward_line</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-backward-line" title="gtk_text_iter_backward_line ()">gtk_text_iter_backward_line</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-forward-lines" title="gtk_text_iter_forward_lines ()">gtk_text_iter_forward_lines</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-backward-lines" title="gtk_text_iter_backward_lines ()">gtk_text_iter_backward_lines</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-forward-word-ends" title="gtk_text_iter_forward_word_ends ()">gtk_text_iter_forward_word_ends</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-backward-word-starts" title="gtk_text_iter_backward_word_starts ()">gtk_text_iter_backward_word_starts</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-forward-word-end" title="gtk_text_iter_forward_word_end ()">gtk_text_iter_forward_word_end</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-backward-word-start" title="gtk_text_iter_backward_word_start ()">gtk_text_iter_backward_word_start</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-forward-cursor-position" title="gtk_text_iter_forward_cursor_position ()">gtk_text_iter_forward_cursor_position</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-backward-cursor-position" title="gtk_text_iter_backward_cursor_position ()">gtk_text_iter_backward_cursor_position</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-forward-cursor-positions" title="gtk_text_iter_forward_cursor_positions ()">gtk_text_iter_forward_cursor_positions</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-backward-cursor-positions" title="gtk_text_iter_backward_cursor_positions ()">gtk_text_iter_backward_cursor_positions</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-backward-sentence-start" title="gtk_text_iter_backward_sentence_start ()">gtk_text_iter_backward_sentence_start</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-backward-sentence-starts" title="gtk_text_iter_backward_sentence_starts ()">gtk_text_iter_backward_sentence_starts</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-forward-sentence-end" title="gtk_text_iter_forward_sentence_end ()">gtk_text_iter_forward_sentence_end</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-forward-sentence-ends" title="gtk_text_iter_forward_sentence_ends ()">gtk_text_iter_forward_sentence_ends</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-forward-visible-word-ends" title="gtk_text_iter_forward_visible_word_ends ()">gtk_text_iter_forward_visible_word_ends</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-backward-visible-word-starts" title="gtk_text_iter_backward_visible_word_starts ()">gtk_text_iter_backward_visible_word_starts</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-forward-visible-word-end" title="gtk_text_iter_forward_visible_word_end ()">gtk_text_iter_forward_visible_word_end</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-backward-visible-word-start" title="gtk_text_iter_backward_visible_word_start ()">gtk_text_iter_backward_visible_word_start</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-forward-visible-cursor-position" title="gtk_text_iter_forward_visible_cursor_position ()">gtk_text_iter_forward_visible_cursor_position</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-backward-visible-cursor-position" title="gtk_text_iter_backward_visible_cursor_position ()">gtk_text_iter_backward_visible_cursor_position</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-forward-visible-cursor-positions" title="gtk_text_iter_forward_visible_cursor_positions ()">gtk_text_iter_forward_visible_cursor_positions</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-backward-visible-cursor-positions" title="gtk_text_iter_backward_visible_cursor_positions ()">gtk_text_iter_backward_visible_cursor_positions</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-forward-visible-line" title="gtk_text_iter_forward_visible_line ()">gtk_text_iter_forward_visible_line</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-backward-visible-line" title="gtk_text_iter_backward_visible_line ()">gtk_text_iter_backward_visible_line</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-forward-visible-lines" title="gtk_text_iter_forward_visible_lines ()">gtk_text_iter_forward_visible_lines</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-backward-visible-lines" title="gtk_text_iter_backward_visible_lines ()">gtk_text_iter_backward_visible_lines</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-set-offset" title="gtk_text_iter_set_offset ()">gtk_text_iter_set_offset</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-set-line" title="gtk_text_iter_set_line ()">gtk_text_iter_set_line</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-set-line-offset" title="gtk_text_iter_set_line_offset ()">gtk_text_iter_set_line_offset</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-set-line-index" title="gtk_text_iter_set_line_index ()">gtk_text_iter_set_line_index</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-set-visible-line-index" title="gtk_text_iter_set_visible_line_index ()">gtk_text_iter_set_visible_line_index</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-set-visible-line-offset" title="gtk_text_iter_set_visible_line_offset ()">gtk_text_iter_set_visible_line_offset</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-forward-to-end" title="gtk_text_iter_forward_to_end ()">gtk_text_iter_forward_to_end</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-forward-to-line-end" title="gtk_text_iter_forward_to_line_end ()">gtk_text_iter_forward_to_line_end</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-forward-to-tag-toggle" title="gtk_text_iter_forward_to_tag_toggle ()">gtk_text_iter_forward_to_tag_toggle</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-backward-to-tag-toggle" title="gtk_text_iter_backward_to_tag_toggle ()">gtk_text_iter_backward_to_tag_toggle</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<span class="c_punctuation">(</span><a class="link" href="GtkTextIter.html#GtkTextCharPredicate" title="GtkTextCharPredicate ()">*GtkTextCharPredicate</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-forward-find-char" title="gtk_text_iter_forward_find_char ()">gtk_text_iter_forward_find_char</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-backward-find-char" title="gtk_text_iter_backward_find_char ()">gtk_text_iter_backward_find_char</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-forward-search" title="gtk_text_iter_forward_search ()">gtk_text_iter_forward_search</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-backward-search" title="gtk_text_iter_backward_search ()">gtk_text_iter_backward_search</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-equal" title="gtk_text_iter_equal ()">gtk_text_iter_equal</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gint</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-compare" title="gtk_text_iter_compare ()">gtk_text_iter_compare</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-in-range" title="gtk_text_iter_in_range ()">gtk_text_iter_in_range</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-order" title="gtk_text_iter_order ()">gtk_text_iter_order</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkTextIter.other"></a><h2>Types and Values</h2>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="other_proto_type">
|
||
<col class="other_proto_name">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="datatype_keyword"> </td>
|
||
<td class="function_name"><a class="link" href="GtkTextIter.html#GtkTextIter-struct" title="GtkTextIter">GtkTextIter</a></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="datatype_keyword">enum</td>
|
||
<td class="function_name"><a class="link" href="GtkTextIter.html#GtkTextSearchFlags" title="enum GtkTextSearchFlags">GtkTextSearchFlags</a></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkTextIter.object-hierarchy"></a><h2>Object Hierarchy</h2>
|
||
<pre class="screen"> <a href="/usr/share/gtk-doc/html/gobject/gobject-Boxed-Types.html">GBoxed</a>
|
||
<span class="lineart">╰──</span> GtkTextIter
|
||
</pre>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkTextIter.includes"></a><h2>Includes</h2>
|
||
<pre class="synopsis">#include <gtk/gtk.h>
|
||
</pre>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkTextIter.description"></a><h2>Description</h2>
|
||
<p>You may wish to begin by reading the
|
||
<a class="link" href="TextWidget.html" title="Text Widget Overview">text widget conceptual overview</a>
|
||
which gives an overview of all the objects and data
|
||
types related to the text widget and how they work together.</p>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkTextIter.functions_details"></a><h2>Functions</h2>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-get-buffer"></a><h3>gtk_text_iter_get_buffer ()</h3>
|
||
<pre class="programlisting"><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="returnvalue">GtkTextBuffer</span></a> *
|
||
gtk_text_iter_get_buffer (<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>);</pre>
|
||
<p>Returns the <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> this iterator is associated with.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-get-buffer.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>an iterator</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-get-buffer.returns"></a><h4>Returns</h4>
|
||
<p>the buffer. </p>
|
||
<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-copy"></a><h3>gtk_text_iter_copy ()</h3>
|
||
<pre class="programlisting"><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="returnvalue">GtkTextIter</span></a> *
|
||
gtk_text_iter_copy (<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>);</pre>
|
||
<p>Creates a dynamically-allocated copy of an iterator. This function
|
||
is not useful in applications, because iterators can be copied with a
|
||
simple assignment (<code class="literal">GtkTextIter i = j;</code>). The
|
||
function is used by language bindings.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-copy.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>an iterator</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-copy.returns"></a><h4>Returns</h4>
|
||
<p> a copy of the <em class="parameter"><code>iter</code></em>
|
||
, free with <a class="link" href="GtkTextIter.html#gtk-text-iter-free" title="gtk_text_iter_free ()"><code class="function">gtk_text_iter_free()</code></a></p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-assign"></a><h3>gtk_text_iter_assign ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_text_iter_assign (<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
|
||
<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *other</code></em>);</pre>
|
||
<p>Assigns the value of <em class="parameter"><code>other</code></em>
|
||
to <em class="parameter"><code>iter</code></em>
|
||
. This function
|
||
is not useful in applications, because iterators can be assigned
|
||
with <code class="literal">GtkTextIter i = j;</code>. The
|
||
function is used by language bindings.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-assign.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>other</p></td>
|
||
<td class="parameter_description"><p>another <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: <a class="link" href="api-index-3-2.html#api-index-3.2">3.2</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-free"></a><h3>gtk_text_iter_free ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_text_iter_free (<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>);</pre>
|
||
<p>Free an iterator allocated on the heap. This function
|
||
is intended for use in language bindings, and is not
|
||
especially useful for applications, because iterators can
|
||
simply be allocated on the stack.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-free.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>a dynamically-allocated iterator</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-get-offset"></a><h3>gtk_text_iter_get_offset ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gint</span>
|
||
gtk_text_iter_get_offset (<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>);</pre>
|
||
<p>Returns the character offset of an iterator.
|
||
Each character in a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> has an offset,
|
||
starting with 0 for the first character in the buffer.
|
||
Use <a class="link" href="GtkTextBuffer.html#gtk-text-buffer-get-iter-at-offset" title="gtk_text_buffer_get_iter_at_offset ()"><code class="function">gtk_text_buffer_get_iter_at_offset()</code></a> to convert an
|
||
offset back into an iterator.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-get-offset.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>an iterator</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-get-offset.returns"></a><h4>Returns</h4>
|
||
<p> a character offset</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-get-line"></a><h3>gtk_text_iter_get_line ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gint</span>
|
||
gtk_text_iter_get_line (<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>);</pre>
|
||
<p>Returns the line number containing the iterator. Lines in
|
||
a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> are numbered beginning with 0 for the first
|
||
line in the buffer.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-get-line.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>an iterator</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-get-line.returns"></a><h4>Returns</h4>
|
||
<p> a line number</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-get-line-offset"></a><h3>gtk_text_iter_get_line_offset ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gint</span>
|
||
gtk_text_iter_get_line_offset (<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>);</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>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-get-line-offset.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>an iterator</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-get-line-offset.returns"></a><h4>Returns</h4>
|
||
<p> offset from start of line</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-get-line-index"></a><h3>gtk_text_iter_get_line_index ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gint</span>
|
||
gtk_text_iter_get_line_index (<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>);</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>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-get-line-index.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>an iterator</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-get-line-index.returns"></a><h4>Returns</h4>
|
||
<p> distance from start of line, in bytes</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-get-visible-line-index"></a><h3>gtk_text_iter_get_visible_line_index ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gint</span>
|
||
gtk_text_iter_get_visible_line_index (<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>);</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>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-get-visible-line-index.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-get-visible-line-index.returns"></a><h4>Returns</h4>
|
||
<p> byte index of <em class="parameter"><code>iter</code></em>
|
||
with respect to the start of the line</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-get-visible-line-offset"></a><h3>gtk_text_iter_get_visible_line_offset ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gint</span>
|
||
gtk_text_iter_get_visible_line_offset (<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>);</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>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-get-visible-line-offset.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-get-visible-line-offset.returns"></a><h4>Returns</h4>
|
||
<p> offset in visible characters from the start of the line </p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-get-char"></a><h3>gtk_text_iter_get_char ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gunichar</span>
|
||
gtk_text_iter_get_char (<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>);</pre>
|
||
<p>The Unicode character at this iterator is returned. (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="GtkTextIter.html#gtk-text-iter-get-char" title="gtk_text_iter_get_char ()"><code class="function">gtk_text_iter_get_char()</code></a>
|
||
returns 0.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-get-char.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>an iterator</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-get-char.returns"></a><h4>Returns</h4>
|
||
<p> a Unicode character, or 0 if <em class="parameter"><code>iter</code></em>
|
||
is not dereferenceable</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-get-slice"></a><h3>gtk_text_iter_get_slice ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gchar</span> *
|
||
gtk_text_iter_get_slice (<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *start</code></em>,
|
||
<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *end</code></em>);</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>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-get-slice.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>start</p></td>
|
||
<td class="parameter_description"><p>iterator at start of a range</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>end</p></td>
|
||
<td class="parameter_description"><p>iterator at end of a range</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-get-slice.returns"></a><h4>Returns</h4>
|
||
<p>slice of text from the buffer. </p>
|
||
<p><span class="annotation">[<acronym title="The caller owns the data, and is responsible for free it."><span class="acronym">transfer full</span></acronym>]</span></p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-get-text"></a><h3>gtk_text_iter_get_text ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gchar</span> *
|
||
gtk_text_iter_get_text (<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *start</code></em>,
|
||
<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *end</code></em>);</pre>
|
||
<p>Returns text 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="GtkTextIter.html#gtk-text-iter-get-slice" title="gtk_text_iter_get_slice ()"><code class="function">gtk_text_iter_get_slice()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-get-text.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>start</p></td>
|
||
<td class="parameter_description"><p>iterator at start of a range</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>end</p></td>
|
||
<td class="parameter_description"><p>iterator at end of a range</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-get-text.returns"></a><h4>Returns</h4>
|
||
<p>array of characters from the buffer. </p>
|
||
<p><span class="annotation">[<acronym title="The caller owns the data, and is responsible for free it."><span class="acronym">transfer full</span></acronym>]</span></p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-get-visible-slice"></a><h3>gtk_text_iter_get_visible_slice ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gchar</span> *
|
||
gtk_text_iter_get_visible_slice (<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *start</code></em>,
|
||
<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *end</code></em>);</pre>
|
||
<p>Like <a class="link" href="GtkTextIter.html#gtk-text-iter-get-slice" title="gtk_text_iter_get_slice ()"><code class="function">gtk_text_iter_get_slice()</code></a>, but invisible text is not included.
|
||
Invisible text is usually invisible because a <a class="link" href="GtkTextTag.html" title="GtkTextTag"><span class="type">GtkTextTag</span></a> with the
|
||
“invisible” attribute turned on has been applied to it.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-get-visible-slice.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>start</p></td>
|
||
<td class="parameter_description"><p>iterator at start of range</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>end</p></td>
|
||
<td class="parameter_description"><p>iterator at end of range</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-get-visible-slice.returns"></a><h4>Returns</h4>
|
||
<p>slice of text from the buffer. </p>
|
||
<p><span class="annotation">[<acronym title="The caller owns the data, and is responsible for free it."><span class="acronym">transfer full</span></acronym>]</span></p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-get-visible-text"></a><h3>gtk_text_iter_get_visible_text ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gchar</span> *
|
||
gtk_text_iter_get_visible_text (<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *start</code></em>,
|
||
<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *end</code></em>);</pre>
|
||
<p>Like <a class="link" href="GtkTextIter.html#gtk-text-iter-get-text" title="gtk_text_iter_get_text ()"><code class="function">gtk_text_iter_get_text()</code></a>, but invisible text is not included.
|
||
Invisible text is usually invisible because a <a class="link" href="GtkTextTag.html" title="GtkTextTag"><span class="type">GtkTextTag</span></a> with the
|
||
“invisible” attribute turned on has been applied to it.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-get-visible-text.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>start</p></td>
|
||
<td class="parameter_description"><p>iterator at start of range</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>end</p></td>
|
||
<td class="parameter_description"><p>iterator at end of range</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-get-visible-text.returns"></a><h4>Returns</h4>
|
||
<p>string containing visible text in the
|
||
range. </p>
|
||
<p><span class="annotation">[<acronym title="The caller owns the data, and is responsible for free it."><span class="acronym">transfer full</span></acronym>]</span></p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-get-pixbuf"></a><h3>gtk_text_iter_get_pixbuf ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">GdkPixbuf</span> *
|
||
gtk_text_iter_get_pixbuf (<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>);</pre>
|
||
<p>If the element at <em class="parameter"><code>iter</code></em>
|
||
is a pixbuf, the pixbuf is returned
|
||
(with no new reference count added). Otherwise,
|
||
<code class="literal">NULL</code> is returned.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-get-pixbuf.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>an iterator</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-get-pixbuf.returns"></a><h4>Returns</h4>
|
||
<p>the pixbuf at <em class="parameter"><code>iter</code></em>
|
||
. </p>
|
||
<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-get-marks"></a><h3>gtk_text_iter_get_marks ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">GSList</span> *
|
||
gtk_text_iter_get_marks (<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>);</pre>
|
||
<p>Returns a list of all <a class="link" href="GtkTextMark.html" title="GtkTextMark"><span class="type">GtkTextMark</span></a> at this location. Because marks
|
||
are not iterable (they don’t take up any "space" in the buffer,
|
||
they are just marks in between iterable locations), multiple marks
|
||
can exist in the same place. The returned list is not in any
|
||
meaningful order.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-get-marks.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>an iterator</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-get-marks.returns"></a><h4>Returns</h4>
|
||
<p>list of <a class="link" href="GtkTextMark.html" title="GtkTextMark"><span class="type">GtkTextMark</span></a>. </p>
|
||
<p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GtkTextMark][<acronym title="The caller owns the data container, but not the data inside it."><span class="acronym">transfer container</span></acronym>]</span></p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-get-toggled-tags"></a><h3>gtk_text_iter_get_toggled_tags ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">GSList</span> *
|
||
gtk_text_iter_get_toggled_tags (<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> toggled_on</code></em>);</pre>
|
||
<p>Returns a list of <a class="link" href="GtkTextTag.html" title="GtkTextTag"><span class="type">GtkTextTag</span></a> that are toggled on or off at this
|
||
point. (If <em class="parameter"><code>toggled_on</code></em>
|
||
is <code class="literal">TRUE</code>, the list contains tags that are
|
||
toggled on.) If a tag is toggled on at <em class="parameter"><code>iter</code></em>
|
||
, then some non-empty
|
||
range of characters following <em class="parameter"><code>iter</code></em>
|
||
has that tag applied to it. If
|
||
a tag is toggled off, then some non-empty range following <em class="parameter"><code>iter</code></em>
|
||
|
||
does not have the tag applied to it.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-get-toggled-tags.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>an iterator</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>toggled_on</p></td>
|
||
<td class="parameter_description"><p><code class="literal">TRUE</code> to get toggled-on tags</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-get-toggled-tags.returns"></a><h4>Returns</h4>
|
||
<p>tags toggled at this point. </p>
|
||
<p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GtkTextTag][<acronym title="The caller owns the data container, but not the data inside it."><span class="acronym">transfer container</span></acronym>]</span></p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-get-child-anchor"></a><h3>gtk_text_iter_get_child_anchor ()</h3>
|
||
<pre class="programlisting"><a class="link" href="GtkTextView.html#GtkTextChildAnchor"><span class="returnvalue">GtkTextChildAnchor</span></a> *
|
||
gtk_text_iter_get_child_anchor (<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>);</pre>
|
||
<p>If the location at <em class="parameter"><code>iter</code></em>
|
||
contains a child anchor, the
|
||
anchor is returned (with no new reference count added). Otherwise,
|
||
<code class="literal">NULL</code> is returned.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-get-child-anchor.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>an iterator</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-get-child-anchor.returns"></a><h4>Returns</h4>
|
||
<p>the anchor at <em class="parameter"><code>iter</code></em>
|
||
. </p>
|
||
<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-starts-tag"></a><h3>gtk_text_iter_starts_tag ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_iter_starts_tag (<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextTag.html" title="GtkTextTag"><span class="type">GtkTextTag</span></a> *tag</code></em>);</pre>
|
||
<p>Returns <code class="literal">TRUE</code> if <em class="parameter"><code>tag</code></em>
|
||
is toggled on at exactly this point. If <em class="parameter"><code>tag</code></em>
|
||
|
||
is <code class="literal">NULL</code>, returns <code class="literal">TRUE</code> if any tag is toggled on at this point.</p>
|
||
<p>Note that if <a class="link" href="GtkTextIter.html#gtk-text-iter-starts-tag" title="gtk_text_iter_starts_tag ()"><code class="function">gtk_text_iter_starts_tag()</code></a> returns <code class="literal">TRUE</code>, it means that <em class="parameter"><code>iter</code></em>
|
||
is
|
||
at the beginning of the tagged range, and that the
|
||
character at <em class="parameter"><code>iter</code></em>
|
||
is inside the tagged range. In other
|
||
words, unlike <a class="link" href="GtkTextIter.html#gtk-text-iter-ends-tag" title="gtk_text_iter_ends_tag ()"><code class="function">gtk_text_iter_ends_tag()</code></a>, if <a class="link" href="GtkTextIter.html#gtk-text-iter-starts-tag" title="gtk_text_iter_starts_tag ()"><code class="function">gtk_text_iter_starts_tag()</code></a> returns
|
||
<code class="literal">TRUE</code>, <a class="link" href="GtkTextIter.html#gtk-text-iter-has-tag" title="gtk_text_iter_has_tag ()"><code class="function">gtk_text_iter_has_tag()</code></a> will also return <code class="literal">TRUE</code> for the same
|
||
parameters.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-starts-tag.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>an iterator</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>tag</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextTag.html" title="GtkTextTag"><span class="type">GtkTextTag</span></a>, or <code class="literal">NULL</code>. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-starts-tag.returns"></a><h4>Returns</h4>
|
||
<p> whether <em class="parameter"><code>iter</code></em>
|
||
is the start of a range tagged with <em class="parameter"><code>tag</code></em>
|
||
</p>
|
||
</div>
|
||
<p class="since">Since: <a class="link" href="api-index-3-20.html#api-index-3.20">3.20</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-begins-tag"></a><h3>gtk_text_iter_begins_tag ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_iter_begins_tag (<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextTag.html" title="GtkTextTag"><span class="type">GtkTextTag</span></a> *tag</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gtk_text_iter_begins_tag</code> has been deprecated since version 3.20 and should not be used in newly-written code.</p>
|
||
<p>Use <a class="link" href="GtkTextIter.html#gtk-text-iter-starts-tag" title="gtk_text_iter_starts_tag ()"><code class="function">gtk_text_iter_starts_tag()</code></a> instead.</p>
|
||
</div>
|
||
<p>Returns <code class="literal">TRUE</code> if <em class="parameter"><code>tag</code></em>
|
||
is toggled on at exactly this point. If <em class="parameter"><code>tag</code></em>
|
||
|
||
is <code class="literal">NULL</code>, returns <code class="literal">TRUE</code> if any tag is toggled on at this point.</p>
|
||
<p>Note that if <a class="link" href="GtkTextIter.html#gtk-text-iter-begins-tag" title="gtk_text_iter_begins_tag ()"><code class="function">gtk_text_iter_begins_tag()</code></a> returns <code class="literal">TRUE</code>, it means that <em class="parameter"><code>iter</code></em>
|
||
is
|
||
at the beginning of the tagged range, and that the
|
||
character at <em class="parameter"><code>iter</code></em>
|
||
is inside the tagged range. In other
|
||
words, unlike <a class="link" href="GtkTextIter.html#gtk-text-iter-ends-tag" title="gtk_text_iter_ends_tag ()"><code class="function">gtk_text_iter_ends_tag()</code></a>, if <a class="link" href="GtkTextIter.html#gtk-text-iter-begins-tag" title="gtk_text_iter_begins_tag ()"><code class="function">gtk_text_iter_begins_tag()</code></a> returns
|
||
<code class="literal">TRUE</code>, <a class="link" href="GtkTextIter.html#gtk-text-iter-has-tag" title="gtk_text_iter_has_tag ()"><code class="function">gtk_text_iter_has_tag()</code></a> will also return <code class="literal">TRUE</code> for the same
|
||
parameters.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-begins-tag.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>an iterator</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>tag</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextTag.html" title="GtkTextTag"><span class="type">GtkTextTag</span></a>, or <code class="literal">NULL</code>. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-begins-tag.returns"></a><h4>Returns</h4>
|
||
<p> whether <em class="parameter"><code>iter</code></em>
|
||
is the start of a range tagged with <em class="parameter"><code>tag</code></em>
|
||
</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-ends-tag"></a><h3>gtk_text_iter_ends_tag ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_iter_ends_tag (<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextTag.html" title="GtkTextTag"><span class="type">GtkTextTag</span></a> *tag</code></em>);</pre>
|
||
<p>Returns <code class="literal">TRUE</code> if <em class="parameter"><code>tag</code></em>
|
||
is toggled off at exactly this point. If <em class="parameter"><code>tag</code></em>
|
||
|
||
is <code class="literal">NULL</code>, returns <code class="literal">TRUE</code> if any tag is toggled off at this point.</p>
|
||
<p>Note that if <a class="link" href="GtkTextIter.html#gtk-text-iter-ends-tag" title="gtk_text_iter_ends_tag ()"><code class="function">gtk_text_iter_ends_tag()</code></a> returns <code class="literal">TRUE</code>, it means that <em class="parameter"><code>iter</code></em>
|
||
is
|
||
at the end of the tagged range, but that the character
|
||
at <em class="parameter"><code>iter</code></em>
|
||
is outside the tagged range. In other words,
|
||
unlike <a class="link" href="GtkTextIter.html#gtk-text-iter-starts-tag" title="gtk_text_iter_starts_tag ()"><code class="function">gtk_text_iter_starts_tag()</code></a>, if <a class="link" href="GtkTextIter.html#gtk-text-iter-ends-tag" title="gtk_text_iter_ends_tag ()"><code class="function">gtk_text_iter_ends_tag()</code></a> returns <code class="literal">TRUE</code>,
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-has-tag" title="gtk_text_iter_has_tag ()"><code class="function">gtk_text_iter_has_tag()</code></a> will return <code class="literal">FALSE</code> for the same parameters.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-ends-tag.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>an iterator</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>tag</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextTag.html" title="GtkTextTag"><span class="type">GtkTextTag</span></a>, or <code class="literal">NULL</code>. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-ends-tag.returns"></a><h4>Returns</h4>
|
||
<p> whether <em class="parameter"><code>iter</code></em>
|
||
is the end of a range tagged with <em class="parameter"><code>tag</code></em>
|
||
</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-toggles-tag"></a><h3>gtk_text_iter_toggles_tag ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_iter_toggles_tag (<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextTag.html" title="GtkTextTag"><span class="type">GtkTextTag</span></a> *tag</code></em>);</pre>
|
||
<p>This is equivalent to (<a class="link" href="GtkTextIter.html#gtk-text-iter-starts-tag" title="gtk_text_iter_starts_tag ()"><code class="function">gtk_text_iter_starts_tag()</code></a> ||
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-ends-tag" title="gtk_text_iter_ends_tag ()"><code class="function">gtk_text_iter_ends_tag()</code></a>), i.e. it tells you whether a range with
|
||
<em class="parameter"><code>tag</code></em>
|
||
applied to it begins or ends at <em class="parameter"><code>iter</code></em>
|
||
.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-toggles-tag.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>an iterator</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>tag</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextTag.html" title="GtkTextTag"><span class="type">GtkTextTag</span></a>, or <code class="literal">NULL</code>. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-toggles-tag.returns"></a><h4>Returns</h4>
|
||
<p> whether <em class="parameter"><code>tag</code></em>
|
||
is toggled on or off at <em class="parameter"><code>iter</code></em>
|
||
</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-has-tag"></a><h3>gtk_text_iter_has_tag ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_iter_has_tag (<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextTag.html" title="GtkTextTag"><span class="type">GtkTextTag</span></a> *tag</code></em>);</pre>
|
||
<p>Returns <code class="literal">TRUE</code> if <em class="parameter"><code>iter</code></em>
|
||
points to a character that is part of a range tagged
|
||
with <em class="parameter"><code>tag</code></em>
|
||
. See also <a class="link" href="GtkTextIter.html#gtk-text-iter-starts-tag" title="gtk_text_iter_starts_tag ()"><code class="function">gtk_text_iter_starts_tag()</code></a> and <a class="link" href="GtkTextIter.html#gtk-text-iter-ends-tag" title="gtk_text_iter_ends_tag ()"><code class="function">gtk_text_iter_ends_tag()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-has-tag.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>an iterator</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>tag</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextTag.html" title="GtkTextTag"><span class="type">GtkTextTag</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-has-tag.returns"></a><h4>Returns</h4>
|
||
<p> whether <em class="parameter"><code>iter</code></em>
|
||
is tagged with <em class="parameter"><code>tag</code></em>
|
||
</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-get-tags"></a><h3>gtk_text_iter_get_tags ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">GSList</span> *
|
||
gtk_text_iter_get_tags (<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>);</pre>
|
||
<p>Returns a list of tags that apply to <em class="parameter"><code>iter</code></em>
|
||
, in ascending order of
|
||
priority (highest-priority tags are last). The <a class="link" href="GtkTextTag.html" title="GtkTextTag"><span class="type">GtkTextTag</span></a> in the
|
||
list don’t have a reference added, but you have to free the list
|
||
itself.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-get-tags.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-get-tags.returns"></a><h4>Returns</h4>
|
||
<p>list of <a class="link" href="GtkTextTag.html" title="GtkTextTag"><span class="type">GtkTextTag</span></a>. </p>
|
||
<p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GtkTextTag][<acronym title="The caller owns the data container, but not the data inside it."><span class="acronym">transfer container</span></acronym>]</span></p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-editable"></a><h3>gtk_text_iter_editable ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_iter_editable (<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> default_setting</code></em>);</pre>
|
||
<p>Returns whether the character at <em class="parameter"><code>iter</code></em>
|
||
is within an editable region
|
||
of text. Non-editable text is “locked” and can’t be changed by the
|
||
user via <a class="link" href="GtkTextView.html" title="GtkTextView"><span class="type">GtkTextView</span></a>. This function is simply a convenience
|
||
wrapper around <a class="link" href="GtkTextIter.html#gtk-text-iter-get-attributes" title="gtk_text_iter_get_attributes ()"><code class="function">gtk_text_iter_get_attributes()</code></a>. If no tags applied
|
||
to this text affect editability, <em class="parameter"><code>default_setting</code></em>
|
||
will be returned.</p>
|
||
<p>You don’t want to use this function to decide whether text can be
|
||
inserted at <em class="parameter"><code>iter</code></em>
|
||
, because for insertion you don’t want to know
|
||
whether the char at <em class="parameter"><code>iter</code></em>
|
||
is inside an editable range, you want to
|
||
know whether a new character inserted at <em class="parameter"><code>iter</code></em>
|
||
would be inside an
|
||
editable range. Use <a class="link" href="GtkTextIter.html#gtk-text-iter-can-insert" title="gtk_text_iter_can_insert ()"><code class="function">gtk_text_iter_can_insert()</code></a> to handle this
|
||
case.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-editable.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>an iterator</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>default_setting</p></td>
|
||
<td class="parameter_description"><p><code class="literal">TRUE</code> if text is editable by default</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-editable.returns"></a><h4>Returns</h4>
|
||
<p> whether <em class="parameter"><code>iter</code></em>
|
||
is inside an editable range</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-can-insert"></a><h3>gtk_text_iter_can_insert ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_iter_can_insert (<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> default_editability</code></em>);</pre>
|
||
<p>Considering the default editability of the buffer, and tags that
|
||
affect editability, determines whether text inserted at <em class="parameter"><code>iter</code></em>
|
||
would
|
||
be editable. If text inserted at <em class="parameter"><code>iter</code></em>
|
||
would be editable then the
|
||
user should be allowed to insert text at <em class="parameter"><code>iter</code></em>
|
||
.
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-insert-interactive" title="gtk_text_buffer_insert_interactive ()"><code class="function">gtk_text_buffer_insert_interactive()</code></a> uses this function to decide
|
||
whether insertions are allowed at a given position.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-can-insert.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>an iterator</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>default_editability</p></td>
|
||
<td class="parameter_description"><p><code class="literal">TRUE</code> if text is editable by default</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-can-insert.returns"></a><h4>Returns</h4>
|
||
<p> whether text inserted at <em class="parameter"><code>iter</code></em>
|
||
would be editable</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-starts-word"></a><h3>gtk_text_iter_starts_word ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_iter_starts_word (<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>);</pre>
|
||
<p>Determines whether <em class="parameter"><code>iter</code></em>
|
||
begins a natural-language word. Word
|
||
breaks are determined by Pango and should be correct for nearly any
|
||
language (if not, the correct fix would be to the Pango word break
|
||
algorithms).</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-starts-word.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-starts-word.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if <em class="parameter"><code>iter</code></em>
|
||
is at the start of a word</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-ends-word"></a><h3>gtk_text_iter_ends_word ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_iter_ends_word (<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>);</pre>
|
||
<p>Determines whether <em class="parameter"><code>iter</code></em>
|
||
ends a natural-language word. Word breaks
|
||
are determined by Pango and should be correct for nearly any
|
||
language (if not, the correct fix would be to the Pango word break
|
||
algorithms).</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-ends-word.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-ends-word.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if <em class="parameter"><code>iter</code></em>
|
||
is at the end of a word</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-inside-word"></a><h3>gtk_text_iter_inside_word ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_iter_inside_word (<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>);</pre>
|
||
<p>Determines whether the character pointed by <em class="parameter"><code>iter</code></em>
|
||
is part of a
|
||
natural-language word (as opposed to say inside some whitespace). Word
|
||
breaks are determined by Pango and should be correct for nearly any language
|
||
(if not, the correct fix would be to the Pango word break algorithms).</p>
|
||
<p>Note that if <a class="link" href="GtkTextIter.html#gtk-text-iter-starts-word" title="gtk_text_iter_starts_word ()"><code class="function">gtk_text_iter_starts_word()</code></a> returns <code class="literal">TRUE</code>, then this function
|
||
returns <code class="literal">TRUE</code> too, since <em class="parameter"><code>iter</code></em>
|
||
points to the first character of the word.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-inside-word.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-inside-word.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if <em class="parameter"><code>iter</code></em>
|
||
is inside a word</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-starts-line"></a><h3>gtk_text_iter_starts_line ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_iter_starts_line (<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>);</pre>
|
||
<p>Returns <code class="literal">TRUE</code> if <em class="parameter"><code>iter</code></em>
|
||
begins a paragraph,
|
||
i.e. if <a class="link" href="GtkTextIter.html#gtk-text-iter-get-line-offset" title="gtk_text_iter_get_line_offset ()"><code class="function">gtk_text_iter_get_line_offset()</code></a> would return 0.
|
||
However this function is potentially more efficient than
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-get-line-offset" title="gtk_text_iter_get_line_offset ()"><code class="function">gtk_text_iter_get_line_offset()</code></a> because it doesn’t have to compute
|
||
the offset, it just has to see whether it’s 0.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-starts-line.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>an iterator</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-starts-line.returns"></a><h4>Returns</h4>
|
||
<p> whether <em class="parameter"><code>iter</code></em>
|
||
begins a line</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-ends-line"></a><h3>gtk_text_iter_ends_line ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_iter_ends_line (<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>);</pre>
|
||
<p>Returns <code class="literal">TRUE</code> if <em class="parameter"><code>iter</code></em>
|
||
points to the start of the paragraph
|
||
delimiter characters for a line (delimiters will be either a
|
||
newline, a carriage return, a carriage return followed by a
|
||
newline, or a Unicode paragraph separator character). Note that an
|
||
iterator pointing to the \n of a \r\n pair will not be counted as
|
||
the end of a line, the line ends before the \r. The end iterator is
|
||
considered to be at the end of a line, even though there are no
|
||
paragraph delimiter chars there.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-ends-line.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>an iterator</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-ends-line.returns"></a><h4>Returns</h4>
|
||
<p> whether <em class="parameter"><code>iter</code></em>
|
||
is at the end of a line</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-starts-sentence"></a><h3>gtk_text_iter_starts_sentence ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_iter_starts_sentence (<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>);</pre>
|
||
<p>Determines whether <em class="parameter"><code>iter</code></em>
|
||
begins a sentence. Sentence boundaries are
|
||
determined by Pango and should be correct for nearly any language
|
||
(if not, the correct fix would be to the Pango text boundary
|
||
algorithms).</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-starts-sentence.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-starts-sentence.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if <em class="parameter"><code>iter</code></em>
|
||
is at the start of a sentence.</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-ends-sentence"></a><h3>gtk_text_iter_ends_sentence ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_iter_ends_sentence (<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>);</pre>
|
||
<p>Determines whether <em class="parameter"><code>iter</code></em>
|
||
ends a sentence. Sentence boundaries are
|
||
determined by Pango and should be correct for nearly any language
|
||
(if not, the correct fix would be to the Pango text boundary
|
||
algorithms).</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-ends-sentence.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-ends-sentence.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if <em class="parameter"><code>iter</code></em>
|
||
is at the end of a sentence.</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-inside-sentence"></a><h3>gtk_text_iter_inside_sentence ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_iter_inside_sentence (<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>);</pre>
|
||
<p>Determines whether <em class="parameter"><code>iter</code></em>
|
||
is inside a sentence (as opposed to in
|
||
between two sentences, e.g. after a period and before the first
|
||
letter of the next sentence). Sentence boundaries are determined
|
||
by Pango and should be correct for nearly any language (if not, the
|
||
correct fix would be to the Pango text boundary algorithms).</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-inside-sentence.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-inside-sentence.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if <em class="parameter"><code>iter</code></em>
|
||
is inside a sentence.</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-is-cursor-position"></a><h3>gtk_text_iter_is_cursor_position ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_iter_is_cursor_position (<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>);</pre>
|
||
<p>See <a class="link" href="GtkTextIter.html#gtk-text-iter-forward-cursor-position" title="gtk_text_iter_forward_cursor_position ()"><code class="function">gtk_text_iter_forward_cursor_position()</code></a> or <span class="type">PangoLogAttr</span> or
|
||
<code class="function">pango_break()</code> for details on what a cursor position is.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-is-cursor-position.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-is-cursor-position.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if the cursor can be placed at <em class="parameter"><code>iter</code></em>
|
||
</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-get-chars-in-line"></a><h3>gtk_text_iter_get_chars_in_line ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gint</span>
|
||
gtk_text_iter_get_chars_in_line (<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>);</pre>
|
||
<p>Returns the number of characters in the line containing <em class="parameter"><code>iter</code></em>
|
||
,
|
||
including the paragraph delimiters.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-get-chars-in-line.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>an iterator</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-get-chars-in-line.returns"></a><h4>Returns</h4>
|
||
<p> number of characters in the line</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-get-bytes-in-line"></a><h3>gtk_text_iter_get_bytes_in_line ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gint</span>
|
||
gtk_text_iter_get_bytes_in_line (<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>);</pre>
|
||
<p>Returns the number of bytes in the line containing <em class="parameter"><code>iter</code></em>
|
||
,
|
||
including the paragraph delimiters.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-get-bytes-in-line.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>an iterator</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-get-bytes-in-line.returns"></a><h4>Returns</h4>
|
||
<p> number of bytes in the line</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-get-attributes"></a><h3>gtk_text_iter_get_attributes ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_iter_get_attributes (<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextTag.html#GtkTextAttributes" title="struct GtkTextAttributes"><span class="type">GtkTextAttributes</span></a> *values</code></em>);</pre>
|
||
<p>Computes the effect of any tags applied to this spot in the
|
||
text. The <em class="parameter"><code>values</code></em>
|
||
parameter should be initialized to the default
|
||
settings you wish to use if no tags are in effect. You’d typically
|
||
obtain the defaults from <a class="link" href="GtkTextView.html#gtk-text-view-get-default-attributes" title="gtk_text_view_get_default_attributes ()"><code class="function">gtk_text_view_get_default_attributes()</code></a>.</p>
|
||
<p>gtk_text_iter_get_attributes() will modify <em class="parameter"><code>values</code></em>
|
||
, applying the
|
||
effects of any tags present at <em class="parameter"><code>iter</code></em>
|
||
. If any tags affected <em class="parameter"><code>values</code></em>
|
||
,
|
||
the function returns <code class="literal">TRUE</code>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-get-attributes.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>an iterator</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>values</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextTag.html#GtkTextAttributes" title="struct GtkTextAttributes"><span class="type">GtkTextAttributes</span></a> to be filled in. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-get-attributes.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if <em class="parameter"><code>values</code></em>
|
||
was modified</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-get-language"></a><h3>gtk_text_iter_get_language ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">PangoLanguage</span> *
|
||
gtk_text_iter_get_language (<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>);</pre>
|
||
<p>A convenience wrapper around <a class="link" href="GtkTextIter.html#gtk-text-iter-get-attributes" title="gtk_text_iter_get_attributes ()"><code class="function">gtk_text_iter_get_attributes()</code></a>,
|
||
which returns the language in effect at <em class="parameter"><code>iter</code></em>
|
||
. If no tags affecting
|
||
language apply to <em class="parameter"><code>iter</code></em>
|
||
, the return value is identical to that of
|
||
<a class="link" href="gtk3-General.html#gtk-get-default-language" title="gtk_get_default_language ()"><code class="function">gtk_get_default_language()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-get-language.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>an iterator</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-get-language.returns"></a><h4>Returns</h4>
|
||
<p>language in effect at <em class="parameter"><code>iter</code></em>
|
||
. </p>
|
||
<p><span class="annotation">[<acronym title="The caller owns the data, and is responsible for free it."><span class="acronym">transfer full</span></acronym>]</span></p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-is-end"></a><h3>gtk_text_iter_is_end ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_iter_is_end (<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>);</pre>
|
||
<p>Returns <code class="literal">TRUE</code> if <em class="parameter"><code>iter</code></em>
|
||
is the end iterator, i.e. one past the last
|
||
dereferenceable iterator in the buffer. <a class="link" href="GtkTextIter.html#gtk-text-iter-is-end" title="gtk_text_iter_is_end ()"><code class="function">gtk_text_iter_is_end()</code></a> is
|
||
the most efficient way to check whether an iterator is the end
|
||
iterator.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-is-end.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>an iterator</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-is-end.returns"></a><h4>Returns</h4>
|
||
<p> whether <em class="parameter"><code>iter</code></em>
|
||
is the end iterator</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-is-start"></a><h3>gtk_text_iter_is_start ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_iter_is_start (<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>);</pre>
|
||
<p>Returns <code class="literal">TRUE</code> if <em class="parameter"><code>iter</code></em>
|
||
is the first iterator in the buffer, that is
|
||
if <em class="parameter"><code>iter</code></em>
|
||
has a character offset of 0.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-is-start.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>an iterator</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-is-start.returns"></a><h4>Returns</h4>
|
||
<p> whether <em class="parameter"><code>iter</code></em>
|
||
is the first in the buffer</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-forward-char"></a><h3>gtk_text_iter_forward_char ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_iter_forward_char (<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>);</pre>
|
||
<p>Moves <em class="parameter"><code>iter</code></em>
|
||
forward by one character offset. Note that images
|
||
embedded in the buffer occupy 1 character slot, so
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-forward-char" title="gtk_text_iter_forward_char ()"><code class="function">gtk_text_iter_forward_char()</code></a> may actually move onto an image instead
|
||
of a character, if you have images in your buffer. If <em class="parameter"><code>iter</code></em>
|
||
is the
|
||
end iterator or one character before it, <em class="parameter"><code>iter</code></em>
|
||
will now point at
|
||
the end iterator, and <a class="link" href="GtkTextIter.html#gtk-text-iter-forward-char" title="gtk_text_iter_forward_char ()"><code class="function">gtk_text_iter_forward_char()</code></a> returns <code class="literal">FALSE</code> for
|
||
convenience when writing loops.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-forward-char.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>an iterator</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-forward-char.returns"></a><h4>Returns</h4>
|
||
<p> whether <em class="parameter"><code>iter</code></em>
|
||
moved and is dereferenceable</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-backward-char"></a><h3>gtk_text_iter_backward_char ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_iter_backward_char (<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>);</pre>
|
||
<p>Moves backward by one character offset. Returns <code class="literal">TRUE</code> if movement
|
||
was possible; if <em class="parameter"><code>iter</code></em>
|
||
was the first in the buffer (character
|
||
offset 0), <a class="link" href="GtkTextIter.html#gtk-text-iter-backward-char" title="gtk_text_iter_backward_char ()"><code class="function">gtk_text_iter_backward_char()</code></a> returns <code class="literal">FALSE</code> for convenience when
|
||
writing loops.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-backward-char.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>an iterator</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-backward-char.returns"></a><h4>Returns</h4>
|
||
<p> whether movement was possible</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-forward-chars"></a><h3>gtk_text_iter_forward_chars ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_iter_forward_chars (<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> count</code></em>);</pre>
|
||
<p>Moves <em class="parameter"><code>count</code></em>
|
||
characters if possible (if <em class="parameter"><code>count</code></em>
|
||
would move past the
|
||
start or end of the buffer, moves to the start or end of the
|
||
buffer). The return value indicates whether the new position of
|
||
<em class="parameter"><code>iter</code></em>
|
||
is different from its original position, and dereferenceable
|
||
(the last iterator in the buffer is not dereferenceable). If <em class="parameter"><code>count</code></em>
|
||
|
||
is 0, the function does nothing and returns <code class="literal">FALSE</code>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-forward-chars.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>an iterator</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>count</p></td>
|
||
<td class="parameter_description"><p>number of characters to move, may be negative</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-forward-chars.returns"></a><h4>Returns</h4>
|
||
<p> whether <em class="parameter"><code>iter</code></em>
|
||
moved and is dereferenceable</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-backward-chars"></a><h3>gtk_text_iter_backward_chars ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_iter_backward_chars (<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> count</code></em>);</pre>
|
||
<p>Moves <em class="parameter"><code>count</code></em>
|
||
characters backward, if possible (if <em class="parameter"><code>count</code></em>
|
||
would move
|
||
past the start or end of the buffer, moves to the start or end of
|
||
the buffer). The return value indicates whether the iterator moved
|
||
onto a dereferenceable position; if the iterator didn’t move, or
|
||
moved onto the end iterator, then <code class="literal">FALSE</code> is returned. If <em class="parameter"><code>count</code></em>
|
||
is 0,
|
||
the function does nothing and returns <code class="literal">FALSE</code>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-backward-chars.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>an iterator</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>count</p></td>
|
||
<td class="parameter_description"><p>number of characters to move</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-backward-chars.returns"></a><h4>Returns</h4>
|
||
<p> whether <em class="parameter"><code>iter</code></em>
|
||
moved and is dereferenceable</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-forward-line"></a><h3>gtk_text_iter_forward_line ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_iter_forward_line (<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>);</pre>
|
||
<p>Moves <em class="parameter"><code>iter</code></em>
|
||
to the start of the next line. If the iter is already on the
|
||
last line of the buffer, moves the iter to the end of the current line.
|
||
If after the operation, the iter is at the end of the buffer and not
|
||
dereferencable, returns <code class="literal">FALSE</code>. Otherwise, returns <code class="literal">TRUE</code>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-forward-line.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>an iterator</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-forward-line.returns"></a><h4>Returns</h4>
|
||
<p> whether <em class="parameter"><code>iter</code></em>
|
||
can be dereferenced</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-backward-line"></a><h3>gtk_text_iter_backward_line ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_iter_backward_line (<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>);</pre>
|
||
<p>Moves <em class="parameter"><code>iter</code></em>
|
||
to the start of the previous line. Returns <code class="literal">TRUE</code> if
|
||
<em class="parameter"><code>iter</code></em>
|
||
could be moved; i.e. if <em class="parameter"><code>iter</code></em>
|
||
was at character offset 0, this
|
||
function returns <code class="literal">FALSE</code>. Therefore if <em class="parameter"><code>iter</code></em>
|
||
was already on line 0,
|
||
but not at the start of the line, <em class="parameter"><code>iter</code></em>
|
||
is snapped to the start of
|
||
the line and the function returns <code class="literal">TRUE</code>. (Note that this implies that
|
||
in a loop calling this function, the line number may not change on
|
||
every iteration, if your first iteration is on line 0.)</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-backward-line.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>an iterator</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-backward-line.returns"></a><h4>Returns</h4>
|
||
<p> whether <em class="parameter"><code>iter</code></em>
|
||
moved</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-forward-lines"></a><h3>gtk_text_iter_forward_lines ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_iter_forward_lines (<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> count</code></em>);</pre>
|
||
<p>Moves <em class="parameter"><code>count</code></em>
|
||
lines forward, if possible (if <em class="parameter"><code>count</code></em>
|
||
would move
|
||
past the start or end of the buffer, moves to the start or end of
|
||
the buffer). The return value indicates whether the iterator moved
|
||
onto a dereferenceable position; if the iterator didn’t move, or
|
||
moved onto the end iterator, then <code class="literal">FALSE</code> is returned. If <em class="parameter"><code>count</code></em>
|
||
is 0,
|
||
the function does nothing and returns <code class="literal">FALSE</code>. If <em class="parameter"><code>count</code></em>
|
||
is negative,
|
||
moves backward by 0 - <em class="parameter"><code>count</code></em>
|
||
lines.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-forward-lines.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>count</p></td>
|
||
<td class="parameter_description"><p>number of lines to move forward</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-forward-lines.returns"></a><h4>Returns</h4>
|
||
<p> whether <em class="parameter"><code>iter</code></em>
|
||
moved and is dereferenceable</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-backward-lines"></a><h3>gtk_text_iter_backward_lines ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_iter_backward_lines (<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> count</code></em>);</pre>
|
||
<p>Moves <em class="parameter"><code>count</code></em>
|
||
lines backward, if possible (if <em class="parameter"><code>count</code></em>
|
||
would move
|
||
past the start or end of the buffer, moves to the start or end of
|
||
the buffer). The return value indicates whether the iterator moved
|
||
onto a dereferenceable position; if the iterator didn’t move, or
|
||
moved onto the end iterator, then <code class="literal">FALSE</code> is returned. If <em class="parameter"><code>count</code></em>
|
||
is 0,
|
||
the function does nothing and returns <code class="literal">FALSE</code>. If <em class="parameter"><code>count</code></em>
|
||
is negative,
|
||
moves forward by 0 - <em class="parameter"><code>count</code></em>
|
||
lines.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-backward-lines.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>count</p></td>
|
||
<td class="parameter_description"><p>number of lines to move backward</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-backward-lines.returns"></a><h4>Returns</h4>
|
||
<p> whether <em class="parameter"><code>iter</code></em>
|
||
moved and is dereferenceable</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-forward-word-ends"></a><h3>gtk_text_iter_forward_word_ends ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_iter_forward_word_ends (<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> count</code></em>);</pre>
|
||
<p>Calls <a class="link" href="GtkTextIter.html#gtk-text-iter-forward-word-end" title="gtk_text_iter_forward_word_end ()"><code class="function">gtk_text_iter_forward_word_end()</code></a> up to <em class="parameter"><code>count</code></em>
|
||
times.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-forward-word-ends.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>count</p></td>
|
||
<td class="parameter_description"><p>number of times to move</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-forward-word-ends.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if <em class="parameter"><code>iter</code></em>
|
||
moved and is not the end iterator </p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-backward-word-starts"></a><h3>gtk_text_iter_backward_word_starts ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_iter_backward_word_starts (<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> count</code></em>);</pre>
|
||
<p>Calls <a class="link" href="GtkTextIter.html#gtk-text-iter-backward-word-start" title="gtk_text_iter_backward_word_start ()"><code class="function">gtk_text_iter_backward_word_start()</code></a> up to <em class="parameter"><code>count</code></em>
|
||
times.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-backward-word-starts.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>count</p></td>
|
||
<td class="parameter_description"><p>number of times to move</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-backward-word-starts.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if <em class="parameter"><code>iter</code></em>
|
||
moved and is not the end iterator </p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-forward-word-end"></a><h3>gtk_text_iter_forward_word_end ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_iter_forward_word_end (<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>);</pre>
|
||
<p>Moves forward to the next word end. (If <em class="parameter"><code>iter</code></em>
|
||
is currently on a
|
||
word end, moves forward to the next one after that.) Word breaks
|
||
are determined by Pango and should be correct for nearly any
|
||
language (if not, the correct fix would be to the Pango word break
|
||
algorithms).</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-forward-word-end.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-forward-word-end.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if <em class="parameter"><code>iter</code></em>
|
||
moved and is not the end iterator </p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-backward-word-start"></a><h3>gtk_text_iter_backward_word_start ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_iter_backward_word_start (<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>);</pre>
|
||
<p>Moves backward to the previous word start. (If <em class="parameter"><code>iter</code></em>
|
||
is currently on a
|
||
word start, moves backward to the next one after that.) Word breaks
|
||
are determined by Pango and should be correct for nearly any
|
||
language (if not, the correct fix would be to the Pango word break
|
||
algorithms).</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-backward-word-start.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-backward-word-start.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if <em class="parameter"><code>iter</code></em>
|
||
moved and is not the end iterator </p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-forward-cursor-position"></a><h3>gtk_text_iter_forward_cursor_position ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_iter_forward_cursor_position (<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>);</pre>
|
||
<p>Moves <em class="parameter"><code>iter</code></em>
|
||
forward by a single cursor position. Cursor positions
|
||
are (unsurprisingly) positions where the cursor can appear. Perhaps
|
||
surprisingly, there may not be a cursor position between all
|
||
characters. The most common example for European languages would be
|
||
a carriage return/newline sequence. For some Unicode characters,
|
||
the equivalent of say the letter “a” with an accent mark will be
|
||
represented as two characters, first the letter then a "combining
|
||
mark" that causes the accent to be rendered; so the cursor can’t go
|
||
between those two characters. See also the <span class="type">PangoLogAttr</span> and
|
||
<code class="function">pango_break()</code> function.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-forward-cursor-position.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-forward-cursor-position.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if we moved and the new position is dereferenceable</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-backward-cursor-position"></a><h3>gtk_text_iter_backward_cursor_position ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_iter_backward_cursor_position
|
||
(<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>);</pre>
|
||
<p>Like <a class="link" href="GtkTextIter.html#gtk-text-iter-forward-cursor-position" title="gtk_text_iter_forward_cursor_position ()"><code class="function">gtk_text_iter_forward_cursor_position()</code></a>, but moves backward.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-backward-cursor-position.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-backward-cursor-position.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if we moved</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-forward-cursor-positions"></a><h3>gtk_text_iter_forward_cursor_positions ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_iter_forward_cursor_positions
|
||
(<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> count</code></em>);</pre>
|
||
<p>Moves up to <em class="parameter"><code>count</code></em>
|
||
cursor positions. See
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-forward-cursor-position" title="gtk_text_iter_forward_cursor_position ()"><code class="function">gtk_text_iter_forward_cursor_position()</code></a> for details.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-forward-cursor-positions.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>count</p></td>
|
||
<td class="parameter_description"><p>number of positions to move</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-forward-cursor-positions.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if we moved and the new position is dereferenceable</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-backward-cursor-positions"></a><h3>gtk_text_iter_backward_cursor_positions ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_iter_backward_cursor_positions
|
||
(<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> count</code></em>);</pre>
|
||
<p>Moves up to <em class="parameter"><code>count</code></em>
|
||
cursor positions. See
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-forward-cursor-position" title="gtk_text_iter_forward_cursor_position ()"><code class="function">gtk_text_iter_forward_cursor_position()</code></a> for details.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-backward-cursor-positions.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>count</p></td>
|
||
<td class="parameter_description"><p>number of positions to move</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-backward-cursor-positions.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if we moved and the new position is dereferenceable</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-backward-sentence-start"></a><h3>gtk_text_iter_backward_sentence_start ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_iter_backward_sentence_start (<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>);</pre>
|
||
<p>Moves backward to the previous sentence start; if <em class="parameter"><code>iter</code></em>
|
||
is already at
|
||
the start of a sentence, moves backward to the next one. Sentence
|
||
boundaries are determined by Pango and should be correct for nearly
|
||
any language (if not, the correct fix would be to the Pango text
|
||
boundary algorithms).</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-backward-sentence-start.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-backward-sentence-start.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if <em class="parameter"><code>iter</code></em>
|
||
moved and is not the end iterator</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-backward-sentence-starts"></a><h3>gtk_text_iter_backward_sentence_starts ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_iter_backward_sentence_starts
|
||
(<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> count</code></em>);</pre>
|
||
<p>Calls <a class="link" href="GtkTextIter.html#gtk-text-iter-backward-sentence-start" title="gtk_text_iter_backward_sentence_start ()"><code class="function">gtk_text_iter_backward_sentence_start()</code></a> up to <em class="parameter"><code>count</code></em>
|
||
times,
|
||
or until it returns <code class="literal">FALSE</code>. If <em class="parameter"><code>count</code></em>
|
||
is negative, moves forward
|
||
instead of backward.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-backward-sentence-starts.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>count</p></td>
|
||
<td class="parameter_description"><p>number of sentences to move</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-backward-sentence-starts.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if <em class="parameter"><code>iter</code></em>
|
||
moved and is not the end iterator</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-forward-sentence-end"></a><h3>gtk_text_iter_forward_sentence_end ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_iter_forward_sentence_end (<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>);</pre>
|
||
<p>Moves forward to the next sentence end. (If <em class="parameter"><code>iter</code></em>
|
||
is at the end of
|
||
a sentence, moves to the next end of sentence.) Sentence
|
||
boundaries are determined by Pango and should be correct for nearly
|
||
any language (if not, the correct fix would be to the Pango text
|
||
boundary algorithms).</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-forward-sentence-end.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-forward-sentence-end.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if <em class="parameter"><code>iter</code></em>
|
||
moved and is not the end iterator</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-forward-sentence-ends"></a><h3>gtk_text_iter_forward_sentence_ends ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_iter_forward_sentence_ends (<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> count</code></em>);</pre>
|
||
<p>Calls <a class="link" href="GtkTextIter.html#gtk-text-iter-forward-sentence-end" title="gtk_text_iter_forward_sentence_end ()"><code class="function">gtk_text_iter_forward_sentence_end()</code></a> <em class="parameter"><code>count</code></em>
|
||
times (or until
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-forward-sentence-end" title="gtk_text_iter_forward_sentence_end ()"><code class="function">gtk_text_iter_forward_sentence_end()</code></a> returns <code class="literal">FALSE</code>). If <em class="parameter"><code>count</code></em>
|
||
is
|
||
negative, moves backward instead of forward.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-forward-sentence-ends.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>count</p></td>
|
||
<td class="parameter_description"><p>number of sentences to move</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-forward-sentence-ends.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if <em class="parameter"><code>iter</code></em>
|
||
moved and is not the end iterator</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-forward-visible-word-ends"></a><h3>gtk_text_iter_forward_visible_word_ends ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_iter_forward_visible_word_ends
|
||
(<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> count</code></em>);</pre>
|
||
<p>Calls <a class="link" href="GtkTextIter.html#gtk-text-iter-forward-visible-word-end" title="gtk_text_iter_forward_visible_word_end ()"><code class="function">gtk_text_iter_forward_visible_word_end()</code></a> up to <em class="parameter"><code>count</code></em>
|
||
times.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-forward-visible-word-ends.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>count</p></td>
|
||
<td class="parameter_description"><p>number of times to move</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-forward-visible-word-ends.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if <em class="parameter"><code>iter</code></em>
|
||
moved and is not the end iterator </p>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-backward-visible-word-starts"></a><h3>gtk_text_iter_backward_visible_word_starts ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_iter_backward_visible_word_starts
|
||
(<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> count</code></em>);</pre>
|
||
<p>Calls <a class="link" href="GtkTextIter.html#gtk-text-iter-backward-visible-word-start" title="gtk_text_iter_backward_visible_word_start ()"><code class="function">gtk_text_iter_backward_visible_word_start()</code></a> up to <em class="parameter"><code>count</code></em>
|
||
times.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-backward-visible-word-starts.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>count</p></td>
|
||
<td class="parameter_description"><p>number of times to move</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-backward-visible-word-starts.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if <em class="parameter"><code>iter</code></em>
|
||
moved and is not the end iterator </p>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-forward-visible-word-end"></a><h3>gtk_text_iter_forward_visible_word_end ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_iter_forward_visible_word_end
|
||
(<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>);</pre>
|
||
<p>Moves forward to the next visible word end. (If <em class="parameter"><code>iter</code></em>
|
||
is currently on a
|
||
word end, moves forward to the next one after that.) Word breaks
|
||
are determined by Pango and should be correct for nearly any
|
||
language (if not, the correct fix would be to the Pango word break
|
||
algorithms).</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-forward-visible-word-end.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-forward-visible-word-end.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if <em class="parameter"><code>iter</code></em>
|
||
moved and is not the end iterator </p>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-backward-visible-word-start"></a><h3>gtk_text_iter_backward_visible_word_start ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_iter_backward_visible_word_start
|
||
(<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>);</pre>
|
||
<p>Moves backward to the previous visible word start. (If <em class="parameter"><code>iter</code></em>
|
||
is currently
|
||
on a word start, moves backward to the next one after that.) Word breaks
|
||
are determined by Pango and should be correct for nearly any
|
||
language (if not, the correct fix would be to the Pango word break
|
||
algorithms).</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-backward-visible-word-start.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-backward-visible-word-start.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if <em class="parameter"><code>iter</code></em>
|
||
moved and is not the end iterator </p>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-forward-visible-cursor-position"></a><h3>gtk_text_iter_forward_visible_cursor_position ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_iter_forward_visible_cursor_position
|
||
(<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>);</pre>
|
||
<p>Moves <em class="parameter"><code>iter</code></em>
|
||
forward to the next visible cursor position. See
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-forward-cursor-position" title="gtk_text_iter_forward_cursor_position ()"><code class="function">gtk_text_iter_forward_cursor_position()</code></a> for details.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-forward-visible-cursor-position.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-forward-visible-cursor-position.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if we moved and the new position is dereferenceable</p>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-backward-visible-cursor-position"></a><h3>gtk_text_iter_backward_visible_cursor_position ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_iter_backward_visible_cursor_position
|
||
(<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>);</pre>
|
||
<p>Moves <em class="parameter"><code>iter</code></em>
|
||
forward to the previous visible cursor position. See
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-backward-cursor-position" title="gtk_text_iter_backward_cursor_position ()"><code class="function">gtk_text_iter_backward_cursor_position()</code></a> for details.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-backward-visible-cursor-position.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-backward-visible-cursor-position.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if we moved and the new position is dereferenceable</p>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-forward-visible-cursor-positions"></a><h3>gtk_text_iter_forward_visible_cursor_positions ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_iter_forward_visible_cursor_positions
|
||
(<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> count</code></em>);</pre>
|
||
<p>Moves up to <em class="parameter"><code>count</code></em>
|
||
visible cursor positions. See
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-forward-cursor-position" title="gtk_text_iter_forward_cursor_position ()"><code class="function">gtk_text_iter_forward_cursor_position()</code></a> for details.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-forward-visible-cursor-positions.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>count</p></td>
|
||
<td class="parameter_description"><p>number of positions to move</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-forward-visible-cursor-positions.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if we moved and the new position is dereferenceable</p>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-backward-visible-cursor-positions"></a><h3>gtk_text_iter_backward_visible_cursor_positions ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_iter_backward_visible_cursor_positions
|
||
(<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> count</code></em>);</pre>
|
||
<p>Moves up to <em class="parameter"><code>count</code></em>
|
||
visible cursor positions. See
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-backward-cursor-position" title="gtk_text_iter_backward_cursor_position ()"><code class="function">gtk_text_iter_backward_cursor_position()</code></a> for details.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-backward-visible-cursor-positions.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>count</p></td>
|
||
<td class="parameter_description"><p>number of positions to move</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-backward-visible-cursor-positions.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if we moved and the new position is dereferenceable</p>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-forward-visible-line"></a><h3>gtk_text_iter_forward_visible_line ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_iter_forward_visible_line (<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>);</pre>
|
||
<p>Moves <em class="parameter"><code>iter</code></em>
|
||
to the start of the next visible line. Returns <code class="literal">TRUE</code> if there
|
||
was a next line to move to, and <code class="literal">FALSE</code> if <em class="parameter"><code>iter</code></em>
|
||
was simply moved to
|
||
the end of the buffer and is now not dereferenceable, or if <em class="parameter"><code>iter</code></em>
|
||
was
|
||
already at the end of the buffer.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-forward-visible-line.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>an iterator</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-forward-visible-line.returns"></a><h4>Returns</h4>
|
||
<p> whether <em class="parameter"><code>iter</code></em>
|
||
can be dereferenced</p>
|
||
</div>
|
||
<p class="since">Since: 2.8</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-backward-visible-line"></a><h3>gtk_text_iter_backward_visible_line ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_iter_backward_visible_line (<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>);</pre>
|
||
<p>Moves <em class="parameter"><code>iter</code></em>
|
||
to the start of the previous visible line. Returns <code class="literal">TRUE</code> if
|
||
<em class="parameter"><code>iter</code></em>
|
||
could be moved; i.e. if <em class="parameter"><code>iter</code></em>
|
||
was at character offset 0, this
|
||
function returns <code class="literal">FALSE</code>. Therefore if <em class="parameter"><code>iter</code></em>
|
||
was already on line 0,
|
||
but not at the start of the line, <em class="parameter"><code>iter</code></em>
|
||
is snapped to the start of
|
||
the line and the function returns <code class="literal">TRUE</code>. (Note that this implies that
|
||
in a loop calling this function, the line number may not change on
|
||
every iteration, if your first iteration is on line 0.)</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-backward-visible-line.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>an iterator</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-backward-visible-line.returns"></a><h4>Returns</h4>
|
||
<p> whether <em class="parameter"><code>iter</code></em>
|
||
moved</p>
|
||
</div>
|
||
<p class="since">Since: 2.8</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-forward-visible-lines"></a><h3>gtk_text_iter_forward_visible_lines ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_iter_forward_visible_lines (<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> count</code></em>);</pre>
|
||
<p>Moves <em class="parameter"><code>count</code></em>
|
||
visible lines forward, if possible (if <em class="parameter"><code>count</code></em>
|
||
would move
|
||
past the start or end of the buffer, moves to the start or end of
|
||
the buffer). The return value indicates whether the iterator moved
|
||
onto a dereferenceable position; if the iterator didn’t move, or
|
||
moved onto the end iterator, then <code class="literal">FALSE</code> is returned. If <em class="parameter"><code>count</code></em>
|
||
is 0,
|
||
the function does nothing and returns <code class="literal">FALSE</code>. If <em class="parameter"><code>count</code></em>
|
||
is negative,
|
||
moves backward by 0 - <em class="parameter"><code>count</code></em>
|
||
lines.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-forward-visible-lines.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>count</p></td>
|
||
<td class="parameter_description"><p>number of lines to move forward</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-forward-visible-lines.returns"></a><h4>Returns</h4>
|
||
<p> whether <em class="parameter"><code>iter</code></em>
|
||
moved and is dereferenceable</p>
|
||
</div>
|
||
<p class="since">Since: 2.8</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-backward-visible-lines"></a><h3>gtk_text_iter_backward_visible_lines ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_iter_backward_visible_lines (<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> count</code></em>);</pre>
|
||
<p>Moves <em class="parameter"><code>count</code></em>
|
||
visible lines backward, if possible (if <em class="parameter"><code>count</code></em>
|
||
would move
|
||
past the start or end of the buffer, moves to the start or end of
|
||
the buffer). The return value indicates whether the iterator moved
|
||
onto a dereferenceable position; if the iterator didn’t move, or
|
||
moved onto the end iterator, then <code class="literal">FALSE</code> is returned. If <em class="parameter"><code>count</code></em>
|
||
is 0,
|
||
the function does nothing and returns <code class="literal">FALSE</code>. If <em class="parameter"><code>count</code></em>
|
||
is negative,
|
||
moves forward by 0 - <em class="parameter"><code>count</code></em>
|
||
lines.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-backward-visible-lines.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>count</p></td>
|
||
<td class="parameter_description"><p>number of lines to move backward</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-backward-visible-lines.returns"></a><h4>Returns</h4>
|
||
<p> whether <em class="parameter"><code>iter</code></em>
|
||
moved and is dereferenceable</p>
|
||
</div>
|
||
<p class="since">Since: 2.8</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-set-offset"></a><h3>gtk_text_iter_set_offset ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_text_iter_set_offset (<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> char_offset</code></em>);</pre>
|
||
<p>Sets <em class="parameter"><code>iter</code></em>
|
||
to point to <em class="parameter"><code>char_offset</code></em>
|
||
. <em class="parameter"><code>char_offset</code></em>
|
||
counts from the start
|
||
of the entire text buffer, starting with 0.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-set-offset.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>char_offset</p></td>
|
||
<td class="parameter_description"><p>a character number</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-set-line"></a><h3>gtk_text_iter_set_line ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_text_iter_set_line (<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> line_number</code></em>);</pre>
|
||
<p>Moves iterator <em class="parameter"><code>iter</code></em>
|
||
to the start of the line <em class="parameter"><code>line_number</code></em>
|
||
. If
|
||
<em class="parameter"><code>line_number</code></em>
|
||
is negative or larger than the number of lines in the
|
||
buffer, moves <em class="parameter"><code>iter</code></em>
|
||
to the start of the last line in the buffer.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-set-line.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>line_number</p></td>
|
||
<td class="parameter_description"><p>line number (counted from 0)</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-set-line-offset"></a><h3>gtk_text_iter_set_line_offset ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_text_iter_set_line_offset (<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> char_on_line</code></em>);</pre>
|
||
<p>Moves <em class="parameter"><code>iter</code></em>
|
||
within a line, to a new character
|
||
(not byte) offset. The given character offset must be less than or
|
||
equal to the number of characters in the line; if equal, <em class="parameter"><code>iter</code></em>
|
||
|
||
moves to the start of the next line. See
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-set-line-index" title="gtk_text_iter_set_line_index ()"><code class="function">gtk_text_iter_set_line_index()</code></a> if you have a byte index rather than
|
||
a character offset.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-set-line-offset.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> </p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>char_on_line</p></td>
|
||
<td class="parameter_description"><p>a character offset relative to the start of <em class="parameter"><code>iter</code></em>
|
||
’s current line</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-set-line-index"></a><h3>gtk_text_iter_set_line_index ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_text_iter_set_line_index (<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> byte_on_line</code></em>);</pre>
|
||
<p>Same as <a class="link" href="GtkTextIter.html#gtk-text-iter-set-line-offset" title="gtk_text_iter_set_line_offset ()"><code class="function">gtk_text_iter_set_line_offset()</code></a>, but works with a
|
||
byte index. The given byte index must be at
|
||
the start of a character, it can’t be in the middle of a UTF-8
|
||
encoded character.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-set-line-index.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>byte_on_line</p></td>
|
||
<td class="parameter_description"><p>a byte index relative to the start of <em class="parameter"><code>iter</code></em>
|
||
’s current line</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-set-visible-line-index"></a><h3>gtk_text_iter_set_visible_line_index ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_text_iter_set_visible_line_index (<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> byte_on_line</code></em>);</pre>
|
||
<p>Like <a class="link" href="GtkTextIter.html#gtk-text-iter-set-line-index" title="gtk_text_iter_set_line_index ()"><code class="function">gtk_text_iter_set_line_index()</code></a>, but the index is in visible
|
||
bytes, i.e. text with a tag making it invisible is not counted
|
||
in the index.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-set-visible-line-index.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>byte_on_line</p></td>
|
||
<td class="parameter_description"><p>a byte index</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-set-visible-line-offset"></a><h3>gtk_text_iter_set_visible_line_offset ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_text_iter_set_visible_line_offset (<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> char_on_line</code></em>);</pre>
|
||
<p>Like <a class="link" href="GtkTextIter.html#gtk-text-iter-set-line-offset" title="gtk_text_iter_set_line_offset ()"><code class="function">gtk_text_iter_set_line_offset()</code></a>, but the offset is in visible
|
||
characters, i.e. text with a tag making it invisible is not
|
||
counted in the offset.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-set-visible-line-offset.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>char_on_line</p></td>
|
||
<td class="parameter_description"><p>a character offset</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-forward-to-end"></a><h3>gtk_text_iter_forward_to_end ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_text_iter_forward_to_end (<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>);</pre>
|
||
<p>Moves <em class="parameter"><code>iter</code></em>
|
||
forward to the “end iterator,” which points one past the last
|
||
valid character in the buffer. <a class="link" href="GtkTextIter.html#gtk-text-iter-get-char" title="gtk_text_iter_get_char ()"><code class="function">gtk_text_iter_get_char()</code></a> called on the
|
||
end iterator returns 0, which is convenient for writing loops.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-forward-to-end.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-forward-to-line-end"></a><h3>gtk_text_iter_forward_to_line_end ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_iter_forward_to_line_end (<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>);</pre>
|
||
<p>Moves the iterator to point to the paragraph delimiter characters,
|
||
which will be either a newline, a carriage return, a carriage
|
||
return/newline in sequence, or the Unicode paragraph separator
|
||
character. If the iterator is already at the paragraph delimiter
|
||
characters, moves to the paragraph delimiter characters for the
|
||
next line. If <em class="parameter"><code>iter</code></em>
|
||
is on the last line in the buffer, which does
|
||
not end in paragraph delimiters, moves to the end iterator (end of
|
||
the last line), and returns <code class="literal">FALSE</code>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-forward-to-line-end.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-forward-to-line-end.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if we moved and the new location is not the end iterator</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-forward-to-tag-toggle"></a><h3>gtk_text_iter_forward_to_tag_toggle ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_iter_forward_to_tag_toggle (<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextTag.html" title="GtkTextTag"><span class="type">GtkTextTag</span></a> *tag</code></em>);</pre>
|
||
<p>Moves forward to the next toggle (on or off) of the
|
||
<a class="link" href="GtkTextTag.html" title="GtkTextTag"><span class="type">GtkTextTag</span></a> <em class="parameter"><code>tag</code></em>
|
||
, or to the next toggle of any tag if
|
||
<em class="parameter"><code>tag</code></em>
|
||
is <code class="literal">NULL</code>. If no matching tag toggles are found,
|
||
returns <code class="literal">FALSE</code>, otherwise <code class="literal">TRUE</code>. Does not return toggles
|
||
located at <em class="parameter"><code>iter</code></em>
|
||
, only toggles after <em class="parameter"><code>iter</code></em>
|
||
. Sets <em class="parameter"><code>iter</code></em>
|
||
to
|
||
the location of the toggle, or to the end of the buffer
|
||
if no toggle is found.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-forward-to-tag-toggle.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>tag</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextTag.html" title="GtkTextTag"><span class="type">GtkTextTag</span></a>, or <code class="literal">NULL</code>. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-forward-to-tag-toggle.returns"></a><h4>Returns</h4>
|
||
<p> whether we found a tag toggle after <em class="parameter"><code>iter</code></em>
|
||
</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-backward-to-tag-toggle"></a><h3>gtk_text_iter_backward_to_tag_toggle ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_iter_backward_to_tag_toggle (<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextTag.html" title="GtkTextTag"><span class="type">GtkTextTag</span></a> *tag</code></em>);</pre>
|
||
<p>Moves backward to the next toggle (on or off) of the
|
||
<a class="link" href="GtkTextTag.html" title="GtkTextTag"><span class="type">GtkTextTag</span></a> <em class="parameter"><code>tag</code></em>
|
||
, or to the next toggle of any tag if
|
||
<em class="parameter"><code>tag</code></em>
|
||
is <code class="literal">NULL</code>. If no matching tag toggles are found,
|
||
returns <code class="literal">FALSE</code>, otherwise <code class="literal">TRUE</code>. Does not return toggles
|
||
located at <em class="parameter"><code>iter</code></em>
|
||
, only toggles before <em class="parameter"><code>iter</code></em>
|
||
. Sets <em class="parameter"><code>iter</code></em>
|
||
|
||
to the location of the toggle, or the start of the buffer
|
||
if no toggle is found.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-backward-to-tag-toggle.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>tag</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextTag.html" title="GtkTextTag"><span class="type">GtkTextTag</span></a>, or <code class="literal">NULL</code>. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-backward-to-tag-toggle.returns"></a><h4>Returns</h4>
|
||
<p> whether we found a tag toggle before <em class="parameter"><code>iter</code></em>
|
||
</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkTextCharPredicate"></a><h3>GtkTextCharPredicate ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
<span class="c_punctuation">(</span>*GtkTextCharPredicate<span class="c_punctuation">)</span> (<em class="parameter"><code><span class="type">gunichar</span> ch</code></em>,
|
||
<em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-forward-find-char"></a><h3>gtk_text_iter_forward_find_char ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_iter_forward_find_char (<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextIter.html#GtkTextCharPredicate" title="GtkTextCharPredicate ()"><span class="type">GtkTextCharPredicate</span></a> pred</code></em>,
|
||
<em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>,
|
||
<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *limit</code></em>);</pre>
|
||
<p>Advances <em class="parameter"><code>iter</code></em>
|
||
, calling <em class="parameter"><code>pred</code></em>
|
||
on each character. If
|
||
<em class="parameter"><code>pred</code></em>
|
||
returns <code class="literal">TRUE</code>, returns <code class="literal">TRUE</code> and stops scanning.
|
||
If <em class="parameter"><code>pred</code></em>
|
||
never returns <code class="literal">TRUE</code>, <em class="parameter"><code>iter</code></em>
|
||
is set to <em class="parameter"><code>limit</code></em>
|
||
if
|
||
<em class="parameter"><code>limit</code></em>
|
||
is non-<code class="literal">NULL</code>, otherwise to the end iterator.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-forward-find-char.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>pred</p></td>
|
||
<td class="parameter_description"><p>a function to be called on each character. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid only during the call to the method."><span class="acronym">scope call</span></acronym>]</span></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>user_data</p></td>
|
||
<td class="parameter_description"><p>user data for <em class="parameter"><code>pred</code></em>
|
||
</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>limit</p></td>
|
||
<td class="parameter_description"><p>search limit, or <code class="literal">NULL</code> for none. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-forward-find-char.returns"></a><h4>Returns</h4>
|
||
<p> whether a match was found</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-backward-find-char"></a><h3>gtk_text_iter_backward_find_char ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_iter_backward_find_char (<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextIter.html#GtkTextCharPredicate" title="GtkTextCharPredicate ()"><span class="type">GtkTextCharPredicate</span></a> pred</code></em>,
|
||
<em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>,
|
||
<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *limit</code></em>);</pre>
|
||
<p>Same as <a class="link" href="GtkTextIter.html#gtk-text-iter-forward-find-char" title="gtk_text_iter_forward_find_char ()"><code class="function">gtk_text_iter_forward_find_char()</code></a>, but goes backward from <em class="parameter"><code>iter</code></em>
|
||
.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-backward-find-char.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>pred</p></td>
|
||
<td class="parameter_description"><p>function to be called on each character. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid only during the call to the method."><span class="acronym">scope call</span></acronym>]</span></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>user_data</p></td>
|
||
<td class="parameter_description"><p>user data for <em class="parameter"><code>pred</code></em>
|
||
</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>limit</p></td>
|
||
<td class="parameter_description"><p>search limit, or <code class="literal">NULL</code> for none. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-backward-find-char.returns"></a><h4>Returns</h4>
|
||
<p> whether a match was found</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-forward-search"></a><h3>gtk_text_iter_forward_search ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_iter_forward_search (<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
|
||
<em class="parameter"><code>const <span class="type">gchar</span> *str</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextIter.html#GtkTextSearchFlags" title="enum GtkTextSearchFlags"><span class="type">GtkTextSearchFlags</span></a> flags</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *match_start</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *match_end</code></em>,
|
||
<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *limit</code></em>);</pre>
|
||
<p>Searches forward for <em class="parameter"><code>str</code></em>
|
||
. Any match is returned by setting
|
||
<em class="parameter"><code>match_start</code></em>
|
||
to the first character of the match and <em class="parameter"><code>match_end</code></em>
|
||
to the
|
||
first character after the match. The search will not continue past
|
||
<em class="parameter"><code>limit</code></em>
|
||
. Note that a search is a linear or O(n) operation, so you
|
||
may wish to use <em class="parameter"><code>limit</code></em>
|
||
to avoid locking up your UI on large
|
||
buffers.</p>
|
||
<p><em class="parameter"><code>match_start</code></em>
|
||
will never be set to a <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> located before <em class="parameter"><code>iter</code></em>
|
||
, even if
|
||
there is a possible <em class="parameter"><code>match_end</code></em>
|
||
after or at <em class="parameter"><code>iter</code></em>
|
||
.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-forward-search.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>start of search</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>str</p></td>
|
||
<td class="parameter_description"><p>a search string</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>flags</p></td>
|
||
<td class="parameter_description"><p>flags affecting how the search is done</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>match_start</p></td>
|
||
<td class="parameter_description"><p>return location for start of match, or <code class="literal">NULL</code>. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="Out parameter, where caller must allocate storage."><span class="acronym">out caller-allocates</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>match_end</p></td>
|
||
<td class="parameter_description"><p>return location for end of match, or <code class="literal">NULL</code>. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="Out parameter, where caller must allocate storage."><span class="acronym">out caller-allocates</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>limit</p></td>
|
||
<td class="parameter_description"><p>location of last possible <em class="parameter"><code>match_end</code></em>
|
||
, or <code class="literal">NULL</code> for the end of the buffer. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-forward-search.returns"></a><h4>Returns</h4>
|
||
<p> whether a match was found</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-backward-search"></a><h3>gtk_text_iter_backward_search ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_iter_backward_search (<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
|
||
<em class="parameter"><code>const <span class="type">gchar</span> *str</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextIter.html#GtkTextSearchFlags" title="enum GtkTextSearchFlags"><span class="type">GtkTextSearchFlags</span></a> flags</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *match_start</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *match_end</code></em>,
|
||
<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *limit</code></em>);</pre>
|
||
<p>Same as <a class="link" href="GtkTextIter.html#gtk-text-iter-forward-search" title="gtk_text_iter_forward_search ()"><code class="function">gtk_text_iter_forward_search()</code></a>, but moves backward.</p>
|
||
<p><em class="parameter"><code>match_end</code></em>
|
||
will never be set to a <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> located after <em class="parameter"><code>iter</code></em>
|
||
, even if
|
||
there is a possible <em class="parameter"><code>match_start</code></em>
|
||
before or at <em class="parameter"><code>iter</code></em>
|
||
.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-backward-search.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> where the search begins</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>str</p></td>
|
||
<td class="parameter_description"><p>search string</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>flags</p></td>
|
||
<td class="parameter_description"><p>bitmask of flags affecting the search</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>match_start</p></td>
|
||
<td class="parameter_description"><p>return location for start of match, or <code class="literal">NULL</code>. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="Out parameter, where caller must allocate storage."><span class="acronym">out caller-allocates</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>match_end</p></td>
|
||
<td class="parameter_description"><p>return location for end of match, or <code class="literal">NULL</code>. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="Out parameter, where caller must allocate storage."><span class="acronym">out caller-allocates</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>limit</p></td>
|
||
<td class="parameter_description"><p>location of last possible <em class="parameter"><code>match_start</code></em>
|
||
, or <code class="literal">NULL</code> for start of buffer. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-backward-search.returns"></a><h4>Returns</h4>
|
||
<p> whether a match was found</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-equal"></a><h3>gtk_text_iter_equal ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_iter_equal (<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *lhs</code></em>,
|
||
<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *rhs</code></em>);</pre>
|
||
<p>Tests whether two iterators are equal, using the fastest possible
|
||
mechanism. This function is very fast; you can expect it to perform
|
||
better than e.g. getting the character offset for each iterator and
|
||
comparing the offsets yourself. Also, it’s a bit faster than
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-compare" title="gtk_text_iter_compare ()"><code class="function">gtk_text_iter_compare()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-equal.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>lhs</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>rhs</p></td>
|
||
<td class="parameter_description"><p>another <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-equal.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if the iterators point to the same place in the buffer</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-compare"></a><h3>gtk_text_iter_compare ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gint</span>
|
||
gtk_text_iter_compare (<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *lhs</code></em>,
|
||
<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *rhs</code></em>);</pre>
|
||
<p>A <code class="function">qsort()</code>-style function that returns negative if <em class="parameter"><code>lhs</code></em>
|
||
is less than
|
||
<em class="parameter"><code>rhs</code></em>
|
||
, positive if <em class="parameter"><code>lhs</code></em>
|
||
is greater than <em class="parameter"><code>rhs</code></em>
|
||
, and 0 if they’re equal.
|
||
Ordering is in character offset order, i.e. the first character in the buffer
|
||
is less than the second character in the buffer.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-compare.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>lhs</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>rhs</p></td>
|
||
<td class="parameter_description"><p>another <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-compare.returns"></a><h4>Returns</h4>
|
||
<p> -1 if <em class="parameter"><code>lhs</code></em>
|
||
is less than <em class="parameter"><code>rhs</code></em>
|
||
, 1 if <em class="parameter"><code>lhs</code></em>
|
||
is greater, 0 if they are equal</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-in-range"></a><h3>gtk_text_iter_in_range ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_iter_in_range (<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
|
||
<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *start</code></em>,
|
||
<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *end</code></em>);</pre>
|
||
<p>Checks whether <em class="parameter"><code>iter</code></em>
|
||
falls in the range [<em class="parameter"><code>start</code></em>
|
||
, <em class="parameter"><code>end</code></em>
|
||
).
|
||
<em class="parameter"><code>start</code></em>
|
||
and <em class="parameter"><code>end</code></em>
|
||
must be in ascending order.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-in-range.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>start</p></td>
|
||
<td class="parameter_description"><p>start of range</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>end</p></td>
|
||
<td class="parameter_description"><p>end of range</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-in-range.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if <em class="parameter"><code>iter</code></em>
|
||
is in the range</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-iter-order"></a><h3>gtk_text_iter_order ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_text_iter_order (<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *first</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *second</code></em>);</pre>
|
||
<p>Swaps the value of <em class="parameter"><code>first</code></em>
|
||
and <em class="parameter"><code>second</code></em>
|
||
if <em class="parameter"><code>second</code></em>
|
||
comes before
|
||
<em class="parameter"><code>first</code></em>
|
||
in the buffer. That is, ensures that <em class="parameter"><code>first</code></em>
|
||
and <em class="parameter"><code>second</code></em>
|
||
are
|
||
in sequence. Most text buffer functions that take a range call this
|
||
automatically on your behalf, so there’s no real reason to call it yourself
|
||
in those cases. There are some exceptions, such as <a class="link" href="GtkTextIter.html#gtk-text-iter-in-range" title="gtk_text_iter_in_range ()"><code class="function">gtk_text_iter_in_range()</code></a>,
|
||
that expect a pre-sorted range.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-iter-order.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>first</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>second</p></td>
|
||
<td class="parameter_description"><p>another <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkTextIter.other_details"></a><h2>Types and Values</h2>
|
||
<div class="refsect2">
|
||
<a name="GtkTextIter-struct"></a><h3>GtkTextIter</h3>
|
||
<pre class="programlisting">typedef struct {
|
||
/* GtkTextIter is an opaque datatype; ignore all these fields.
|
||
* Initialize the iter with gtk_text_buffer_get_iter_*
|
||
* functions
|
||
*/
|
||
} GtkTextIter;
|
||
</pre>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkTextSearchFlags"></a><h3>enum GtkTextSearchFlags</h3>
|
||
<p>Flags affecting how a search is done.</p>
|
||
<p>If neither <a class="link" href="GtkTextIter.html#GTK-TEXT-SEARCH-VISIBLE-ONLY:CAPS"><span class="type">GTK_TEXT_SEARCH_VISIBLE_ONLY</span></a> nor <a class="link" href="GtkTextIter.html#GTK-TEXT-SEARCH-TEXT-ONLY:CAPS"><span class="type">GTK_TEXT_SEARCH_TEXT_ONLY</span></a> are
|
||
enabled, the match must be exact; the special 0xFFFC character will match
|
||
embedded pixbufs or child widgets.</p>
|
||
<div class="refsect3">
|
||
<a name="GtkTextSearchFlags.members"></a><h4>Members</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="300px" class="enum_members_name">
|
||
<col class="enum_members_description">
|
||
<col width="200px" class="enum_members_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GTK-TEXT-SEARCH-VISIBLE-ONLY:CAPS"></a>GTK_TEXT_SEARCH_VISIBLE_ONLY</p></td>
|
||
<td class="enum_member_description">
|
||
<p>Search only visible data. A search match may
|
||
have invisible text interspersed.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GTK-TEXT-SEARCH-TEXT-ONLY:CAPS"></a>GTK_TEXT_SEARCH_TEXT_ONLY</p></td>
|
||
<td class="enum_member_description">
|
||
<p>Search only text. A match may have pixbufs or
|
||
child widgets mixed inside the matched range.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GTK-TEXT-SEARCH-CASE-INSENSITIVE:CAPS"></a>GTK_TEXT_SEARCH_CASE_INSENSITIVE</p></td>
|
||
<td class="enum_member_description">
|
||
<p>The text will be matched regardless of
|
||
what case it is in.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
<div class="footer">
|
||
<hr>Generated by GTK-Doc V1.33.1</div>
|
||
</body>
|
||
</html> |