3
3
PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "DTD/xhtml1-strict.dtd">
4
4
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
5
<!-- /fasttmp/mkdist-qt-4.5.2-1245473805/qt-x11-opensource-src-4.5.2/src/gui/text/qabstracttextdocumentlayout.cpp -->
5
<!-- qabstracttextdocumentlayout.cpp -->
7
<title>Qt 4.5: QAbstractTextDocumentLayout Class Reference</title>
7
<title>Qt 4.6: QAbstractTextDocumentLayout Class Reference</title>
8
8
<link href="classic.css" rel="stylesheet" type="text/css" />
11
<a name="//apple_ref/cpp/cl//QAbstractTextDocumentLayout" />
11
12
<table border="0" cellpadding="0" cellspacing="0" width="100%">
13
<td align="left" valign="top" width="32"><a href="http://qtsoftware.com/products/qt"><img src="images/qt-logo.png" align="left" border="0" /></a></td>
14
<td width="1"> </td><td class="postheader" valign="center"><a href="index.html"><font color="#004faf">Home</font></a> · <a href="namespaces.html"><font color="#004faf">All Namespaces</font></a> · <a href="classes.html"><font color="#004faf">All Classes</font></a> · <a href="mainclasses.html"><font color="#004faf">Main Classes</font></a> · <a href="groups.html"><font color="#004faf">Grouped Classes</font></a> · <a href="modules.html"><font color="#004faf">Modules</font></a> · <a href="functions.html"><font color="#004faf">Functions</font></a></td>
15
<td align="right" valign="top" width="230"></td></tr></table><h1 class="title">QAbstractTextDocumentLayout Class Reference<br /><span class="small-subtitle">[<a href="qtgui.html">QtGui</a> module]</span>
14
<td align="left" valign="top" width="32"><a href="http://qt.nokia.com/"><img src="images/qt-logo.png" align="left" border="0" /></a></td>
15
<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="functions.html"><font color="#004faf">All Functions</font></a> · <a href="overviews.html"><font color="#004faf">Overviews</font></a></td><td class="searchBar" align="right" valign="center"><form action="http://www.google.com/cse" id="cse-search-box"><div><input type="hidden" name="cx" value="000136343326384750312:dhbxnqlakyu" /><input type="hidden" name="ie" value="UTF-8" /><input type="text" name="q" size="31" /><input type="submit" name="sa" value="Search" /></div></form></td>
16
</tr></table><h1 class="title">QAbstractTextDocumentLayout Class Reference<br /><span class="small-subtitle">[<a href="qtgui.html">QtGui</a> module]</span>
17
18
<p>The QAbstractTextDocumentLayout class is an abstract base class used to implement custom layouts for QTextDocuments. <a href="#details">More...</a></p>
18
19
<pre> #include <QAbstractTextDocumentLayout></pre><p>Inherits <a href="qobject.html">QObject</a>.</p>
19
20
<p>Inherited by <a href="qplaintextdocumentlayout.html">QPlainTextDocumentLayout</a>.</p>
20
<p><b>Note:</b> All the functions in this class are <a href="threads.html#reentrant">reentrant</a>.</p>
21
<p><b>Note:</b> All functions in this class are <a href="threads-reentrancy.html#reentrant">reentrant</a>.</p>
22
23
<li><a href="qabstracttextdocumentlayout-members.html">List of all members, including inherited members</a></li>
24
26
<a name="public-types"></a>
27
<li><div class="fn"></div>class <b><a href="qabstracttextdocumentlayout-paintcontext.html">PaintContext</a></b></li>
28
<li><div class="fn"></div>class <b><a href="qabstracttextdocumentlayout-selection.html">Selection</a></b></li>
28
<table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%">
29
<tr><td class="memItemLeft" align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><b><a href="qabstracttextdocumentlayout-paintcontext.html">PaintContext</a></b></td></tr>
30
<tr><td class="memItemLeft" align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><b><a href="qabstracttextdocumentlayout-selection.html">Selection</a></b></td></tr>
30
33
<a name="public-functions"></a>
31
<h3>Public Functions</h3>
33
<li><div class="fn"></div><b><a href="qabstracttextdocumentlayout.html#QAbstractTextDocumentLayout">QAbstractTextDocumentLayout</a></b> ( QTextDocument * <i>document</i> )</li>
34
<li><div class="fn"></div>QString <b><a href="qabstracttextdocumentlayout.html#anchorAt">anchorAt</a></b> ( const QPointF & <i>position</i> ) const</li>
35
<li><div class="fn"></div>virtual QRectF <b><a href="qabstracttextdocumentlayout.html#blockBoundingRect">blockBoundingRect</a></b> ( const QTextBlock & <i>block</i> ) const = 0</li>
36
<li><div class="fn"></div>QTextDocument * <b><a href="qabstracttextdocumentlayout.html#document">document</a></b> () const</li>
37
<li><div class="fn"></div>virtual QSizeF <b><a href="qabstracttextdocumentlayout.html#documentSize">documentSize</a></b> () const = 0</li>
38
<li><div class="fn"></div>virtual void <b><a href="qabstracttextdocumentlayout.html#draw">draw</a></b> ( QPainter * <i>painter</i>, const PaintContext & <i>context</i> ) = 0</li>
39
<li><div class="fn"></div>virtual QRectF <b><a href="qabstracttextdocumentlayout.html#frameBoundingRect">frameBoundingRect</a></b> ( QTextFrame * <i>frame</i> ) const = 0</li>
40
<li><div class="fn"></div>QTextObjectInterface * <b><a href="qabstracttextdocumentlayout.html#handlerForObject">handlerForObject</a></b> ( int <i>objectType</i> ) const</li>
41
<li><div class="fn"></div>virtual int <b><a href="qabstracttextdocumentlayout.html#hitTest">hitTest</a></b> ( const QPointF & <i>point</i>, Qt::HitTestAccuracy <i>accuracy</i> ) const = 0</li>
42
<li><div class="fn"></div>virtual int <b><a href="qabstracttextdocumentlayout.html#pageCount">pageCount</a></b> () const = 0</li>
43
<li><div class="fn"></div>QPaintDevice * <b><a href="qabstracttextdocumentlayout.html#paintDevice">paintDevice</a></b> () const</li>
44
<li><div class="fn"></div>void <b><a href="qabstracttextdocumentlayout.html#registerHandler">registerHandler</a></b> ( int <i>objectType</i>, QObject * <i>component</i> )</li>
45
<li><div class="fn"></div>void <b><a href="qabstracttextdocumentlayout.html#setPaintDevice">setPaintDevice</a></b> ( QPaintDevice * <i>device</i> )</li>
48
<li><div class="fn"></div>29 public functions inherited from <a href="qobject.html#public-functions">QObject</a></li>
34
<h2>Public Functions</h2>
35
<table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%">
36
<tr><td class="memItemLeft" align="right" valign="top"></td><td class="memItemRight" valign="bottom"><b><a href="qabstracttextdocumentlayout.html#QAbstractTextDocumentLayout">QAbstractTextDocumentLayout</a></b> ( QTextDocument * <i>document</i> )</td></tr>
37
<tr><td class="memItemLeft" align="right" valign="top">QString </td><td class="memItemRight" valign="bottom"><b><a href="qabstracttextdocumentlayout.html#anchorAt">anchorAt</a></b> ( const QPointF & <i>position</i> ) const</td></tr>
38
<tr><td class="memItemLeft" align="right" valign="top">virtual QRectF </td><td class="memItemRight" valign="bottom"><b><a href="qabstracttextdocumentlayout.html#blockBoundingRect">blockBoundingRect</a></b> ( const QTextBlock & <i>block</i> ) const = 0</td></tr>
39
<tr><td class="memItemLeft" align="right" valign="top">QTextDocument * </td><td class="memItemRight" valign="bottom"><b><a href="qabstracttextdocumentlayout.html#document">document</a></b> () const</td></tr>
40
<tr><td class="memItemLeft" align="right" valign="top">virtual QSizeF </td><td class="memItemRight" valign="bottom"><b><a href="qabstracttextdocumentlayout.html#documentSize">documentSize</a></b> () const = 0</td></tr>
41
<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><b><a href="qabstracttextdocumentlayout.html#draw">draw</a></b> ( QPainter * <i>painter</i>, const PaintContext & <i>context</i> ) = 0</td></tr>
42
<tr><td class="memItemLeft" align="right" valign="top">virtual QRectF </td><td class="memItemRight" valign="bottom"><b><a href="qabstracttextdocumentlayout.html#frameBoundingRect">frameBoundingRect</a></b> ( QTextFrame * <i>frame</i> ) const = 0</td></tr>
43
<tr><td class="memItemLeft" align="right" valign="top">QTextObjectInterface * </td><td class="memItemRight" valign="bottom"><b><a href="qabstracttextdocumentlayout.html#handlerForObject">handlerForObject</a></b> ( int <i>objectType</i> ) const</td></tr>
44
<tr><td class="memItemLeft" align="right" valign="top">virtual int </td><td class="memItemRight" valign="bottom"><b><a href="qabstracttextdocumentlayout.html#hitTest">hitTest</a></b> ( const QPointF & <i>point</i>, Qt::HitTestAccuracy <i>accuracy</i> ) const = 0</td></tr>
45
<tr><td class="memItemLeft" align="right" valign="top">virtual int </td><td class="memItemRight" valign="bottom"><b><a href="qabstracttextdocumentlayout.html#pageCount">pageCount</a></b> () const = 0</td></tr>
46
<tr><td class="memItemLeft" align="right" valign="top">QPaintDevice * </td><td class="memItemRight" valign="bottom"><b><a href="qabstracttextdocumentlayout.html#paintDevice">paintDevice</a></b> () const</td></tr>
47
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qabstracttextdocumentlayout.html#registerHandler">registerHandler</a></b> ( int <i>objectType</i>, QObject * <i>component</i> )</td></tr>
48
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qabstracttextdocumentlayout.html#setPaintDevice">setPaintDevice</a></b> ( QPaintDevice * <i>device</i> )</td></tr>
51
<li><div bar="2" class="fn"></div>29 public functions inherited from <a href="qobject.html#public-functions">QObject</a></li>
50
54
<a name="signals"></a>
53
<li><div class="fn"></div>void <b><a href="qabstracttextdocumentlayout.html#documentSizeChanged">documentSizeChanged</a></b> ( const QSizeF & <i>newSize</i> )</li>
54
<li><div class="fn"></div>void <b><a href="qabstracttextdocumentlayout.html#pageCountChanged">pageCountChanged</a></b> ( int <i>newPages</i> )</li>
55
<li><div class="fn"></div>void <b><a href="qabstracttextdocumentlayout.html#update">update</a></b> ( const QRectF & <i>rect</i> = QRectF( 0., 0., 1000000000., 1000000000. ) )</li>
56
<li><div class="fn"></div>void <b><a href="qabstracttextdocumentlayout.html#updateBlock">updateBlock</a></b> ( const QTextBlock & <i>block</i> )</li>
59
<li><div class="fn"></div>1 signal inherited from <a href="qobject.html#signals">QObject</a></li>
56
<table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%">
57
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qabstracttextdocumentlayout.html#documentSizeChanged">documentSizeChanged</a></b> ( const QSizeF & <i>newSize</i> )</td></tr>
58
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qabstracttextdocumentlayout.html#pageCountChanged">pageCountChanged</a></b> ( int <i>newPages</i> )</td></tr>
59
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qabstracttextdocumentlayout.html#update">update</a></b> ( const QRectF & <i>rect</i> = QRectF( 0., 0., 1000000000., 1000000000. ) )</td></tr>
60
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qabstracttextdocumentlayout.html#updateBlock">updateBlock</a></b> ( const QTextBlock & <i>block</i> )</td></tr>
63
<li><div bar="2" class="fn"></div>1 signal inherited from <a href="qobject.html#signals">QObject</a></li>
61
66
<a name="protected-functions"></a>
62
<h3>Protected Functions</h3>
64
<li><div class="fn"></div>virtual void <b><a href="qabstracttextdocumentlayout.html#documentChanged">documentChanged</a></b> ( int <i>position</i>, int <i>charsRemoved</i>, int <i>charsAdded</i> ) = 0</li>
65
<li><div class="fn"></div>virtual void <b><a href="qabstracttextdocumentlayout.html#drawInlineObject">drawInlineObject</a></b> ( QPainter * <i>painter</i>, const QRectF & <i>rect</i>, QTextInlineObject <i>object</i>, int <i>posInDocument</i>, const QTextFormat & <i>format</i> )</li>
66
<li><div class="fn"></div>QTextCharFormat <b><a href="qabstracttextdocumentlayout.html#format">format</a></b> ( int <i>position</i> )</li>
67
<li><div class="fn"></div>virtual void <b><a href="qabstracttextdocumentlayout.html#positionInlineObject">positionInlineObject</a></b> ( QTextInlineObject <i>item</i>, int <i>posInDocument</i>, const QTextFormat & <i>format</i> )</li>
68
<li><div class="fn"></div>virtual void <b><a href="qabstracttextdocumentlayout.html#resizeInlineObject">resizeInlineObject</a></b> ( QTextInlineObject <i>item</i>, int <i>posInDocument</i>, const QTextFormat & <i>format</i> )</li>
71
<li><div class="fn"></div>7 protected functions inherited from <a href="qobject.html#protected-functions">QObject</a></li>
67
<h2>Protected Functions</h2>
68
<table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%">
69
<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><b><a href="qabstracttextdocumentlayout.html#documentChanged">documentChanged</a></b> ( int <i>position</i>, int <i>charsRemoved</i>, int <i>charsAdded</i> ) = 0</td></tr>
70
<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><b><a href="qabstracttextdocumentlayout.html#drawInlineObject">drawInlineObject</a></b> ( QPainter * <i>painter</i>, const QRectF & <i>rect</i>, QTextInlineObject <i>object</i>, int <i>posInDocument</i>, const QTextFormat & <i>format</i> )</td></tr>
71
<tr><td class="memItemLeft" align="right" valign="top">QTextCharFormat </td><td class="memItemRight" valign="bottom"><b><a href="qabstracttextdocumentlayout.html#format">format</a></b> ( int <i>position</i> )</td></tr>
72
<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><b><a href="qabstracttextdocumentlayout.html#positionInlineObject">positionInlineObject</a></b> ( QTextInlineObject <i>item</i>, int <i>posInDocument</i>, const QTextFormat & <i>format</i> )</td></tr>
73
<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><b><a href="qabstracttextdocumentlayout.html#resizeInlineObject">resizeInlineObject</a></b> ( QTextInlineObject <i>item</i>, int <i>posInDocument</i>, const QTextFormat & <i>format</i> )</td></tr>
76
<li><div bar="2" class="fn"></div>7 protected functions inherited from <a href="qobject.html#protected-functions">QObject</a></li>
73
78
<h3>Additional Inherited Members</h3>
87
92
<p>See also <a href="qtextobjectinterface.html">QTextObjectInterface</a>.</p>
89
94
<h2>Member Function Documentation</h2>
95
<a name="//apple_ref/cpp/instm/QAbstractTextDocumentLayout/QAbstractTextDocumentLayout" />
90
96
<h3 class="fn"><a name="QAbstractTextDocumentLayout"></a>QAbstractTextDocumentLayout::QAbstractTextDocumentLayout ( <a href="qtextdocument.html">QTextDocument</a> * <i>document</i> )</h3>
91
97
<p>Creates a new text document layout for the given <i>document</i>.</p>
98
<a name="//apple_ref/cpp/instm/QAbstractTextDocumentLayout/anchorAt" />
92
99
<h3 class="fn"><a name="anchorAt"></a><a href="qstring.html">QString</a> QAbstractTextDocumentLayout::anchorAt ( const <a href="qpointf.html">QPointF</a> & <i>position</i> ) const</h3>
93
100
<p>Returns the reference of the anchor the given <i>position</i>, or an empty string if no anchor exists at that point.</p>
101
<a name="//apple_ref/cpp/instm/QAbstractTextDocumentLayout/blockBoundingRect" />
94
102
<h3 class="fn"><a name="blockBoundingRect"></a><a href="qrectf.html">QRectF</a> QAbstractTextDocumentLayout::blockBoundingRect ( const <a href="qtextblock.html">QTextBlock</a> & <i>block</i> ) const <tt> [pure virtual]</tt></h3>
95
103
<p>Returns the bounding rectangle of <i>block</i>.</p>
104
<a name="//apple_ref/cpp/instm/QAbstractTextDocumentLayout/document" />
96
105
<h3 class="fn"><a name="document"></a><a href="qtextdocument.html">QTextDocument</a> * QAbstractTextDocumentLayout::document () const</h3>
97
106
<p>Returns the text document that this layout is operating on.</p>
107
<a name="//apple_ref/cpp/instm/QAbstractTextDocumentLayout/documentChanged" />
98
108
<h3 class="fn"><a name="documentChanged"></a>void QAbstractTextDocumentLayout::documentChanged ( int <i>position</i>, int <i>charsRemoved</i>, int <i>charsAdded</i> ) <tt> [pure virtual protected]</tt></h3>
99
109
<p>This function is called whenever the contents of the document change. A change occurs when text is inserted, removed, or a combination of these two. The change is specified by <i>position</i>, <i>charsRemoved</i>, and <i>charsAdded</i> corresponding to the starting character position of the change, the number of characters removed from the document, and the number of characters added.</p>
100
110
<p>For example, when inserting the text "Hello" into an empty document, <i>charsRemoved</i> would be 0 and <i>charsAdded</i> would be 5 (the length of the string).</p>
109
119
<li>The <a href="qabstracttextdocumentlayout.html#update">update</a>() signal should be emitted to schedule a repaint of areas in the layout that require repainting.</li>
111
121
<p>See also <a href="qtextlayout.html">QTextLayout</a>.</p>
122
<a name="//apple_ref/cpp/instm/QAbstractTextDocumentLayout/documentSize" />
112
123
<h3 class="fn"><a name="documentSize"></a><a href="qsizef.html">QSizeF</a> QAbstractTextDocumentLayout::documentSize () const <tt> [pure virtual]</tt></h3>
113
124
<p>Returns the total size of the document's layout.</p>
114
125
<p>This information can be used by display widgets to update their scroll bars correctly.</p>
115
126
<p>See also <a href="qabstracttextdocumentlayout.html#documentSizeChanged">documentSizeChanged</a>() and <a href="qtextdocument.html#pageSize-prop">QTextDocument::pageSize</a>.</p>
127
<a name="//apple_ref/cpp/instm/QAbstractTextDocumentLayout/documentSizeChanged" />
116
128
<h3 class="fn"><a name="documentSizeChanged"></a>void QAbstractTextDocumentLayout::documentSizeChanged ( const <a href="qsizef.html">QSizeF</a> & <i>newSize</i> ) <tt> [signal]</tt></h3>
117
129
<p>This signal is emitted when the size of the document layout changes to <i>newSize</i>.</p>
118
130
<p>Subclasses of <a href="qabstracttextdocumentlayout.html">QAbstractTextDocumentLayout</a> should emit this signal when the document's entire layout size changes. This signal is useful for widgets that display text documents since it enables them to update their scroll bars correctly.</p>
119
131
<p>See also <a href="qabstracttextdocumentlayout.html#documentSize">documentSize</a>().</p>
132
<a name="//apple_ref/cpp/instm/QAbstractTextDocumentLayout/draw" />
120
133
<h3 class="fn"><a name="draw"></a>void QAbstractTextDocumentLayout::draw ( <a href="qpainter.html">QPainter</a> * <i>painter</i>, const <a href="qabstracttextdocumentlayout-paintcontext.html">PaintContext</a> & <i>context</i> ) <tt> [pure virtual]</tt></h3>
121
134
<p>Draws the layout with the given <i>painter</i> using the given <i>context</i>.</p>
135
<a name="//apple_ref/cpp/instm/QAbstractTextDocumentLayout/drawInlineObject" />
122
136
<h3 class="fn"><a name="drawInlineObject"></a>void QAbstractTextDocumentLayout::drawInlineObject ( <a href="qpainter.html">QPainter</a> * <i>painter</i>, const <a href="qrectf.html">QRectF</a> & <i>rect</i>, <a href="qtextinlineobject.html">QTextInlineObject</a> <i>object</i>, int <i>posInDocument</i>, const <a href="qtextformat.html">QTextFormat</a> & <i>format</i> ) <tt> [virtual protected]</tt></h3>
123
137
<p>This function is called to draw the inline object, <i>object</i>, with the given <i>painter</i> within the rectangle specified by <i>rect</i> using the specified text <i>format</i>.</p>
124
138
<p><i>posInDocument</i> specifies the position of the object within the document.</p>
125
139
<p>The default implementation calls drawObject() on the object handlers. This function is called only within Qt. Subclasses can reimplement this function to customize the drawing of inline objects.</p>
126
140
<p>See also <a href="qabstracttextdocumentlayout.html#draw">draw</a>().</p>
141
<a name="//apple_ref/cpp/instm/QAbstractTextDocumentLayout/format" />
127
142
<h3 class="fn"><a name="format"></a><a href="qtextcharformat.html">QTextCharFormat</a> QAbstractTextDocumentLayout::format ( int <i>position</i> ) <tt> [protected]</tt></h3>
128
143
<p>Returns the character format that is applicable at the given <i>position</i>.</p>
144
<a name="//apple_ref/cpp/instm/QAbstractTextDocumentLayout/frameBoundingRect" />
129
145
<h3 class="fn"><a name="frameBoundingRect"></a><a href="qrectf.html">QRectF</a> QAbstractTextDocumentLayout::frameBoundingRect ( <a href="qtextframe.html">QTextFrame</a> * <i>frame</i> ) const <tt> [pure virtual]</tt></h3>
130
146
<p>Returns the bounding rectangle of <i>frame</i>.</p>
147
<a name="//apple_ref/cpp/instm/QAbstractTextDocumentLayout/handlerForObject" />
131
148
<h3 class="fn"><a name="handlerForObject"></a><a href="qtextobjectinterface.html">QTextObjectInterface</a> * QAbstractTextDocumentLayout::handlerForObject ( int <i>objectType</i> ) const</h3>
132
149
<p>Returns a handler for objects of the given <i>objectType</i>.</p>
150
<a name="//apple_ref/cpp/instm/QAbstractTextDocumentLayout/hitTest" />
133
151
<h3 class="fn"><a name="hitTest"></a>int QAbstractTextDocumentLayout::hitTest ( const <a href="qpointf.html">QPointF</a> & <i>point</i>, <a href="qt.html#HitTestAccuracy-enum">Qt::HitTestAccuracy</a> <i>accuracy</i> ) const <tt> [pure virtual]</tt></h3>
134
152
<p>Returns the cursor postion for the given <i>point</i> with the specified <i>accuracy</i>. Returns -1 if no valid cursor position was found.</p>
153
<a name="//apple_ref/cpp/instm/QAbstractTextDocumentLayout/pageCount" />
135
154
<h3 class="fn"><a name="pageCount"></a>int QAbstractTextDocumentLayout::pageCount () const <tt> [pure virtual]</tt></h3>
136
155
<p>Returns the number of pages contained in the layout.</p>
137
156
<p>See also <a href="qabstracttextdocumentlayout.html#pageCountChanged">pageCountChanged</a>().</p>
157
<a name="//apple_ref/cpp/instm/QAbstractTextDocumentLayout/pageCountChanged" />
138
158
<h3 class="fn"><a name="pageCountChanged"></a>void QAbstractTextDocumentLayout::pageCountChanged ( int <i>newPages</i> ) <tt> [signal]</tt></h3>
139
159
<p>This signal is emitted when the number of pages in the layout changes; <i>newPages</i> is the updated page count.</p>
140
160
<p>Subclasses of <a href="qabstracttextdocumentlayout.html">QAbstractTextDocumentLayout</a> should emit this signal when the number of pages in the layout has changed. Changes to the page count are caused by changes to the layout or the document content itself.</p>
141
161
<p>See also <a href="qabstracttextdocumentlayout.html#pageCount">pageCount</a>().</p>
162
<a name="//apple_ref/cpp/instm/QAbstractTextDocumentLayout/paintDevice" />
142
163
<h3 class="fn"><a name="paintDevice"></a><a href="qpaintdevice.html">QPaintDevice</a> * QAbstractTextDocumentLayout::paintDevice () const</h3>
143
164
<p>Returns the paint device used to render the document's layout.</p>
144
165
<p>See also <a href="qabstracttextdocumentlayout.html#setPaintDevice">setPaintDevice</a>().</p>
166
<a name="//apple_ref/cpp/instm/QAbstractTextDocumentLayout/positionInlineObject" />
145
167
<h3 class="fn"><a name="positionInlineObject"></a>void QAbstractTextDocumentLayout::positionInlineObject ( <a href="qtextinlineobject.html">QTextInlineObject</a> <i>item</i>, int <i>posInDocument</i>, const <a href="qtextformat.html">QTextFormat</a> & <i>format</i> ) <tt> [virtual protected]</tt></h3>
146
168
<p>Lays out the inline object <i>item</i> using the given text <i>format</i>.</p>
147
169
<p><i>posInDocument</i> specifies the position of the object within the document.</p>
148
170
<p>The default implementation does nothing. This function is called only within Qt. Subclasses can reimplement this function to customize the position of inline objects.</p>
149
171
<p>See also <a href="qabstracttextdocumentlayout.html#drawInlineObject">drawInlineObject</a>().</p>
172
<a name="//apple_ref/cpp/instm/QAbstractTextDocumentLayout/registerHandler" />
150
173
<h3 class="fn"><a name="registerHandler"></a>void QAbstractTextDocumentLayout::registerHandler ( int <i>objectType</i>, <a href="qobject.html">QObject</a> * <i>component</i> )</h3>
151
174
<p>Registers the given <i>component</i> as a handler for items of the given <i>objectType</i>.</p>
152
175
<p><b>Note:</b> registerHandler() has to be called once for each object type. This means that there is only one handler for multiple replacement characters of the same object type.</p>
176
<a name="//apple_ref/cpp/instm/QAbstractTextDocumentLayout/resizeInlineObject" />
153
177
<h3 class="fn"><a name="resizeInlineObject"></a>void QAbstractTextDocumentLayout::resizeInlineObject ( <a href="qtextinlineobject.html">QTextInlineObject</a> <i>item</i>, int <i>posInDocument</i>, const <a href="qtextformat.html">QTextFormat</a> & <i>format</i> ) <tt> [virtual protected]</tt></h3>
154
178
<p>Sets the size of the inline object <i>item</i> corresponding to the text <i>format</i>.</p>
155
179
<p><i>posInDocument</i> specifies the position of the object within the document.</p>
156
180
<p>The default implementation resizes the <i>item</i> to the size returned by the object handler's intrinsicSize() function. This function is called only within Qt. Subclasses can reimplement this function to customize the resizing of inline objects.</p>
181
<a name="//apple_ref/cpp/instm/QAbstractTextDocumentLayout/setPaintDevice" />
157
182
<h3 class="fn"><a name="setPaintDevice"></a>void QAbstractTextDocumentLayout::setPaintDevice ( <a href="qpaintdevice.html">QPaintDevice</a> * <i>device</i> )</h3>
158
183
<p>Sets the paint device used for rendering the document's layout to the given <i>device</i>.</p>
159
184
<p>See also <a href="qabstracttextdocumentlayout.html#paintDevice">paintDevice</a>().</p>
185
<a name="//apple_ref/cpp/instm/QAbstractTextDocumentLayout/update" />
160
186
<h3 class="fn"><a name="update"></a>void QAbstractTextDocumentLayout::update ( const <a href="qrectf.html">QRectF</a> & <i>rect</i> = QRectF( 0., 0., 1000000000., 1000000000. ) ) <tt> [signal]</tt></h3>
161
187
<p>This signal is emitted when the rectangle <i>rect</i> has been updated.</p>
162
188
<p>Subclasses of <a href="qabstracttextdocumentlayout.html">QAbstractTextDocumentLayout</a> should emit this signal when the layout of the contents change in order to repaint.</p>
189
<a name="//apple_ref/cpp/instm/QAbstractTextDocumentLayout/updateBlock" />
163
190
<h3 class="fn"><a name="updateBlock"></a>void QAbstractTextDocumentLayout::updateBlock ( const <a href="qtextblock.html">QTextBlock</a> & <i>block</i> ) <tt> [signal]</tt></h3>
164
191
<p>This signal is emitted when the specified <i>block</i> has been updated.</p>
165
192
<p>Subclasses of <a href="qabstracttextdocumentlayout.html">QAbstractTextDocumentLayout</a> should emit this signal when the layout of <i>block</i> has changed in order to repaint.</p>
166
193
<p>This function was introduced in Qt 4.4.</p>
167
194
<p /><address><hr /><div align="center">
168
195
<table width="100%" cellspacing="0" border="0"><tr class="address">
169
<td width="30%" align="left">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies)</td>
170
<td width="40%" align="center"><a href="trademarks.html">Trademarks</a></td>
171
<td width="30%" align="right"><div align="right">Qt 4.5.2</div></td>
172
</tr></table></div></address></body>
196
<td width="40%" align="left">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies)</td>
197
<td width="20%" align="center"><a href="trademarks.html">Trademarks</a></td>
198
<td width="40%" align="right"><div align="right">Qt 4.6.0</div></td>
199
<script type="text/javascript" src="http://www.google.com/jsapi"></script><script type="text/javascript">google.load("elements", "1", {packages: "transliteration"});</script><script type="text/javascript" src="http://www.google.com/coop/cse/t13n?form=cse-search-box&t13n_langs=en"></script><script type="text/javascript" src="http://www.google.com/coop/cse/brand?form=cse-search-box&lang=en"></script></tr></table></div></address></body>
added
removed
doc/html/qabstracttextdocumentlayout.html
