1
<?xml version="1.0" encoding="iso-8859-1"?>
2
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "DTD/xhtml1-strict.dtd">
3
<html><head><title>QTextFrame Class Reference</title><style>h3.fn,span.fn { margin-left: 1cm; text-indent: -1cm }
4
a:link { color: #004faf; text-decoration: none }
5
a:visited { color: #672967; text-decoration: none }
6
td.postheader { font-family: sans-serif }
7
tr.address { font-family: sans-serif }
8
body { background: #ffffff; color: black; }
9
</style></head><body><table border="0" cellpadding="0" cellspacing="0" width="100%"><tr /><td align="left" valign="top" width="32"><img align="left" border="0" height="32" src="images/rb-logo.png" width="32" /></td><td width="1">  </td><td class="postheader" valign="center"><a href="index.html"><font color="#004faf">Home</font></a> · <a href="classes.html"><font color="#004faf">All Classes</font></a> · <a href="modules.html"><font color="#004faf">Modules</font></a></td></table><h1 align="center">QTextFrame Class Reference<br /><sup><sup>[<a href="qtgui.html">QtGui</a> module]</sup></sup></h1><p>The QTextFrame class represents a frame in a <a href="qtextdocument.html">QTextDocument</a>. <a href="#details">More...</a></p>
11
<p>Inherits <a href="qtextobject.html">QTextObject</a>.</p><p>Inherited by <a href="qtexttable.html">QTextTable</a>.</p><h3>Types</h3><ul><li><div class="fn" />class <b><a href="qtextframe-iterator.html">iterator</a></b></li></ul><h3>Methods</h3><ul><li><div class="fn" /><b><a href="qtextframe.html#QTextFrame">__init__</a></b> (<i>self</i>, QTextDocument <i>doc</i>)</li><li><div class="fn" />iterator <b><a href="qtextframe.html#begin">begin</a></b> (<i>self</i>)</li><li><div class="fn" />list-of-QTextFrame <b><a href="qtextframe.html#childFrames">childFrames</a></b> (<i>self</i>)</li><li><div class="fn" />iterator <b><a href="qtextframe.html#end">end</a></b> (<i>self</i>)</li><li><div class="fn" />QTextCursor <b><a href="qtextframe.html#firstCursorPosition">firstCursorPosition</a></b> (<i>self</i>)</li><li><div class="fn" />int <b><a href="qtextframe.html#firstPosition">firstPosition</a></b> (<i>self</i>)</li><li><div class="fn" />QTextFrameFormat <b><a href="qtextframe.html#frameFormat">frameFormat</a></b> (<i>self</i>)</li><li><div class="fn" />QTextCursor <b><a href="qtextframe.html#lastCursorPosition">lastCursorPosition</a></b> (<i>self</i>)</li><li><div class="fn" />int <b><a href="qtextframe.html#lastPosition">lastPosition</a></b> (<i>self</i>)</li><li><div class="fn" />QTextFrame <b><a href="qtextframe.html#parentFrame">parentFrame</a></b> (<i>self</i>)</li><li><div class="fn" /><b><a href="qtextframe.html#setFrameFormat">setFrameFormat</a></b> (<i>self</i>, QTextFrameFormat <i>aformat</i>)</li></ul><a name="details" /><hr /><h2>Detailed Description</h2><p>The QTextFrame class represents a frame in a <a href="qtextdocument.html">QTextDocument</a>.</p>
12
<p>Text frames provide structure for the text in a document. They
13
are used as generic containers for other document elements. Frames
14
are usually created by using <a href="qtextcursor.html#insertFrame">QTextCursor.insertFrame</a>().</p>
15
<p>Frames can be used to create hierarchical structures in rich
16
text documents. Each document has a root frame (<a href="qtextdocument.html#rootFrame">QTextDocument.rootFrame</a>()), and
17
each frame beneath the root frame has a parent frame and a
18
(possibly empty) list of child frames. The parent frame can be
19
found with <a href="qtextframe.html#parentFrame">parentFrame</a>(),
20
and the <a href="qtextframe.html#childFrames">childFrames</a>()
21
function provides a list of child frames.</p>
22
<p>Each frame contains at least one text block to enable text
23
cursors to insert new document elements within. As a result, the
24
<a href="qtextframe-iterator.html">QTextFrame.iterator</a> class
25
is used to traverse both the blocks and child frames within a given
26
frame. The first and last child elements in the frame can be found
27
with <a href="qtextframe.html#begin">begin</a>() and <a href="qtextframe.html#end">end</a>().</p>
28
<p>A frame also has a format (specified using <a href="qtextframeformat.html">QTextFrameFormat</a>) which can be set with
29
<a href="qtextobject.html#setFormat">setFormat</a>() and read with
30
<a href="qtextobject.html#format">format</a>().</p>
31
<p>Text cursors can be obtained that point to the first and last
32
valid cursor positions within a frame; use the <a href="qtextframe.html#firstCursorPosition">firstCursorPosition</a>() and
33
<a href="qtextframe.html#lastCursorPosition">lastCursorPosition</a>()
34
functions for this. The frame's extent in the document can be found
35
with <a href="qtextframe.html#firstPosition">firstPosition</a>()
36
and <a href="qtextframe.html#lastPosition">lastPosition</a>().</p>
37
<p>You can iterate over a frame's contents using the <a href="qtextframe-iterator.html">QTextFrame.iterator</a> class: this
38
provides read-only access to its internal list of text blocks and
40
<hr /><h2>Method Documentation</h2><h3 class="fn"><a name="QTextFrame" />QTextFrame.__init__ (<i>self</i>, <a href="qtextdocument.html">QTextDocument</a> <i>doc</i>)</h3><p>Creates a new empty frame for the text <i>document</i>.</p>
43
<h3 class="fn"><a name="begin" /><a href="qtextframe-iterator.html">iterator</a> QTextFrame.begin (<i>self</i>)</h3><p>Returns an iterator pointing to the first document element
44
inside the frame. Please see the document <a href="containers.html#stl-style-iterators">STL-style-Iterators</a> for
46
<p><b>See also</b> <a href="qtextframe.html#end">end</a>().</p>
49
<h3 class="fn"><a name="childFrames" />list-of-QTextFrame QTextFrame.childFrames (<i>self</i>)</h3><p>Returns a (possibly empty) list of the frame's child frames.</p>
50
<p><b>See also</b> <a href="qtextframe.html#parentFrame">parentFrame</a>().</p>
53
<h3 class="fn"><a name="end" /><a href="qtextframe-iterator.html">iterator</a> QTextFrame.end (<i>self</i>)</h3><p>Returns an iterator pointing to the position past the last
54
document element inside the frame. Please see the document <a href="containers.html#stl-style-iterators">STL-Style Iterators</a> for
56
<p><b>See also</b> <a href="qtextframe.html#begin">begin</a>().</p>
59
<h3 class="fn"><a name="firstCursorPosition" /><a href="qtextcursor.html">QTextCursor</a> QTextFrame.firstCursorPosition (<i>self</i>)</h3><p>Returns the first cursor position inside the frame.</p>
60
<p><b>See also</b> <a href="qtextframe.html#lastCursorPosition">lastCursorPosition</a>(),
61
<a href="qtextframe.html#firstPosition">firstPosition</a>(), and
62
<a href="qtextframe.html#lastPosition">lastPosition</a>().</p>
65
<h3 class="fn"><a name="firstPosition" />int QTextFrame.firstPosition (<i>self</i>)</h3><p>Returns the first document position inside the frame.</p>
66
<p><b>See also</b> <a href="qtextframe.html#lastPosition">lastPosition</a>(), <a href="qtextframe.html#firstCursorPosition">firstCursorPosition</a>(),
67
and <a href="qtextframe.html#lastCursorPosition">lastCursorPosition</a>().</p>
70
<h3 class="fn"><a name="frameFormat" /><a href="qtextframeformat.html">QTextFrameFormat</a> QTextFrame.frameFormat (<i>self</i>)</h3><p>Returns the frame's format.</p>
71
<p><b>See also</b> <a href="qtextframe.html#setFrameFormat">setFrameFormat</a>().</p>
74
<h3 class="fn"><a name="lastCursorPosition" /><a href="qtextcursor.html">QTextCursor</a> QTextFrame.lastCursorPosition (<i>self</i>)</h3><p>Returns the last cursor position inside the frame.</p>
75
<p><b>See also</b> <a href="qtextframe.html#firstCursorPosition">firstCursorPosition</a>(),
76
<a href="qtextframe.html#firstPosition">firstPosition</a>(), and
77
<a href="qtextframe.html#lastPosition">lastPosition</a>().</p>
80
<h3 class="fn"><a name="lastPosition" />int QTextFrame.lastPosition (<i>self</i>)</h3><p>Returns the last document position inside the frame.</p>
81
<p><b>See also</b> <a href="qtextframe.html#firstPosition">firstPosition</a>(), <a href="qtextframe.html#firstCursorPosition">firstCursorPosition</a>(),
82
and <a href="qtextframe.html#lastCursorPosition">lastCursorPosition</a>().</p>
85
<h3 class="fn"><a name="parentFrame" /><a href="qtextframe.html">QTextFrame</a> QTextFrame.parentFrame (<i>self</i>)</h3><p>Returns the frame's parent frame. If the frame is the root frame
86
of a document, this will return 0.</p>
87
<p><b>See also</b> <a href="qtextframe.html#childFrames">childFrames</a>() and <a href="qtextdocument.html#rootFrame">QTextDocument.rootFrame</a>().</p>
90
<h3 class="fn"><a name="setFrameFormat" />QTextFrame.setFrameFormat (<i>self</i>, <a href="qtextframeformat.html">QTextFrameFormat</a> <i>aformat</i>)</h3><p>Sets the frame's <i>format</i>.</p>
91
<p><b>See also</b> <a href="qtextframe.html#frameFormat">frameFormat</a>().</p>
92
<address><hr /><div align="center"><table border="0" cellspacing="0" width="100%"><tr class="address"><td align="left" width="25%">PyQt 4.10.3 for X11</td><td align="center" width="50%">Copyright © <a href="http://www.riverbankcomputing.com">Riverbank Computing Ltd</a> and <a href="http://www.qtsoftware.com">Nokia</a> 2012</td><td align="right" width="25%">Qt 4.8.5</td></tr></table></div></address></body></html>
b'\\ No newline at end of file'