/usr/share/doc/python-gtk2-tutorial/html/ch-TextViewWidget.html is in python-gtk2-tutorial 2.4-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 | <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Chapter 13. TextView Widget</title><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="index.html" title="PyGTK 2.0 Tutorial"><link rel="up" href="index.html" title="PyGTK 2.0 Tutorial"><link rel="previous" href="sec-DrawingMethods.html" title="12.2. Drawing Methods"><link rel="next" href="sec-TextViews.html" title="13.2. TextViews"></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">Chapter 13. TextView Widget</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="sec-DrawingMethods.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="sec-TextViews.html">Next</a></td></tr></table><hr></div><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="ch-TextViewWidget"></a>Chapter 13. TextView Widget</h2></div></div><div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="ch-TextViewWidget.html#sec-TextViewOverview">13.1. TextView Overview</a></span></dt><dt><span class="sect1"><a href="sec-TextViews.html">13.2. TextViews</a></span></dt><dt><span class="sect1"><a href="sec-TextBuffers.html">13.3. Text Buffers</a></span></dt><dd><dl><dt><span class="sect2"><a href="sec-TextBuffers.html#id3108401">13.3.1. TextBuffer Status Information</a></span></dt><dt><span class="sect2"><a href="sec-TextBuffers.html#id3108455">13.3.2. Creating TextIters</a></span></dt><dt><span class="sect2"><a href="sec-TextBuffers.html#id3121630">13.3.3. Text Insertion, Retrieval and Deletion</a></span></dt><dt><span class="sect2"><a href="sec-TextBuffers.html#id3122000">13.3.4. TextMarks</a></span></dt><dt><span class="sect2"><a href="sec-TextBuffers.html#id3122216">13.3.5. Creating and Applying TextTags</a></span></dt><dt><span class="sect2"><a href="sec-TextBuffers.html#id3122398">13.3.6. Inserting Images and Widgets</a></span></dt></dl></dd><dt><span class="sect1"><a href="sec-TextIters.html">13.4. Text Iters</a></span></dt><dd><dl><dt><span class="sect2"><a href="sec-TextIters.html#id3122662">13.4.1. TextIter Attributes</a></span></dt><dt><span class="sect2"><a href="sec-TextIters.html#id3122704">13.4.2. Text Attributes at a TextIter</a></span></dt><dt><span class="sect2"><a href="sec-TextIters.html#id3123006">13.4.3. Copying a TextIter</a></span></dt><dt><span class="sect2"><a href="sec-TextIters.html#id3123025">13.4.4. Retrieving Text and Objects</a></span></dt><dt><span class="sect2"><a href="sec-TextIters.html#id3123068">13.4.5. Checking Conditions at a TextIter</a></span></dt><dt><span class="sect2"><a href="sec-TextIters.html#id3123315">13.4.6. Checking Location in Text</a></span></dt><dt><span class="sect2"><a href="sec-TextIters.html#id3123413">13.4.7. Moving Through Text</a></span></dt><dt><span class="sect2"><a href="sec-TextIters.html#id3123547">13.4.8. Moving to a Specific Location</a></span></dt><dt><span class="sect2"><a href="sec-TextIters.html#id3123641">13.4.9. Searching in Text</a></span></dt></dl></dd><dt><span class="sect1"><a href="sec-TextMarks.html">13.5. Text Marks</a></span></dt><dt><span class="sect1"><a href="sec-TextTagsAndTextTagTables.html">13.6. Text Tags and Tag Tables</a></span></dt><dd><dl><dt><span class="sect2"><a href="sec-TextTagsAndTextTagTables.html#sec-TextTags">13.6.1. Text Tags</a></span></dt><dt><span class="sect2"><a href="sec-TextTagsAndTextTagTables.html#sec-TextTagTables">13.6.2. Text Tag Tables</a></span></dt></dl></dd><dt><span class="sect1"><a href="sec-TextViewExample.html">13.7. A TextView Example</a></span></dt></dl></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="sec-TextViewOverview"></a>13.1. TextView Overview</h2></div></div><div></div></div><p><tt class="classname">TextView</tt> widgets and their associated
objects (<tt class="classname">TextBuffer</tt>s,
<tt class="classname">TextMark</tt>s, <tt class="classname">TextIter</tt>s,
<tt class="classname">TextTag</tt>s and <tt class="classname">TextTagTable</tt>s)
provide a powerful framework for multiline text editing.</p><p>A <tt class="classname">TextBuffer</tt> (see <a href="sec-TextBuffers.html" title="13.3. Text Buffers">Section 13.3, “Text Buffers”</a>) contains the text which is displayed by
one or more <tt class="classname">TextView</tt> widgets.</p><p>Within GTK+ 2.0, text is encoded in UTF-8 which means that one
character may be encoded as multiple bytes. Within a
<tt class="classname">TextBuffer</tt> it is necessary to differentiate between
the character counts (called offsets) and the byte counts (called
indexes).</p><p><tt class="classname">TextIters</tt> provide a volatile representation
of the position in a <tt class="classname">TextBuffer</tt> between two
characters. <tt class="classname">TextIters</tt> are valid until the number of
characters in the <tt class="classname">TextBuffer</tt> changes; i.e. any time
characters are inserted or deleted from a <tt class="classname">TextBuffer</tt>
all <tt class="classname">TextIters</tt> will become invalid.
<tt class="classname">TextIters</tt> are the primary way to specify locations in
a <tt class="classname">TextBuffer</tt> for manipulating text.</p><p><tt class="classname">TextMarks</tt> are provided to allow
preservation of <tt class="classname">TextBuffer</tt> positions across buffer
modifications. A mark is like a <tt class="classname">TextIter</tt> (see <a href="sec-TextIters.html" title="13.4. Text Iters">Section 13.4, “Text Iters”</a>) in that it represents a position between
two characters in a <tt class="classname">TextBuffer</tt>) but if the text
surrounding the mark is deleted the mark remains where the deleted text once
was. Likewise, if text is inserted at the mark the mark ends up either to
the left or right of the inserted text depending on the gravity of the mark
- right gravity leaves the mark to the right of the inserted text while left
gravity leaves it to the left. <tt class="classname">TextMark</tt>s (see <a href="sec-TextMarks.html" title="13.5. Text Marks">Section 13.5, “Text Marks”</a>) may be named or anonymous if not given a
name. Each <tt class="classname">TextBuffer</tt> has two predefined named
<tt class="classname">TextMark</tt>s (see <a href="sec-TextMarks.html" title="13.5. Text Marks">Section 13.5, “Text Marks”</a>)
called <i class="parameter"><tt>insert</tt></i> and
<i class="parameter"><tt>selection_bound</tt></i>. These refer to the insertion point
and the boundary of the selection (the selection is between the
<i class="parameter"><tt>insert</tt></i> and the <i class="parameter"><tt>selection_bound</tt></i>
marks).</p><p><tt class="classname">TextTag</tt>s (see <a href="sec-TextTagsAndTextTagTables.html#sec-TextTags" title="13.6.1. Text Tags">Section 13.6.1, “Text Tags”</a>) are objects that specify a set of attributes
that can be applied to a range of text in a
<tt class="classname">TextBuffer</tt>. Each <tt class="classname">TextBuffer</tt>
has a <tt class="classname">TextTagTable</tt> (see <a href="sec-TextTagsAndTextTagTables.html#sec-TextTagTables" title="13.6.2. Text Tag Tables">Section 13.6.2, “Text Tag Tables”</a>) which contains the tags that are
available in that buffer. <tt class="classname">TextTagTable</tt>s can be shared
between <tt class="classname">TextBuffer</tt>s to provide
commonality. <tt class="classname">TextTag</tt>s are generally used to change
the appearance of a range of text but can also be used to prevent a range of
text from being edited.</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="sec-DrawingMethods.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="index.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="sec-TextViews.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">12.2. Drawing Methods </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 13.2. TextViews</td></tr></table></div></body></html>
|