QPlainTextDocumentLayout Class

The QPlainTextDocumentLayout class implements a plain text layout for QTextDocument More...

Header: #include <QPlainTextDocumentLayout>
qmake: QT += widgets
Since: Qt 4.4
Inherits: QAbstractTextDocumentLayout


  • 1 property inherited from QObject

Public Functions

QPlainTextDocumentLayout(QTextDocument *document)
int cursorWidth() const
void ensureBlockLayout(const QTextBlock &block) const
void requestUpdate()
void setCursorWidth(int width)

Reimplemented Public Functions

virtual QRectF blockBoundingRect(const QTextBlock &block) const
virtual QSizeF documentSize() const
virtual void draw(QPainter *, const PaintContext &)
virtual QRectF frameBoundingRect(QTextFrame *) const
virtual int hitTest(const QPointF &, Qt::HitTestAccuracy) const
virtual int pageCount() const

Reimplemented Protected Functions

virtual void documentChanged(int from, int charsRemoved, int charsAdded)

Additional Inherited Members

Detailed Description

The QPlainTextDocumentLayout class implements a plain text layout for QTextDocument

A QPlainTextDocumentLayout is required for text documents that can be display or edited in a QPlainTextEdit. See QTextDocument::setDocumentLayout().

QPlainTextDocumentLayout uses the QAbstractTextDocumentLayout API that QTextDocument requires, but redefines it partially in order to support plain text better. For instances, it does not operate on vertical pixels, but on paragraphs (called blocks) instead. The height of a document is identical to the number of paragraphs it contains. The layout also doesn't support tables or nested frames, or any sort of advanced text layout that goes beyond a list of paragraphs with syntax highlighting.

Property Documentation

cursorWidth : int

This property specifies the width of the cursor in pixels. The default value is 1.

Access functions:

int cursorWidth() const
void setCursorWidth(int width)

Member Function Documentation

QPlainTextDocumentLayout::QPlainTextDocumentLayout(QTextDocument *document)

Constructs a plain text document layout for the text document.


Destructs a plain text document layout.

[virtual] QRectF QPlainTextDocumentLayout::blockBoundingRect(const QTextBlock &block) const

Reimplemented from QAbstractTextDocumentLayout::blockBoundingRect().

[virtual protected] void QPlainTextDocumentLayout::documentChanged(int from, int charsRemoved, int charsAdded)

Reimplemented from QAbstractTextDocumentLayout::documentChanged().

[virtual] QSizeF QPlainTextDocumentLayout::documentSize() const

Reimplemented from QAbstractTextDocumentLayout::documentSize().

[virtual] void QPlainTextDocumentLayout::draw(QPainter *, const PaintContext &)

Reimplemented from QAbstractTextDocumentLayout::draw().

void QPlainTextDocumentLayout::ensureBlockLayout(const QTextBlock &block) const

Ensures that block has a valid layout

[virtual] QRectF QPlainTextDocumentLayout::frameBoundingRect(QTextFrame *) const

Reimplemented from QAbstractTextDocumentLayout::frameBoundingRect().

[virtual] int QPlainTextDocumentLayout::hitTest(const QPointF &, Qt::HitTestAccuracy) const

Reimplemented from QAbstractTextDocumentLayout::hitTest().

[virtual] int QPlainTextDocumentLayout::pageCount() const

Reimplemented from QAbstractTextDocumentLayout::pageCount().

void QPlainTextDocumentLayout::requestUpdate()

Requests a complete update on all views.

© 2017 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.