Line | Source Code | Coverage |
---|
1 | /**************************************************************************** | - |
2 | ** | - |
3 | ** Copyright (C) 2013 Digia Plc and/or its subsidiary(-ies). | - |
4 | ** Contact: http://www.qt-project.org/legal | - |
5 | ** | - |
6 | ** This file is part of the QtGui module of the Qt Toolkit. | - |
7 | ** | - |
8 | ** $QT_BEGIN_LICENSE:LGPL$ | - |
9 | ** Commercial License Usage | - |
10 | ** Licensees holding valid commercial Qt licenses may use this file in | - |
11 | ** accordance with the commercial license agreement provided with the | - |
12 | ** Software or, alternatively, in accordance with the terms contained in | - |
13 | ** a written agreement between you and Digia. For licensing terms and | - |
14 | ** conditions see http://qt.digia.com/licensing. For further information | - |
15 | ** use the contact form at http://qt.digia.com/contact-us. | - |
16 | ** | - |
17 | ** GNU Lesser General Public License Usage | - |
18 | ** Alternatively, this file may be used under the terms of the GNU Lesser | - |
19 | ** General Public License version 2.1 as published by the Free Software | - |
20 | ** Foundation and appearing in the file LICENSE.LGPL included in the | - |
21 | ** packaging of this file. Please review the following information to | - |
22 | ** ensure the GNU Lesser General Public License version 2.1 requirements | - |
23 | ** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html. | - |
24 | ** | - |
25 | ** In addition, as a special exception, Digia gives you certain additional | - |
26 | ** rights. These rights are described in the Digia Qt LGPL Exception | - |
27 | ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package. | - |
28 | ** | - |
29 | ** GNU General Public License Usage | - |
30 | ** Alternatively, this file may be used under the terms of the GNU | - |
31 | ** General Public License version 3.0 as published by the Free Software | - |
32 | ** Foundation and appearing in the file LICENSE.GPL included in the | - |
33 | ** packaging of this file. Please review the following information to | - |
34 | ** ensure the GNU General Public License version 3.0 requirements will be | - |
35 | ** met: http://www.gnu.org/copyleft/gpl.html. | - |
36 | ** | - |
37 | ** | - |
38 | ** $QT_END_LICENSE$ | - |
39 | ** | - |
40 | ****************************************************************************/ | - |
41 | | - |
42 | #include <qabstracttextdocumentlayout.h> | - |
43 | #include <qtextformat.h> | - |
44 | #include "qtextdocument_p.h" | - |
45 | #include "qtextengine_p.h" | - |
46 | | - |
47 | #include "qabstracttextdocumentlayout_p.h" | - |
48 | | - |
49 | QT_BEGIN_NAMESPACE | - |
50 | | - |
51 | /*! | - |
52 | \class QAbstractTextDocumentLayout | - |
53 | \reentrant | - |
54 | | - |
55 | \brief The QAbstractTextDocumentLayout class is an abstract base | - |
56 | class used to implement custom layouts for QTextDocuments. | - |
57 | \inmodule QtGui | - |
58 | | - |
59 | \ingroup richtext-processing | - |
60 | | - |
61 | The standard layout provided by Qt can handle simple word processing | - |
62 | including inline images, lists and tables. | - |
63 | | - |
64 | Some applications, e.g., a word processor or a DTP application might need | - |
65 | more features than the ones provided by Qt's layout engine, in which case | - |
66 | you can subclass QAbstractTextDocumentLayout to provide custom layout | - |
67 | behavior for your text documents. | - |
68 | | - |
69 | An instance of the QAbstractTextDocumentLayout subclass can be installed | - |
70 | on a QTextDocument object with the | - |
71 | \l{QTextDocument::}{setDocumentLayout()} function. | - |
72 | | - |
73 | You can insert custom objects into a QTextDocument; see the | - |
74 | QTextObjectInterface class description for details. | - |
75 | | - |
76 | \sa QTextObjectInterface | - |
77 | */ | - |
78 | | - |
79 | /*! | - |
80 | \class QTextObjectInterface | - |
81 | \brief The QTextObjectInterface class allows drawing of | - |
82 | custom text objects in \l{QTextDocument}s. | - |
83 | \since 4.5 | - |
84 | \inmodule QtGui | - |
85 | | - |
86 | A text object describes the structure of one or more elements in a | - |
87 | text document; for instance, images imported from HTML are | - |
88 | implemented using text objects. A text object knows how to lay out | - |
89 | and draw its elements when a document is being rendered. | - |
90 | | - |
91 | Qt allows custom text objects to be inserted into a document by | - |
92 | registering a custom \l{QTextCharFormat::objectType()}{object | - |
93 | type} with QTextCharFormat. A QTextObjectInterface must also be | - |
94 | implemented for this type and be | - |
95 | \l{QAbstractTextDocumentLayout::registerHandler()}{registered} | - |
96 | with the QAbstractTextDocumentLayout of the document. When the | - |
97 | object type is encountered while rendering a QTextDocument, the | - |
98 | intrinsicSize() and drawObject() functions of the interface are | - |
99 | called. | - |
100 | | - |
101 | The following list explains the required steps of inserting a | - |
102 | custom text object into a document: | - |
103 | | - |
104 | \list | - |
105 | \li Choose an \a objectType. The \a objectType is an integer with a | - |
106 | value greater or equal to QTextFormat::UserObject. | - |
107 | \li Create a QTextCharFormat object and set the object type to the | - |
108 | chosen type using the setObjectType() function. | - |
109 | \li Implement the QTextObjectInterface class. | - |
110 | \li Call QAbstractTextDocumentLayout::registerHandler() with an instance of your | - |
111 | QTextObjectInterface subclass to register your object type. | - |
112 | \li Insert QChar::ObjectReplacementCharacter with the aforementioned | - |
113 | QTextCharFormat of the chosen object type into the document. | - |
114 | As mentioned, the functions of QTextObjectInterface | - |
115 | \l{QTextObjectInterface::}{intrinsicSize()} and | - |
116 | \l{QTextObjectInterface::}{drawObject()} will then be called with the | - |
117 | QTextFormat as parameter whenever the replacement character is | - |
118 | encountered. | - |
119 | \endlist | - |
120 | | - |
121 | A class implementing a text object needs to inherit both QObject | - |
122 | and QTextObjectInterface. QObject must be the first class | - |
123 | inherited. For instance: | - |
124 | | - |
125 | \snippet qtextobject/textobjectinterface.h 0 | - |
126 | | - |
127 | The data of a text object is usually stored in the QTextCharFormat | - |
128 | using QTextCharFormat::setProperty(), and then retrieved with | - |
129 | QTextCharFormat::property(). | - |
130 | | - |
131 | \warning Copy and Paste operations ignore custom text objects. | - |
132 | | - |
133 | \sa {Text Object Example}, QTextCharFormat, QTextLayout | - |
134 | */ | - |
135 | | - |
136 | /*! | - |
137 | \fn QTextObjectInterface::~QTextObjectInterface() | - |
138 | | - |
139 | Destroys this QTextObjectInterface. | - |
140 | */ | - |
141 | | - |
142 | /*! | - |
143 | \fn virtual QSizeF QTextObjectInterface::intrinsicSize(QTextDocument *doc, int posInDocument, const QTextFormat &format) = 0 | - |
144 | | - |
145 | The intrinsicSize() function returns the size of the text object | - |
146 | represented by \a format in the given document (\a doc) at the | - |
147 | given position (\a posInDocument). | - |
148 | | - |
149 | The size calculated will be used for subsequent calls to | - |
150 | drawObject() for this \a format. | - |
151 | | - |
152 | \sa drawObject() | - |
153 | */ | - |
154 | | - |
155 | /*! | - |
156 | \fn virtual void QTextObjectInterface::drawObject(QPainter *painter, const QRectF &rect, QTextDocument *doc, int posInDocument, const QTextFormat &format) = 0 | - |
157 | | - |
158 | Draws this text object using the specified \a painter. | - |
159 | | - |
160 | The size of the rectangle, \a rect, to draw in is the size | - |
161 | previously calculated by intrinsicSize(). The rectangles position | - |
162 | is relative to the \a painter. | - |
163 | | - |
164 | You also get the document (\a doc) and the position (\a | - |
165 | posInDocument) of the \a format in that document. | - |
166 | | - |
167 | \sa intrinsicSize() | - |
168 | */ | - |
169 | | - |
170 | /*! | - |
171 | \fn void QAbstractTextDocumentLayout::update(const QRectF &rect) | - |
172 | | - |
173 | This signal is emitted when the rectangle \a rect has been updated. | - |
174 | | - |
175 | Subclasses of QAbstractTextDocumentLayout should emit this signal when | - |
176 | the layout of the contents change in order to repaint. | - |
177 | */ | - |
178 | | - |
179 | /*! | - |
180 | \fn void QAbstractTextDocumentLayout::updateBlock(const QTextBlock &block) | - |
181 | \since 4.4 | - |
182 | | - |
183 | This signal is emitted when the specified \a block has been updated. | - |
184 | | - |
185 | Subclasses of QAbstractTextDocumentLayout should emit this signal when | - |
186 | the layout of \a block has changed in order to repaint. | - |
187 | */ | - |
188 | | - |
189 | /*! | - |
190 | \fn void QAbstractTextDocumentLayout::documentSizeChanged(const QSizeF &newSize) | - |
191 | | - |
192 | This signal is emitted when the size of the document layout changes to | - |
193 | \a newSize. | - |
194 | | - |
195 | Subclasses of QAbstractTextDocumentLayout should emit this signal when the | - |
196 | document's entire layout size changes. This signal is useful for widgets | - |
197 | that display text documents since it enables them to update their scroll | - |
198 | bars correctly. | - |
199 | | - |
200 | \sa documentSize() | - |
201 | */ | - |
202 | | - |
203 | /*! | - |
204 | \fn void QAbstractTextDocumentLayout::pageCountChanged(int newPages) | - |
205 | | - |
206 | This signal is emitted when the number of pages in the layout changes; | - |
207 | \a newPages is the updated page count. | - |
208 | | - |
209 | Subclasses of QAbstractTextDocumentLayout should emit this signal when | - |
210 | the number of pages in the layout has changed. Changes to the page count | - |
211 | are caused by changes to the layout or the document content itself. | - |
212 | | - |
213 | \sa pageCount() | - |
214 | */ | - |
215 | | - |
216 | /*! | - |
217 | \fn int QAbstractTextDocumentLayout::pageCount() const | - |
218 | | - |
219 | Returns the number of pages contained in the layout. | - |
220 | | - |
221 | \sa pageCountChanged() | - |
222 | */ | - |
223 | | - |
224 | /*! | - |
225 | \fn QSizeF QAbstractTextDocumentLayout::documentSize() const | - |
226 | | - |
227 | Returns the total size of the document's layout. | - |
228 | | - |
229 | This information can be used by display widgets to update their scroll bars | - |
230 | correctly. | - |
231 | | - |
232 | \sa documentSizeChanged(), QTextDocument::pageSize | - |
233 | */ | - |
234 | | - |
235 | /*! | - |
236 | \fn void QAbstractTextDocumentLayout::draw(QPainter *painter, const PaintContext &context) | - |
237 | | - |
238 | Draws the layout with the given \a painter using the given \a context. | - |
239 | */ | - |
240 | | - |
241 | /*! | - |
242 | \fn int QAbstractTextDocumentLayout::hitTest(const QPointF &point, Qt::HitTestAccuracy accuracy) const | - |
243 | | - |
244 | Returns the cursor position for the given \a point with the specified | - |
245 | \a accuracy. Returns -1 if no valid cursor position was found. | - |
246 | */ | - |
247 | | - |
248 | /*! | - |
249 | \fn void QAbstractTextDocumentLayout::documentChanged(int position, int charsRemoved, int charsAdded) | - |
250 | | - |
251 | This function is called whenever the contents of the document change. A | - |
252 | change occurs when text is inserted, removed, or a combination of these | - |
253 | two. The change is specified by \a position, \a charsRemoved, and | - |
254 | \a charsAdded corresponding to the starting character position of the | - |
255 | change, the number of characters removed from the document, and the | - |
256 | number of characters added. | - |
257 | | - |
258 | For example, when inserting the text "Hello" into an empty document, | - |
259 | \a charsRemoved would be 0 and \a charsAdded would be 5 (the length of | - |
260 | the string). | - |
261 | | - |
262 | Replacing text is a combination of removing and inserting. For example, if | - |
263 | the text "Hello" gets replaced by "Hi", \a charsRemoved would be 5 and | - |
264 | \a charsAdded would be 2. | - |
265 | | - |
266 | For subclasses of QAbstractTextDocumentLayout, this is the central function | - |
267 | where a large portion of the work to lay out and position document contents | - |
268 | is done. | - |
269 | | - |
270 | For example, in a subclass that only arranges blocks of text, an | - |
271 | implementation of this function would have to do the following: | - |
272 | | - |
273 | \list | - |
274 | \li Determine the list of changed \l{QTextBlock}(s) using the parameters | - |
275 | provided. | - |
276 | \li Each QTextBlock object's corresponding QTextLayout object needs to | - |
277 | be processed. You can access the \l{QTextBlock}'s layout using the | - |
278 | QTextBlock::layout() function. This processing should take the | - |
279 | document's page size into consideration. | - |
280 | \li If the total number of pages changed, the pageCountChanged() signal | - |
281 | should be emitted. | - |
282 | \li If the total size changed, the documentSizeChanged() signal should | - |
283 | be emitted. | - |
284 | \li The update() signal should be emitted to schedule a repaint of areas | - |
285 | in the layout that require repainting. | - |
286 | \endlist | - |
287 | | - |
288 | \sa QTextLayout | - |
289 | */ | - |
290 | | - |
291 | /*! | - |
292 | \class QAbstractTextDocumentLayout::PaintContext | - |
293 | \reentrant | - |
294 | \inmodule QtGui | - |
295 | | - |
296 | \brief The QAbstractTextDocumentLayout::PaintContext class is a convenience | - |
297 | class defining the parameters used when painting a document's layout. | - |
298 | | - |
299 | A paint context is used when rendering custom layouts for QTextDocuments | - |
300 | with the QAbstractTextDocumentLayout::draw() function. It is specified by | - |
301 | a \l {cursorPosition}{cursor position}, \l {palette}{default text color}, | - |
302 | \l clip rectangle and a collection of \l selections. | - |
303 | | - |
304 | \sa QAbstractTextDocumentLayout | - |
305 | */ | - |
306 | | - |
307 | /*! | - |
308 | \fn QAbstractTextDocumentLayout::PaintContext::PaintContext() | - |
309 | \internal | - |
310 | */ | - |
311 | | - |
312 | /*! | - |
313 | \variable QAbstractTextDocumentLayout::PaintContext::cursorPosition | - |
314 | | - |
315 | \brief the position within the document, where the cursor line should be | - |
316 | drawn. | - |
317 | | - |
318 | The default value is -1. | - |
319 | */ | - |
320 | | - |
321 | /*! | - |
322 | \variable QAbstractTextDocumentLayout::PaintContext::palette | - |
323 | | - |
324 | \brief the default color that is used for the text, when no color is | - |
325 | specified. | - |
326 | | - |
327 | The default value is the application's default palette. | - |
328 | */ | - |
329 | | - |
330 | /*! | - |
331 | \variable QAbstractTextDocumentLayout::PaintContext::clip | - |
332 | | - |
333 | \brief a hint to the layout specifying the area around paragraphs, frames | - |
334 | or text require painting. | - |
335 | | - |
336 | Everything outside of this rectangle does not need to be painted. | - |
337 | | - |
338 | Specifying a clip rectangle can speed up drawing of large documents | - |
339 | significantly. Note that the clip rectangle is in document coordinates (not | - |
340 | in viewport coordinates). It is not a substitute for a clip region set on | - |
341 | the painter but merely a hint. | - |
342 | | - |
343 | The default value is a null rectangle indicating everything needs to be | - |
344 | painted. | - |
345 | */ | - |
346 | | - |
347 | /*! | - |
348 | \variable QAbstractTextDocumentLayout::PaintContext::selections | - |
349 | | - |
350 | \brief the collection of selections that will be rendered when passing this | - |
351 | paint context to QAbstractTextDocumentLayout's draw() function. | - |
352 | | - |
353 | The default value is an empty vector indicating no selection. | - |
354 | */ | - |
355 | | - |
356 | /*! | - |
357 | \class QAbstractTextDocumentLayout::Selection | - |
358 | \reentrant | - |
359 | \inmodule QtGui | - |
360 | | - |
361 | \brief The QAbstractTextDocumentLayout::Selection class is a convenience | - |
362 | class defining the parameters of a selection. | - |
363 | | - |
364 | A selection can be used to specify a part of a document that should be | - |
365 | highlighted when drawing custom layouts for QTextDocuments with the | - |
366 | QAbstractTextDocumentLayout::draw() function. It is specified using | - |
367 | \l cursor and a \l format. | - |
368 | | - |
369 | \sa QAbstractTextDocumentLayout, PaintContext | - |
370 | */ | - |
371 | | - |
372 | /*! | - |
373 | \variable QAbstractTextDocumentLayout::Selection::format | - |
374 | | - |
375 | \brief the format of the selection | - |
376 | | - |
377 | The default value is QTextFormat::InvalidFormat. | - |
378 | */ | - |
379 | | - |
380 | /*! | - |
381 | \variable QAbstractTextDocumentLayout::Selection::cursor | - |
382 | \brief the selection's cursor | - |
383 | | - |
384 | The default value is a null cursor. | - |
385 | */ | - |
386 | | - |
387 | /*! | - |
388 | Creates a new text document layout for the given \a document. | - |
389 | */ | - |
390 | QAbstractTextDocumentLayout::QAbstractTextDocumentLayout(QTextDocument *document) | - |
391 | : QObject(*new QAbstractTextDocumentLayoutPrivate, document) | - |
392 | { | - |
393 | Q_D(QAbstractTextDocumentLayout); executed (the execution status of this line is deduced): QAbstractTextDocumentLayoutPrivate * const d = d_func(); | - |
394 | d->setDocument(document); executed (the execution status of this line is deduced): d->setDocument(document); | - |
395 | } executed: } Execution Count:47 | 47 |
396 | | - |
397 | /*! | - |
398 | \internal | - |
399 | */ | - |
400 | QAbstractTextDocumentLayout::QAbstractTextDocumentLayout(QAbstractTextDocumentLayoutPrivate &p, QTextDocument *document) | - |
401 | :QObject(p, document) | - |
402 | { | - |
403 | Q_D(QAbstractTextDocumentLayout); executed (the execution status of this line is deduced): QAbstractTextDocumentLayoutPrivate * const d = d_func(); | - |
404 | d->setDocument(document); executed (the execution status of this line is deduced): d->setDocument(document); | - |
405 | } executed: } Execution Count:406 | 406 |
406 | | - |
407 | /*! | - |
408 | \internal | - |
409 | */ | - |
410 | QAbstractTextDocumentLayout::~QAbstractTextDocumentLayout() | - |
411 | { | - |
412 | } | - |
413 | | - |
414 | /*! | - |
415 | \fn void QAbstractTextDocumentLayout::registerHandler(int objectType, QObject *component) | - |
416 | | - |
417 | Registers the given \a component as a handler for items of the given \a objectType. | - |
418 | | - |
419 | \note registerHandler() has to be called once for each object type. This | - |
420 | means that there is only one handler for multiple replacement characters | - |
421 | of the same object type. | - |
422 | | - |
423 | The text document layout does not take ownership of \c component. | - |
424 | */ | - |
425 | void QAbstractTextDocumentLayout::registerHandler(int formatType, QObject *component) | - |
426 | { | - |
427 | Q_D(QAbstractTextDocumentLayout); executed (the execution status of this line is deduced): QAbstractTextDocumentLayoutPrivate * const d = d_func(); | - |
428 | | - |
429 | QTextObjectInterface *iface = qobject_cast<QTextObjectInterface *>(component); executed (the execution status of this line is deduced): QTextObjectInterface *iface = qobject_cast<QTextObjectInterface *>(component); | - |
430 | if (!iface) partially evaluated: !iface no Evaluation Count:0 | yes Evaluation Count:314 |
| 0-314 |
431 | return; // ### print error message on terminal? | 0 |
432 | | - |
433 | connect(component, SIGNAL(destroyed(QObject*)), this, SLOT(_q_handlerDestroyed(QObject*))); executed (the execution status of this line is deduced): connect(component, "2""destroyed(QObject*)", this, "1""_q_handlerDestroyed(QObject*)"); | - |
434 | | - |
435 | QTextObjectHandler h; executed (the execution status of this line is deduced): QTextObjectHandler h; | - |
436 | h.iface = iface; executed (the execution status of this line is deduced): h.iface = iface; | - |
437 | h.component = component; executed (the execution status of this line is deduced): h.component = component; | - |
438 | d->handlers.insert(formatType, h); executed (the execution status of this line is deduced): d->handlers.insert(formatType, h); | - |
439 | } executed: } Execution Count:314 | 314 |
440 | | - |
441 | /*! | - |
442 | Returns a handler for objects of the given \a objectType. | - |
443 | */ | - |
444 | QTextObjectInterface *QAbstractTextDocumentLayout::handlerForObject(int objectType) const | - |
445 | { | - |
446 | Q_D(const QAbstractTextDocumentLayout); executed (the execution status of this line is deduced): const QAbstractTextDocumentLayoutPrivate * const d = d_func(); | - |
447 | | - |
448 | QTextObjectHandler handler = d->handlers.value(objectType); executed (the execution status of this line is deduced): QTextObjectHandler handler = d->handlers.value(objectType); | - |
449 | if (!handler.component) partially evaluated: !handler.component no Evaluation Count:0 | yes Evaluation Count:1 |
| 0-1 |
450 | return 0; never executed: return 0; | 0 |
451 | | - |
452 | return handler.iface; executed: return handler.iface; Execution Count:1 | 1 |
453 | } | - |
454 | | - |
455 | /*! | - |
456 | Sets the size of the inline object \a item corresponding to the text | - |
457 | \a format. | - |
458 | | - |
459 | \a posInDocument specifies the position of the object within the document. | - |
460 | | - |
461 | The default implementation resizes the \a item to the size returned by | - |
462 | the object handler's intrinsicSize() function. This function is called only | - |
463 | within Qt. Subclasses can reimplement this function to customize the | - |
464 | resizing of inline objects. | - |
465 | */ | - |
466 | void QAbstractTextDocumentLayout::resizeInlineObject(QTextInlineObject item, int posInDocument, const QTextFormat &format) | - |
467 | { | - |
468 | Q_D(QAbstractTextDocumentLayout); never executed (the execution status of this line is deduced): QAbstractTextDocumentLayoutPrivate * const d = d_func(); | - |
469 | | - |
470 | QTextCharFormat f = format.toCharFormat(); never executed (the execution status of this line is deduced): QTextCharFormat f = format.toCharFormat(); | - |
471 | Q_ASSERT(f.isValid()); never executed (the execution status of this line is deduced): qt_noop(); | - |
472 | QTextObjectHandler handler = d->handlers.value(f.objectType()); never executed (the execution status of this line is deduced): QTextObjectHandler handler = d->handlers.value(f.objectType()); | - |
473 | if (!handler.component) never evaluated: !handler.component | 0 |
474 | return; | 0 |
475 | | - |
476 | QSizeF s = handler.iface->intrinsicSize(document(), posInDocument, format); never executed (the execution status of this line is deduced): QSizeF s = handler.iface->intrinsicSize(document(), posInDocument, format); | - |
477 | item.setWidth(s.width()); never executed (the execution status of this line is deduced): item.setWidth(s.width()); | - |
478 | item.setAscent(s.height()); never executed (the execution status of this line is deduced): item.setAscent(s.height()); | - |
479 | item.setDescent(0); never executed (the execution status of this line is deduced): item.setDescent(0); | - |
480 | } | 0 |
481 | | - |
482 | /*! | - |
483 | Lays out the inline object \a item using the given text \a format. | - |
484 | | - |
485 | \a posInDocument specifies the position of the object within the document. | - |
486 | | - |
487 | The default implementation does nothing. This function is called only | - |
488 | within Qt. Subclasses can reimplement this function to customize the | - |
489 | position of inline objects. | - |
490 | | - |
491 | \sa drawInlineObject() | - |
492 | */ | - |
493 | void QAbstractTextDocumentLayout::positionInlineObject(QTextInlineObject item, int posInDocument, const QTextFormat &format) | - |
494 | { | - |
495 | Q_UNUSED(item); never executed (the execution status of this line is deduced): (void)item;; | - |
496 | Q_UNUSED(posInDocument); never executed (the execution status of this line is deduced): (void)posInDocument;; | - |
497 | Q_UNUSED(format); never executed (the execution status of this line is deduced): (void)format;; | - |
498 | } | 0 |
499 | | - |
500 | /*! | - |
501 | \fn void QAbstractTextDocumentLayout::drawInlineObject(QPainter *painter, const QRectF &rect, QTextInlineObject object, int posInDocument, const QTextFormat &format) | - |
502 | | - |
503 | This function is called to draw the inline object, \a object, with the | - |
504 | given \a painter within the rectangle specified by \a rect using the | - |
505 | specified text \a format. | - |
506 | | - |
507 | \a posInDocument specifies the position of the object within the document. | - |
508 | | - |
509 | The default implementation calls drawObject() on the object handlers. This | - |
510 | function is called only within Qt. Subclasses can reimplement this function | - |
511 | to customize the drawing of inline objects. | - |
512 | | - |
513 | \sa draw() | - |
514 | */ | - |
515 | void QAbstractTextDocumentLayout::drawInlineObject(QPainter *p, const QRectF &rect, QTextInlineObject item, | - |
516 | int posInDocument, const QTextFormat &format) | - |
517 | { | - |
518 | Q_UNUSED(item); executed (the execution status of this line is deduced): (void)item;; | - |
519 | Q_D(QAbstractTextDocumentLayout); executed (the execution status of this line is deduced): QAbstractTextDocumentLayoutPrivate * const d = d_func(); | - |
520 | | - |
521 | QTextCharFormat f = format.toCharFormat(); executed (the execution status of this line is deduced): QTextCharFormat f = format.toCharFormat(); | - |
522 | Q_ASSERT(f.isValid()); executed (the execution status of this line is deduced): qt_noop(); | - |
523 | QTextObjectHandler handler = d->handlers.value(f.objectType()); executed (the execution status of this line is deduced): QTextObjectHandler handler = d->handlers.value(f.objectType()); | - |
524 | if (!handler.component) partially evaluated: !handler.component no Evaluation Count:0 | yes Evaluation Count:1 |
| 0-1 |
525 | return; | 0 |
526 | | - |
527 | handler.iface->drawObject(p, rect, document(), posInDocument, format); executed (the execution status of this line is deduced): handler.iface->drawObject(p, rect, document(), posInDocument, format); | - |
528 | } executed: } Execution Count:1 | 1 |
529 | | - |
530 | void QAbstractTextDocumentLayoutPrivate::_q_handlerDestroyed(QObject *obj) | - |
531 | { | - |
532 | HandlerHash::Iterator it = handlers.begin(); never executed (the execution status of this line is deduced): HandlerHash::Iterator it = handlers.begin(); | - |
533 | while (it != handlers.end()) never evaluated: it != handlers.end() | 0 |
534 | if ((*it).component == obj) never evaluated: (*it).component == obj | 0 |
535 | it = handlers.erase(it); never executed: it = handlers.erase(it); | 0 |
536 | else | - |
537 | ++it; | 0 |
538 | } | 0 |
539 | | - |
540 | /*! | - |
541 | \internal | - |
542 | | - |
543 | Returns the index of the format at position \a pos. | - |
544 | */ | - |
545 | int QAbstractTextDocumentLayout::formatIndex(int pos) | - |
546 | { | - |
547 | QTextDocumentPrivate *pieceTable = qobject_cast<QTextDocument *>(parent())->docHandle(); never executed (the execution status of this line is deduced): QTextDocumentPrivate *pieceTable = qobject_cast<QTextDocument *>(parent())->docHandle(); | - |
548 | return pieceTable->find(pos).value()->format; never executed: return pieceTable->find(pos).value()->format; | 0 |
549 | } | - |
550 | | - |
551 | /*! | - |
552 | \fn QTextCharFormat QAbstractTextDocumentLayout::format(int position) | - |
553 | | - |
554 | Returns the character format that is applicable at the given \a position. | - |
555 | */ | - |
556 | QTextCharFormat QAbstractTextDocumentLayout::format(int pos) | - |
557 | { | - |
558 | QTextDocumentPrivate *pieceTable = qobject_cast<QTextDocument *>(parent())->docHandle(); executed (the execution status of this line is deduced): QTextDocumentPrivate *pieceTable = qobject_cast<QTextDocument *>(parent())->docHandle(); | - |
559 | int idx = pieceTable->find(pos).value()->format; executed (the execution status of this line is deduced): int idx = pieceTable->find(pos).value()->format; | - |
560 | return pieceTable->formatCollection()->charFormat(idx); executed: return pieceTable->formatCollection()->charFormat(idx); Execution Count:1 | 1 |
561 | } | - |
562 | | - |
563 | | - |
564 | | - |
565 | /*! | - |
566 | Returns the text document that this layout is operating on. | - |
567 | */ | - |
568 | QTextDocument *QAbstractTextDocumentLayout::document() const | - |
569 | { | - |
570 | Q_D(const QAbstractTextDocumentLayout); executed (the execution status of this line is deduced): const QAbstractTextDocumentLayoutPrivate * const d = d_func(); | - |
571 | return d->document; executed: return d->document; Execution Count:20089 | 20089 |
572 | } | - |
573 | | - |
574 | /*! | - |
575 | \fn QString QAbstractTextDocumentLayout::anchorAt(const QPointF &position) const | - |
576 | | - |
577 | Returns the reference of the anchor the given \a position, or an empty | - |
578 | string if no anchor exists at that point. | - |
579 | */ | - |
580 | QString QAbstractTextDocumentLayout::anchorAt(const QPointF& pos) const | - |
581 | { | - |
582 | int cursorPos = hitTest(pos, Qt::ExactHit); executed (the execution status of this line is deduced): int cursorPos = hitTest(pos, Qt::ExactHit); | - |
583 | if (cursorPos == -1) evaluated: cursorPos == -1 yes Evaluation Count:1 | yes Evaluation Count:6 |
| 1-6 |
584 | return QString(); executed: return QString(); Execution Count:1 | 1 |
585 | | - |
586 | // compensate for preedit in the hit text block | - |
587 | QTextBlock block = document()->firstBlock(); executed (the execution status of this line is deduced): QTextBlock block = document()->firstBlock(); | - |
588 | while (block.isValid()) { partially evaluated: block.isValid() yes Evaluation Count:10 | no Evaluation Count:0 |
| 0-10 |
589 | QRectF blockBr = blockBoundingRect(block); executed (the execution status of this line is deduced): QRectF blockBr = blockBoundingRect(block); | - |
590 | if (blockBr.contains(pos)) { evaluated: blockBr.contains(pos) yes Evaluation Count:6 | yes Evaluation Count:4 |
| 4-6 |
591 | QTextLayout *layout = block.layout(); executed (the execution status of this line is deduced): QTextLayout *layout = block.layout(); | - |
592 | int relativeCursorPos = cursorPos - block.position(); executed (the execution status of this line is deduced): int relativeCursorPos = cursorPos - block.position(); | - |
593 | const int preeditLength = layout ? layout->preeditAreaText().length() : 0; partially evaluated: layout yes Evaluation Count:6 | no Evaluation Count:0 |
| 0-6 |
594 | if (preeditLength > 0 && relativeCursorPos > layout->preeditAreaPosition()) evaluated: preeditLength > 0 yes Evaluation Count:2 | yes Evaluation Count:4 |
evaluated: relativeCursorPos > layout->preeditAreaPosition() yes Evaluation Count:1 | yes Evaluation Count:1 |
| 1-4 |
595 | cursorPos -= qMin(cursorPos - layout->preeditAreaPosition(), preeditLength); executed: cursorPos -= qMin(cursorPos - layout->preeditAreaPosition(), preeditLength); Execution Count:1 | 1 |
596 | break; executed: break; Execution Count:6 | 6 |
597 | } | - |
598 | block = block.next(); executed (the execution status of this line is deduced): block = block.next(); | - |
599 | } executed: } Execution Count:4 | 4 |
600 | | - |
601 | QTextDocumentPrivate *pieceTable = qobject_cast<const QTextDocument *>(parent())->docHandle(); executed (the execution status of this line is deduced): QTextDocumentPrivate *pieceTable = qobject_cast<const QTextDocument *>(parent())->docHandle(); | - |
602 | QTextDocumentPrivate::FragmentIterator it = pieceTable->find(cursorPos); executed (the execution status of this line is deduced): QTextDocumentPrivate::FragmentIterator it = pieceTable->find(cursorPos); | - |
603 | QTextCharFormat fmt = pieceTable->formatCollection()->charFormat(it->format); executed (the execution status of this line is deduced): QTextCharFormat fmt = pieceTable->formatCollection()->charFormat(it->format); | - |
604 | return fmt.anchorHref(); executed: return fmt.anchorHref(); Execution Count:6 | 6 |
605 | } | - |
606 | | - |
607 | /*! | - |
608 | \fn QRectF QAbstractTextDocumentLayout::frameBoundingRect(QTextFrame *frame) const | - |
609 | | - |
610 | Returns the bounding rectangle of \a frame. | - |
611 | */ | - |
612 | | - |
613 | /*! | - |
614 | \fn QRectF QAbstractTextDocumentLayout::blockBoundingRect(const QTextBlock &block) const | - |
615 | | - |
616 | Returns the bounding rectangle of \a block. | - |
617 | */ | - |
618 | | - |
619 | /*! | - |
620 | Sets the paint device used for rendering the document's layout to the given | - |
621 | \a device. | - |
622 | | - |
623 | \sa paintDevice() | - |
624 | */ | - |
625 | void QAbstractTextDocumentLayout::setPaintDevice(QPaintDevice *device) | - |
626 | { | - |
627 | Q_D(QAbstractTextDocumentLayout); executed (the execution status of this line is deduced): QAbstractTextDocumentLayoutPrivate * const d = d_func(); | - |
628 | d->paintDevice = device; executed (the execution status of this line is deduced): d->paintDevice = device; | - |
629 | } executed: } Execution Count:262 | 262 |
630 | | - |
631 | /*! | - |
632 | Returns the paint device used to render the document's layout. | - |
633 | | - |
634 | \sa setPaintDevice() | - |
635 | */ | - |
636 | QPaintDevice *QAbstractTextDocumentLayout::paintDevice() const | - |
637 | { | - |
638 | Q_D(const QAbstractTextDocumentLayout); executed (the execution status of this line is deduced): const QAbstractTextDocumentLayoutPrivate * const d = d_func(); | - |
639 | return d->paintDevice; executed: return d->paintDevice; Execution Count:94779 | 94779 |
640 | } | - |
641 | | - |
642 | QT_END_NAMESPACE | - |
643 | | - |
644 | #include "moc_qabstracttextdocumentlayout.cpp" | - |
645 | | - |
| | |