QTextDocument Class

Dokumentation der Mitgliedsfunktionen

[explicit] QTextDocument::QTextDocument(QObject *parent = nullptr)

Erstellt ein leeres QTextDocument mit dem angegebenen „ parent “.

[explicit] QTextDocument::QTextDocument(const QString &text, QObject *parent = nullptr)

Erstellt ein QTextDocument, das den angegebenen einfachen (unformatierten) Text „ text “ enthält und die angegebene „ parent “ aufweist.

[virtual noexcept] QTextDocument::~QTextDocument()

Vernichtet das Dokument.

void QTextDocument::addResource(int type, const QUrl &name, const QVariant &resource)

Fügt die Ressource resource zum Ressourcen-Cache hinzu und verwendet dabei type und name als Bezeichner. type sollte ein Wert aus QTextDocument::ResourceType sein.

Beispielsweise können Sie ein Bild als Ressource hinzufügen, um im Dokument darauf zu verweisen:

    document->addResource(QTextDocument::ImageResource,
        QUrl("mydata://image.png"), QVariant(image));

Das Bild kann mithilfe der „ QTextCursor “-API in das Dokument eingefügt werden:

    QTextImageFormat imageFormat;
    imageFormat.setName("mydata://image.png");
    cursor.insertImage(imageFormat);

Alternativ können Sie Bilder mithilfe des HTML-Tags ` img ` einfügen:

    editor->append("<img src=\"mydata://image.png\" />");

void QTextDocument::adjustSize()

Passt das Dokument auf eine angemessene Größe an.

Siehe auch idealWidth(), textWidth und size.

QList<QTextFormat> QTextDocument::allFormats() const

Gibt eine Liste der Textformate für alle im Dokument verwendeten Formate zurück.

int QTextDocument::availableRedoSteps() const

Gibt die Anzahl der verfügbaren Redo-Schritte zurück.

Siehe auch „ isRedoAvailable()“.

int QTextDocument::availableUndoSteps() const

Gibt die Anzahl der verfügbaren Rückgängig-Schritte zurück.

Siehe auch „ isUndoAvailable()“.

[since 6.0] qreal QTextDocument::baselineOffset() const

Gibt den im Dokumentlayout verwendeten Grundlinienversatz in Prozent zurück.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch setBaselineOffset(), setSubScriptBaseline(), subScriptBaseline(), setSuperScriptBaseline() und superScriptBaseline().

QTextBlock QTextDocument::begin() const

Gibt den ersten Textblock des Dokuments zurück.

Siehe auch ` firstBlock()`.

[signal] void QTextDocument::blockCountChanged(int newBlockCount)

Dieses Signal wird ausgelöst, wenn sich die Gesamtzahl der Textblöcke im Dokument ändert. Der an „ newBlockCount “ übergebene Wert ist die neue Gesamtzahl.

QChar QTextDocument::characterAt(int pos) const

Gibt das Zeichen an der Position pos zurück oder ein Nullzeichen, wenn die Position außerhalb des zulässigen Bereichs liegt.

Siehe auch characterCount().

int QTextDocument::characterCount() const

Gibt die Anzahl der Zeichen in diesem Dokument zurück.

Siehe auch „ blockCount()“ und „ characterAt()“.

[virtual] void QTextDocument::clear()

Löscht das Dokument.

void QTextDocument::clearUndoRedoStacks(QTextDocument::Stacks stacksToClear = UndoAndRedoStacks)

Löscht die durch ` stacksToClear` angegebenen Stacks.

Diese Methode löscht alle Befehle im Rückgängig-Stapel, im Wiederherstellen-Stapel oder in beiden (Standard). Wenn Befehle gelöscht werden, werden die entsprechenden Signale ausgelöst: „ QTextDocument::undoAvailable()“ oder „ QTextDocument::redoAvailable()“.

Siehe auch ` QTextDocument::undoAvailable()` und ` QTextDocument::redoAvailable()`.

QTextDocument *QTextDocument::clone(QObject *parent = nullptr) const

Erstellt ein neues „ QTextDocument “, das eine Kopie dieses Textdokuments darstellt. „ parent “ ist das übergeordnete Element des zurückgegebenen Textdokuments.

[signal] void QTextDocument::contentsChange(int position, int charsRemoved, int charsAdded)

Dieses Signal wird immer dann ausgelöst, wenn sich der Inhalt des Dokuments ändert, beispielsweise wenn Text eingefügt oder gelöscht wird oder wenn eine Formatierung vorgenommen wird.

Es werden Informationen über die „ position “ des Zeichens im Dokument, an dem die Änderung stattfand, die Anzahl der entfernten Zeichen (charsRemoved) und die Anzahl der hinzugefügten Zeichen (charsAdded) bereitgestellt.

Das Signal wird ausgegeben, bevor der Layout-Manager des Dokuments über die Änderung informiert wird. Mit diesem Hook können Sie eine Syntaxhervorhebung für das Dokument implementieren.

Siehe auch ` QAbstractTextDocumentLayout::documentChanged()` und ` contentsChanged()`.

[signal] void QTextDocument::contentsChanged()

Dieses Signal wird immer dann ausgelöst, wenn sich der Inhalt des Dokuments ändert, beispielsweise wenn Text eingefügt oder gelöscht wird oder wenn eine Formatierung angewendet wird.

Siehe auch „ contentsChange“ ().

[virtual protected] QTextObject *QTextDocument::createObject(const QTextFormat &format)

Erstellt ein neues Dokumentobjekt (ein ` QTextObject`) auf der Grundlage des angegebenen ` format` und gibt es zurück.

QTextObjects werden immer über diese Methode erstellt. Daher müssen Sie sie neu implementieren, wenn Sie benutzerdefinierte Textobjekte in Ihrem Dokument verwenden.

[signal] void QTextDocument::cursorPositionChanged(const QTextCursor &cursor)

Dieses Signal wird immer dann ausgelöst, wenn sich die Position eines Cursors aufgrund einer Bearbeitungsaktion geändert hat. Der betroffene Cursor wird in ` cursor` übergeben. Wenn das Dokument mit der Klasse ` QTextEdit ` verwendet wird und Sie ein Signal benötigen, wenn der Cursor mit den Pfeiltasten bewegt wird, können Sie das Signal ` cursorPositionChanged()` in ` QTextEdit` verwenden.

Qt::CursorMoveStyle QTextDocument::defaultCursorMoveStyle() const

Der Standardstil für die Cursorbewegung wird von allen „ QTextCursor “-Objekten verwendet, die aus dem Dokument erstellt werden. Die Standardeinstellung lautet „ Qt::LogicalMoveStyle “.

Siehe auch setDefaultCursorMoveStyle().

QFont QTextDocument::defaultFont() const

Gibt die Standardschriftart zurück, die im Dokumentlayout verwendet werden soll.

Siehe auch „ setDefaultFont()“.

[static, since 6.1] QTextDocument::ResourceProvider QTextDocument::defaultResourceProvider()

Gibt den Standard-Ressourcenanbieter zurück.

Diese Funktion wurde in Qt 6.1 eingeführt.

Siehe auch setDefaultResourceProvider(), resourceProvider() und loadResource().

QTextOption QTextDocument::defaultTextOption() const

Die Standardtextoption wird für alle „ QTextLayout “-Objekte im Dokument verwendet. Damit lassen sich globale Eigenschaften für das Dokument festlegen, wie beispielsweise der Standardmodus für den Zeilenumbruch.

Siehe auch „ setDefaultTextOption()“.

QAbstractTextDocumentLayout *QTextDocument::documentLayout() const

Gibt das Dokumentlayout für dieses Dokument zurück.

Siehe auch „ setDocumentLayout()“.

[signal] void QTextDocument::documentLayoutChanged()

Dieses Signal wird ausgelöst, wenn ein neues Dokumentlayout festgelegt wird.

Siehe auch „ setDocumentLayout()“.

void QTextDocument::drawContents(QPainter *p, const QRectF &rect = QRectF())

Zeichnet den Inhalt des Dokuments mit dem Maler- p, beschnitten auf rect. Ist rect ein Null-Rechteck (Standard), wird das Dokument unbeschnitten gezeichnet.

QTextBlock QTextDocument::end() const

Diese Funktion gibt einen Block zurück, mit dem beim Durchlaufen des Dokuments geprüft werden kann, ob das Ende des Dokuments erreicht ist.

for (QTextBlock it = doc->begin(); it != doc->end(); it = it.next())
    std::cout << it.text().toStdString() << "\n";

Der zurückgegebene Block ist ungültig und stellt den Block nach dem letzten Block im Dokument dar. Mit ` lastBlock()` können Sie den letzten gültigen Block des Dokuments abrufen.

Siehe auch ` lastBlock()`.

QTextCursor QTextDocument::find(const QRegularExpression &expr, const QTextCursor &cursor, QTextDocument::FindFlags options = FindFlags()) const

Sucht innerhalb desselben Absatzes im Dokument nach dem nächsten Vorkommen, das dem angegebenen regulären Ausdruck „ expr “ entspricht.

Die Suche beginnt an der Position des angegebenen „ cursor “ und verläuft vorwärts durch das Dokument, sofern in den Suchoptionen nichts anderes festgelegt ist. Die „ options “ steuern die Art der durchgeführten Suche.

Gibt einen Cursor zurück, bei dem die Übereinstimmung markiert ist, falls eine Übereinstimmung gefunden wurde; andernfalls wird ein Null-Cursor zurückgegeben.

Wenn der angegebene ` cursor ` eine Auswahl enthält, beginnt die Suche nach der Auswahl; andernfalls beginnt sie an der Cursorposition.

Standardmäßig wird bei der Suche die Groß-/Kleinschreibung nicht berücksichtigt, und es kann nach Text an beliebiger Stelle im Dokument gesucht werden.

QTextCursor QTextDocument::find(const QRegularExpression &expr, int from = 0, QTextDocument::FindFlags options = FindFlags()) const

Sucht innerhalb desselben Absatzes im Dokument nach dem nächsten Vorkommen, das dem angegebenen regulären Ausdruck „ expr “ entspricht.

Die Suche beginnt an der angegebenen Position „ from “ und verläuft vorwärts durch das Dokument, sofern in den Suchoptionen nichts anderes festgelegt ist. Die „ options “ steuern die Art der durchgeführten Suche.

Gibt einen Cursor zurück, bei dem die Übereinstimmung markiert ist, sofern eine Übereinstimmung gefunden wurde; andernfalls wird ein Null-Cursor zurückgegeben.

Ist die Position „ from “ 0 (Standard), beginnt die Suche am Anfang des Dokuments; andernfalls beginnt sie an der angegebenen Position.

QTextCursor QTextDocument::find(const QString &subString, const QTextCursor &cursor, QTextDocument::FindFlags options = FindFlags()) const

Sucht im Dokument nach dem nächsten Vorkommen der Zeichenfolge „ subString “. Die Suche beginnt an der Position des angegebenen „ cursor “ und verläuft forwärts durch das Dokument, sofern in den Suchoptionen nichts anderes festgelegt ist. Die „ options “ legen die Art der durchgeführten Suche fest.

Gibt einen Cursor zurück, bei dem die Übereinstimmung markiert ist, wenn „ subString “ gefunden wurde; andernfalls wird ein Null-Cursor zurückgegeben.

Wenn der angegebene ` cursor ` eine Auswahl enthält, beginnt die Suche nach der Auswahl; andernfalls beginnt sie an der Cursorposition.

Standardmäßig erfolgt die Suche ohne Berücksichtigung der Groß-/Kleinschreibung und kann Text an beliebiger Stelle im Dokument finden.

QTextCursor QTextDocument::find(const QString &subString, int position = 0, QTextDocument::FindFlags options = FindFlags()) const

Sucht im Dokument nach dem nächsten Vorkommen der Zeichenfolge „ subString “. Die Suche beginnt an der angegebenen Position „ position “ und verläuft vorwärts durch das Dokument, sofern in den Suchoptionen nichts anderes festgelegt ist. Die Suchoptionen „ options “ legen die Art der durchgeführten Suche fest.

Gibt einen Cursor zurück, bei dem die Übereinstimmung markiert ist, wenn „ subString “ gefunden wurde; andernfalls wird ein Null-Cursor zurückgegeben.

Ist der Parameter „ position “ gleich 0 (Standardwert), beginnt die Suche am Anfang des Dokuments; andernfalls beginnt sie an der angegebenen Position.

QTextBlock QTextDocument::findBlock(int pos) const

Gibt den Textblock zurück, der das -te Zeichen von „ pos “ enthält.

QTextBlock QTextDocument::findBlockByLineNumber(int lineNumber) const

Gibt den Textblock zurück, der den angegebenen „ lineNumber “ enthält.

Siehe auch QTextBlock::firstLineNumber().

QTextBlock QTextDocument::findBlockByNumber(int blockNumber) const

Gibt den Textblock mit dem angegebenen „ blockNumber “ zurück.

Siehe auch QTextBlock::blockNumber().

QTextBlock QTextDocument::firstBlock() const

Gibt den ersten Textblock des Dokuments zurück.

qreal QTextDocument::idealWidth() const

Gibt die ideale Breite des Textdokuments zurück. Die ideale Breite ist die tatsächlich genutzte Breite des Dokuments, ohne Berücksichtigung optionaler Ausrichtungen. Sie ist immer <= size().width().

Siehe auch adjustSize() und textWidth.

bool QTextDocument::isEmpty() const

Gibt „ true “ zurück, wenn das Dokument leer ist; andernfalls wird „ false “ zurückgegeben.

bool QTextDocument::isRedoAvailable() const

Gibt „ true “ zurück, wenn „redo“ verfügbar ist; andernfalls wird „ false “ zurückgegeben.

Siehe auch „ isUndoAvailable()“ und „ availableRedoSteps()“.

bool QTextDocument::isUndoAvailable() const

Gibt „ true “ zurück, wenn die Rückgängig-Funktion verfügbar ist; andernfalls gibt es „ false “ zurück.

Siehe auch „ isRedoAvailable()“ und „ availableUndoSteps()“.

QTextBlock QTextDocument::lastBlock() const

Gibt den letzten (gültigen) Textblock des Dokuments zurück.

int QTextDocument::lineCount() const

Gibt die Anzahl der Zeilen dieses Dokuments zurück (sofern das Layout dies unterstützt). Andernfalls entspricht diese Zahl der Anzahl der Blöcke.

Siehe auch blockCount() und characterCount().

[virtual protected invokable] QVariant QTextDocument::loadResource(int type, const QUrl &name)

Lädt Daten des angegebenen „ type “ aus der Ressource mit der angegebenen „ name “ .

Diese Funktion wird von der Rich-Text-Engine aufgerufen, um Daten anzufordern, die nicht direkt von QTextDocument gespeichert werden, aber dennoch damit verknüpft sind. Beispielsweise werden Bilder indirekt über das „name“-Attribut eines QTextImageFormat -Objekts referenziert.

Wenn die Funktion von Qt XML aufgerufen wird, ist ` type ` einer der Werte von ` QTextDocument::ResourceType`.

Ist „ QTextDocument “ ein untergeordnetes Objekt eines „ QObject “, das über eine aufrufbare „loadResource“-Methode wie „ QTextEdit “, „ QTextBrowser “ oder „ QTextDocument “ selbst verfügt, versucht die Standardimplementierung, die Daten vom übergeordneten Objekt abzurufen.

Siehe auch QTextDocument::ResourceProvider.

void QTextDocument::markContentsDirty(int position, int length)

Markiert die durch die angegebenen position und length bezeichneten Inhalte als „dirty“ und teilt dem Dokument damit mit, dass es neu gesetzt werden muss.

QString QTextDocument::metaInformation(QTextDocument::MetaInformation info) const

Gibt Metainformationen über das Dokument des durch „ info “ angegebenen Typs zurück.

Siehe auch setMetaInformation().

[signal] void QTextDocument::modificationChanged(bool changed)

Dieses Signal wird immer dann ausgelöst, wenn sich der Inhalt des Dokuments so ändert, dass sich der Änderungsstatus ändert. Ist „ changed “ wahr, wurde das Dokument geändert; andernfalls ist es falsch.

Wird beispielsweise „ setModified “ (false) für ein Dokument aufgerufen und anschließend Text eingefügt, wird das Signal ausgelöst. Wenn Sie diesen Vorgang rückgängig machen, wodurch das Dokument in seinen ursprünglichen, unveränderten Zustand zurückversetzt wird, wird das Signal erneut ausgelöst.

QTextObject *QTextDocument::object(int objectIndex) const

Gibt das Textobjekt zurück, das dem angegebenen ` objectIndex` zugeordnet ist.

QTextObject *QTextDocument::objectForFormat(const QTextFormat &f) const

Gibt das Text-Objekt zurück, das dem Format „ f “ zugeordnet ist.

int QTextDocument::pageCount() const

Gibt die Anzahl der Seiten in diesem Dokument zurück.

void QTextDocument::print(QPagedPaintDevice *printer) const

Druckt das Dokument auf den angegebenen Drucker „ printer “. Der Drucker „ QPagedPaintDevice “ muss vor der Verwendung mit dieser Funktion eingerichtet werden.

Dies ist lediglich eine Komfortmethode, um das gesamte Dokument auf dem Drucker auszudrucken.

Wenn das Dokument bereits über eine in der Eigenschaft „ pageSize()“ angegebene Höhe paginiert ist, wird es unverändert gedruckt.

Ist das Dokument nicht paginiert, wie beispielsweise ein in einem ` QTextEdit` verwendetes Dokument, wird eine temporäre Kopie des Dokuments erstellt und diese Kopie entsprechend der Größe von `paperRect()` des Druckgeräts auf mehrere Seiten aufgeteilt. Standardmäßig wird ein Rand von 2 cm um den Dokumentinhalt herum festgelegt. Zudem wird die aktuelle Seitenzahl am unteren Rand jeder Seite gedruckt.

Siehe auch ` QTextEdit::print()`.

void QTextDocument::redo(QTextCursor *cursor)

Führt den letzten Bearbeitungsschritt am Dokument erneut aus, wenn redo is available.

Der übergebene ` cursor ` wird am Ende der Stelle positioniert, an der der Bearbeitungsvorgang wiederholt wurde.

[slot] void QTextDocument::redo()

Führt den letzten Bearbeitungsvorgang am Dokument erneut aus, wenn „ redo is available “ gesetzt ist.

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        textDocument, qOverload<>(&QTextDocument::redo));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        textDocument, [receiver = textDocument]() { receiver->redo(); });

[signal] void QTextDocument::redoAvailable(bool available)

Dieses Signal wird ausgegeben, sobald Redo-Operationen verfügbar sind (available ist wahr) oder nicht verfügbar sind (available ist falsch).

QVariant QTextDocument::resource(int type, const QUrl &name) const

Gibt Daten des angegebenen „ type “ aus der Ressource mit der angegebenen „ name “ zurück.

Diese Funktion wird von der Rich-Text-Engine aufgerufen, um Daten anzufordern, die nicht direkt von ` QTextDocument` gespeichert werden, aber dennoch damit in Verbindung stehen. Beispielsweise werden Bilder indirekt über das `name`-Attribut eines ` QTextImageFormat `-Objekts referenziert.

Ressourcen werden intern im Dokument zwischengespeichert. Kann eine Ressource nicht im Cache gefunden werden, wird ` loadResource ` aufgerufen, um zu versuchen, die Ressource zu laden. ` loadResource ` sollte dann mithilfe von ` addResource ` die Ressource dem Cache hinzufügen.

Wenn „ loadResource “ die Ressource nicht lädt, werden „ resourceProvider “ und schließlich „ defaultResourceProvider “ aufgerufen, sofern diese definiert sind. Beachten Sie, dass das Ergebnis des Anbieters nicht automatisch zum Cache hinzugefügt wird.

Siehe auch QTextDocument::ResourceType und resourceProvider().

[since 6.1] QTextDocument::ResourceProvider QTextDocument::resourceProvider() const

Gibt den Ressourcenanbieter für dieses Textdokument zurück.

Diese Funktion wurde in Qt 6.1 eingeführt.

Siehe auch setResourceProvider(), defaultResourceProvider() und loadResource().

int QTextDocument::revision() const

Gibt die Revision des Dokuments zurück (sofern die Rückgängig-Funktion aktiviert ist).

Die Revisionsnummer erhöht sich garantiert, wenn ein Dokument bearbeitet wird, das zuvor nicht geändert wurde.

Siehe auch QTextBlock::revision() und isModified().

QTextFrame *QTextDocument::rootFrame() const

Gibt den Stammrahmen des Dokuments zurück.

[since 6.0] void QTextDocument::setBaselineOffset(qreal baseline)

Legt die Grundlinie als Prozentsatz der Schrifthöhe fest, der im Dokumentlayout verwendet werden soll ( baseline). Der Standardwert ist 0. Ein positiver Wert verschiebt den Text um den entsprechenden Prozentsatz nach oben; ein negativer Wert verschiebt ihn nach unten.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch baselineOffset(), setSubScriptBaseline(), subScriptBaseline(), setSuperScriptBaseline() und superScriptBaseline().

void QTextDocument::setDefaultCursorMoveStyle(Qt::CursorMoveStyle style)

Legt den Standardstil für die Cursorbewegung auf den angegebenen Wert „ style “ fest.

Siehe auch defaultCursorMoveStyle().

void QTextDocument::setDefaultFont(const QFont &font)

Legt die Standard- font fest, die im Dokumentlayout verwendet werden soll.

Siehe auch „ defaultFont()“.

[static, since 6.1] void QTextDocument::setDefaultResourceProvider(const QTextDocument::ResourceProvider &provider)

Legt den Standard-Ressourcenanbieter auf „ provider “ fest.

Der Standardanbieter wird von allen `QTextDocument`-Objekten verwendet, für die kein Anbieter explizit festgelegt wurde.

Diese Funktion wurde in Qt 6.1 eingeführt.

Siehe auch „ defaultResourceProvider()“, „ setResourceProvider()“ und „ loadResource()“.

void QTextDocument::setDefaultTextOption(const QTextOption &option)

Legt die Standardtextoption auf „ option “ fest.

Siehe auch „ defaultTextOption()“.

void QTextDocument::setDocumentLayout(QAbstractTextDocumentLayout *layout)

Legt fest, dass das Dokument das angegebene Layout „ layout “ verwendet. Das bisherige Layout wird gelöscht.

Siehe auch documentLayoutChanged().

void QTextDocument::setHtml(const QString &html)

Ersetzt den gesamten Inhalt des Dokuments durch den angegebenen HTML-formatierten Text in der Zeichenkette „ html “. Der Verlauf der Rückgängig- und Wiederherstellungsaktionen wird beim Aufruf dieser Funktion zurückgesetzt.

Die HTML-Formatierung wird so weit wie möglich beibehalten; beispielsweise erzeugt „<b>bold</b> text“ einen Text, bei dem das erste Wort eine Schriftstärke aufweist, die ihm ein fettgedrucktes Aussehen verleiht: „bold text“.

Um eine andere CSS-Medienregel als die Standardregel „screen“ auszuwählen, verwenden Sie setMetaInformation() mit „CssMedia “ als „info“-Parameter.

Siehe auch setPlainText(), Unterstützte HTML-Teilmenge und setMetaInformation().

void QTextDocument::setIndentWidth(qreal width)

Legt den Wert „ width “ fest, der für die Einrückung von Textlisten und Textblöcken verwendet wird.

Die Einrückungseigenschaften von „ QTextListFormat “ und „ QTextBlockFormat “ legen Vielfache dieses Werts fest. Die Standard-Einrückungsbreite beträgt 40.

Siehe auch „ indentWidth()“.

void QTextDocument::setMarkdown(const QString &markdown, QTextDocument::MarkdownFeatures features = MarkdownDialectGitHub)

Ersetzt den gesamten Inhalt des Dokuments durch den in der Zeichenfolge „ markdown “ angegebenen, im Markdown-Format formatierten Text, wobei die in „ features “ angegebenen Formatierungen unterstützt werden. Standardmäßig werden alle unterstützten Markdown-Funktionen im GitHub-Stil berücksichtigt; übergebe „ MarkdownDialectCommonMark “, um eine einfachere Analyse durchzuführen.

Die Markdown-Formatierung wird so weit wie möglich beibehalten; beispielsweise erzeugt „*fettgedruckter* Text“ einen Text, bei dem das erste Wort eine Schriftstärke aufweist, die ihm ein hervorgehobenes Aussehen verleiht.

Die Analyse von HTML, das in der Zeichenkette ` markdown ` enthalten ist, erfolgt auf dieselbe Weise wie in ` setHtml`; Markdown-Formatierungen innerhalb von HTML-Blöcken werden jedoch nicht unterstützt.

Einige Funktionen des Parsers können über das Argument „ features “ aktiviert oder deaktiviert werden. Die Standardeinstellung ist „ MarkdownDialectGitHub “.

Der Verlauf der Rückgängig- und Wiederherstellungsaktionen wird beim Aufruf dieser Funktion zurückgesetzt.

void QTextDocument::setMetaInformation(QTextDocument::MetaInformation info, const QString &string)

Setzt die Metainformationen des Dokuments des durch „ info “ angegebenen Typs auf den angegebenen Wert „ string “.

Siehe auch metaInformation().

void QTextDocument::setPlainText(const QString &text)

Ersetzt den gesamten Inhalt des Dokuments durch den angegebenen reinen Text text. Der Verlauf der Rückgängig- und Wiederherstellungsaktionen wird beim Aufruf dieser Funktion zurückgesetzt.

Siehe auch setHtml().

[since 6.1] void QTextDocument::setResourceProvider(const QTextDocument::ResourceProvider &provider)

Legt den Anbieter der Ressourcen für das Textdokument auf „ provider “ fest.

Diese Funktion wurde in Qt 6.1 eingeführt.

Siehe auch „ resourceProvider()“ und „ loadResource()“.

[since 6.0] void QTextDocument::setSubScriptBaseline(qreal baseline)

Legt die Basislinie des Standard-Index als Prozentsatz der Schriftgröße fest, der im Dokumentlayout verwendet werden soll: baseline. Der Standardwert beträgt 16,67 % (1/6 der Höhe).

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch subScriptBaseline(), setSuperScriptBaseline(), superScriptBaseline(), setBaselineOffset() und baselineOffset().

[since 6.0] void QTextDocument::setSuperScriptBaseline(qreal baseline)

Legt die Basislinie für hochgestellte Zeichen als Prozentsatz der Schrifthöhe fest, der im Dokumentlayout verwendet werden soll: baseline. Der Standardwert beträgt 50 % (1/2 der Höhe).

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch superScriptBaseline(), setSubScriptBaseline(), subScriptBaseline(), setBaselineOffset() und baselineOffset().

[since 6.0] qreal QTextDocument::subScriptBaseline() const

Gibt die Grundlinie des hochgestellten Zeichens als Prozentsatz der im Dokumentlayout verwendeten Schrifthöhe zurück.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch setSubScriptBaseline(), setSuperScriptBaseline(), superScriptBaseline(), setBaselineOffset() und baselineOffset().

[since 6.0] qreal QTextDocument::superScriptBaseline() const

Gibt die Grundlinie des hochgestellten Zeichens als Prozentsatz der im Dokumentlayout verwendeten Schrifthöhe zurück.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch setSuperScriptBaseline(), setSubScriptBaseline(), subScriptBaseline(), setBaselineOffset() und baselineOffset().

QString QTextDocument::toHtml() const

Gibt eine Zeichenkette zurück, die eine HTML-Darstellung des Dokuments enthält.

Der Inhalt des Dokuments gibt an, dass es in UTF-8 kodiert ist. Wenn Sie die zurückgegebene HTML-Zeichenkette später zur Übertragung über ein Netzwerk oder zum Speichern auf Festplatte in ein Byte-Array konvertieren, sollten Sie die Funktion ` QString::toUtf8()` verwenden, um die Zeichenkette in ein ` QByteArray` zu konvertieren.

Siehe auch „Unterstützte HTML-Teilmenge“.

QString QTextDocument::toMarkdown(QTextDocument::MarkdownFeatures features = MarkdownDialectGitHub) const

Gibt eine Zeichenkette zurück, die eine Markdown-Darstellung des Dokuments mit dem angegebenen ` features` enthält, oder eine leere Zeichenkette, falls das Schreiben aus irgendeinem Grund fehlschlägt.

Siehe auch ` setMarkdown`.

QString QTextDocument::toPlainText() const

Gibt den im Dokument enthaltenen Klartext zurück. Wenn Sie Formatierungsinformationen benötigen, verwenden Sie stattdessen die Funktion „ QTextCursor “.

Diese Funktion liefert dasselbe Ergebnis wie ` toRawText()`, ersetzt jedoch einige Unicode-Zeichen durch ASCII-Entsprechungen. Insbesondere wird das Geschmackstrennzeichen (U+00A0) durch ein normales Leerzeichen (U+0020) ersetzt, und sowohl Absatztrennzeichen (U+2029) als auch Zeilentrennzeichen (U+2028) werden durch einen Zeilenvorschub (U+000A) ersetzt. Wenn Sie den genauen Inhalt des Dokuments benötigen, verwenden Sie stattdessen die Funktion „ toRawText()“.

Siehe auch „ toHtml“ ().

QString QTextDocument::toRawText() const

Gibt den im Dokument enthaltenen Rohtext ohne Formatierungsinformationen zurück. Wenn Sie Formatierungsinformationen benötigen, verwenden Sie stattdessen „ QTextCursor “.

Siehe auch toPlainText().

void QTextDocument::undo(QTextCursor *cursor)

Macht den letzten Bearbeitungsvorgang im Dokument rückgängig, sofern die Rückgängig-Funktion verfügbar ist. Der übergebene ` cursor ` wird am Ende der Stelle positioniert, an der der Bearbeitungsvorgang rückgängig gemacht wurde.

Weitere Informationen finden Sie in der Dokumentation zum Qt-Undo-Framework.

Siehe auch „ undoAvailable()“ und „ isUndoRedoEnabled()“.

[slot] void QTextDocument::undo()

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        textDocument, qOverload<>(&QTextDocument::undo));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        textDocument, [receiver = textDocument]() { receiver->undo(); });

[signal] void QTextDocument::undoAvailable(bool available)

Dieses Signal wird immer dann ausgelöst, wenn Rückgängig-Operationen verfügbar sind (available ist wahr) oder nicht verfügbar sind (available ist falsch).

Weitere Informationen finden Sie in der Dokumentation zum Qt-Undo-Framework.

Siehe auch undo() und isUndoRedoEnabled().

[signal] void QTextDocument::undoCommandAdded()

Dieses Signal wird jedes Mal ausgelöst, wenn der „ QTextDocument “ eine neue Rückgängig-Ebene hinzugefügt wird.