/usr/share/gtk-doc/html/pygtk/class-gtktextbuffer.html

<html><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"><title>gtk.TextBuffer</title><link rel="stylesheet" href="style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><link rel="home" href="index.html" title="PyGTK 2.0 Reference Manual"><link rel="up" href="gtk-class-reference.html" title="The gtk Class Reference"><link rel="prev" href="class-gtktextattributes.html" title="gtk.TextAttributes"><link rel="next" href="class-gtktextchildanchor.html" title="gtk.TextChildAnchor"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">gtk.TextBuffer</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="class-gtktextattributes.html">Prev</a> </td><th width="60%" align="center">The gtk Class Reference</th><td width="20%" align="right"> <a accesskey="n" href="class-gtktextchildanchor.html">Next</a></td></tr></table><hr></div><div class="refentry" title="gtk.TextBuffer"><a name="class-gtktextbuffer"></a><div class="titlepage"></div><div class="refnamediv"><h2>gtk.TextBuffer</h2><p>gtk.TextBuffer — stores attributed text for display in a <a class="link" href="class-gtktextview.html" title="gtk.TextView"><code class="classname">gtk.TextView</code></a></p></div><div class="refsect1" title="Synopsis"><a name="id3935138"></a><h2>Synopsis</h2><table bgcolor="#D0E0F0" width="100%"><tr><td><pre class="classsynopsis">class <span class="ooclass"><span class="classname">gtk.TextBuffer</span></span>(<span class="ooclass"><span class="classname"><PYGTKDOCLINK HREF="class-gobject">gobject.GObject</PYGTKDOCLINK></span></span>):
<code class="constructorsynopsis">    <span class="methodname"><a class="link" href="class-gtktextbuffer.html#constructor-gtktextbuffer" title="Constructor">gtk.TextBuffer</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>table</code></strong></span><span class="initializer">=None</span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--get-line-count" title="gtk.TextBuffer.get_line_count">get_line_count</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--get-char-count" title="gtk.TextBuffer.get_char_count">get_char_count</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--get-tag-table" title="gtk.TextBuffer.get_tag_table">get_tag_table</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--set-text" title="gtk.TextBuffer.set_text">set_text</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>text</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--insert" title="gtk.TextBuffer.insert">insert</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>iter</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>text</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--insert-at-cursor" title="gtk.TextBuffer.insert_at_cursor">insert_at_cursor</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>text</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--insert-interactive" title="gtk.TextBuffer.insert_interactive">insert_interactive</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>iter</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>text</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>default_editable</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--insert-interactive-at-cursor" title="gtk.TextBuffer.insert_interactive_at_cursor">insert_interactive_at_cursor</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>text</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>default_editable</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--insert-range" title="gtk.TextBuffer.insert_range">insert_range</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>iter</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>start</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>end</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--insert-range-interactive" title="gtk.TextBuffer.insert_range_interactive">insert_range_interactive</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>iter</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>start</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>end</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>default_editable</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--insert-with-tags" title="gtk.TextBuffer.insert_with_tags">insert_with_tags</a></span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>iter</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>text</code></em></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>...</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--insert-with-tags-by-name" title="gtk.TextBuffer.insert_with_tags_by_name">insert_with_tags_by_name</a></span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>iter</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>text</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--delete" title="gtk.TextBuffer.delete">delete</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>start</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>end</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--delete-interactive" title="gtk.TextBuffer.delete_interactive">delete_interactive</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>start_iter</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>end_iter</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>default_editable</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--get-text" title="gtk.TextBuffer.get_text">get_text</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>start</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>end</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>include_hidden_chars</code></strong></span><span class="initializer">=True</span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--get-slice" title="gtk.TextBuffer.get_slice">get_slice</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>start</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>end</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>include_hidden_chars</code></strong></span><span class="initializer">=True</span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--insert-pixbuf" title="gtk.TextBuffer.insert_pixbuf">insert_pixbuf</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>iter</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>pixbuf</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--insert-child-anchor" title="gtk.TextBuffer.insert_child_anchor">insert_child_anchor</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>iter</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>anchor</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--create-child-anchor" title="gtk.TextBuffer.create_child_anchor">create_child_anchor</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>iter</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--create-mark" title="gtk.TextBuffer.create_mark">create_mark</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>mark_name</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>where</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>left_gravity</code></strong></span><span class="initializer">=False</span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--move-mark" title="gtk.TextBuffer.move_mark">move_mark</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>mark</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>where</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--delete-mark" title="gtk.TextBuffer.delete_mark">delete_mark</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>mark</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--get-mark" title="gtk.TextBuffer.get_mark">get_mark</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>name</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--move-mark-by-name" title="gtk.TextBuffer.move_mark_by_name">move_mark_by_name</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>name</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>where</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--delete-mark-by-name" title="gtk.TextBuffer.delete_mark_by_name">delete_mark_by_name</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>name</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--get-insert" title="gtk.TextBuffer.get_insert">get_insert</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--get-selection-bound" title="gtk.TextBuffer.get_selection_bound">get_selection_bound</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--place-cursor" title="gtk.TextBuffer.place_cursor">place_cursor</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>where</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--place-cursor" title="gtk.TextBuffer.place_cursor">select_range</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>ins</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>bound</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--apply-tag" title="gtk.TextBuffer.apply_tag">apply_tag</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>tag</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>start</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>end</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--remove-tag" title="gtk.TextBuffer.remove_tag">remove_tag</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>tag</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>start</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>end</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--apply-tag-by-name" title="gtk.TextBuffer.apply_tag_by_name">apply_tag_by_name</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>name</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>start</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>end</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--remove-tag-by-name" title="gtk.TextBuffer.remove_tag_by_name">remove_tag_by_name</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>name</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>start</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>end</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--remove-all-tags" title="gtk.TextBuffer.remove_all_tags">remove_all_tags</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>start</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>end</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--create-tag" title="gtk.TextBuffer.create_tag">create_tag</a></span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>tag_name</code></em></span><span class="initializer">=None</span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--get-iter-at-line-offset" title="gtk.TextBuffer.get_iter_at_line_offset">get_iter_at_line_offset</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>line_number</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>char_offset</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--get-iter-at-line-index" title="gtk.TextBuffer.get_iter_at_line_index">get_iter_at_line_index</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>line_number</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>byte_index</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--get-iter-at-offset" title="gtk.TextBuffer.get_iter_at_offset">get_iter_at_offset</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>char_offset</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--get-iter-at-line" title="gtk.TextBuffer.get_iter_at_line">get_iter_at_line</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>line_number</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--get-start-iter" title="gtk.TextBuffer.get_start_iter">get_start_iter</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--get-end-iter" title="gtk.TextBuffer.get_end_iter">get_end_iter</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--get-bounds" title="gtk.TextBuffer.get_bounds">get_bounds</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--get-iter-at-mark" title="gtk.TextBuffer.get_iter_at_mark">get_iter_at_mark</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>mark</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--get-iter-at-child-anchor" title="gtk.TextBuffer.get_iter_at_child_anchor">get_iter_at_child_anchor</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>anchor</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--get-modified" title="gtk.TextBuffer.get_modified">get_modified</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--set-modified" title="gtk.TextBuffer.set_modified">set_modified</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>setting</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--add-selection-clipboard" title="gtk.TextBuffer.add_selection_clipboard">add_selection_clipboard</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>clipboard</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--remove-selection-clipboard" title="gtk.TextBuffer.remove_selection_clipboard">remove_selection_clipboard</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>clipboard</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--cut-clipboard" title="gtk.TextBuffer.cut_clipboard">cut_clipboard</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>clipboard</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>default_editable</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--copy-clipboard" title="gtk.TextBuffer.copy_clipboard">copy_clipboard</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>clipboard</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--paste-clipboard" title="gtk.TextBuffer.paste_clipboard">paste_clipboard</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>clipboard</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>override_location</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>default_editable</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--get-selection-bounds" title="gtk.TextBuffer.get_selection_bounds">get_selection_bounds</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--delete-selection" title="gtk.TextBuffer.delete_selection">delete_selection</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>interactive</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>default_editable</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--begin-user-action" title="gtk.TextBuffer.begin_user_action">begin_user_action</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--end-user-action" title="gtk.TextBuffer.end_user_action">end_user_action</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--end-user-action" title="gtk.TextBuffer.end_user_action">backspace</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>iter</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>interactive</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>default_editable</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--get-has-selection" title="gtk.TextBuffer.get_has_selection">get_has_selection</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--get-copy-target-list" title="gtk.TextBuffer.get_copy_target_list">get_copy_target_list</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--get-paste-target-list" title="gtk.TextBuffer.get_paste_target_list">get_paste_target_list</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--register-serialize-format" title="gtk.TextBuffer.register_serialize_format">register_serialize_format</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>mime_type</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>function</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>user_data</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--register-serialize-tagset" title="gtk.TextBuffer.register_serialize_tagset">register_serialize_tagset</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>tagset_name</code></strong></span><span class="initializer">=NULL</span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--register-deserialize-format" title="gtk.TextBuffer.register_deserialize_format">register_deserialize_format</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>mime_type</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>function</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>user_data</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--register-deserialize-tagset" title="gtk.TextBuffer.register_deserialize_tagset">register_deserialize_tagset</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>tagset_name</code></strong></span><span class="initializer">=NULL</span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--unregister-serialize-format" title="gtk.TextBuffer.unregister_serialize_format">unregister_serialize_format</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>format</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--unregister-deserialize-format" title="gtk.TextBuffer.unregister_deserialize_format">unregister_deserialize_format</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>format</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--deserialize-set-can-create-tags" title="gtk.TextBuffer.deserialize_set_can_create_tags">deserialize_set_can_create_tags</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>format</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>can_create_tags</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--deserialize-get-can-create-tags" title="gtk.TextBuffer.deserialize_get_can_create_tags">deserialize_get_can_create_tags</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>format</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--get-serialize-formats" title="gtk.TextBuffer.get_serialize_formats">get_serialize_formats</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--get-deserialize-formats" title="gtk.TextBuffer.get_deserialize_formats">get_deserialize_formats</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--serialize" title="gtk.TextBuffer.serialize">serialize</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>content_buffer</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>format</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>start</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>end</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--deserialize" title="gtk.TextBuffer.deserialize">deserialize</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>content_buffer</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>format</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>iter</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>data</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--add-mark" title="gtk.TextBuffer.add_mark">add_mark</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>mark</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>where</code></strong></span></span>)</code><br></pre></td></tr></table></div><div class="refsect1" title="Ancestry"><a name="id3937874"></a><h2>Ancestry</h2><pre class="synopsis">+-- <PYGTKDOCLINK HREF="class-gobject">gobject.GObject</PYGTKDOCLINK>
  +-- <a class="link" href="class-gtktextbuffer.html" title="gtk.TextBuffer">gtk.TextBuffer</a>
</pre></div><div class="refsect1" title="gtk.TextBuffer Properties"><a name="properties-gtktextbuffer"></a><h2>gtk.TextBuffer Properties</h2><div class="blockquote"><table width="100%" border="0" bgcolor="#E0E0E0"><tr><td valign="top"><div class="informaltable"><table width="100%" border="0"><colgroup><col width="1in"><col width="1in"><col width="4in"></colgroup><tbody><tr valign="top"><td valign="top">"copy-target-list"</td><td valign="top">Read</td><td valign="top">The list of targets this buffer supports for clipboard
              copying and as DND source.  This property is available in GTK+
              2.10 and above.</td></tr><tr valign="top"><td valign="top">"cursor-position"</td><td valign="top">Read</td><td valign="top">The position of the insert mark (as offset from the
              beginning of the buffer).  It is useful for getting notified
              when the cursor moves. Allowed values: &gt;= 0.  Default value:
              0.  This property is available in GTK+ 2.10 and above.</td></tr><tr valign="top"><td valign="top">"has-selection"</td><td valign="top">Read</td><td valign="top">If <code class="literal">True</code> the buffer has some text
              currently selected. Default value:
              <code class="literal">False</code>. This property is available in GTK+
              2.10 and above.</td></tr><tr valign="top"><td valign="top">"paste-target-list"</td><td valign="top">Read</td><td valign="top">The list of targets this buffer supports for clipboard
              pasting and as DND destination.  This property is available in
              GTK+ 2.10 and above.</td></tr><tr valign="top"><td valign="top">"tag-table"</td><td valign="top">Read-Write-Construct Only</td><td valign="top">The <a class="link" href="class-gtktexttagtable.html" title="gtk.TextTagTable"><code class="classname">gtk.TextTagTable</code></a>
              associated with the textbuffer. Available in GTK+ 2.2 and
              above.</td></tr><tr valign="top"><td valign="top">"text"</td><td valign="top">Read-Write</td><td valign="top">The text content of the buffer. Without child widgets
              and images, see the <a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--get-text" title="gtk.TextBuffer.get_text"><code class="methodname">gtk.TextBuffer.get_text()</code></a>
              method for more information. Default value: "". This property
              is available in GTK+ 2.8 and above.</td></tr></tbody></table></div></td></tr></table></div></div><div class="refsect1" title="Attributes"><a name="id3938108"></a><h2>Attributes</h2><div class="blockquote"><table width="100%" border="0" bgcolor="#E0E0E0"><tr><td valign="top"><div class="informaltable"><table cellpadding="5" width="100%" border="0"><colgroup><col width="1in"><col width="1in"><col width="4in"></colgroup><tbody><tr valign="top"><td valign="top">"tag_table"</td><td valign="top">Read</td><td valign="top">The <a class="link" href="class-gtktexttagtable.html" title="gtk.TextTagTable"><code class="classname">gtk.TextTagTable</code></a> 
associated with the textbuffer.</td></tr></tbody></table></div></td></tr></table></div></div><div class="refsect1" title="gtk.TextBuffer Signal Prototypes"><a name="signal-prototypes-gtktextbuffer"></a><h2>gtk.TextBuffer Signal Prototypes</h2><p><PYGTKDOCLINK HREF="signal-prototypes-gobject">gobject.GObject Signal Prototypes</PYGTKDOCLINK></p><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term">"<a class="link" href="class-gtktextbuffer.html#signal-gtktextbuffer--apply-tag" title='The "apply-tag" gtk.TextBuffer Signal'>apply-tag</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>textbuffer</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>texttag</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>start</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>end</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtktextbuffer.html#signal-gtktextbuffer--begin-user-action" title='The "begin-user-action" gtk.TextBuffer Signal'>begin-user-action</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>textbuffer</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtktextbuffer.html#signal-gtktextbuffer--changed" title='The "changed" gtk.TextBuffer Signal'>changed</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>textbuffer</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtktextbuffer.html#signal-gtktextbuffer--delete-range" title='The "delete-range" gtk.TextBuffer Signal'>delete-range</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>textbuffer</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>start</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>end</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtktextbuffer.html#signal-gtktextbuffer--end-user-action" title='The "end-user-action" gtk.TextBuffer Signal'>end-user-action</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>textbuffer</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtktextbuffer.html#signal-gtktextbuffer--insert-child-anchor" title='The "insert-child-anchor" gtk.TextBuffer Signal'>insert-child-anchor</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>textbuffer</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>iter</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>anchor</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtktextbuffer.html#signal-gtktextbuffer--insert-pixbuf" title='The "insert-pixbuf" gtk.TextBuffer Signal'>insert-pixbuf</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>textbuffer</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>iter</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>pixbuf</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtktextbuffer.html#signal-gtktextbuffer--insert-text" title='The "insert-text" gtk.TextBuffer Signal'>insert-text</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>textbuffer</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>iter</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>text</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>length</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtktextbuffer.html#signal-gtktextbuffer--mark-deleted" title='The "mark-deleted" gtk.TextBuffer Signal'>mark-deleted</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>textbuffer</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>textmark</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtktextbuffer.html#signal-gtktextbuffer--mark-set" title='The "mark-set" gtk.TextBuffer Signal'>mark-set</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>textbuffer</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>iter</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>textmark</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtktextbuffer.html#signal-gtktextbuffer--modified-changed" title='The "modified-changed" gtk.TextBuffer Signal'>modified-changed</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>textbuffer</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtktextbuffer.html#signal-gtktextbuffer--paste-done" title='The "paste-done" gtk.TextBuffer Signal'>paste-done</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>textbuffer</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtktextbuffer.html#signal-gtktextbuffer--remove-tag" title='The "remove-tag" gtk.TextBuffer Signal'>remove-tag</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>textbuffer</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>texttag</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>start</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>end</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr></tbody></table></div><div class="refsect1" title="Description"><a name="id3939221"></a><h2>Description</h2><p>A <a class="link" href="class-gtktextbuffer.html" title="gtk.TextBuffer"><code class="classname">gtk.TextBuffer</code></a>
is the core component of the PyGTK text editing system. A <a class="link" href="class-gtktextbuffer.html" title="gtk.TextBuffer"><code class="classname">gtk.TextBuffer</code></a>
contains the text, pixbufs and child widget anchors that are displayed in
one or more <a class="link" href="class-gtktextview.html" title="gtk.TextView"><code class="classname">gtk.TextView</code></a>
widgets. A <a class="link" href="class-gtktextbuffer.html" title="gtk.TextBuffer"><code class="classname">gtk.TextBuffer</code></a>
has an associated <a class="link" href="class-gtktexttagtable.html" title="gtk.TextTagTable"><code class="classname">gtk.TextTagTable</code></a> 
that contains the <a class="link" href="class-gtktexttag.html" title="gtk.TextTag"><code class="classname">gtk.TextTag</code></a> objects
that can be used to set attributes on the text in the textbuffer.</p><p>A <a class="link" href="class-gtktextbuffer.html" title="gtk.TextBuffer"><code class="classname">gtk.TextBuffer</code></a>
can be automatically created when creating a <a class="link" href="class-gtktextview.html" title="gtk.TextView"><code class="classname">gtk.TextView</code></a> or it
can be created with the <a class="link" href="class-gtktextbuffer.html#constructor-gtktextbuffer" title="Constructor">gtk.TextBuffer</a>() constructor and
associated with a <a class="link" href="class-gtktextview.html" title="gtk.TextView"><code class="classname">gtk.TextView</code></a> using
the <a class="link" href="class-gtktextview.html#method-gtktextview--set-buffer" title="gtk.TextView.set_buffer"><code class="methodname">set_buffer</code>()</a> 
method or the <a class="link" href="class-gtktextview.html#constructor-gtktextview" title="Constructor">gtk.TextView</a>()
constructor.</p></div><div class="refsect1" title="Constructor"><a name="constructor-gtktextbuffer"></a><h2>Constructor</h2><pre class="programlisting"><code class="constructorsynopsis">    <span class="methodname">gtk.TextBuffer</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>table</code></strong></span><span class="initializer">=None</span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>table</code></strong> :</span></p></td><td>a tag table, or None to create a new
one</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a new text buffer object</td></tr></tbody></table><p>Creates a new <a class="link" href="class-gtktextbuffer.html" title="gtk.TextBuffer"><code class="classname">gtk.TextBuffer</code></a>
object.</p></div><div class="refsect1" title="Methods"><a name="id3939420"></a><h2>Methods</h2><div class="refsect2" title="gtk.TextBuffer.get_line_count"><a name="method-gtktextbuffer--get-line-count"></a><h3>gtk.TextBuffer.get_line_count</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_line_count</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the number of lines in the
buffer</td></tr></tbody></table><p>The <code class="methodname">get_line_count</code>() method returns the
number of lines in the buffer. This value is cached, so the function is very
fast.</p></div><div class="refsect2" title="gtk.TextBuffer.get_char_count"><a name="method-gtktextbuffer--get-char-count"></a><h3>gtk.TextBuffer.get_char_count</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_char_count</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the number of characters in the
buffer</td></tr></tbody></table><p>The <code class="methodname">get_char_count</code>() method returns the
number of characters in the buffer; note that characters and bytes are not
the same, you can't e.g. expect the contents of the buffer in string form to
be this many bytes long. The character count is cached, so this function is
very fast.</p></div><div class="refsect2" title="gtk.TextBuffer.get_tag_table"><a name="method-gtktextbuffer--get-tag-table"></a><h3>gtk.TextBuffer.get_tag_table</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_tag_table</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the buffer's tag table</td></tr></tbody></table><p>The <code class="methodname">get_tag_table</code>() method returns the
<a class="link" href="class-gtktexttagtable.html" title="gtk.TextTagTable"><code class="classname">gtk.TextTagTable</code></a> 
object associated with the textbuffer.</p></div><div class="refsect2" title="gtk.TextBuffer.set_text"><a name="method-gtktextbuffer--set-text"></a><h3>gtk.TextBuffer.set_text</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_text</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>text</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>text</code></strong> :</span></p></td><td>UTF-8 text to insert</td></tr></tbody></table><p>The <code class="methodname">set_text</code>() method replaces the
current contents of the textbuffer with the contents of
<em class="parameter"><code>text</code></em>. <em class="parameter"><code>text</code></em> must be valid
UTF-8.</p></div><div class="refsect2" title="gtk.TextBuffer.insert"><a name="method-gtktextbuffer--insert"></a><h3>gtk.TextBuffer.insert</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">insert</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>iter</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>text</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>iter</code></strong> :</span></p></td><td>a <a class="link" href="class-gtktextiter.html" title="gtk.TextIter"><code class="classname">gtk.TextIter</code></a>
specifying a position in the buffer</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>text</code></strong> :</span></p></td><td>UTF-8 format text to
insert</td></tr></tbody></table><p>The <code class="methodname">insert</code>() method inserts the
contents of <em class="parameter"><code>text</code></em> into the textbuffer at the position
specified by <em class="parameter"><code>iter</code></em>. The "insert_text" signal is
emitted and the text insertion actually occurs in the default handler for
the signal. <em class="parameter"><code>iter</code></em> is invalidated when insertion occurs
(because the buffer contents change), but the default signal handler
revalidates it to point to the end of the inserted text.</p></div><div class="refsect2" title="gtk.TextBuffer.insert_at_cursor"><a name="method-gtktextbuffer--insert-at-cursor"></a><h3>gtk.TextBuffer.insert_at_cursor</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">insert_at_cursor</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>text</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>text</code></strong> :</span></p></td><td>some text in UTF-8 format</td></tr></tbody></table><p>The <code class="methodname">insert_at_cursor</code>() method is a
convenience method that calls the <a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--insert" title="gtk.TextBuffer.insert"><code class="methodname">insert</code>()</a> 
method, using the current cursor position as the insertion point.</p></div><div class="refsect2" title="gtk.TextBuffer.insert_interactive"><a name="method-gtktextbuffer--insert-interactive"></a><h3>gtk.TextBuffer.insert_interactive</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">insert_interactive</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>iter</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>text</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>default_editable</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>iter</code></strong> :</span></p></td><td>a <a class="link" href="class-gtktextiter.html" title="gtk.TextIter"><code class="classname">gtk.TextIter</code></a>
specifying a position in
<em class="parameter"><code>buffer</code></em></td></tr><tr><td><p><span class="term"><strong class="parameter"><code>text</code></strong> :</span></p></td><td>some UTF-8 text</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>default_editable</code></strong> :</span></p></td><td>default editability of
buffer</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the text was
actually inserted</td></tr></tbody></table><p>The <code class="methodname">insert_interactive</code>() method is
similar to the <a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--insert" title="gtk.TextBuffer.insert"><code class="methodname">insert</code>()</a> 
method, except the insertion of <em class="parameter"><code>text</code></em> at
<em class="parameter"><code>iter</code></em> will not occur if <em class="parameter"><code>iter</code></em> is
at a non-editable location in the buffer. A location is non-editable if a
<a class="link" href="class-gtktexttag.html" title="gtk.TextTag"><code class="classname">gtk.TextTag</code></a>
applied at that location has its "editable" attribute set to
<code class="literal">False</code> or the <a class="link" href="class-gtktextview.html" title="gtk.TextView"><code class="classname">gtk.TextView</code></a> used
by the user is set non-editable. Usually you want to prevent insertions at
locations if the insertion results from a user action (is
interactive).</p><p><em class="parameter"><code>default_editable</code></em> indicates the
editability of text that doesn't have a tag affecting editability applied to
it. Typically the result of the <a class="link" href="class-gtktextview.html#method-gtktextview--get-editable" title="gtk.TextView.get_editable"><code class="methodname">gtk.TextView.get_editable</code>()</a> 
method is appropriate here.</p></div><div class="refsect2" title="gtk.TextBuffer.insert_interactive_at_cursor"><a name="method-gtktextbuffer--insert-interactive-at-cursor"></a><h3>gtk.TextBuffer.insert_interactive_at_cursor</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">insert_interactive_at_cursor</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>text</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>default_editable</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>text</code></strong> :</span></p></td><td>text in UTF-8 format</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>default_editable</code></strong> :</span></p></td><td>default editability of
buffer</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the text was
actually inserted</td></tr></tbody></table><p>The <code class="methodname">insert_interactive_at_cursor</code>()
method calls the <a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--insert-interactive" title="gtk.TextBuffer.insert_interactive"><code class="methodname">insert_interactive</code>()</a> 
method to insert <em class="parameter"><code>text</code></em> at the cursor (insert)
position. <em class="parameter"><code>default_editable</code></em> indicates the editability
of text that doesn't have a tag affecting editability applied to it.
Typically the result of the <a class="link" href="class-gtktextview.html#method-gtktextview--get-editable" title="gtk.TextView.get_editable"><code class="methodname">gtk.TextView.get_editable</code>()</a> 
method is appropriate here.</p></div><div class="refsect2" title="gtk.TextBuffer.insert_range"><a name="method-gtktextbuffer--insert-range"></a><h3>gtk.TextBuffer.insert_range</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">insert_range</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>iter</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>start</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>end</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>iter</code></strong> :</span></p></td><td>a <a class="link" href="class-gtktextiter.html" title="gtk.TextIter"><code class="classname">gtk.TextIter</code></a>
specifying a position in the
textbuffer</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>start</code></strong> :</span></p></td><td>a <a class="link" href="class-gtktextiter.html" title="gtk.TextIter"><code class="classname">gtk.TextIter</code></a>
specifying a position in a (possibly different) <a class="link" href="class-gtktextbuffer.html" title="gtk.TextBuffer"><code class="classname">gtk.TextBuffer</code></a></td></tr><tr><td><p><span class="term"><strong class="parameter"><code>end</code></strong> :</span></p></td><td>a <a class="link" href="class-gtktextiter.html" title="gtk.TextIter"><code class="classname">gtk.TextIter</code></a>
specifying another position in the same buffer as
<em class="parameter"><code>start</code></em></td></tr></tbody></table><p>The <code class="methodname">insert_range</code>() method copies text,
tags, and pixbufs (but not child anchors) between
<em class="parameter"><code>start</code></em> and <em class="parameter"><code>end</code></em> (the order of
<em class="parameter"><code>start</code></em> and <em class="parameter"><code>end</code></em> doesn't matter)
form a <a class="link" href="class-gtktextbuffer.html" title="gtk.TextBuffer"><code class="classname">gtk.TextBuffer</code></a>
and inserts the copy at <em class="parameter"><code>iter</code></em>. Used instead of simply
getting/inserting text because it preserves images and tags. If
<em class="parameter"><code>start</code></em> and <em class="parameter"><code>end</code></em> are in a
different buffer from <em class="parameter"><code>buffer</code></em>, the two buffers must
share the same tag table. This method is implemented via emissions of the
"insert_text" and "apply_tag" signals.</p></div><div class="refsect2" title="gtk.TextBuffer.insert_range_interactive"><a name="method-gtktextbuffer--insert-range-interactive"></a><h3>gtk.TextBuffer.insert_range_interactive</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">insert_range_interactive</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>iter</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>start</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>end</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>default_editable</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>iter</code></strong> :</span></p></td><td>a <a class="link" href="class-gtktextiter.html" title="gtk.TextIter"><code class="classname">gtk.TextIter</code></a>
specifying a position in the
textbuffer</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>start</code></strong> :</span></p></td><td>a <a class="link" href="class-gtktextiter.html" title="gtk.TextIter"><code class="classname">gtk.TextIter</code></a>
specifying a position in a (possibly different) <a class="link" href="class-gtktextbuffer.html" title="gtk.TextBuffer"><code class="classname">gtk.TextBuffer</code></a></td></tr><tr><td><p><span class="term"><strong class="parameter"><code>end</code></strong> :</span></p></td><td>a <a class="link" href="class-gtktextiter.html" title="gtk.TextIter"><code class="classname">gtk.TextIter</code></a>
specifying another position in the same buffer as
<em class="parameter"><code>start</code></em></td></tr><tr><td><p><span class="term"><strong class="parameter"><code>default_editable</code></strong> :</span></p></td><td>default editability of the
buffer</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if an insertion was
possible at <em class="parameter"><code>iter</code></em></td></tr></tbody></table><p>The <code class="methodname">insert_range_interactive</code>() method
is similar to the <a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--insert-range" title="gtk.TextBuffer.insert_range"><code class="methodname">insert_range</code>()</a> 
method, except the insertion of <em class="parameter"><code>text</code></em> at
<em class="parameter"><code>iter</code></em> will not occur if the insertion position is
non-editable. A location is non-editable if a <a class="link" href="class-gtktexttag.html" title="gtk.TextTag"><code class="classname">gtk.TextTag</code></a> applied
at that location has its "editable" attribute set to
<code class="literal">False</code> or the <a class="link" href="class-gtktextview.html" title="gtk.TextView"><code class="classname">gtk.TextView</code></a> used
by the user is set non-editable. The <em class="parameter"><code>default_editable</code></em>
parameter indicates whether the text is editable at
<em class="parameter"><code>iter</code></em> if no tags enclosing <em class="parameter"><code>iter</code></em>
affect editability. Typically the result of the <a class="link" href="class-gtktextview.html#method-gtktextview--get-editable" title="gtk.TextView.get_editable"><code class="methodname">gtk.TextView.get_editable</code>()</a> 
method is appropriate here.</p></div><div class="refsect2" title="gtk.TextBuffer.insert_with_tags"><a name="method-gtktextbuffer--insert-with-tags"></a><h3>gtk.TextBuffer.insert_with_tags</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">insert_with_tags</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>iter</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>text</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td><td>a <a class="link" href="class-gtktextiter.html" title="gtk.TextIter"><code class="classname">gtk.TextIter</code></a>
specifying a position in <em class="parameter"><code>buffer</code></em></td></tr><tr><td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td><td>UTF-8 text</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>one or more optional <a class="link" href="class-gtktexttag.html" title="gtk.TextTag"><code class="classname">gtk.TextTag</code></a> objects
to apply to <em class="parameter"><code>text</code></em></td></tr></tbody></table><p>The <code class="methodname">insert_with_tags</code>() method inserts
the specified <em class="parameter"><code>text</code></em> into the textbuffer at the
location specified by <em class="parameter"><code>iter</code></em>, applying any optional
tags following the first two parameters to the newly-inserted text. This
method is a convenience method that is equivalent to calling the <a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--insert" title="gtk.TextBuffer.insert"><code class="methodname">insert</code>()</a> 
method, then the <a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--apply-tag" title="gtk.TextBuffer.apply_tag"><code class="methodname">apply_tag</code>()</a> 
method on the inserted text.</p></div><div class="refsect2" title="gtk.TextBuffer.insert_with_tags_by_name"><a name="method-gtktextbuffer--insert-with-tags-by-name"></a><h3>gtk.TextBuffer.insert_with_tags_by_name</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">insert_with_tags_by_name</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>iter</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>text</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td><td>a <a class="link" href="class-gtktextiter.html" title="gtk.TextIter"><code class="classname">gtk.TextIter</code></a>
specifying a position in <em class="parameter"><code>buffer</code></em></td></tr><tr><td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td><td>UTF-8 text</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>one or more optional <a class="link" href="class-gtktexttag.html" title="gtk.TextTag"><code class="classname">gtk.TextTag</code></a> names
to apply to <em class="parameter"><code>text</code></em></td></tr></tbody></table><p>The <code class="methodname">insert_with_tags_by_name</code>() method
is similar to the <a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--insert-with-tags" title="gtk.TextBuffer.insert_with_tags"><code class="methodname">insert_with_tags</code>()</a> 
method, but uses tag names instead of tag objects.</p></div><div class="refsect2" title="gtk.TextBuffer.delete"><a name="method-gtktextbuffer--delete"></a><h3>gtk.TextBuffer.delete</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">delete</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>start</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>end</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>start</code></strong> :</span></p></td><td>a <a class="link" href="class-gtktextiter.html" title="gtk.TextIter"><code class="classname">gtk.TextIter</code></a>
specifying a position in the textbuffer</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>end</code></strong> :</span></p></td><td>a <a class="link" href="class-gtktextiter.html" title="gtk.TextIter"><code class="classname">gtk.TextIter</code></a>
specifying another position in the textbuffer</td></tr></tbody></table><p>The <code class="methodname">delete</code>() method deletes the text
between <em class="parameter"><code>start</code></em> and <em class="parameter"><code>end</code></em>. The
order of <em class="parameter"><code>start</code></em> and <em class="parameter"><code>end</code></em> is not
actually relevant as the <code class="methodname">delete</code>() method will
reorder them. This method emits the "delete_range" signal, and the default
handler of that signal deletes the text. Because the textbuffer is modified,
all outstanding iterators become invalid after calling this function;
however, <em class="parameter"><code>start</code></em> and <em class="parameter"><code>end</code></em> will be
re-initialized to point to the location where text was deleted.</p></div><div class="refsect2" title="gtk.TextBuffer.delete_interactive"><a name="method-gtktextbuffer--delete-interactive"></a><h3>gtk.TextBuffer.delete_interactive</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">delete_interactive</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>start_iter</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>end_iter</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>default_editable</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>start_iter</code></strong> :</span></p></td><td>a <a class="link" href="class-gtktextiter.html" title="gtk.TextIter"><code class="classname">gtk.TextIter</code></a>
specifying the start of the text to delete</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>end_iter</code></strong> :</span></p></td><td>a <a class="link" href="class-gtktextiter.html" title="gtk.TextIter"><code class="classname">gtk.TextIter</code></a>
specifying the end of the text to delete</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>default_editable</code></strong> :</span></p></td><td>whether the buffer is editable by
default</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if some text was
actually deleted</td></tr></tbody></table><p>The <code class="methodname">delete_interactive</code>() method deletes
all <span class="emphasis"><em>editable</em></span> text in the given range. This method calls
the <a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--delete" title="gtk.TextBuffer.delete"><code class="methodname">delete</code>()</a> 
method for each editable sub-range of
[<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> are revalidated
to point to the location of the last deleted range, or left untouched if no
text was deleted. A range of <em class="parameter"><code>text</code></em> is non-editable if
a <a class="link" href="class-gtktexttag.html" title="gtk.TextTag"><code class="classname">gtk.TextTag</code></a>
applied to that range has its "editable" attribute set to
<code class="literal">False</code> or the <a class="link" href="class-gtktextview.html" title="gtk.TextView"><code class="classname">gtk.TextView</code></a> used
by the user is set non-editable. The <em class="parameter"><code>default_editable</code></em>
parameter indicates whether <em class="parameter"><code>text</code></em> is editable if no
tags enclosing any part of <em class="parameter"><code>text</code></em> affect editability.
Typically the result of the <a class="link" href="class-gtktextview.html#method-gtktextview--get-editable" title="gtk.TextView.get_editable"><code class="methodname">gtk.TextView.get_editable</code>()</a> 
method is appropriate here.</p></div><div class="refsect2" title="gtk.TextBuffer.get_text"><a name="method-gtktextbuffer--get-text"></a><h3>gtk.TextBuffer.get_text</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_text</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>start</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>end</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>include_hidden_chars</code></strong></span><span class="initializer">=True</span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>start</code></strong> :</span></p></td><td>a <a class="link" href="class-gtktextiter.html" title="gtk.TextIter"><code class="classname">gtk.TextIter</code></a>
specifying the start of a range</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>end</code></strong> :</span></p></td><td>a <a class="link" href="class-gtktextiter.html" title="gtk.TextIter"><code class="classname">gtk.TextIter</code></a>
specifying the end of a range</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>include_hidden_chars</code></strong> :</span></p></td><td>if <code class="literal">True</code> include invisible
text</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the text in the range</td></tr></tbody></table><p>The <code class="methodname">get_text</code>() method returns the text
in the specified range
[<em class="parameter"><code>start</code></em>,<em class="parameter"><code>end</code></em>). Undisplayed text
(text marked with tags that set the invisibility attribute) are excluded if
<em class="parameter"><code>include_hidden_chars</code></em> is <code class="literal">False</code>.
<code class="methodname">get_text</code>() does not return characters representing
embedded images, so byte and character indexes into the returned string do
<span class="emphasis"><em>not</em></span> correspond to byte and character indexes into the
buffer. Contrast this behavior with the <a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--get-slice" title="gtk.TextBuffer.get_slice"><code class="methodname">get_slice</code>()</a> 
method.</p></div><div class="refsect2" title="gtk.TextBuffer.get_slice"><a name="method-gtktextbuffer--get-slice"></a><h3>gtk.TextBuffer.get_slice</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_slice</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>start</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>end</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>include_hidden_chars</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>start</code></strong> :</span></p></td><td>a <a class="link" href="class-gtktextiter.html" title="gtk.TextIter"><code class="classname">gtk.TextIter</code></a>
specifying the start of a range</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>end</code></strong> :</span></p></td><td>a <a class="link" href="class-gtktextiter.html" title="gtk.TextIter"><code class="classname">gtk.TextIter</code></a>
specifying the end of a range</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>include_hidden_chars</code></strong> :</span></p></td><td>if <code class="literal">True</code> include invisible
text</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the contents of the range including text and
indicators for pixbufs and child anchors</td></tr></tbody></table><p>The <code class="methodname">get_slice</code>() method returns the text
in the range [<em class="parameter"><code>start</code></em>,<em class="parameter"><code>end</code></em>).
Undisplayed text (text marked with tags that set the invisibility attribute)
is excluded if <em class="parameter"><code>include_hidden_chars</code></em> is
<code class="literal">False</code>. The returned string includes a 0xFFFC character
whenever the textbuffer contains embedded images or child anchors, so byte
and character indexes into the returned string <span class="emphasis"><em>do</em></span>
correspond to byte and character indexes into the buffer. Contrast this
behavior with the <a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--get-text" title="gtk.TextBuffer.get_text"><code class="methodname">get_text</code>()</a> 
method. 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><div class="refsect2" title="gtk.TextBuffer.insert_pixbuf"><a name="method-gtktextbuffer--insert-pixbuf"></a><h3>gtk.TextBuffer.insert_pixbuf</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">insert_pixbuf</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>iter</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>pixbuf</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>iter</code></strong> :</span></p></td><td>a <a class="link" href="class-gtktextiter.html" title="gtk.TextIter"><code class="classname">gtk.TextIter</code></a>
specifying the location to insert the pixbuf</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>pixbuf</code></strong> :</span></p></td><td>a <a class="link" href="class-gdkpixbuf.html" title="gtk.gdk.Pixbuf"><code class="classname">gtk.gdk.Pixbuf</code></a></td></tr></tbody></table><p>The <code class="methodname">insert_pixbuf</code>() method inserts an
image specified by <em class="parameter"><code>pixbuf</code></em> into the text buffer at the
location specified by <em class="parameter"><code>iter</code></em>. The image will be counted
as one character in character counts, and when obtaining the buffer contents
as a string, will be represented by the Unicode "object replacement
character" 0xFFFC. Note that the "slice" variants for obtaining portions of
the buffer as a string include this character for pixbufs, but the "text"
variants do not. e.g. see the <a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--get-slice" title="gtk.TextBuffer.get_slice"><code class="methodname">get_slice</code>()</a> 
and <a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--get-text" title="gtk.TextBuffer.get_text"><code class="methodname">get_text</code>()</a> 
methods.</p></div><div class="refsect2" title="gtk.TextBuffer.insert_child_anchor"><a name="method-gtktextbuffer--insert-child-anchor"></a><h3>gtk.TextBuffer.insert_child_anchor</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">insert_child_anchor</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>iter</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>anchor</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>iter</code></strong> :</span></p></td><td>a <a class="link" href="class-gtktextiter.html" title="gtk.TextIter"><code class="classname">gtk.TextIter</code></a>
specifying the location to insert the anchor</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>anchor</code></strong> :</span></p></td><td>a <a class="link" href="class-gtktextchildanchor.html" title="gtk.TextChildAnchor"><code class="classname">gtk.TextChildAnchor</code></a></td></tr></tbody></table><p>The <code class="methodname">insert_child_anchor</code>() method
inserts a child widget anchor specified by <em class="parameter"><code>anchor</code></em>
into the textbuffer at the location specified by
<em class="parameter"><code>iter</code></em>. The anchor will be counted as one character in
character counts, and when obtaining the buffer contents as a string, will
be represented by the Unicode "object replacement character" 0xFFFC. Note
that the "slice" variants for obtaining portions of the buffer as a string
include this character for child anchors, but the "text" variants do not.
e.g. see the <a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--get-slice" title="gtk.TextBuffer.get_slice"><code class="methodname">get_slice</code>()</a> 
and <a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--get-text" title="gtk.TextBuffer.get_text"><code class="methodname">get_text</code>()</a> 
methods. The <a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--create-child-anchor" title="gtk.TextBuffer.create_child_anchor"><code class="methodname">create_child_anchor</code>()</a> 
is a more convenient alternative to this function.</p></div><div class="refsect2" title="gtk.TextBuffer.create_child_anchor"><a name="method-gtktextbuffer--create-child-anchor"></a><h3>gtk.TextBuffer.create_child_anchor</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">create_child_anchor</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>iter</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>iter</code></strong> :</span></p></td><td>a <a class="link" href="class-gtktextiter.html" title="gtk.TextIter"><code class="classname">gtk.TextIter</code></a>
specifying a location in the buffer</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the new child anchor</td></tr></tbody></table><p>The <code class="methodname">create_child_anchor</code>() method is a
convenience function that creates a child anchor with the <a class="link" href="class-gtktextchildanchor.html#constructor-gtktextchildanchor" title="Constructor">gtk.TextChildAnchor</a>()
constructor and inserts it into the textbuffer at the location specified by
<em class="parameter"><code>iter</code></em> with the <a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--insert-child-anchor" title="gtk.TextBuffer.insert_child_anchor"><code class="methodname">insert_child_anchor</code>()</a> 
method.</p></div><div class="refsect2" title="gtk.TextBuffer.create_mark"><a name="method-gtktextbuffer--create-mark"></a><h3>gtk.TextBuffer.create_mark</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">create_mark</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>mark_name</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>where</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>left_gravity</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>mark_name</code></strong> :</span></p></td><td>the name for the new mark, or
<code class="literal">None</code></td></tr><tr><td><p><span class="term"><strong class="parameter"><code>where</code></strong> :</span></p></td><td>a <a class="link" href="class-gtktextiter.html" title="gtk.TextIter"><code class="classname">gtk.TextIter</code></a>
specifying the location to place the mark</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>left_gravity</code></strong> :</span></p></td><td>if <code class="literal">True</code> the mark has left
gravity</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the new <a class="link" href="class-gtktextmark.html" title="gtk.TextMark"><code class="classname">gtk.TextMark</code></a>
object</td></tr></tbody></table><p>The <code class="methodname">create_mark</code>() method creates a mark
with the name specified by <em class="parameter"><code>mark_name</code></em> at the position
specified by <em class="parameter"><code>where</code></em> and left gravity specified by
<em class="parameter"><code>left_gravity</code></em>. If <em class="parameter"><code>mark_name</code></em> is
<code class="literal">None</code>, the mark is anonymous; otherwise, the mark can be
retrieved by name using the <a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--get-mark" title="gtk.TextBuffer.get_mark"><code class="methodname">get_mark</code>()</a> 
method. If a mark has left gravity, and text is inserted at the mark's
current location, the mark will be moved to the left of the newly-inserted
text. If the mark has right gravity (<em class="parameter"><code>left_gravity</code></em> =
<code class="literal">False</code>), the mark will end up on the right of
newly-inserted text. The standard left-to-right cursor is a mark with right
gravity (when you type, the cursor stays on the right side of the text
you're typing). Marks are owned by the buffer and go away when the buffer
does. This method emits the "mark_set" signal as notification of the mark's
initial placement.</p></div><div class="refsect2" title="gtk.TextBuffer.move_mark"><a name="method-gtktextbuffer--move-mark"></a><h3>gtk.TextBuffer.move_mark</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">move_mark</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>mark</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>where</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>mark</code></strong> :</span></p></td><td>a <a class="link" href="class-gtktextmark.html" title="gtk.TextMark"><code class="classname">gtk.TextMark</code></a></td></tr><tr><td><p><span class="term"><strong class="parameter"><code>where</code></strong> :</span></p></td><td>a <a class="link" href="class-gtktextiter.html" title="gtk.TextIter"><code class="classname">gtk.TextIter</code></a>
specifying a new location for <em class="parameter"><code>mark</code></em></td></tr></tbody></table><p>The <code class="methodname">move_mark</code>() method moves the <a class="link" href="class-gtktextmark.html" title="gtk.TextMark"><code class="classname">gtk.TextMark</code></a>
specified by <em class="parameter"><code>mark</code></em> to the new location specified by
<em class="parameter"><code>where</code></em>.This method  emits the "mark_set" signal as
notification of the move.</p></div><div class="refsect2" title="gtk.TextBuffer.delete_mark"><a name="method-gtktextbuffer--delete-mark"></a><h3>gtk.TextBuffer.delete_mark</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">delete_mark</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>mark</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>mark</code></strong> :</span></p></td><td>a <a class="link" href="class-gtktextmark.html" title="gtk.TextMark"><code class="classname">gtk.TextMark</code></a> in
the textbuffer</td></tr></tbody></table><p>The <code class="methodname">delete_mark</code>() method deletes the
<a class="link" href="class-gtktextmark.html" title="gtk.TextMark"><code class="classname">gtk.TextMark</code></a>
specified by <em class="parameter"><code>mark</code></em>, so that it's no longer located
anywhere in the textbuffer. Most operations on <em class="parameter"><code>mark</code></em>
become invalid and there is no way to undelete a mark. The <a class="link" href="class-gtktextmark.html#method-gtktextmark--get-deleted" title="gtk.TextMark.get_deleted"><code class="methodname">get_deleted</code>()</a> 
method will return <code class="literal">True</code> after this method has been called
on a mark to indicate that a mark no longer belongs to a textbuffer. The
"mark_deleted" signal will be emitted as notification after the mark is
deleted.</p></div><div class="refsect2" title="gtk.TextBuffer.get_mark"><a name="method-gtktextbuffer--get-mark"></a><h3>gtk.TextBuffer.get_mark</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_mark</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>name</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>name</code></strong> :</span></p></td><td>a mark name</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a <a class="link" href="class-gtktextmark.html" title="gtk.TextMark"><code class="classname">gtk.TextMark</code></a>, or
None</td></tr></tbody></table><p>The get_mark() method returns the mark named
<em class="parameter"><code>name</code></em> in the textbuffer, or <code class="literal">None</code> if
no such mark exists in the buffer.</p></div><div class="refsect2" title="gtk.TextBuffer.move_mark_by_name"><a name="method-gtktextbuffer--move-mark-by-name"></a><h3>gtk.TextBuffer.move_mark_by_name</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">move_mark_by_name</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>name</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>where</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>name</code></strong> :</span></p></td><td>the name of a mark</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>where</code></strong> :</span></p></td><td>a <a class="link" href="class-gtktextiter.html" title="gtk.TextIter"><code class="classname">gtk.TextIter</code></a>
specifying the new location for mark</td></tr></tbody></table><p>The <code class="methodname">move_mark_by_name</code>() method moves
the mark named <em class="parameter"><code>name</code></em> (which must exist) to the
textbuffer location specified by <em class="parameter"><code>where</code></em>. See the <a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--move-mark" title="gtk.TextBuffer.move_mark"><code class="methodname">move_mark</code>()</a> 
method for details.</p></div><div class="refsect2" title="gtk.TextBuffer.delete_mark_by_name"><a name="method-gtktextbuffer--delete-mark-by-name"></a><h3>gtk.TextBuffer.delete_mark_by_name</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">delete_mark_by_name</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>name</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>name</code></strong> :</span></p></td><td>the name of a mark in
<em class="parameter"><code>buffer</code></em></td></tr></tbody></table><p>The <code class="methodname">delete_mark_by_name</code>() method
deletes the mark (which must exist) named <em class="parameter"><code>name</code></em>. See
the <a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--delete-mark" title="gtk.TextBuffer.delete_mark"><code class="methodname">delete_mark</code>()</a> 
for details.</p></div><div class="refsect2" title="gtk.TextBuffer.get_insert"><a name="method-gtktextbuffer--get-insert"></a><h3>gtk.TextBuffer.get_insert</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_insert</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the insertion point mark</td></tr></tbody></table><p>The <code class="methodname">get_insert</code>() method returns the
mark that represents the cursor (insertion point). Equivalent to calling the
<a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--get-mark" title="gtk.TextBuffer.get_mark"><code class="methodname">get_mark</code>()</a> 
method to get the mark named "insert", but very slightly more efficient, and
involving less typing.</p></div><div class="refsect2" title="gtk.TextBuffer.get_selection_bound"><a name="method-gtktextbuffer--get-selection-bound"></a><h3>gtk.TextBuffer.get_selection_bound</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_selection_bound</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the selection bound mark</td></tr></tbody></table><p>The <code class="methodname">get_selection_bound</code>() method
returns the mark that represents the selection bound.  Equivalent to calling
the <a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--get-mark" title="gtk.TextBuffer.get_mark"><code class="methodname">get_mark</code>()</a> 
method to get the mark named "selection_bound", but very slightly more
efficient, and involving less typing. The currently-selected text in a
textbuffer is the region between the "selection_bound" and "insert" marks.
If "selection_bound" and "insert" are in the same place, then there is no
current selection. The <a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--get-selection-bounds" title="gtk.TextBuffer.get_selection_bounds"><code class="methodname">get_selection_bounds</code>()</a> 
method is a convenience method for handling the selection, if you just
want to know whether there's a selection and what its bounds are.</p></div><div class="refsect2" title="gtk.TextBuffer.place_cursor"><a name="method-gtktextbuffer--place-cursor"></a><h3>gtk.TextBuffer.place_cursor</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">place_cursor</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>where</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>where</code></strong> :</span></p></td><td>a <a class="link" href="class-gtktextiter.html" title="gtk.TextIter"><code class="classname">gtk.TextIter</code></a>
specifying where to put the cursor</td></tr></tbody></table><p>The <code class="methodname">place_cursor</code>() method moves the
"insert" and "selection_bound" marks simultaneously to the location
specified by <em class="parameter"><code>where</code></em>.  If you move them to the same
place in two steps with the <a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--move-mark" title="gtk.TextBuffer.move_mark"><code class="methodname">move_mark</code>()</a> 
method, you will temporarily select a region in between their old and new
locations, which is inefficient. This method moves them as a unit, which can
be optimized.</p></div><div class="refsect2" title="gtk.TextBuffer.select_range"><a name="method-gtktextbuffer--select-range"></a><h3>gtk.TextBuffer.select_range</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">select_range</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>ins</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>bound</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>ins</code></strong> :</span></p></td><td>a <a class="link" href="class-gtktextiter.html" title="gtk.TextIter"><code class="classname">gtk.TextIter</code></a>
specifying where to put the "insert" mark</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>bound</code></strong> :</span></p></td><td>a <a class="link" href="class-gtktextiter.html" title="gtk.TextIter"><code class="classname">gtk.TextIter</code></a>
specifying where to put the "selection_bound" mark</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.4 and above.</p></div><p>The <code class="methodname">select_range</code>() method moves the
"insert" and "selection_bound" marks simultaneously to the locations
specified by <em class="parameter"><code>ins</code></em> and <em class="parameter"><code>bound</code></em>
respectively.  If you move them to the same place in two steps with the
<a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--move-mark" title="gtk.TextBuffer.move_mark"><code class="methodname">move_mark</code>()</a>
method, you will temporarily select a region in between their old and new
locations, which is inefficient. This method moves them as a unit, which can
be optimized.</p></div><div class="refsect2" title="gtk.TextBuffer.apply_tag"><a name="method-gtktextbuffer--apply-tag"></a><h3>gtk.TextBuffer.apply_tag</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">apply_tag</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>tag</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>start</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>end</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>tag</code></strong> :</span></p></td><td>a <a class="link" href="class-gtktexttag.html" title="gtk.TextTag"><code class="classname">gtk.TextTag</code></a></td></tr><tr><td><p><span class="term"><strong class="parameter"><code>start</code></strong> :</span></p></td><td>a <a class="link" href="class-gtktextiter.html" title="gtk.TextIter"><code class="classname">gtk.TextIter</code></a>
specifying the start of the range</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>end</code></strong> :</span></p></td><td>a <a class="link" href="class-gtktextiter.html" title="gtk.TextIter"><code class="classname">gtk.TextIter</code></a>
specifying the end of the range</td></tr></tbody></table><p>The <code class="methodname">apply_tag</code>() method emits the
"apply-tag" signal that causes the <a class="link" href="class-gtktexttag.html" title="gtk.TextTag"><code class="classname">gtk.TextTag</code></a>
specified by <em class="parameter"><code>tag</code></em> to be applied to the range of text
between <em class="parameter"><code>start</code></em> and <em class="parameter"><code>end</code></em> by the
default signal handler. <em class="parameter"><code>start</code></em> and
<em class="parameter"><code>end</code></em> do not have to be in order.</p></div><div class="refsect2" title="gtk.TextBuffer.remove_tag"><a name="method-gtktextbuffer--remove-tag"></a><h3>gtk.TextBuffer.remove_tag</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">remove_tag</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>tag</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>start</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>end</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>tag</code></strong> :</span></p></td><td>a <a class="link" href="class-gtktexttag.html" title="gtk.TextTag"><code class="classname">gtk.TextTag</code></a></td></tr><tr><td><p><span class="term"><strong class="parameter"><code>start</code></strong> :</span></p></td><td>a <a class="link" href="class-gtktextiter.html" title="gtk.TextIter"><code class="classname">gtk.TextIter</code></a>
specifying the start of the range</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>end</code></strong> :</span></p></td><td>a <a class="link" href="class-gtktextiter.html" title="gtk.TextIter"><code class="classname">gtk.TextIter</code></a>
specifying the end of the range</td></tr></tbody></table><p>The <code class="methodname">delete_tag</code>() method emits the
"remove_tag" signal that causes the default handler for the signal to remove
all occurrences of the <a class="link" href="class-gtktexttag.html" title="gtk.TextTag"><code class="classname">gtk.TextTag</code></a>
specified by <em class="parameter"><code>tag</code></em> from the text in the range between
<em class="parameter"><code>start</code></em> and <em class="parameter"><code>end</code></em>.
<em class="parameter"><code>start</code></em> and <em class="parameter"><code>end</code></em> don't have to be
in order.</p></div><div class="refsect2" title="gtk.TextBuffer.apply_tag_by_name"><a name="method-gtktextbuffer--apply-tag-by-name"></a><h3>gtk.TextBuffer.apply_tag_by_name</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">apply_tag_by_name</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>name</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>start</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>end</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>name</code></strong> :</span></p></td><td>the name of a <a class="link" href="class-gtktexttag.html" title="gtk.TextTag"><code class="classname">gtk.TextTag</code></a></td></tr><tr><td><p><span class="term"><strong class="parameter"><code>start</code></strong> :</span></p></td><td>a <a class="link" href="class-gtktextiter.html" title="gtk.TextIter"><code class="classname">gtk.TextIter</code></a>
specifying the start of the range</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>end</code></strong> :</span></p></td><td>a <a class="link" href="class-gtktextiter.html" title="gtk.TextIter"><code class="classname">gtk.TextIter</code></a>
specifying the end of the range</td></tr></tbody></table><p>The <code class="methodname">apply_tag_by_name</code>() method calls
the <a class="link" href="class-gtktexttagtable.html#method-gtktexttagtable--lookup" title="gtk.TextTagTable.lookup"><code class="methodname">gtk.TextTagTable.lookup</code>()</a> 
method on the textbuffer's tag table to find the <a class="link" href="class-gtktexttag.html" title="gtk.TextTag"><code class="classname">gtk.TextTag</code></a> with
the specified <em class="parameter"><code>name</code></em>, then calls the <a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--apply-tag" title="gtk.TextBuffer.apply_tag"><code class="methodname">apply_tag</code>()</a> 
method to apply that tag to the text in the range between
<em class="parameter"><code>start</code></em> and <em class="parameter"><code>end</code></em>.
<em class="parameter"><code>start</code></em> and <em class="parameter"><code>end</code></em> don't have to be
in order.</p></div><div class="refsect2" title="gtk.TextBuffer.remove_tag_by_name"><a name="method-gtktextbuffer--remove-tag-by-name"></a><h3>gtk.TextBuffer.remove_tag_by_name</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">remove_tag_by_name</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>name</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>start</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>end</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>name</code></strong> :</span></p></td><td>the name of a <a class="link" href="class-gtktexttag.html" title="gtk.TextTag"><code class="classname">gtk.TextTag</code></a></td></tr><tr><td><p><span class="term"><strong class="parameter"><code>start</code></strong> :</span></p></td><td>a <a class="link" href="class-gtktextiter.html" title="gtk.TextIter"><code class="classname">gtk.TextIter</code></a>
specifying the start of the range</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>end</code></strong> :</span></p></td><td>a <a class="link" href="class-gtktextiter.html" title="gtk.TextIter"><code class="classname">gtk.TextIter</code></a>
specifying the end of the range</td></tr></tbody></table><p>The <code class="methodname">delete_tag_by_name</code>() method calls
the <a class="link" href="class-gtktexttagtable.html#method-gtktexttagtable--lookup" title="gtk.TextTagTable.lookup"><code class="methodname">gtk.TextTagTable.lookup</code>()</a> 
method on the textbuffer's tag table to find the <a class="link" href="class-gtktexttag.html" title="gtk.TextTag"><code class="classname">gtk.TextTag</code></a>, then
calls the <a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--remove-tag" title="gtk.TextBuffer.remove_tag"><code class="methodname">remove_tag</code>()</a> 
method to remove that that tag from the text in the range between
<em class="parameter"><code>start</code></em> and <em class="parameter"><code>end</code></em>.
<em class="parameter"><code>start</code></em> and <em class="parameter"><code>end</code></em> don't have to be
in order.</p></div><div class="refsect2" title="gtk.TextBuffer.remove_all_tags"><a name="method-gtktextbuffer--remove-all-tags"></a><h3>gtk.TextBuffer.remove_all_tags</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">remove_all_tags</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>start</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>end</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>start</code></strong> :</span></p></td><td>a <a class="link" href="class-gtktextiter.html" title="gtk.TextIter"><code class="classname">gtk.TextIter</code></a>
specifying the start of the range</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>end</code></strong> :</span></p></td><td>a <a class="link" href="class-gtktextiter.html" title="gtk.TextIter"><code class="classname">gtk.TextIter</code></a>
specifying the end of the range</td></tr></tbody></table><p>The <code class="methodname">remove_all_tags</code>() method removes
all tags in the text in the range between <em class="parameter"><code>start</code></em> and
<em class="parameter"><code>end</code></em>.  Be careful with this function; it could remove
tags added in code unrelated to the code you're currently writing. That is,
using this function is probably a bad idea if you have two or more unrelated
code sections that add tags. <em class="parameter"><code>start</code></em> and
<em class="parameter"><code>end</code></em> don't have to be in order.</p></div><div class="refsect2" title="gtk.TextBuffer.create_tag"><a name="method-gtktextbuffer--create-tag"></a><h3>gtk.TextBuffer.create_tag</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">create_tag</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>tag_name</code></em></span><span class="initializer">=None</span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>tag_name</code></em> :</span></p></td><td>the name of the new tag, or
<code class="literal">None</code> if the tag is anonymous</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>one or more property_name= value pairs
</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a new tag</td></tr></tbody></table><p>The <code class="methodname">create_tag</code>() method creates a tag
with the name specified by <em class="parameter"><code>tag_name</code></em> and adds it to
the tag table for the textbuffer. If one or more
<code class="literal">property_name=value</code> pairs are available they are used to
set the properties of the tag. Note the <code class="literal">property_name</code>
must be specified using underscores instead of dashes e.g. use
pixels_above_lines=10 instead of pixels-above-lines=10. This method is
equivalent to calling the <a class="link" href="class-gtktexttag.html#constructor-gtktexttag" title="Constructor">gtk.TextTag</a>() constructor and then
adding the tag to the buffer's tag table with the <a class="link" href="class-gtktexttagtable.html#method-gtktexttagtable--add" title="gtk.TextTagTable.add"><code class="methodname">gtk.TextTagTable.add</code>()</a> 
method. If <em class="parameter"><code>tag_name</code></em> is <code class="literal">None</code>, the
tag is anonymous. If <em class="parameter"><code>tag_name</code></em> is
non-<code class="literal">None</code>, a tag called <em class="parameter"><code>tag_name</code></em>
must not already exist in the tag table for this buffer.</p></div><div class="refsect2" title="gtk.TextBuffer.get_iter_at_line_offset"><a name="method-gtktextbuffer--get-iter-at-line-offset"></a><h3>gtk.TextBuffer.get_iter_at_line_offset</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_iter_at_line_offset</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>line_number</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>char_offset</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>line_number</code></strong> :</span></p></td><td>the line number counting from
0</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>char_offset</code></strong> :</span></p></td><td>the char offset from start of
line</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a <a class="link" href="class-gtktextiter.html" title="gtk.TextIter"><code class="classname">gtk.TextIter</code></a></td></tr></tbody></table><p>The<code class="methodname"> get_iter_at_line_offset</code>() returns
an iterator pointing to the position specified by
<em class="parameter"><code>char_offset</code></em> within the line specified by
<em class="parameter"><code>line_number</code></em>. The <em class="parameter"><code>char_offset</code></em>
must exist, offsets off the end of the line are not allowed. Note specify
<span class="emphasis"><em>characters</em></span>, not bytes; UTF-8 may encode one character
as multiple bytes.</p></div><div class="refsect2" title="gtk.TextBuffer.get_iter_at_line_index"><a name="method-gtktextbuffer--get-iter-at-line-index"></a><h3>gtk.TextBuffer.get_iter_at_line_index</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_iter_at_line_index</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>line_number</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>byte_index</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>line_number</code></strong> :</span></p></td><td>the line number counting from
0</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>byte_index</code></strong> :</span></p></td><td>the byte index from start of
line</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a <a class="link" href="class-gtktextiter.html" title="gtk.TextIter"><code class="classname">gtk.TextIter</code></a></td></tr></tbody></table><p>The <code class="methodname">get_iter_at_line_index</code>() method
returns an iterator pointing to the position specified by
<em class="parameter"><code>byte_index</code></em> within the line specified by
<em class="parameter"><code>line_number</code></em>. <em class="parameter"><code>byte_index</code></em> must
be the start of a UTF-8 character, and must not be beyond the end of the
line.  Note specify <span class="emphasis"><em>bytes</em></span>, not characters; UTF-8 may
encode one character as multiple bytes.</p></div><div class="refsect2" title="gtk.TextBuffer.get_iter_at_offset"><a name="method-gtktextbuffer--get-iter-at-offset"></a><h3>gtk.TextBuffer.get_iter_at_offset</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_iter_at_offset</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>char_offset</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>char_offset</code></strong> :</span></p></td><td>the char offset from start of buffer, counting
from 0</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a <a class="link" href="class-gtktextiter.html" title="gtk.TextIter"><code class="classname">gtk.TextIter</code></a></td></tr></tbody></table><p>The <code class="methodname">get_iter_at_offset</code>() method returns
an iterator pointing to the location specified by
<em class="parameter"><code>char_offset</code></em> characters from the start of the entire
buffer.</p></div><div class="refsect2" title="gtk.TextBuffer.get_iter_at_line"><a name="method-gtktextbuffer--get-iter-at-line"></a><h3>gtk.TextBuffer.get_iter_at_line</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_iter_at_line</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>line_number</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>line_number</code></strong> :</span></p></td><td>line number counting from
0</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a <a class="link" href="class-gtktextiter.html" title="gtk.TextIter"><code class="classname">gtk.TextIter</code></a></td></tr></tbody></table><p>The <code class="methodname">get_iter_at_line</code>() method returns
an iterator pointing to the start of the line specified by
<em class="parameter"><code>line_number</code></em>.</p></div><div class="refsect2" title="gtk.TextBuffer.get_start_iter"><a name="method-gtktextbuffer--get-start-iter"></a><h3>gtk.TextBuffer.get_start_iter</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_start_iter</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a <a class="link" href="class-gtktextiter.html" title="gtk.TextIter"><code class="classname">gtk.TextIter</code></a></td></tr></tbody></table><p>The <code class="methodname">get_start_iter</code>() method returns an
iterator pointing at the location of the first position in the text buffer.
This is the same as using the <a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--get-iter-at-offset" title="gtk.TextBuffer.get_iter_at_offset"><code class="methodname">get_iter_at_offset</code>()</a> 
with an argument of 0.
</p></div><div class="refsect2" title="gtk.TextBuffer.get_end_iter"><a name="method-gtktextbuffer--get-end-iter"></a><h3>gtk.TextBuffer.get_end_iter</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_end_iter</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a <a class="link" href="class-gtktextiter.html" title="gtk.TextIter"><code class="classname">gtk.TextIter</code></a></td></tr></tbody></table><p>The <code class="methodname">get_end_iter</code>() method returns an
iterator pointing at the "end iterator," one past the last valid character
in the text buffer. If passed to the <a class="link" href="class-gtktextiter.html#method-gtktextiter--get-char" title="gtk.TextIter.get_char"><code class="methodname">gtk.TextIter.get_char</code>()</a> 
method, the end iterator has a character value of 0. The entire buffer lies
in the range from the first position in the buffer (call the <a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--get-start-iter" title="gtk.TextBuffer.get_start_iter"><code class="methodname">get_start_iter</code>()</a> 
method to get character position 0) to the end iterator.</p></div><div class="refsect2" title="gtk.TextBuffer.get_bounds"><a name="method-gtktextbuffer--get-bounds"></a><h3>gtk.TextBuffer.get_bounds</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_bounds</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a tuple containing <a class="link" href="class-gtktextiter.html" title="gtk.TextIter"><code class="classname">gtk.TextIter</code></a> objects
that point at the first and last positions in the buffer</td></tr></tbody></table><p>The <code class="methodname">get_bounds</code>() method returns a tuple
containing the first and last iterators in the buffer, i.e. the entire
buffer lies within the range.</p></div><div class="refsect2" title="gtk.TextBuffer.get_iter_at_mark"><a name="method-gtktextbuffer--get-iter-at-mark"></a><h3>gtk.TextBuffer.get_iter_at_mark</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_iter_at_mark</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>mark</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>mark</code></strong> :</span></p></td><td>a <a class="link" href="class-gtktextmark.html" title="gtk.TextMark"><code class="classname">gtk.TextMark</code></a> in
the textbuffer</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a <a class="link" href="class-gtktextiter.html" title="gtk.TextIter"><code class="classname">gtk.TextIter</code></a></td></tr></tbody></table><p>The <code class="methodname">get_iter_at_mark</code>() method returns
an iterator that points at the current position of
<em class="parameter"><code>mark</code></em>.</p></div><div class="refsect2" title="gtk.TextBuffer.get_iter_at_child_anchor"><a name="method-gtktextbuffer--get-iter-at-child-anchor"></a><h3>gtk.TextBuffer.get_iter_at_child_anchor</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_iter_at_child_anchor</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>iter</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>anchor</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>anchor</code></strong> :</span></p></td><td>a child anchor that appears in the
textbuffer</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a <a class="link" href="class-gtktextiter.html" title="gtk.TextIter"><code class="classname">gtk.TextIter</code></a></td></tr></tbody></table><p>The <code class="methodname">get_iter_at_child_anchor</code>() method
returns an iterator that points at the location of
<em class="parameter"><code>anchor</code></em> within the textbuffer.</p></div><div class="refsect2" title="gtk.TextBuffer.get_modified"><a name="method-gtktextbuffer--get-modified"></a><h3>gtk.TextBuffer.get_modified</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_modified</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the buffer has been
modified</td></tr></tbody></table><p>The <code class="methodname">get_modified</code>() method returns
<code class="literal">True</code> if the buffer has been modified since the last call
to the <a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--set-modified" title="gtk.TextBuffer.set_modified"><code class="methodname">set_modified</code>()</a> 
method set the modification flag to <code class="literal">False</code>. Used for
example to enable a "save" function in a text editor.</p></div><div class="refsect2" title="gtk.TextBuffer.set_modified"><a name="method-gtktextbuffer--set-modified"></a><h3>gtk.TextBuffer.set_modified</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_modified</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>setting</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>setting</code></strong> :</span></p></td><td>the modification flag
setting</td></tr></tbody></table><p>The <code class="methodname">set_modified</code>() method sets the
modification flag of the textbuffer to the value specified by
<em class="parameter"><code>setting</code></em>. The modification flag is used to keep track
of whether the buffer has been modified since the last time it was saved.
Whenever the buffer is saved to disk, call this method with a
<em class="parameter"><code>setting</code></em> of <code class="literal">False</code>. When the buffer
is modified, it will automatically set the modification flag to
<em class="parameter"><code>True</code></em> and emit a "modified_changed" signal.</p></div><div class="refsect2" title="gtk.TextBuffer.add_selection_clipboard"><a name="method-gtktextbuffer--add-selection-clipboard"></a><h3>gtk.TextBuffer.add_selection_clipboard</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">add_selection_clipboard</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>clipboard</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>clipboard</code></strong> :</span></p></td><td>a <a class="link" href="class-gtkclipboard.html" title="gtk.Clipboard"><code class="classname">gtk.Clipboard</code></a></td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.2 and above.</p></div><p>The <code class="methodname">add_selection_clipboard</code>() method
adds the <a class="link" href="class-gtkclipboard.html" title="gtk.Clipboard"><code class="classname">gtk.Clipboard</code></a>
specified by <em class="parameter"><code>clipboard</code></em> to the list of clipboards in
which the selection contents of the buffer are available. In most cases,
<em class="parameter"><code>clipboard</code></em> will be the
<code class="literal">gtk.gdk.SELECTION_PRIMARY</code> clipboard</p></div><div class="refsect2" title="gtk.TextBuffer.remove_selection_clipboard"><a name="method-gtktextbuffer--remove-selection-clipboard"></a><h3>gtk.TextBuffer.remove_selection_clipboard</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">remove_selection_clipboard</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>clipboard</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>clipboard</code></strong> :</span></p></td><td>a <a class="link" href="class-gtkclipboard.html" title="gtk.Clipboard"><code class="classname">gtk.Clipboard</code></a>
	  added to the buffer by the <a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--add-selection-clipboard" title="gtk.TextBuffer.add_selection_clipboard"><code class="methodname">add_selection_clipboard()</code></a>
	  method.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.2 and above.</p></div><p>The <code class="methodname">remove_selection_clipboard</code>() method
removes the <a class="link" href="class-gtkclipboard.html" title="gtk.Clipboard"><code class="classname">gtk.Clipboard</code></a>
added with the <a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--add-selection-clipboard" title="gtk.TextBuffer.add_selection_clipboard"><code class="methodname">add_selection_clipboard</code>()</a>
method.</p></div><div class="refsect2" title="gtk.TextBuffer.cut_clipboard"><a name="method-gtktextbuffer--cut-clipboard"></a><h3>gtk.TextBuffer.cut_clipboard</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">cut_clipboard</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>clipboard</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>default_editable</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>clipboard</code></strong> :</span></p></td><td>the <a class="link" href="class-gtkclipboard.html" title="gtk.Clipboard"><code class="classname">gtk.Clipboard</code></a>
	  object to cut to.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>default_editable</code></strong> :</span></p></td><td>the default editability of the
	  buffer</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.2 and above.</p></div><p>The <code class="methodname">cut_clipboard</code>() method copies the
currently-selected text to the <a class="link" href="class-gtkclipboard.html" title="gtk.Clipboard"><code class="classname">gtk.Clipboard</code></a>
specified by <em class="parameter"><code>clipboard</code></em>, then deletes said text if
it's editable as specified by
<em class="parameter"><code>default_editable</code></em>. Typically the result of the <a class="link" href="class-gtktextview.html#method-gtktextview--get-editable" title="gtk.TextView.get_editable"><code class="methodname">gtk.TextView.get_editable</code>()</a>
method is appropriate here.</p></div><div class="refsect2" title="gtk.TextBuffer.copy_clipboard"><a name="method-gtktextbuffer--copy-clipboard"></a><h3>gtk.TextBuffer.copy_clipboard</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">copy_clipboard</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>clipboard</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>clipboard</code></strong> :</span></p></td><td>the <a class="link" href="class-gtkclipboard.html" title="gtk.Clipboard"><code class="classname">gtk.Clipboard</code></a>
	  object to copy to.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.2 and above.</p></div><p>The <code class="methodname">copy_clipboard</code>() method copies the
currently-selected text to the <a class="link" href="class-gtkclipboard.html" title="gtk.Clipboard"><code class="classname">gtk.ClipBoard</code></a>
specified by <em class="parameter"><code>clipboard</code></em>.</p></div><div class="refsect2" title="gtk.TextBuffer.paste_clipboard"><a name="method-gtktextbuffer--paste-clipboard"></a><h3>gtk.TextBuffer.paste_clipboard</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">paste_clipboard</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>clipboard</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>override_location</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>default_editable</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>clipboard</code></strong> :</span></p></td><td>the <a class="link" href="class-gtkclipboard.html" title="gtk.Clipboard"><code class="classname">gtk.Clipboard</code></a>
	  to paste from</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>override_location</code></strong> :</span></p></td><td>the <a class="link" href="class-gtktextiter.html" title="gtk.TextIter"><code class="classname">gtk.TextIter</code></a>
	  specifying the location to insert pasted text, or
	  <code class="literal">None</code> for at the cursor</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>default_editable</code></strong> :</span></p></td><td>the default editability of the
	  buffer</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.2 and above.</p></div><p>The <code class="methodname">paste_clipboard</code>() method pastes the
contents of the <a class="link" href="class-gtkclipboard.html" title="gtk.Clipboard"><code class="classname">gtk.ClipBoard</code></a>
specified by <em class="parameter"><code>clipboard</code></em> at the insertion point, or at
the location specified by <em class="parameter"><code>override_location</code></em> (if not
<code class="literal">None</code>).  (Note: pasting is asynchronous, that is, we'll
ask for the paste data and return, and at some point later after the main
loop runs, the paste data will be inserted.)</p></div><div class="refsect2" title="gtk.TextBuffer.get_selection_bounds"><a name="method-gtktextbuffer--get-selection-bounds"></a><h3>gtk.TextBuffer.get_selection_bounds</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_selection_bounds</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a tuple containing <a class="link" href="class-gtktextiter.html" title="gtk.TextIter"><code class="classname">gtk.TextIter</code></a> objects pointing to the selection start and end or an empty tuple if there is no
selection</td></tr></tbody></table><p>The <code class="methodname">get_selection_bounds</code>() method
returns a tuple containing iterators that point at the start and end of the
selection, if any. If there is no selection an empty tuple is
returned.</p></div><div class="refsect2" title="gtk.TextBuffer.delete_selection"><a name="method-gtktextbuffer--delete-selection"></a><h3>gtk.TextBuffer.delete_selection</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">delete_selection</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>interactive</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>default_editable</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>interactive</code></strong> :</span></p></td><td>if <code class="literal">True</code> the deletion is
caused by user interaction</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>default_editable</code></strong> :</span></p></td><td>if <em class="parameter"><code>True</code></em> the buffer is
editable by default</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if there was a
non-empty selection to delete</td></tr></tbody></table><p>The <code class="methodname">delete_selection</code>() method deletes
the text in the range between the "insert" and "selection_bound" marks, i.e.
the currently-selected text. If <em class="parameter"><code>interactive</code></em> is
<code class="literal">True</code>, the editability of the selection will be considered
(users can't delete uneditable text) and default_editable is used to
determine the default editability of the textbuffer usually as a result of a
call to the <a class="link" href="class-gtktextview.html#method-gtktextview--get-editable" title="gtk.TextView.get_editable"><code class="methodname">gtk.TextView.get_editable</code>()</a> 
method.</p></div><div class="refsect2" title="gtk.TextBuffer.begin_user_action"><a name="method-gtktextbuffer--begin-user-action"></a><h3>gtk.TextBuffer.begin_user_action</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">begin_user_action</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="methodname">begin_user_action</code>() method is
called to indicate that the textbuffer operations until a call to the <a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--end-user-action" title="gtk.TextBuffer.end_user_action"><code class="methodname">end_user_action</code>()</a> 
method are part of a single user-visible operation. The operations between
the <code class="methodname">begin_user_action</code>() and <a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--end-user-action" title="gtk.TextBuffer.end_user_action"><code class="methodname">end_user_action</code>()</a> 
methods can then be grouped when creating an undo stack. <a class="link" href="class-gtktextbuffer.html" title="gtk.TextBuffer"><code class="classname">gtk.TextBuffer</code></a>
maintains a count of calls to the
<code class="methodname">begin_user_action</code>() method that have not been
closed with a call to the <a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--end-user-action" title="gtk.TextBuffer.end_user_action"><code class="methodname">end_user_action</code>()</a> 
method, and emits the "begin_user_action" and "end_user_action" signals only
for the outermost pair of calls. This allows you to chain user
actions.</p><p>The "interactive" textbuffer mutation methods, such as the <a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--insert-interactive" title="gtk.TextBuffer.insert_interactive"><code class="methodname">insert_interactive</code>()</a> 
method, automatically call the begin and end user action methods around the
textbuffer operations they perform, so there's no need to add extra calls if
you user action consists solely of a single call to one of those
methods.</p></div><div class="refsect2" title="gtk.TextBuffer.end_user_action"><a name="method-gtktextbuffer--end-user-action"></a><h3>gtk.TextBuffer.end_user_action</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">end_user_action</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="methodname">end_user_action</code>() method should be
paired with a call to the <a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--begin-user-action" title="gtk.TextBuffer.begin_user_action"><code class="methodname">begin_user_action</code>()</a> 
method.</p></div><div class="refsect2" title="gtk.TextBuffer.backspace"><a name="method-gtktextbuffer--backspace"></a><h3>gtk.TextBuffer.backspace</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">backspace</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>iter</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>interactive</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>default_editable</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>iter</code></strong> :</span></p></td><td>a <a class="link" href="class-gtktextiter.html" title="gtk.TextIter"><code class="classname">gtk.TextIter</code></a></td></tr><tr><td><p><span class="term"><strong class="parameter"><code>interactive</code></strong> :</span></p></td><td>if <code class="literal">True</code> the deletion is
caused by user interaction</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>default_editable</code></strong> :</span></p></td><td>if <em class="parameter"><code>True</code></em> the buffer is
editable by default</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the buffer was
modified</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">backspace</code>() method performs the
appropriate action as if the user hit the delete key with the cursor at the
position specified by <em class="parameter"><code>iter</code></em>. In the normal case a
single character will be deleted, but when combining accents are involved,
more than one character can be deleted, and when precomposed character and
accent combinations are involved, less than one character will be
deleted.</p><p>Because the buffer is modified, all outstanding iterators become
invalid after calling this function; however, <em class="parameter"><code>iter</code></em>
will be re-initialized to point to the location where text was
deleted.</p></div><div class="refsect2" title="gtk.TextBuffer.get_has_selection"><a name="method-gtktextbuffer--get-has-selection"></a><h3>gtk.TextBuffer.get_has_selection</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_has_selection</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if there is text
          selected</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.10 and above.</p></div><p>Indicates whether the buffer has some text currently
      selected.</p></div><div class="refsect2" title="gtk.TextBuffer.get_copy_target_list"><a name="method-gtktextbuffer--get-copy-target-list"></a><h3>gtk.TextBuffer.get_copy_target_list</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_copy_target_list</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a list of the targets each represented as a
          3-tuple containing the target name, a combination of the <a class="xref" href="gtk-constants.html#gtk-target-flags-constants" title="GTK Target Flags Constants">GTK Target Flags Constants</a> and an
          application assigned integer</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.10 and above.</p></div><p>This method returns the list of targets this text buffer can
      provide for copying and as DND source. The targets in the list are
      added with <code class="literal">info</code> values from the <a class="xref" href="gtk-constants.html#gtk-textbuffer-target-info-constants" title="GTK TextBuffer Target Info Constants">GTK TextBuffer Target Info Constants</a>, using
      the <a class="link" href="class-gtkselectiondata.html#function-gtk--target-list-add-rich-text-targets" title="gtk.target_list_add_rich_text_targets"><code class="function">gtk.target_list_add_rich_text_targets</code>()</a>
      and <a class="link" href="class-gtkselectiondata.html#function-gtk--target-list-add-text-targets" title="gtk.target_list_add_text_targets"><code class="function">gtk.target_list_add_text_targets</code>()</a>
      functions.</p></div><div class="refsect2" title="gtk.TextBuffer.get_paste_target_list"><a name="method-gtktextbuffer--get-paste-target-list"></a><h3>gtk.TextBuffer.get_paste_target_list</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_paste_target_list</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a list of the targets each represented as a
          3-tuple containing the target name, a combination of the <a class="xref" href="gtk-constants.html#gtk-target-flags-constants" title="GTK Target Flags Constants">GTK Target Flags Constants</a> and an
          application assigned integer</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.10 and above.</p></div><p>This method returns the list of targets this text buffer supports
      for pasting and as DND destination. The targets in the list are
      added with <code class="literal">info</code> values from the <a class="xref" href="gtk-constants.html#gtk-textbuffer-target-info-constants" title="GTK TextBuffer Target Info Constants">GTK TextBuffer Target Info Constants</a>, using
      the <a class="link" href="class-gtkselectiondata.html#function-gtk--target-list-add-rich-text-targets" title="gtk.target_list_add_rich_text_targets"><code class="function">gtk.target_list_add_rich_text_targets</code>()</a>
      and <a class="link" href="class-gtkselectiondata.html#function-gtk--target-list-add-text-targets" title="gtk.target_list_add_text_targets"><code class="function">gtk.target_list_add_text_targets</code>()</a>
      functions.</p></div><div class="refsect2" title="gtk.TextBuffer.register_serialize_format"><a name="method-gtktextbuffer--register-serialize-format"></a><h3>gtk.TextBuffer.register_serialize_format</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">register_serialize_format</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>mime_type</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>function</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>user_data</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>mime_type</code></strong> :</span></p></td><td>the format's mime-type</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>function</code></strong> :</span></p></td><td>the serialize function to register</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>user_data</code></strong> :</span></p></td><td><code class="literal">function</code>'s user_data</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the newly registered format's
          mime-type.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.10 and above.</p></div><p>This method registers a rich text serialization
      <code class="literal">function</code> along with its
      <code class="literal">mime_type</code> with the passed
      <code class="literal">buffer</code>.</p><p>The signature of function is:</p><pre class="programlisting">
  def function(register_buf, content_buf, start, end, data):
      </pre><p>where <em class="parameter"><code>register_buf</code></em> is the textbuffer that
      the format is registered with, <em class="parameter"><code>content_buf</code></em> is
      the textbuffer containing the text to be serialized,
      <em class="parameter"><code>start</code></em> and <em class="parameter"><code>end</code></em> are
      textiters bounding the text to be serialized and
      <em class="parameter"><code>data</code></em> is
      <em class="parameter"><code>user_data</code></em>. <em class="parameter"><code>function</code></em>
      should return the serialized data.</p></div><div class="refsect2" title="gtk.TextBuffer.register_serialize_tagset"><a name="method-gtktextbuffer--register-serialize-tagset"></a><h3>gtk.TextBuffer.register_serialize_tagset</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">register_serialize_tagset</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>tagset_name</code></strong></span><span class="initializer">=NULL</span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>tagset_name</code></strong> :</span></p></td><td>an optional tagset name, or
          <code class="literal">None</code></td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the newly registered format's
          mime-type.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.10 and above.</p></div><p>This method registers GTK+'s internal rich text serialization
      format with this textbuffer. The internal format does not comply to
      any standard rich text format and only works between <a class="link" href="class-gtktextbuffer.html" title="gtk.TextBuffer"><code class="classname">gtk.TextBuffer</code></a>
      instances. It is capable of serializing all of a text buffer's tags
      and embedded pixbufs.</p><p>This method is just a wrapper around <a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--register-serialize-format" title="gtk.TextBuffer.register_serialize_format"><code class="methodname">gtk.TextBuffer.register_serialize_format()</code></a>. The
      <code class="literal">mime_type</code> used for registering is
      "application/x-gtk-text-buffer-rich-text", or
      "application/x-gtk-text-buffer-rich-text;format=<code class="literal">tagset_name</code>"
      if a <code class="literal">tagset_name</code> was passed.</p><p>The <code class="literal">tagset_name</code> can be used to restrict the
      transfer of rich text to buffers with compatible sets of tags, in
      order to avoid unknown tags from being pasted. It is probably the
      common case to pass a non-<code class="literal">None</code> tagset here,
      since the <code class="literal">None</code> tagset requires the receiving buffer
      to deal with with pasting of arbitrary tags.</p></div><div class="refsect2" title="gtk.TextBuffer.register_deserialize_format"><a name="method-gtktextbuffer--register-deserialize-format"></a><h3>gtk.TextBuffer.register_deserialize_format</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">register_deserialize_format</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>mime_type</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>function</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>user_data</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>mime_type</code></strong> :</span></p></td><td>the format's mime-type</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>function</code></strong> :</span></p></td><td>the deserialize function to register</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>user_data</code></strong> :</span></p></td><td><code class="literal">function</code>'s user_data</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the newly registered format's
          mime-type.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.10 and above.</p></div><p>This method registers a rich text deserialization
      <code class="literal">function</code> along with its
      <code class="literal">mime_type</code> with the passed
      <code class="literal">buffer</code>.</p><p>The signature of function is:</p><pre class="programlisting">
  def function(register_buf, content_buf, iter, data, create_tags, udata):
      </pre><p>where <em class="parameter"><code>register_buf</code></em> is the textbuffer that
      the format is registered with, <em class="parameter"><code>content_buf</code></em> is
      the textbuffer that data will be deserialized into,
      <em class="parameter"><code>iter</code></em> is a textiter indicating the start of the
      deserialized data in <em class="parameter"><code>content_buf</code></em>, create_tags
      is a boolean indicating if tags should be created during
      deserializtion and <em class="parameter"><code>udata</code></em> is
      <em class="parameter"><code>user_data</code></em>. <em class="parameter"><code>function</code></em>
      should return <code class="literal">True</code> if the data was successfully
      deserialized.</p></div><div class="refsect2" title="gtk.TextBuffer.register_deserialize_tagset"><a name="method-gtktextbuffer--register-deserialize-tagset"></a><h3>gtk.TextBuffer.register_deserialize_tagset</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">register_deserialize_tagset</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>tagset_name</code></strong></span><span class="initializer">=NULL</span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>tagset_name</code></strong> :</span></p></td><td>an optional tagset name, or
          <code class="literal">None</code></td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the newly registered format's
          mime-type.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.10 and above.</p></div><p>This method registers GTK+'s internal rich text serialization
      format with this buffer. See the <a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--register-serialize-tagset" title="gtk.TextBuffer.register_serialize_tagset"><code class="methodname">gtk.TextBuffer.register_serialize_tagset()</code></a>
      method for details.</p></div><div class="refsect2" title="gtk.TextBuffer.unregister_serialize_format"><a name="method-gtktextbuffer--unregister-serialize-format"></a><h3>gtk.TextBuffer.unregister_serialize_format</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">unregister_serialize_format</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>format</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>format</code></strong> :</span></p></td><td>a target string representing a registered rich
          text format.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.10 and above.</p></div><p>This method unregisters a rich text format that was previously
      registered using the <a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--register-serialize-format" title="gtk.TextBuffer.register_serialize_format"><code class="methodname">gtk.TextBuffer.register_serialize_format()</code></a>
      or <a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--register-serialize-tagset" title="gtk.TextBuffer.register_serialize_tagset"><code class="methodname">gtk.TextBuffer.register_serialize_tagset()</code></a>
      methods.</p></div><div class="refsect2" title="gtk.TextBuffer.unregister_deserialize_format"><a name="method-gtktextbuffer--unregister-deserialize-format"></a><h3>gtk.TextBuffer.unregister_deserialize_format</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">unregister_deserialize_format</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>format</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>format</code></strong> :</span></p></td><td>a target string representing a registered rich
          text format.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.10 and above.</p></div><p>This method unregisters a rich text format that was previously
      registered using the <a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--register-deserialize-format" title="gtk.TextBuffer.register_deserialize_format"><code class="methodname">gtk.TextBuffer.register_deserialize_format()</code></a>
      or <a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--register-deserialize-tagset" title="gtk.TextBuffer.register_deserialize_tagset"><code class="methodname">gtk.TextBuffer.register_deserialize_tagset()</code></a>
      methods.</p></div><div class="refsect2" title="gtk.TextBuffer.deserialize_set_can_create_tags"><a name="method-gtktextbuffer--deserialize-set-can-create-tags"></a><h3>gtk.TextBuffer.deserialize_set_can_create_tags</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">deserialize_set_can_create_tags</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>format</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>can_create_tags</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>format</code></strong> :</span></p></td><td>a target string representing a registered rich
          text format</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>can_create_tags</code></strong> :</span></p></td><td>if <code class="literal">True</code> deserializing
          <em class="parameter"><code>format</code></em> may create tags</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.10 and above.</p></div><p>Use this method to allow a rich text deserialization function to
      create new tags in the receiving buffer. Note that using this method
      is almost always a bad idea, because the rich text functions you
      register should know how to map the rich text format they handle to
      your text buffers set of tags.</p><p>The ability of creating new (arbitrary!) tags in the receiving
      buffer is meant for special rich text formats like the internal one
      that is registered using <a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--register-deserialize-tagset" title="gtk.TextBuffer.register_deserialize_tagset"><code class="methodname">gtk.TextBuffer.register_deserialize_tagset()</code></a>,
      because that format is essentially a dump of the internal structure of
      the source buffer, including its tag names.</p><p>You should allow creation of tags only if you know what you are
      doing, e.g. if you defined a tagset name for your application suite's
      text buffers and you know that it's fine to receive new tags from
      these buffers, because you know that your application can handle the
      newly created tags.</p></div><div class="refsect2" title="gtk.TextBuffer.deserialize_get_can_create_tags"><a name="method-gtktextbuffer--deserialize-get-can-create-tags"></a><h3>gtk.TextBuffer.deserialize_get_can_create_tags</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">deserialize_get_can_create_tags</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>format</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>format</code></strong> :</span></p></td><td>a target string representing a registered rich
          text format</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if deserializing
          <em class="parameter"><code>format</code></em> may create tags</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.10 and above.</p></div><p>This method returns the value set with the <a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--deserialize-set-can-create-tags" title="gtk.TextBuffer.deserialize_set_can_create_tags"><code class="methodname">gtk.TextBuffer.deserialize_set_can_create_tags()</code></a>
      method.</p></div><div class="refsect2" title="gtk.TextBuffer.get_serialize_formats"><a name="method-gtktextbuffer--get-serialize-formats"></a><h3>gtk.TextBuffer.get_serialize_formats</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_serialize_formats</span>()</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a list of target strings representing the
          registered formats.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.10 and above.</p></div><p>This method returns a list of the rich text serialize formats
      registered using the <a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--register-serialize-format" title="gtk.TextBuffer.register_serialize_format"><code class="methodname">gtk.TextBuffer.register_serialize_format()</code></a>
      or <a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--register-serialize-tagset" title="gtk.TextBuffer.register_serialize_tagset"><code class="methodname">gtk.TextBuffer.register_serialize_tagset()</code></a>
      methods.</p></div><div class="refsect2" title="gtk.TextBuffer.get_deserialize_formats"><a name="method-gtktextbuffer--get-deserialize-formats"></a><h3>gtk.TextBuffer.get_deserialize_formats</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_deserialize_formats</span>()</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a list of target strings representing the
          registered formats.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.10 and above.</p></div><p>This method returns the rich text deserialize formats registered
      using the <a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--register-deserialize-format" title="gtk.TextBuffer.register_deserialize_format"><code class="methodname">gtk.TextBuffer.register_deserialize_format()</code></a>
      or <a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--register-deserialize-tagset" title="gtk.TextBuffer.register_deserialize_tagset"><code class="methodname">gtk.TextBuffer.register_deserialize_tagset()</code></a>
      methods.</p></div><div class="refsect2" title="gtk.TextBuffer.serialize"><a name="method-gtktextbuffer--serialize"></a><h3>gtk.TextBuffer.serialize</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">serialize</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>content_buffer</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>format</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>start</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>end</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>content_buffer</code></strong> :</span></p></td><td>the <a class="link" href="class-gtktextbuffer.html" title="gtk.TextBuffer"><code class="classname">gtk.TextBuffer</code></a>
          to serialize</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>format</code></strong> :</span></p></td><td>the rich text format to use for
          serializing</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>start</code></strong> :</span></p></td><td>start of block of text to
          serialize</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>end</code></strong> :</span></p></td><td>end of block of test to
          serialize</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the serialized data, encoded as
          <code class="literal">format</code></td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.10 and above.</p></div><p>This method serializes the portion of text between <code class="literal">start</code>
      and <code class="literal">end</code> in the rich text format represented by <code class="literal">format</code>.</p><p>The formats to be used must be registered using the <a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--register-serialize-format" title="gtk.TextBuffer.register_serialize_format"><code class="methodname">gtk.TextBuffer.register_serialize_format()</code></a>
            or <a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--register-serialize-tagset" title="gtk.TextBuffer.register_serialize_tagset"><code class="methodname">gtk.TextBuffer.register_serialize_tagset()</code></a>
            methods beforehand.</p></div><div class="refsect2" title="gtk.TextBuffer.deserialize"><a name="method-gtktextbuffer--deserialize"></a><h3>gtk.TextBuffer.deserialize</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">deserialize</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>content_buffer</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>format</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>iter</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>data</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>content_buffer</code></strong> :</span></p></td><td>the <a class="link" href="class-gtktextbuffer.html" title="gtk.TextBuffer"><code class="classname">gtk.TextBuffer</code></a>
          to deserialize into</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>format</code></strong> :</span></p></td><td>the rich text format to use for
          deserializing</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>iter</code></strong> :</span></p></td><td>insertion point for the deserialized
          text</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>data</code></strong> :</span></p></td><td>data to deserialize</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> on success,
          <code class="literal">False</code> otherwise.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.10 and above.</p></div><p>This method deserializes rich text in format
      <code class="literal">format</code> and inserts it at <code class="literal">iter</code> in
      <em class="parameter"><code>content_buffer</code></em>.</p><p>The formats to be used must be registered using the <a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--register-deserialize-format" title="gtk.TextBuffer.register_deserialize_format"><code class="methodname">gtk.TextBuffer.register_deserialize_format()</code></a>
            or <a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--register-deserialize-tagset" title="gtk.TextBuffer.register_deserialize_tagset"><code class="methodname">gtk.TextBuffer.register_deserialize_tagset()</code></a>
            methods beforehand.</p></div><div class="refsect2" title="gtk.TextBuffer.add_mark"><a name="method-gtktextbuffer--add-mark"></a><h3>gtk.TextBuffer.add_mark</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">add_mark</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>mark</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>where</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>mark</code></strong> :</span></p></td><td>the <a class="link" href="class-gtktextmark.html" title="gtk.TextMark"><code class="classname">gtk.TextMark</code></a>
          to add</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>where</code></strong> :</span></p></td><td>the location to place mark.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.12 and above.</p></div><p>Adds the <em class="parameter"><code>mark</code></em> at position <em class="parameter"><code>where</code></em>.
      The mark must not be added to another buffer, and if its name is not <code class="literal">None</code>
      then there must not be another mark in the buffer with the same name.</p><p>Emits the "mark_set" signal as notification of the mark's initial placement.</p></div></div><div class="refsect1" title="Signals"><a name="id3949597"></a><h2>Signals</h2><div class="refsect2" title='The "apply-tag" gtk.TextBuffer Signal'><a name="signal-gtktextbuffer--apply-tag"></a><h3>The "apply-tag" gtk.TextBuffer Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>textbuffer</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>texttag</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>start</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>end</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>textbuffer</code></em> :</span></p></td><td>the textbuffer that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>texttag</code></em> :</span></p></td><td>the <a class="link" href="class-gtktexttag.html" title="gtk.TextTag"><code class="classname">gtk.TextTag</code></a> being
applied</td></tr><tr><td><p><span class="term"><em class="parameter"><code>start</code></em> :</span></p></td><td>a <a class="link" href="class-gtktextiter.html" title="gtk.TextIter"><code class="classname">gtk.TextIter</code></a>
pointing to the start of the range of text</td></tr><tr><td><p><span class="term"><em class="parameter"><code>end</code></em> :</span></p></td><td>a <a class="link" href="class-gtktextiter.html" title="gtk.TextIter"><code class="classname">gtk.TextIter</code></a>
pointing to the end of the range of text</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>The "apply-tag" signal is emitted when
<em class="parameter"><code>texttag</code></em> is applied to the text in
<em class="parameter"><code>textbuffer</code></em> in the range specified by
<em class="parameter"><code>start</code></em> and <em class="parameter"><code>end</code></em>.</p></div><div class="refsect2" title='The "begin-user-action" gtk.TextBuffer Signal'><a name="signal-gtktextbuffer--begin-user-action"></a><h3>The "begin-user-action" gtk.TextBuffer Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>textbuffer</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>textbuffer</code></em> :</span></p></td><td>the textbuffer that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>The "begin-user-action" signal is emitted on the first call to
the <a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--begin-user-action" title="gtk.TextBuffer.begin_user_action"><code class="methodname">begin_user_action</code>()</a> 
method.</p></div><div class="refsect2" title='The "changed" gtk.TextBuffer Signal'><a name="signal-gtktextbuffer--changed"></a><h3>The "changed" gtk.TextBuffer Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>textbuffer</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>textbuffer</code></em> :</span></p></td><td>the textbuffer that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>The "changed" signal is emitted when text is inserted in
<em class="parameter"><code>textbuffer</code></em>.</p></div><div class="refsect2" title='The "delete-range" gtk.TextBuffer Signal'><a name="signal-gtktextbuffer--delete-range"></a><h3>The "delete-range" gtk.TextBuffer Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>textbuffer</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>start</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>end</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>textbuffer</code></em> :</span></p></td><td>the textbuffer that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>start</code></em> :</span></p></td><td>a <a class="link" href="class-gtktextiter.html" title="gtk.TextIter"><code class="classname">gtk.TextIter</code></a>
pointing to the start of the range of text</td></tr><tr><td><p><span class="term"><em class="parameter"><code>end</code></em> :</span></p></td><td>a <a class="link" href="class-gtktextiter.html" title="gtk.TextIter"><code class="classname">gtk.TextIter</code></a>
pointing to the end of the range of text</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>The "delete-range" signal is emitted when the text in the range
specified by <em class="parameter"><code>start</code></em> and <em class="parameter"><code>end</code></em> is
to be deleted.</p></div><div class="refsect2" title='The "end-user-action" gtk.TextBuffer Signal'><a name="signal-gtktextbuffer--end-user-action"></a><h3>The "end-user-action" gtk.TextBuffer Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>textbuffer</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>textbuffer</code></em> :</span></p></td><td>the textbuffer that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>The "end-user-action" signal is emitted when the call to the
<a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--end-user-action" title="gtk.TextBuffer.end_user_action"><code class="methodname">end_user_action</code>()</a> 
method reduces the user action count to zero i.e. undoes the first call to
the <a class="link" href="class-gtktextbuffer.html#method-gtktextbuffer--begin-user-action" title="gtk.TextBuffer.begin_user_action"><code class="methodname">begin_user_action</code>()</a> 
method.</p></div><div class="refsect2" title='The "insert-child-anchor" gtk.TextBuffer Signal'><a name="signal-gtktextbuffer--insert-child-anchor"></a><h3>The "insert-child-anchor" gtk.TextBuffer Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>textbuffer</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>iter</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>anchor</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>textbuffer</code></em> :</span></p></td><td>the textbuffer that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td><td>a <a class="link" href="class-gtktextiter.html" title="gtk.TextIter"><code class="classname">gtk.TextIter</code></a></td></tr><tr><td><p><span class="term"><em class="parameter"><code>anchor</code></em> :</span></p></td><td>a <a class="link" href="class-gtktextchildanchor.html" title="gtk.TextChildAnchor"><code class="classname">gtk.TextChildAnchor</code></a></td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>The "insert-child-anchor" signal is emitted when
<em class="parameter"><code>anchor</code></em> is inserted into
<em class="parameter"><code>textbuffer</code></em> at the location specified by
<em class="parameter"><code>iter</code></em>.</p></div><div class="refsect2" title='The "insert-pixbuf" gtk.TextBuffer Signal'><a name="signal-gtktextbuffer--insert-pixbuf"></a><h3>The "insert-pixbuf" gtk.TextBuffer Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>textbuffer</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>iter</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>pixbuf</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>textbuffer</code></em> :</span></p></td><td>the textbuffer that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td><td>a <a class="link" href="class-gtktextiter.html" title="gtk.TextIter"><code class="classname">gtk.TextIter</code></a></td></tr><tr><td><p><span class="term"><em class="parameter"><code>pixbuf</code></em> :</span></p></td><td>a <a class="link" href="class-gdkpixbuf.html" title="gtk.gdk.Pixbuf"><code class="classname">gtk.gdk.Pixbuf</code></a></td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>The "insert-pixbuf" signal is emitted when
<em class="parameter"><code>pixbuf</code></em> is inserted into
<em class="parameter"><code>textbuffer</code></em> at the location specified by
<em class="parameter"><code>iter</code></em>.</p></div><div class="refsect2" title='The "insert-text" gtk.TextBuffer Signal'><a name="signal-gtktextbuffer--insert-text"></a><h3>The "insert-text" gtk.TextBuffer Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>textbuffer</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>iter</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>text</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>length</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>textbuffer</code></em> :</span></p></td><td>the textbuffer that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td><td>a <a class="link" href="class-gtktextiter.html" title="gtk.TextIter"><code class="classname">gtk.TextIter</code></a></td></tr><tr><td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td><td>the text inserted in
<em class="parameter"><code>textbuffer</code></em></td></tr><tr><td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td><td>the length of the text inserted in
<em class="parameter"><code>textbuffer</code></em></td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>The "insert-text" signal is emitted when
<em class="parameter"><code>text</code></em> of the size specified by
<em class="parameter"><code>length</code></em> is inserted into
<em class="parameter"><code>textbuffer</code></em> at the location specified by
<em class="parameter"><code>iter</code></em>.</p></div><div class="refsect2" title='The "mark-deleted" gtk.TextBuffer Signal'><a name="signal-gtktextbuffer--mark-deleted"></a><h3>The "mark-deleted" gtk.TextBuffer Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>textbuffer</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>textmark</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>textbuffer</code></em> :</span></p></td><td>the textbuffer that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>textmark</code></em> :</span></p></td><td>the <a class="link" href="class-gtktextmark.html" title="gtk.TextMark"><code class="classname">gtk.TextMark</code></a>
	  that is being deleted</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>The "mark-deleted" signal is emitted when
<em class="parameter"><code>textmark</code></em> is being deleted from
<em class="parameter"><code>textbuffer</code></em>.</p></div><div class="refsect2" title='The "mark-set" gtk.TextBuffer Signal'><a name="signal-gtktextbuffer--mark-set"></a><h3>The "mark-set" gtk.TextBuffer Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>textbuffer</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>iter</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>textmark</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>textbuffer</code></em> :</span></p></td><td>the textbuffer that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td><td>a <a class="link" href="class-gtktextiter.html" title="gtk.TextIter"><code class="classname">gtk.TextIter</code></a>
pointing at the location where <em class="parameter"><code>textmark</code></em> will be
set.</td></tr><tr><td><p><span class="term"><em class="parameter"><code>textmark</code></em> :</span></p></td><td>the <a class="link" href="class-gtktextmark.html" title="gtk.TextMark"><code class="classname">gtk.TextMark</code></a>
	  that is being set</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>The "mark-set" signal is emitted when
<em class="parameter"><code>textmark</code></em> is being set at the location specified by
<em class="parameter"><code>iter</code></em> in <em class="parameter"><code>textbuffer</code></em>.</p></div><div class="refsect2" title='The "modified-changed" gtk.TextBuffer Signal'><a name="signal-gtktextbuffer--modified-changed"></a><h3>The "modified-changed" gtk.TextBuffer Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>textbuffer</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>textbuffer</code></em> :</span></p></td><td>the textbuffer that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>The "modified-changed" signal is emitted when the modification
flag is changed.</p></div><div class="refsect2" title='The "paste-done" gtk.TextBuffer Signal'><a name="signal-gtktextbuffer--paste-done"></a><h3>The "paste-done" gtk.TextBuffer Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>textbuffer</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>textbuffer</code></em> :</span></p></td><td>the textbuffer that received the signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified with the
          <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
          method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if any)</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This signal is available in GTK+ 2.16 and above.</p></div><p>The "paste-done" signal is emitted after paste operation has been completed.
      This is useful to properly scroll the view to the end of the pasted text.</p></div><div class="refsect2" title='The "remove-tag" gtk.TextBuffer Signal'><a name="signal-gtktextbuffer--remove-tag"></a><h3>The "remove-tag" gtk.TextBuffer Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>textbuffer</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>texttag</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>start</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>end</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>textbuffer</code></em> :</span></p></td><td>the textbuffer that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>texttag</code></em> :</span></p></td><td>the <a class="link" href="class-gtktexttag.html" title="gtk.TextTag"><code class="classname">gtk.TextTag</code></a> being
removed</td></tr><tr><td><p><span class="term"><em class="parameter"><code>start</code></em> :</span></p></td><td>a <a class="link" href="class-gtktextiter.html" title="gtk.TextIter"><code class="classname">gtk.TextIter</code></a>
pointing to the start of the range of text</td></tr><tr><td><p><span class="term"><em class="parameter"><code>end</code></em> :</span></p></td><td>a <a class="link" href="class-gtktextiter.html" title="gtk.TextIter"><code class="classname">gtk.TextIter</code></a>
 pointing to the end of the range of text</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>The "remove-tag" signal is emitted when
<em class="parameter"><code>texttag</code></em> is being removed from the
<em class="parameter"><code>textbuffer</code></em> text in the range specified by
<em class="parameter"><code>start</code></em> and <em class="parameter"><code>end</code></em>.</p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="class-gtktextattributes.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="gtk-class-reference.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="class-gtktextchildanchor.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">gtk.TextAttributes </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> gtk.TextChildAnchor</td></tr></table></div></body></html>
python-gtk2-doc 2.24.0-3 / usr / share / gtk-doc / html / pygtk / class-gtktextbuffer.html
