Class: QgsTextDocument

class qgis.core.QgsTextDocument

Bases: sip.wrapper

Represents a document consisting of one or more QgsTextBlock objects.

Warning

This API is not considered stable and may change in future QGIS versions.

New in version 3.14.

QgsTextDocument()

QgsTextDocument(block: QgsTextBlock) Constructor for a QgsTextDocument consisting of a single text block.

QgsTextDocument(fragment: QgsTextFragment) Constructor for a QgsTextDocument consisting of a single text fragment.

QgsTextDocument(QgsTextDocument)

Methods

append

Appends a block to the document.

applyCapitalization

Applies a capitalization style to the document's text.

at

Returns the block at the specified index.

fromHtml

Constructor for QgsTextDocument consisting of a set of HTML formatted lines.

fromPlainText

Constructor for QgsTextDocument consisting of a set of plain text lines.

reserve

Reserves the specified count of blocks for optimised block appending.

size

Returns the number of blocks in the document.

splitLines

Splits lines of text in the document to separate lines, using a specified wrap character (wrapCharacter) or newline characters.

toPlainText

Returns a list of plain text lines of text representing the document.

append(self, block: QgsTextBlock)

Appends a block to the document.

Parameters

block (QgsTextBlock) –

applyCapitalization(self, capitalization: Qgis.Capitalization)

Applies a capitalization style to the document’s text.

New in version 3.16.

Parameters

capitalization (Qgis.Capitalization) –

at(self, index: int) QgsTextBlock

Returns the block at the specified index.

Raises

KeyError – if no block exists at the specified index.

Parameters

index (int) –

Return type

QgsTextBlock

fromHtml(lines: Iterable[str]) QgsTextDocument

Constructor for QgsTextDocument consisting of a set of HTML formatted lines.

Parameters

lines (Iterable[str]) –

Return type

QgsTextDocument

fromPlainText(lines: Iterable[str]) QgsTextDocument

Constructor for QgsTextDocument consisting of a set of plain text lines.

Parameters

lines (Iterable[str]) –

Return type

QgsTextDocument

reserve(self, count: int)

Reserves the specified count of blocks for optimised block appending.

Parameters

count (int) –

size(self) int

Returns the number of blocks in the document.

Return type

int

splitLines(self, wrapCharacter: str, autoWrapLength: int = 0, useMaxLineLengthWhenAutoWrapping: bool = True)

Splits lines of text in the document to separate lines, using a specified wrap character (wrapCharacter) or newline characters.

The autoWrapLength argument can be used to specify an ideal length of line to automatically wrap text to (automatic wrapping is disabled if autoWrapLength is 0). This automatic wrapping is performed after processing wrapping using wrapCharacter. When auto wrapping is enabled, the useMaxLineLengthWhenAutoWrapping argument controls whether the lines should be wrapped to an ideal maximum of autoWrapLength characters, or if False then the lines are wrapped to an ideal minimum length of autoWrapLength characters.

Parameters
  • wrapCharacter (str) –

  • autoWrapLength (int = 0) –

  • useMaxLineLengthWhenAutoWrapping (bool = True) –

toPlainText(self) List[str]

Returns a list of plain text lines of text representing the document.

Return type

List[str]