QTextDocument Class

Dokumentation der Mitgliedsfunktionen

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

Konstruiert ein leeres QTextDocument mit dem angegebenen parent.

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

Konstruiert ein QTextDocument mit dem angegebenen einfachen (unformatierten) text und mit dem angegebenen parent.

[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, wobei type und name als Bezeichner verwendet werden. type sollte ein Wert aus QTextDocument::ResourceType sein.

Sie können z. B. ein Bild als Ressource hinzufügen, um es im Dokument zu referenzieren:

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

Das Bild kann über die API QTextCursor in das Dokument eingefügt werden:

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

Alternativ können Sie Bilder auch mit dem HTML-Tag 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 von Textformaten 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 % 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 ausgegeben, wenn sich die Gesamtzahl der Textblöcke im Dokument ändert. Der in 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 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 Stapel.

Diese Methode löscht alle Befehle auf dem Undo-Stack, dem Redo-Stack oder auf beiden (Standardeinstellung). Wenn Befehle gelöscht werden, werden die entsprechenden Signale ausgegeben, QTextDocument::undoAvailable() oder QTextDocument::redoAvailable().

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

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

Erzeugt ein neues QTextDocument, das eine Kopie dieses Textdokuments ist. parent ist das übergeordnete Dokument des zurückgegebenen Textdokuments.

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

Dieses Signal wird immer dann ausgegeben, wenn sich der Inhalt des Dokuments ändert, z. B. 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 stattgefunden hat, 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 ausgegeben, wenn sich der Inhalt des Dokuments ändert, z. B. wenn Text eingefügt oder gelöscht wird oder wenn eine Formatierung vorgenommen wird.

Siehe auch contentsChange().

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

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

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

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

Dieses Signal wird immer dann ausgegeben, wenn sich die Position eines Cursors aufgrund eines Bearbeitungsvorgangs geändert hat. Der geänderte 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 Vorgabe ist 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, z. B. der Standard-Wortumbruchmodus.

Siehe auch setDefaultTextOption().

QAbstractTextDocumentLayout *QTextDocument::documentLayout() const

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

Siehe auch setDocumentLayout().

[signal] void QTextDocument::documentLayoutChanged()

Dieses Signal wird ausgegeben, wenn ein neues Dokumentenlayout festgelegt wird.

Siehe auch setDocumentLayout().

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

Zeichnet den Inhalt des Dokuments mit Painter p, beschnitten auf rect. Wenn rect ein Null-Rechteck ist (Standard), wird das Dokument ohne Beschnitt gezeichnet.

QTextBlock QTextDocument::end() const

Diese Funktion gibt einen Block zurück, um auf das Ende des Dokuments zu prüfen, während sie über das Dokument iteriert.

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 des Dokuments dar. Sie können lastBlock() verwenden, um den letzten gültigen Block des Dokuments abzurufen.

Siehe auch lastBlock().

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

Findet das nächste Vorkommen, das mit dem angegebenen regulären Ausdruck expr übereinstimmt, innerhalb desselben Absatzes im Dokument.

Die Suche beginnt an der Position des angegebenen cursor und geht vorwärts durch das Dokument, sofern in den Suchoptionen nichts anderes angegeben ist. Die options steuert die Art der durchgeführten Suche.

Gibt einen Cursor mit der ausgewählten Übereinstimmung zurück, wenn eine Übereinstimmung gefunden wurde; andernfalls wird ein Null-Cursor zurückgegeben.

Wenn die angegebene cursor eine Auswahl hat, beginnt die Suche nach der Auswahl; andernfalls beginnt sie an der Position der Schreibmarke.

Standardmäßig wird bei der Suche die Groß-/Kleinschreibung nicht berücksichtigt, und der Text kann an einer beliebigen Stelle im Dokument gefunden werden.

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

Findet das nächste Vorkommen, das mit dem angegebenen regulären Ausdruck expr übereinstimmt, innerhalb desselben Absatzes im Dokument.

Die Suche beginnt an der angegebenen Position from und geht vorwärts durch das Dokument, sofern in den Suchoptionen nichts anderes angegeben ist. Die options steuert die Art der durchgeführten Suche.

Gibt einen Cursor mit der ausgewählten Übereinstimmung zurück, wenn eine Übereinstimmung gefunden wurde; andernfalls wird ein Null-Cursor zurückgegeben.

Ist die Position from gleich 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

Findet das nächste Vorkommen der Zeichenkette subString im Dokument. Die Suche beginnt an der Position der angegebenen cursor und geht vorwärts durch das Dokument, sofern in den Suchoptionen nichts anderes angegeben ist. Die options steuert die Art der durchgeführten Suche.

Gibt einen Cursor mit der ausgewählten Übereinstimmung zurück, wenn subString gefunden wurde; andernfalls wird ein Null-Cursor zurückgegeben.

Wenn die angegebene cursor eine Auswahl hat, beginnt die Suche nach der Auswahl; andernfalls beginnt sie an der Position des Cursors.

Standardmäßig wird bei der Suche die Groß- und Kleinschreibung nicht berücksichtigt, und der Text kann an jeder beliebigen Stelle des Dokuments gefunden werden.

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

Dies ist eine überladene Funktion.

Findet das nächste Vorkommen der Zeichenkette subString im Dokument. Die Suche beginnt bei der angegebenen position und geht vorwärts durch das Dokument, sofern in den Suchoptionen nichts anderes angegeben ist. Die options steuert die Art der durchgeführten Suche.

Gibt einen Cursor mit der ausgewählten Übereinstimmung zurück, wenn subString gefunden wurde; andernfalls wird ein Null-Cursor zurückgegeben.

Ist position gleich 0 (Standard), 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 pos-te Zeichen 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 verwendete Breite des Dokuments ohne Berücksichtigung der optionalen 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 false.

Siehe auch isUndoAvailable() und availableRedoSteps().

bool QTextDocument::isUndoAvailable() const

Gibt true zurück, wenn Rückgängig verfügbar ist; andernfalls false.

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 (wenn das Layout dies unterstützt). Andernfalls ist dies identisch mit der Anzahl der Blöcke.

Siehe auch blockCount() und characterCount().

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

Lädt die Daten der 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 mit ihr verbunden sind. Zum Beispiel werden Bilder indirekt durch das Attribut name eines QTextImageFormat Objekts referenziert.

Wenn es von Qt aufgerufen wird, ist type einer der Werte von QTextDocument::ResourceType.

Wenn QTextDocument ein untergeordnetes Objekt von QObject ist, das eine aufrufbare loadResource-Methode hat, wie z.B. QTextEdit, QTextBrowser oder QTextDocument selbst, dann versucht die Standardimplementierung, die Daten vom übergeordneten Objekt abzurufen.

Siehe auch QTextDocument::ResourceProvider.

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

Markiert den durch die angegebenen position und length angegebenen Inhalt als "schmutzig" und teilt dem Dokument mit, dass es neu angelegt 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 ausgegeben, wenn sich der Inhalt des Dokuments in einer Weise ändert, die den Änderungsstatus beeinflusst. Wenn changed wahr ist, wurde das Dokument geändert; andernfalls ist es falsch.

Wenn Sie zum Beispiel setModified(false) für ein Dokument aufrufen und dann Text einfügen, wird das Signal ausgegeben. Wenn Sie diesen Vorgang rückgängig machen, so dass das Dokument in seinen ursprünglichen, unveränderten Zustand zurückkehrt, wird das Signal erneut ausgegeben.

QTextObject *QTextDocument::object(int objectIndex) const

Gibt das Textobjekt zurück, das mit dem angegebenen objectIndex verbunden ist.

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

Gibt das Textobjekt zurück, das mit dem Format f verknüpft ist.

int QTextDocument::pageCount() const

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

void QTextDocument::print(QPagedPaintDevice *printer) const

Druckt das Dokument an die angegebene Adresse printer. Die QPagedPaintDevice muss vor der Verwendung dieser Funktion eingerichtet werden.

Dies ist nur eine einfache Methode, um das gesamte Dokument auf dem Drucker auszugeben.

Wenn das Dokument bereits über eine in der Eigenschaft pageSize() angegebene Höhe paginiert ist, wird es so gedruckt, wie es ist.

Wenn das Dokument nicht paginiert ist, wie z. B. ein Dokument, das in einem QTextEdit verwendet wird, wird eine temporäre Kopie des Dokuments erstellt und die Kopie wird in mehrere Seiten entsprechend der Größe des paperRect() des Malgeräts aufgeteilt. Standardmäßig wird ein Rand von 2 cm um den Inhalt des Dokuments gesetzt. Außerdem wird die aktuelle Seitenzahl am unteren Rand jeder Seite gedruckt.

Siehe auch QTextEdit::print().

void QTextDocument::redo(QTextCursor *cursor)

Wiederholt den letzten Bearbeitungsvorgang des Dokuments, wenn redo is available.

Die bereitgestellte cursor wird am Ende der Stelle positioniert, an der der Bearbeitungsvorgang erneut durchgeführt wurde.

[slot] void QTextDocument::redo()

Dies ist eine überladene Funktion.

Wiederholt den letzten Bearbeitungsvorgang des Dokuments, wenn redo is available.

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

Dieses Signal wird ausgegeben, wenn Redo-Operationen verfügbar (available ist true) oder nicht verfügbar (available ist false) werden.

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

Gibt Daten der 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 mit ihr verbunden sind. Zum Beispiel werden Bilder indirekt durch das Attribut name eines QTextImageFormat Objekts referenziert.

Ressourcen werden intern im Dokument zwischengespeichert. Wenn eine Ressource nicht im Cache gefunden werden kann, wird loadResource aufgerufen, um zu versuchen, die Ressource zu laden. loadResource sollte dann addResource verwenden, um die Ressource zum Cache hinzuzufügen.

Wenn loadResource die Ressource nicht lädt, werden resourceProvider und schließlich defaultResourceProvider aufgerufen, sofern diese Option gesetzt ist. Beachten Sie, dass das Ergebnis des Providers nicht automatisch in den Cache aufgenommen 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 (wenn Rückgängigmachen aktiviert ist).

Die Revision wird garantiert erhöht, wenn ein nicht geändertes Dokument bearbeitet wird.

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

QTextFrame *QTextDocument::rootFrame() const

Gibt den Wurzelrahmen des Dokuments zurück.

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

Setzt die Grundlinie als % der Schrifthöhe, die im Dokumentlayout verwendet werden soll, auf baseline. Der Standardwert ist 0. Ein positiver Wert verschiebt den Text um den entsprechenden %-Wert 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)

Setzt den Standardstil für die Cursorbewegung auf den angegebenen style.

Siehe auch defaultCursorMoveStyle().

void QTextDocument::setDefaultFont(const QFont &font)

Legt den Standardwert font fest, der im Dokumentlayout verwendet werden soll.

Siehe auch defaultFont().

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

Setzt den Standard-Ressourcenanbieter auf provider.

Der Standard-Provider wird von allen QTextDocuments verwendet, die keinen expliziten Provider gesetzt haben.

Diese Funktion wurde in Qt 6.1 eingeführt.

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

void QTextDocument::setDefaultTextOption(const QTextOption &option)

Setzt die Standardtextoption auf option.

Siehe auch defaultTextOption().

void QTextDocument::setDocumentLayout(QAbstractTextDocumentLayout *layout)

Legt fest, dass das Dokument das angegebene layout verwendet. Das vorherige 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 Zeichenfolge html. Der Undo/Redo-Verlauf wird zurückgesetzt, wenn diese Funktion aufgerufen wird.

Die HTML-Formatierung wird so weit wie möglich respektiert; zum Beispiel wird "<b>fetter</b> Text" einen Text erzeugen, bei dem das erste Wort eine Schriftstärke hat, die es fett erscheinen lässt:"fetter Text".

Um eine andere css-Medienregel als die Standardregel "screen" auszuwählen, verwenden Sie setMetaInformation() mit 'CssMedia' als "info"-Parameter.

Siehe auch setPlainText(), Supported HTML Subset und setMetaInformation().

void QTextDocument::setIndentWidth(qreal width)

Legt den für die Einrückung von Textlisten und Textblöcken verwendeten Wert width fest.

Die Einrückungseigenschaften von QTextListFormat und QTextBlockFormat geben Vielfache dieses Wertes an. Die Standardeinzugsbreite ist 40 .

Siehe auch indentWidth().

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

Ersetzt den gesamten Inhalt des Dokuments durch den angegebenen Markdown-formatierten Text in der Zeichenfolge markdown, wobei die angegebene features unterstützt wird. Standardmäßig sind alle unterstützten Markdown-Funktionen im GitHub-Stil enthalten; übergeben Sie MarkdownDialectCommonMark für ein einfacheres Parsen.

Die Markdown-Formatierung wird so weit wie möglich respektiert; zum Beispiel wird "*bold* text" einen Text erzeugen, bei dem das erste Wort eine Schriftstärke hat, die es betont erscheinen lässt.

Das Parsen von HTML, das in der Zeichenfolge markdown enthalten ist, wird auf dieselbe Weise gehandhabt wie in setHtml; allerdings wird die Markdown-Formatierung innerhalb von HTML-Blöcken nicht unterstützt.

Einige Funktionen des Parsers können über das Argument features aktiviert oder deaktiviert werden:

Die Voreinstellung ist MarkdownDialectGitHub.

Der Undo/Redo-Verlauf wird zurückgesetzt, wenn diese Funktion aufgerufen wird.

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

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

Siehe auch metaInformation().

void QTextDocument::setPlainText(const QString &text)

Ersetzt den gesamten Inhalt des Dokuments durch das angegebene einfache text. Die Undo/Redo-Historie wird zurückgesetzt, wenn diese Funktion aufgerufen wird.

Siehe auch setHtml().

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

Setzt den Anbieter von Ressourcen für das Textdokument auf provider.

Diese Funktion wurde in Qt 6.1 eingeführt.

Siehe auch resourceProvider() und loadResource().

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

Setzt die Grundlinie der Standard-Tiefstellung in % der Schrifthöhe, die im Dokumentlayout verwendet werden soll, auf baseline. Der Standardwert ist 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)

Setzt die Grundlinie der Standard-Hochschrift in % der Schrifthöhe, die im Dokumentlayout verwendet werden soll, auf baseline. Der Standardwert ist 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 der hochgestellten Schrift in % 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 der hochgestellten Schrift in % 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 seine Kodierung als UTF-8 an. Wenn Sie die zurückgegebene HTML-Zeichenkette später in ein Byte-Array für die Übertragung über ein Netzwerk oder beim Speichern auf der Festplatte konvertieren, sollten Sie QString::toUtf8() verwenden, um die Zeichenkette in QByteArray zu konvertieren.

Siehe auch Unterstützte HTML-Untermenge.

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, wenn das Schreiben aus irgendeinem Grund fehlschlägt.

Siehe auch setMarkdown.

QString QTextDocument::toPlainText() const

Gibt den im Dokument enthaltenen reinen Text zurück. Wenn Sie Formatierungsinformationen wünschen, verwenden Sie stattdessen QTextCursor.

Diese Funktion gibt dasselbe zurück wie toRawText(), ersetzt aber einige Unicode-Zeichen durch ASCII-Alternativen. Insbesondere wird das Leerzeichen ohne Umbruch (U+00A0) durch ein reguläres Leerzeichen (U+0020) ersetzt, und sowohl Absatz- (U+2029) als auch Zeilentrennzeichen (U+2028) werden durch Zeilenvorschub (U+000A) ersetzt. Wenn Sie den genauen Inhalt des Dokuments benötigen, verwenden Sie stattdessen toRawText().

Siehe auch toHtml().

QString QTextDocument::toRawText() const

Gibt den im Dokument enthaltenen Rohtext ohne Formatierungsinformationen zurück. Wenn Sie Formatierungsinformationen wünschen, verwenden Sie stattdessen QTextCursor.

Siehe auch toPlainText().

void QTextDocument::undo(QTextCursor *cursor)

Macht den letzten Bearbeitungsvorgang des Dokuments rückgängig, sofern Rückgängigmachen verfügbar ist. Die bereitgestellte cursor wird am Ende der Stelle positioniert, an der der Bearbeitungsvorgang rückgängig gemacht wurde.

Siehe die Qt Undo Framework Dokumentation für Details.

Siehe auch undoAvailable() und isUndoRedoEnabled().

[slot] void QTextDocument::undo()

Dies ist eine überladene Funktion.

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

Dieses Signal wird ausgegeben, wenn Undo-Operationen verfügbar (available ist true) oder nicht verfügbar (available ist false) werden.

Siehe die Qt Undo Framework Dokumentation für Details.

Siehe auch undo() und isUndoRedoEnabled().

[signal] void QTextDocument::undoCommandAdded()

Dieses Signal wird jedes Mal ausgegeben, wenn eine neue Stufe der Rückgängigmachung zu QTextDocument hinzugefügt wird.