Auf dieser Seite

QTextEdit Class

Die Klasse „QTextEdit“ stellt ein Widget bereit, mit dem sowohl einfacher Text als auch Rich-Text bearbeitet und angezeigt werden kann. Mehr...

Kopfzeile: #include <QTextEdit>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Erbt von: QAbstractScrollArea
Vererbt an:

QTextBrowser

Öffentliche Typen

struct ExtraSelection
flags AutoFormatting
enum AutoFormattingFlag { AutoNone, AutoBulletList, AutoAll }
enum LineWrapMode { NoWrap, WidgetWidth, FixedPixelWidth, FixedColumnWidth }

Eigenschaften

Öffentliche Funktionen

QTextEdit(QWidget *parent = nullptr)
QTextEdit(const QString &text, QWidget *parent = nullptr)
virtual ~QTextEdit()
bool acceptRichText() const
Qt::Alignment alignment() const
QString anchorAt(const QPoint &pos) const
QTextEdit::AutoFormatting autoFormatting() const
bool canPaste() const
QMenu *createStandardContextMenu()
QMenu *createStandardContextMenu(const QPoint &position)
QTextCharFormat currentCharFormat() const
QFont currentFont() const
QTextCursor cursorForPosition(const QPoint &pos) const
QRect cursorRect() const
QRect cursorRect(const QTextCursor &cursor) const
int cursorWidth() const
QTextDocument *document() const
QString documentTitle() const
void ensureCursorVisible()
QList<QTextEdit::ExtraSelection> extraSelections() const
bool find(const QString &exp, QTextDocument::FindFlags options = QTextDocument::FindFlags())
bool find(const QRegularExpression &exp, QTextDocument::FindFlags options = QTextDocument::FindFlags())
QString fontFamily() const
bool fontItalic() const
qreal fontPointSize() const
bool fontUnderline() const
int fontWeight() const
bool isReadOnly() const
bool isUndoRedoEnabled() const
int lineWrapColumnOrWidth() const
QTextEdit::LineWrapMode lineWrapMode() const
virtual QVariant loadResource(int type, const QUrl &name)
void mergeCurrentCharFormat(const QTextCharFormat &modifier)
void moveCursor(QTextCursor::MoveOperation operation, QTextCursor::MoveMode mode = QTextCursor::MoveAnchor)
bool overwriteMode() const
QString placeholderText() const
void print(QPagedPaintDevice *printer) const
void setAcceptRichText(bool accept)
void setAutoFormatting(QTextEdit::AutoFormatting features)
void setCurrentCharFormat(const QTextCharFormat &format)
void setCursorWidth(int width)
void setDocument(QTextDocument *document)
void setDocumentTitle(const QString &title)
void setExtraSelections(const QList<QTextEdit::ExtraSelection> &selections)
void setLineWrapColumnOrWidth(int w)
void setLineWrapMode(QTextEdit::LineWrapMode mode)
void setOverwriteMode(bool overwrite)
void setPlaceholderText(const QString &placeholderText)
void setReadOnly(bool ro)
void setTabChangesFocus(bool b)
void setTabStopDistance(qreal distance)
void setTextCursor(const QTextCursor &cursor)
void setTextInteractionFlags(Qt::TextInteractionFlags flags)
void setUndoRedoEnabled(bool enable)
void setWordWrapMode(QTextOption::WrapMode policy)
bool tabChangesFocus() const
qreal tabStopDistance() const
QColor textBackgroundColor() const
QColor textColor() const
QTextCursor textCursor() const
Qt::TextInteractionFlags textInteractionFlags() const
QString toHtml() const
QString toMarkdown(QTextDocument::MarkdownFeatures features = QTextDocument::MarkdownDialectGitHub) const
QString toPlainText() const
QTextOption::WrapMode wordWrapMode() const

Neu implementierte öffentliche Funktionen

virtual QVariant inputMethodQuery(Qt::InputMethodQuery property) const override

Öffentliche Slots

void append(const QString &text)
void clear()
void copy()
void cut()
void insertHtml(const QString &text)
void insertPlainText(const QString &text)
void paste()
void redo()
void scrollToAnchor(const QString &name)
void selectAll()
void setAlignment(Qt::Alignment a)
void setCurrentFont(const QFont &f)
void setFontFamily(const QString &fontFamily)
void setFontItalic(bool italic)
void setFontPointSize(qreal s)
void setFontUnderline(bool underline)
void setFontWeight(int weight)
void setHtml(const QString &text)
void setMarkdown(const QString &markdown)
void setPlainText(const QString &text)
void setText(const QString &text)
void setTextBackgroundColor(const QColor &c)
void setTextColor(const QColor &c)
void undo()
void zoomIn(int range = 1)
void zoomOut(int range = 1)

Signale

void copyAvailable(bool yes)
void currentCharFormatChanged(const QTextCharFormat &f)
void cursorPositionChanged()
void redoAvailable(bool available)
void selectionChanged()
void textChanged()
void undoAvailable(bool available)

Geschützte Funktionen

virtual bool canInsertFromMimeData(const QMimeData *source) const
virtual QMimeData *createMimeDataFromSelection() const
virtual void insertFromMimeData(const QMimeData *source)

Neu implementierte geschützte Funktionen

virtual void changeEvent(QEvent *e) override
virtual void contextMenuEvent(QContextMenuEvent *event) override
virtual void dragEnterEvent(QDragEnterEvent *e) override
virtual void dragLeaveEvent(QDragLeaveEvent *e) override
virtual void dragMoveEvent(QDragMoveEvent *e) override
virtual void dropEvent(QDropEvent *e) override
virtual void focusInEvent(QFocusEvent *e) override
virtual bool focusNextPrevChild(bool next) override
virtual void focusOutEvent(QFocusEvent *e) override
virtual void inputMethodEvent(QInputMethodEvent *e) override
virtual void keyPressEvent(QKeyEvent *e) override
virtual void keyReleaseEvent(QKeyEvent *e) override
virtual void mouseDoubleClickEvent(QMouseEvent *e) override
virtual void mouseMoveEvent(QMouseEvent *e) override
virtual void mousePressEvent(QMouseEvent *e) override
virtual void mouseReleaseEvent(QMouseEvent *e) override
virtual void paintEvent(QPaintEvent *event) override
virtual void resizeEvent(QResizeEvent *e) override
virtual void scrollContentsBy(int dx, int dy) override
virtual void showEvent(QShowEvent *) override
virtual void wheelEvent(QWheelEvent *e) override

Ausführliche Beschreibung

Einführung und Konzepte

QTextEdit ist ein fortschrittlicher WYSIWYG-Viewer/Editor, der Rich-Text-Formatierungen mithilfe von HTML-ähnlichen Tags oder im Markdown-Format unterstützt. Er ist für die Bearbeitung umfangreicher Dokumente optimiert und reagiert schnell auf Benutzereingaben.

QTextEdit arbeitet mit Absätzen und Zeichen. Ein Absatz ist eine formatierte Zeichenkette, die so umgebrochen wird, dass sie in die Breite des Widgets passt. Beim Lesen von reinem Text bedeutet standardmäßig ein Zeilenumbruch einen Absatz. Ein Dokument besteht aus null oder mehr Absätzen. Die Wörter innerhalb eines Absatzes werden entsprechend der Ausrichtung des Absatzes ausgerichtet. Absätze werden durch harte Zeilenumbrüche voneinander getrennt. Jedes Zeichen innerhalb eines Absatzes verfügt über eigene Attribute, zum Beispiel Schriftart und Farbe.

QTextEdit kann Bilder, Listen und Tabellen anzeigen. Ist der Text zu groß, um im Ansichtsbereich des Texteditors angezeigt zu werden, werden Bildlaufleisten eingeblendet. Der Texteditor kann sowohl reine Text- als auch Rich-Text-Dateien laden. Rich Text kann mithilfe einer Teilmenge der HTML-4-Auszeichnungssprache beschrieben werden; weitere Informationen finden Sie auf der Seite „Unterstützte HTML-Teilmengen “.

Wenn du nur einen kleinen Abschnitt Rich-Text anzeigen möchtest, verwende ` QLabel`.

Die Rich-Text-Unterstützung in Qt wurde entwickelt, um eine schnelle, portable und effiziente Möglichkeit zu bieten, Anwendungen mit sinnvollen Online-Hilfefunktionen auszustatten, und um eine Grundlage für Rich-Text-Editoren zu schaffen. Sollten Sie die HTML-Unterstützung für Ihre Anforderungen als unzureichend empfinden, können Sie den Einsatz von Qt WebKit in Betracht ziehen, das ein Webbrowser-Widget mit vollem Funktionsumfang bereitstellt.

Die Form des Mauszeigers in einem QTextEdit ist standardmäßig Qt::IBeamCursor. Sie kann über die Eigenschaft `cursor` des viewport() geändert werden.

Verwendung von QTextEdit als Anzeige-Widget

QTextEdit kann einen großen Teil des HTML-Spektrums anzeigen, einschließlich Tabellen und Bildern.

Der Text kann mit ` setHtml()` gesetzt oder ersetzt werden, wodurch vorhandener Text gelöscht und durch den im Aufruf von ` setHtml()` übergebenen Text ersetzt wird. Wenn Sie ` setHtml()` mit veraltetem HTML aufrufen und anschließend ` toHtml()` aufrufen, weist der zurückgegebene Text möglicherweise ein anderes Markup auf, wird jedoch identisch dargestellt. Der gesamte Text kann mit ` clear()` gelöscht werden.

Text kann auch mit „ setMarkdown()“ gesetzt oder ersetzt werden, wobei dieselben Einschränkungen gelten: Wenn Sie anschließend „ toMarkdown()“ aufrufen, ist der zurückgegebene Text möglicherweise anders, aber die Bedeutung bleibt so weit wie möglich erhalten. Markdown mit eingebettetem HTML kann mit denselben Einschränkungen wie bei ` setHtml()` geparst werden; ` toMarkdown()` schreibt jedoch nur „reines“ Markdown ohne eingebettetes HTML.

Text selbst kann mithilfe der Klasse „ QTextCursor “ oder der Komfortfunktionen „ insertHtml()“, „ insertPlainText()“, „ append()“ oder „ paste()“ eingefügt werden. „ QTextCursor “ ist zudem in der Lage, komplexe Objekte wie Tabellen oder Listen in das Dokument einzufügen und übernimmt die Erstellung von Markierungen sowie die Anwendung von Änderungen auf markierten Text.

Standardmäßig führt die Textbearbeitung einen Zeilenumbruch an Leerzeichen durch, damit der Text in das Textbearbeitungs-Widget passt. Mit der Funktion „ setLineWrapMode “ () können Sie die Art des gewünschten Zeilenumbruchs festlegen, oder „ NoWrap “, wenn Sie keinen Zeilenumbruch wünschen. Rufen Sie ` setLineWrapMode()` auf, um eine feste Breite in Pixeln FixedPixelWidth oder eine Zeichen-Spalte (z. B. 80 Spalten) FixedColumnWidth festzulegen, wobei die Pixel oder Spalten mit ` setLineWrapColumnOrWidth()` angegeben werden. Wenn Sie den Zeilenumbruch an die Breite des Widgets anpassen WidgetWidth, können Sie mit ` setWordWrapMode()` festlegen, ob der Umbruch an Leerzeichen oder an beliebiger Stelle erfolgen soll.

Mit der Funktion ` find()` lässt sich eine bestimmte Zeichenkette im Text suchen und markieren.

Wenn Sie die Gesamtzahl der Absätze in einem QTextEdit begrenzen möchten – was beispielsweise in einem Protokoll-Viewer oft sinnvoll ist –, können Sie dazu die Eigenschaft „maximumBlockCount“ von „ QTextDocument “ verwenden.

Tastenkombinationen im schreibgeschützten Modus

Wenn QTextEdit schreibgeschützt verwendet wird, sind die Tastenkombinationen auf die Navigation beschränkt, und Text darf nur mit der Maus ausgewählt werden:

TastendrückeAktion
Nach obenSpringt eine Zeile nach oben.
Nach untenBewegt sich eine Zeile nach unten.
LinksBewegt sich um ein Zeichen nach links.
RechtsBewegt sich um ein Zeichen nach rechts.
Bild aufBlättert eine (Ansichts-)Seite nach oben.
Bild-nach-untenBewegt eine (Ansichtsfenster-)Seite nach unten.
HomeSpringt zum Anfang des Textes.
EndeSpringt zum Ende des Textes.
Alt+MausradBlättert horizontal durch die Seite (das Rad ist das Mausrad).
Strg+RadVergrößert den Text.
Strg+AWählt den gesamten Text aus.

Die Textbearbeitung kann möglicherweise einige Metainformationen bereitstellen. Beispielsweise gibt die Funktion „ documentTitle “ () den Text aus den HTML-Tags „ <title> “ zurück.

Hinweis: Das Vergrößern von HTML-Dokumenten funktioniert nur, wenn die Schriftgröße nicht auf einen festen Wert festgelegt ist.

Verwendung von QTextEdit als Editor

Alle Informationen zur Verwendung von QTextEdit als Anzeige-Widget gelten auch hier.

Die Attribute des aktuellen Zeichenformats werden mit ` setFontItalic()`, ` setFontWeight()`, ` setFontUnderline()`, ` setFontFamily()`, ` setFontPointSize()`, ` setTextColor()` und ` setCurrentFont()` festgelegt. Die Ausrichtung des aktuellen Absatzes wird mit ` setAlignment()` festgelegt.

Die Textauswahl wird von der Klasse „ QTextCursor “ verwaltet, die Funktionen zum Erstellen von Auswahlen, zum Abrufen des Textinhalts oder zum Löschen von Auswahlen bereitstellt. Mit der Methode „ textCursor()“ können Sie das Objekt abrufen, das dem für den Benutzer sichtbaren Cursor entspricht. Wenn Sie in QTextEdit eine Auswahl festlegen möchten, erstellen Sie einfach eine auf einem „ QTextCursor “-Objekt und machen Sie diesen Cursor dann mithilfe von ` setTextCursor()` zum sichtbaren Cursor. Die Auswahl kann mit ` copy()` in die Zwischenablage kopiert oder mit ` cut()` in die Zwischenablage ausgeschnitten werden. Der gesamte Text kann mit ` selectAll()` ausgewählt werden.

Wenn der Cursor bewegt wird und sich die zugrunde liegenden Formatierungsattribute ändern, wird das Signal „ currentCharFormatChanged()“ ausgelöst, um die neuen Attribute an der neuen Cursorposition widerzuspiegeln.

Das Signal „ textChanged()“ wird immer dann ausgelöst, wenn sich der Text ändert (als Folge von „ setText()“ oder durch den Editor selbst).

QTextEdit verwaltet ein „ QTextDocument “-Objekt, das über die Methode „ document()“ abgerufen werden kann. Sie können auch ein eigenes Dokumentobjekt über „ setDocument()“ festlegen.

QTextDocument bietet eine Funktion „ isModified()“, die „true“ zurückgibt, wenn der Text seit dem Laden oder seit dem letzten Aufruf von „setModified“ mit dem Argument „false“ geändert wurde. Darüber hinaus bietet es Methoden zum Rückgängigmachen und Wiederherstellen.

Drag & Drop

QTextEdit unterstützt auch benutzerdefiniertes Drag-and-Drop-Verhalten. Standardmäßig fügt QTextEdit einfachen Text, HTML und Rich Text ein, wenn der Benutzer Daten dieser MIME-Typen auf ein Dokument ablegt. Implementieren Sie „ canInsertFromMimeData()“ und „ insertFromMimeData()“ neu, um Unterstützung für weitere MIME-Typen hinzuzufügen.

Um dem Benutzer beispielsweise das Ziehen und Ablegen eines Bildes in ein QTextEdit zu ermöglichen, könnten Sie diese Funktionen wie folgt implementieren:

bool TextEdit::canInsertFromMimeData( const QMimeData *source ) const
{
    if (source->hasImage())
        return true;
    else
        return QTextEdit::canInsertFromMimeData(source);
}

Wir fügen Unterstützung für Bild-MIME-Typen hinzu, indem wir „true“ zurückgeben. Für alle anderen MIME-Typen verwenden wir die Standardimplementierung.

void TextEdit::insertFromMimeData( const QMimeData *source )
{
    if (source->hasImage())
    {
        QImage image = qvariant_cast<QImage>(source->imageData());
        QTextCursor cursor = this->textCursor();
        QTextDocument *document = this->document();
        document->addResource(QTextDocument::ImageResource, QUrl("image"), image);
        cursor.insertImage("image");
    }
}

Wir entpacken das Bild aus dem von der MIME-Quelle gehaltenen ` QVariant ` und fügen es als Ressource in das Dokument ein.

Bearbeitung von Tastenkombinationen

Die Liste der Tastenkombinationen, die für die Bearbeitung implementiert sind:

TastendrückeAktion
BackspaceLöscht das Zeichen links vom Cursor.
EntfLöscht das Zeichen rechts vom Cursor.
Strg+CKopiert den ausgewählten Text in die Zwischenablage.
Strg+EinfügenKopiert den ausgewählten Text in die Zwischenablage.
Strg+KLöscht bis zum Zeilenende.
Strg+VFügt den Text aus der Zwischenablage in den Texteditor ein.
Umschalt+EinfügenFügt den Text aus der Zwischenablage in Text Edit ein.
Strg+XLöscht den ausgewählten Text und kopiert ihn in die Zwischenablage.
Umschalt+EntfLöscht den ausgewählten Text und kopiert ihn in die Zwischenablage.
Strg+ZMacht den letzten Vorgang rückgängig.
Strg+YWiederholt den letzten Vorgang.
LinksBewegt den Cursor um ein Zeichen nach links.
Strg+Nach linksBewegt den Cursor um ein Wort nach links.
RechtsBewegt den Cursor um ein Zeichen nach rechts.
Strg+RechtsBewegt den Cursor um ein Wort nach rechts.
Nach obenBewegt den Cursor eine Zeile nach oben.
Nach untenBewegt den Cursor eine Zeile nach unten.
Bild aufBewegt den Cursor eine Seite nach oben.
Bild-nach-untenBewegt den Cursor eine Seite nach unten.
Pos1Bewegt den Cursor an den Anfang der Zeile.
Strg+Pos1Bewegt den Cursor an den Anfang des Textes.
EndeBewegt den Cursor an das Ende der Zeile.
Strg+EndeBewegt den Cursor an das Ende des Textes.
Alt+MausradBlättert die Seite horizontal (das Rad ist das Mausrad).

Um Text auszuwählen (zu markieren), halten Sie die Umschalttaste gedrückt, während Sie eine der Bewegungstasten drücken. Beispielsweise wählt „Umschalt+Rechts“ das Zeichen rechts davon aus, und „Umschalt+Strg+Rechts“ wählt das Wort rechts davon aus usw.

Siehe auch „ QTextDocument“ , „ QTextCursor “, „Beispiel für Syntax-Highlighter“ und „Rich-Text-Verarbeitung“.

Dokumentation zu Mitgliedstypen

enum QTextEdit::AutoFormattingFlag
flags QTextEdit::AutoFormatting

KonstanteWertBeschreibung
QTextEdit::AutoNone0Keine automatische Formatierung vornehmen.
QTextEdit::AutoBulletList0x00000001Erstellen Sie automatisch Aufzählungslisten (z. B. wenn der Benutzer ein Sternchen („*“) in die Spalte ganz links eingibt oder in einem vorhandenen Listenelement die Eingabetaste drückt).
QTextEdit::AutoAll0xffffffffAlle automatischen Formatierungen anwenden. Derzeit werden nur automatische Aufzählungslisten unterstützt.

Der Typ „AutoFormatting“ ist ein typedef für QFlags<AutoFormattingFlag>. Er speichert eine ODER-Kombination von AutoFormattingFlag-Werten.

enum QTextEdit::LineWrapMode

KonstanteWert
QTextEdit::NoWrap0
QTextEdit::WidgetWidth1
QTextEdit::FixedPixelWidth2
QTextEdit::FixedColumnWidth3

Dokumentation der Eigenschaft

acceptRichText : bool

Diese Eigenschaft gibt an, ob das Textfeld Rich-Text-Eingaben des Benutzers zulässt

Wenn diese Eigenschaft auf „false“ gesetzt ist, akzeptiert das Textfeld nur reine Texteingaben des Benutzers, beispielsweise über die Zwischenablage oder per Drag & Drop.

Der Standardwert dieser Eigenschaft ist „true“.

Zugriffsfunktionen:

bool acceptRichText() const
void setAcceptRichText(bool accept)

autoFormatting : AutoFormatting

Diese Eigenschaft enthält die aktivierten Funktionen zur automatischen Formatierung

Der Wert kann eine beliebige Kombination der Werte aus der Aufzählung „ AutoFormattingFlag “ sein. Der Standardwert ist „ AutoNone “. Wählen Sie „ AutoAll “, um die gesamte automatische Formatierung zu aktivieren.

Derzeit ist „ AutoBulletList “ die einzige verfügbare automatische Formatierungsfunktion; zukünftige Versionen von Qt bieten möglicherweise weitere an.

Zugriffsfunktionen:

QTextEdit::AutoFormatting autoFormatting() const
void setAutoFormatting(QTextEdit::AutoFormatting features)

cursorWidth : int

Diese Eigenschaft legt die Breite des Cursors in Pixeln fest. Der Standardwert ist 1.

Zugriffsfunktionen:

int cursorWidth() const
void setCursorWidth(int width)

document : QTextDocument*

Diese Eigenschaft enthält das zugrunde liegende Dokument des Texteditors.

Hinweis: Der Editor übernimmt nur dann die Eigentümerschaft für das Dokument, wenn er das übergeordnete Objekt des Dokuments ist. Das übergeordnete Objekt des bereitgestellten Dokuments bleibt Eigentümer des Objekts. Ist das zuvor zugewiesene Dokument ein untergeordnetes Objekt des Editors, wird es gelöscht.

Zugriffsfunktionen:

QTextDocument *document() const
void setDocument(QTextDocument *document)

documentTitle : QString

Diese Eigenschaft enthält den Titel des Dokuments, der aus dem Text extrahiert wurde.

Standardmäßig enthält diese Eigenschaft bei einem neu erstellten, leeren Dokument eine leere Zeichenkette.

Zugriffsfunktionen:

QString documentTitle() const
void setDocumentTitle(const QString &title)

html : QString

Diese Eigenschaft stellt eine HTML-Schnittstelle zum Text des Textfelds bereit.

toHtml() gibt den Text des Textfelds als HTML zurück.

setHtml() ändert den Text des Textfelds. Der bisherige Text wird entfernt und der Rückgängig-/Wiederherstellungsverlauf wird gelöscht. Der eingegebene Text wird als Rich-Text im HTML-Format interpretiert. „ currentCharFormat()“ wird ebenfalls zurückgesetzt, es sei denn, „ textCursor()“ befindet sich bereits am Anfang des Dokuments.

Hinweis: Es liegt in der Verantwortung des Aufrufers, sicherzustellen, dass der Text korrekt dekodiert wird, wenn ein HTML- QString erstellt und an `setHtml()` übergeben wird.

Standardmäßig enthält diese Eigenschaft bei einem neu erstellten, leeren Dokument Text, der ein HTML 4.0-Dokument ohne Lauftext beschreibt.

Zugriffsfunktionen:

QString toHtml() const
void setHtml(const QString &text)

Notifier-Signal:

void textChanged()

Siehe auch „Unterstützte HTML-Teilmenge “ und „ plainText “.

lineWrapColumnOrWidth : int

Diese Eigenschaft gibt die Position (in Pixeln oder Spalten, je nach Zeilenumbruchmodus) an, an der der Text umgebrochen wird

Wenn der Zeilenumbruchmodus „ FixedPixelWidth “ ist, gibt der Wert die Anzahl der Pixel vom linken Rand des Textfelds an, bei der der Text umgebrochen werden soll. Wenn der Zeilenumbruchmodus „ FixedColumnWidth “ ist, gibt der Wert die Spaltenzahl (in Zeichenspalten) vom linken Rand des Textfelds an, bei der der Text umgebrochen werden soll.

Standardmäßig enthält diese Eigenschaft den Wert 0.

Zugriffsfunktionen:

int lineWrapColumnOrWidth() const
void setLineWrapColumnOrWidth(int w)

Siehe auch „ lineWrapMode “.

lineWrapMode : LineWrapMode

Diese Eigenschaft legt den Zeilenumbruchmodus fest

Der Standardmodus ist „ WidgetWidth “, wodurch Wörter am rechten Rand des Textfelds umgebrochen werden. Der Umbruch erfolgt an Leerzeichen, wobei ganze Wörter erhalten bleiben. Wenn Sie möchten, dass der Umbruch innerhalb von Wörtern erfolgt, verwenden Sie „ setWordWrapMode()“. Wenn Sie einen Umbruchmodus von „ FixedPixelWidth “ oder „ FixedColumnWidth “ festlegen, sollten Sie zusätzlich „ setLineWrapColumnOrWidth()“ mit der gewünschten Breite aufrufen.

Zugriffsfunktionen:

QTextEdit::LineWrapMode lineWrapMode() const
void setLineWrapMode(QTextEdit::LineWrapMode mode)

Siehe auch lineWrapColumnOrWidth.

markdown : QString

Diese Eigenschaft stellt eine Markdown-Schnittstelle für den Text des Textfelds bereit.

toMarkdown() Gibt den Text des Textfelds als „reines“ Markdown zurück, ohne eingebettete HTML-Formatierungen. Einige Funktionen, die „ QTextDocument “ unterstützt (wie die Verwendung bestimmter Farben und benannter Schriftarten), lassen sich in „reinem“ Markdown nicht darstellen und werden daher weggelassen.

setMarkdown() Ändert den Text des Textfelds. Der bisherige Text wird entfernt und der Verlauf für „Rückgängig“ und „Wiederherstellen“ wird gelöscht. Der eingegebene Text wird als Rich Text im Markdown-Format interpretiert.

Die Auswertung von HTML, das in der Zeichenkette „ markdown “ enthalten ist, erfolgt auf dieselbe Weise wie bei „ 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:

KonstanteBeschreibung
MarkdownNoHTMLAlle HTML-Tags im Markdown-Text werden ignoriert
MarkdownDialectCommonMarkDer Parser unterstützt nur die von CommonMark standardisierten Funktionen
MarkdownDialectGitHubDer Parser unterstützt den GitHub-Dialekt

Die Standardeinstellung ist „ MarkdownDialectGitHub “.

Zugriffsfunktionen:

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

Notifier-Signal:

void textChanged()

Siehe auch plainText, html, QTextDocument::toMarkdown() und QTextDocument::setMarkdown().

overwriteMode : bool

Diese Eigenschaft legt fest, ob vom Benutzer eingegebener Text vorhandenen Text überschreibt

Wie bei vielen Texteditoren kann das Texteditor-Widget so konfiguriert werden, dass der vom Benutzer eingegebene neue Text in den vorhandenen Text eingefügt oder diesen überschreibt.

Wenn diese Eigenschaft auf „ true “ gesetzt ist, wird der vorhandene Text Zeichen für Zeichen durch den neuen Text überschrieben; andernfalls wird der Text an der Cursorposition eingefügt, wodurch der vorhandene Text verdrängt wird.

Standardmäßig ist diese Eigenschaft auf „ false “ gesetzt (neuer Text überschreibt keinen vorhandenen Text).

Zugriffsfunktionen:

bool overwriteMode() const
void setOverwriteMode(bool overwrite)

placeholderText : QString

Diese Eigenschaft enthält den Platzhaltertext des Editors

Wird diese Eigenschaft gesetzt, zeigt der Editor einen ausgegrauten Platzhaltertext an, solange die Funktion „ document()“ leer ist.

Standardmäßig enthält diese Eigenschaft eine leere Zeichenkette.

Zugriffsfunktionen:

QString placeholderText() const
void setPlaceholderText(const QString &placeholderText)

Siehe auch ` document()`.

plainText : QString

Diese Eigenschaft enthält den Inhalt des Texteditors als Klartext.

Vorherige Inhalte werden entfernt und der Rückgängig-/Wiederherstellungsverlauf wird zurückgesetzt, wenn die Eigenschaft gesetzt wird. ` currentCharFormat()` wird ebenfalls zurückgesetzt, es sei denn, ` textCursor()` befindet sich bereits am Anfang des Dokuments.

Wenn der Texteditor einen anderen Inhaltstyp hat, wird dieser beim Aufruf von ` toPlainText()` nicht durch einfachen Text ersetzt. Die einzige Ausnahme bildet das nicht trennbares Leerzeichen `nbsp;`, das in ein Standard-Leerzeichen umgewandelt wird.

Standardmäßig enthält diese Eigenschaft bei einem Editor ohne Inhalt eine leere Zeichenkette.

Zugriffsfunktionen:

QString toPlainText() const
void setPlainText(const QString &text)

Siehe auch html.

readOnly : bool

Diese Eigenschaft gibt an, ob das Textfeld schreibgeschützt ist

In einem schreibgeschützten Textfeld kann der Benutzer nur durch den Text navigieren und Text markieren; eine Änderung des Textes ist nicht möglich.

Der Standardwert dieser Eigenschaft ist „false“.

Zugriffsfunktionen:

bool isReadOnly() const
void setReadOnly(bool ro)

tabChangesFocus : bool

Diese Eigenschaft gilt unabhängig davon, ob die Taste „ Tab “ den Fokus wechselt oder als Eingabe akzeptiert wird

In manchen Fällen sollten Textfelder es dem Benutzer nicht erlauben, Tabulatorzeichen einzugeben oder die Einrückung mit der Tab -Taste zu ändern, da dies die Fokus-Kette unterbricht. Der Standardwert ist „false“.

Zugriffsfunktionen:

bool tabChangesFocus() const
void setTabChangesFocus(bool b)

tabStopDistance : qreal

Diese Eigenschaft gibt den Tabulatorabstand in Pixeln an

Standardmäßig enthält diese Eigenschaft den Wert 80 Pixel.

Legen Sie keinen Wert fest, der kleiner ist als der Wert von „ horizontalAdvance()“ für das Zeichen „ QChar::VisualTabCharacter “, da das Tabulatorzeichen sonst unvollständig dargestellt wird.

Zugriffsfunktionen:

qreal tabStopDistance() const
void setTabStopDistance(qreal distance)

Siehe auch „ QTextOption::ShowTabsAndSpaces “ und „ QTextDocument::defaultTextOption “.

textInteractionFlags : Qt::TextInteractionFlags

Legt fest, wie das Widget auf Benutzereingaben reagieren soll.

Der Standardwert hängt davon ab, ob das „ QTextEdit “ schreibgeschützt oder bearbeitbar ist und ob es sich um ein „ QTextBrowser “ handelt oder nicht.

Zugriffsfunktionen:

Qt::TextInteractionFlags textInteractionFlags() const
void setTextInteractionFlags(Qt::TextInteractionFlags flags)

undoRedoEnabled : bool

Diese Eigenschaft legt fest, ob „Rückgängig“ und „Wiederherstellen“ aktiviert sind.

Benutzer können Aktionen nur rückgängig machen oder wiederholen, wenn diese Eigenschaft auf „true“ gesetzt ist und wenn eine Aktion vorhanden ist, die rückgängig gemacht (oder wiederholt) werden kann.

Zugriffsfunktionen:

bool isUndoRedoEnabled() const
void setUndoRedoEnabled(bool enable)

wordWrapMode : QTextOption::WrapMode

Diese Eigenschaft legt den Modus fest, den „ QTextEdit “ beim Umbrechen von Text nach Wörtern verwendet

Standardmäßig ist diese Eigenschaft auf „ QTextOption::WrapAtWordBoundaryOrAnywhere “ gesetzt.

Zugriffsfunktionen:

QTextOption::WrapMode wordWrapMode() const
void setWordWrapMode(QTextOption::WrapMode policy)

Siehe auch „ QTextOption::WrapMode “.

Dokumentation zu den Member-Funktionen

[explicit] QTextEdit::QTextEdit(QWidget *parent = nullptr)

Erstellt ein leeres QTextEdit-Objekt mit dem übergeordneten Objekt „ parent “.

[explicit] QTextEdit::QTextEdit(const QString &text, QWidget *parent = nullptr)

Erstellt ein QTextEdit-Objekt mit dem übergeordneten Element „ parent “. Das Textfeld zeigt den Text „ text “ an. Der Text wird als HTML interpretiert.

[virtual noexcept] QTextEdit::~QTextEdit()

Destruktor.

Qt::Alignment QTextEdit::alignment() const

Gibt die Ausrichtung des aktuellen Absatzes zurück.

Siehe auch „ setAlignment()“.

QString QTextEdit::anchorAt(const QPoint &pos) const

Gibt die Referenz des Ankers an der Position pos zurück oder eine leere Zeichenfolge, falls an dieser Stelle kein Anker vorhanden ist.

[slot] void QTextEdit::append(const QString &text)

Fügt am Ende des Textes einen neuen Absatz mit dem Text „ text “ ein.

Hinweis: Der angefügte neue Absatz hat dieselbe Zeichen- und Blockformatierung wie der aktuelle Absatz, die durch die Position des Cursors bestimmt wird.

Siehe auch „ currentCharFormat “ () und „ QTextCursor::blockFormat “ ().

[virtual protected] bool QTextEdit::canInsertFromMimeData(const QMimeData *source) const

Diese Funktion gibt „ true “ zurück, wenn der Inhalt des MIME-Datenobjekts, das durch „ source “ angegeben wird, dekodiert und in das Dokument eingefügt werden kann. Sie wird beispielsweise aufgerufen, wenn die Maus während eines Drag-Vorgangs in dieses Widget gelangt und festgestellt werden muss, ob der Drag-and-Drop-Vorgang akzeptiert werden kann.

Implementieren Sie diese Funktion neu, um die Drag-and-Drop-Unterstützung für weitere MIME-Typen zu aktivieren.

bool QTextEdit::canPaste() const

Gibt zurück, ob Text aus der Zwischenablage in das Textfeld eingefügt werden kann.

[override virtual protected] void QTextEdit::changeEvent(QEvent *e)

Implementiert neu: ` QFrame::changeEvent(QEvent *ev)`.

[slot] void QTextEdit::clear()

Löscht den gesamten Text im Textfeld.

Hinweise:

  • Der Verlauf der Rückgängig-/Wiederherstellungsaktionen wird ebenfalls gelöscht.
  • currentCharFormat() wird zurückgesetzt, es sei denn, textCursor() befindet sich bereits am Anfang des Dokuments.

Siehe auch „ cut()“, „ setPlainText()“ und „ setHtml()“.

[override virtual protected] void QTextEdit::contextMenuEvent(QContextMenuEvent *event)

Implementiert: ` QAbstractScrollArea::contextMenuEvent(QContextMenuEvent *e)`.

Zeigt das mit ` createStandardContextMenu()` erstellte Standard-Kontextmenü an.

Wenn das Textfeld kein Kontextmenü haben soll, können Sie dessen ` contextMenuPolicy ` auf ` Qt::NoContextMenu` setzen. Wenn Sie das Kontextmenü anpassen möchten, implementieren Sie diese Funktion neu. Wenn Sie das Standard-Kontextmenü erweitern möchten, implementieren Sie diese Funktion neu, rufen Sie ` createStandardContextMenu()` auf und erweitern Sie das zurückgegebene Menü.

Informationen zum Ereignis werden im Objekt ` event ` übergeben.

void MyTextEdit::contextMenuEvent(QContextMenuEvent *event)
{
    QMenu *menu = createStandardContextMenu();
    menu->addAction(tr("My Menu Item"));
    //...
    menu->exec(event->globalPos());
    delete menu;
}

[slot] void QTextEdit::copy()

Kopiert den ausgewählten Text in die Zwischenablage.

Siehe auch copyAvailable().

[signal] void QTextEdit::copyAvailable(bool yes)

Dieses Signal wird ausgelöst, wenn Text im Textfeld ausgewählt oder die Auswahl aufgehoben wird.

Wenn Text markiert ist, wird dieses Signal mit dem Wert „ yes “ auf „true“ ausgelöst. Wenn kein Text markiert ist oder wenn die Markierung aufgehoben wird, wird dieses Signal mit dem Wert „ yes “ auf „false“ ausgelöst.

Ist „ yes “ auf „true“ gesetzt, kann „ copy()“ verwendet werden, um die Auswahl in die Zwischenablage zu kopieren. Ist „ yes “ auf „false“ gesetzt, hat „ copy()“ keine Wirkung.

Siehe auch ` selectionChanged()`.

[virtual protected] QMimeData *QTextEdit::createMimeDataFromSelection() const

Diese Funktion gibt ein neues MIME-Datenobjekt zurück, das den Inhalt der aktuellen Auswahl im Textfeld darstellt. Sie wird aufgerufen, wenn die Auswahl in ein neues „ QMimeData “-Objekt gekapselt werden soll; beispielsweise beim Starten eines Drag-and-Drop-Vorgangs oder beim Kopieren von Daten in die Zwischenablage.

Wenn Sie diese Funktion neu implementieren, beachten Sie bitte, dass die Eigentumsrechte am zurückgegebenen „ QMimeData “-Objekt an den Aufrufer übertragen werden. Die Auswahl kann mit der Funktion „ textCursor()“ abgerufen werden.

QMenu *QTextEdit::createStandardContextMenu()

Diese Funktion erstellt das Standard-Kontextmenü, das angezeigt wird, wenn der Benutzer mit der rechten Maustaste auf das Textfeld klickt. Sie wird vom Standard-Handler „ contextMenuEvent()“ aufgerufen. Die Eigentumsrechte am Popup-Menü werden an den Aufrufer übertragen.

Wir empfehlen, stattdessen die Version `createStandardContextMenu(QPoint)` zu verwenden, da diese Aktionen ermöglicht, die davon abhängen, wo der Benutzer geklickt hat.

QMenu *QTextEdit::createStandardContextMenu(const QPoint &position)

Diese Funktion erstellt das Standard-Kontextmenü, das angezeigt wird, wenn der Benutzer mit der rechten Maustaste auf das Textfeld klickt. Sie wird vom Standard-Handler „ contextMenuEvent()“ aufgerufen und erhält als Parameter die Koordinaten „ position “ in Dokumentkoordinaten, an denen der Mausklick erfolgte. Auf diese Weise können Aktionen aktiviert werden, die von der Position abhängen, an der der Benutzer geklickt hat. Die Verantwortung für das Popup-Menü wird an den Aufrufer übertragen.

QTextCharFormat QTextEdit::currentCharFormat() const

Gibt das Zeichenformat zurück, das beim Einfügen von neuem Text verwendet wird.

Siehe auch „ setCurrentCharFormat()“.

[signal] void QTextEdit::currentCharFormatChanged(const QTextCharFormat &f)

Dieses Signal wird ausgegeben, wenn sich das aktuelle Zeichenformat geändert hat, beispielsweise aufgrund einer Änderung der Cursorposition.

Das neue Format lautet „ f “.

Siehe auch ` setCurrentCharFormat()`.

QFont QTextEdit::currentFont() const

Gibt die Schriftart des aktuellen Formats zurück.

Siehe auch setCurrentFont(), setFontFamily() und setFontPointSize().

QTextCursor QTextEdit::cursorForPosition(const QPoint &pos) const

Gibt ein „ QTextCursor “ an der Position „ pos “ (in Viewport-Koordinaten) zurück.

[signal] void QTextEdit::cursorPositionChanged()

Dieses Signal wird immer dann ausgegeben, wenn sich die Position des Cursors ändert.

QRect QTextEdit::cursorRect() const

Gibt ein Rechteck (in Ansichtsbereichskoordinaten) zurück, das den Cursor des Textfelds umfasst.

QRect QTextEdit::cursorRect(const QTextCursor &cursor) const

Gibt ein Rechteck (in Ansichtsbereichskoordinaten) zurück, das den Bereich „ cursor “ umfasst.

[slot] void QTextEdit::cut()

Kopiert den ausgewählten Text in die Zwischenablage und löscht ihn aus dem Textfeld.

Wenn kein Text ausgewählt ist, geschieht nichts.

Siehe auch copy() und paste().

[override virtual protected] void QTextEdit::dragEnterEvent(QDragEnterEvent *e)

Umsetzt: ` QAbstractScrollArea::dragEnterEvent` (`QDragEnterEvent *event`).

[override virtual protected] void QTextEdit::dragLeaveEvent(QDragLeaveEvent *e)

Implementiert: ` QAbstractScrollArea::dragLeaveEvent` (`QDragLeaveEvent *event`).

[override virtual protected] void QTextEdit::dragMoveEvent(QDragMoveEvent *e)

Umsetzt: ` QAbstractScrollArea::dragMoveEvent` (`QDragMoveEvent *event`).

[override virtual protected] void QTextEdit::dropEvent(QDropEvent *e)

Implementiert: ` QAbstractScrollArea::dropEvent(QDropEvent *event)`.

void QTextEdit::ensureCursorVisible()

Stellt sicher, dass der Cursor sichtbar ist, indem der Textbereich bei Bedarf gescrollt wird.

QList<QTextEdit::ExtraSelection> QTextEdit::extraSelections() const

Gibt zuvor festgelegte zusätzliche Auswahlen zurück.

Siehe auch „ setExtraSelections()“.

bool QTextEdit::find(const QString &exp, QTextDocument::FindFlags options = QTextDocument::FindFlags())

Sucht das nächste Vorkommen der Zeichenfolge „ exp “ unter Verwendung des angegebenen „ options “. Gibt „ true “ zurück, wenn „ exp “ gefunden wurde, und setzt den Cursor so, dass die Übereinstimmung markiert ist; andernfalls wird „ false “ zurückgegeben.

bool QTextEdit::find(const QRegularExpression &exp, QTextDocument::FindFlags options = QTextDocument::FindFlags())

Sucht unter Verwendung des angegebenen „ options “ nach dem nächsten Vorkommen, das dem regulären Ausdruck „ exp “ entspricht.

Gibt „ true “ zurück, wenn eine Übereinstimmung gefunden wurde, und setzt den Cursor so, dass die Übereinstimmung markiert ist; andernfalls wird „ false “ zurückgegeben.

Warnung: Aus historischen Gründen wird die für „ exp “ festgelegte Option zur Groß-/Kleinschreibung ignoriert. Stattdessen wird anhand von „ options “ bestimmt, ob bei der Suche die Groß-/Kleinschreibung beachtet wird oder nicht.

Dies ist eine überladene Funktion.

[override virtual protected] void QTextEdit::focusInEvent(QFocusEvent *e)

Implementiert: ` QWidget::focusInEvent(QFocusEvent *event)`.

[override virtual protected] bool QTextEdit::focusNextPrevChild(bool next)

Implementiert: ` QWidget::focusNextPrevChild` (bool next).

[override virtual protected] void QTextEdit::focusOutEvent(QFocusEvent *e)

Implementiert: ` QWidget::focusOutEvent(QFocusEvent *event)`.

QString QTextEdit::fontFamily() const

Gibt die Schriftfamilie des aktuellen Formats zurück.

Siehe auch setFontFamily(), setCurrentFont() und setFontPointSize().

bool QTextEdit::fontItalic() const

Gibt „ true “ zurück, wenn die Schriftart des aktuellen Formats kursiv ist; andernfalls wird „false“ zurückgegeben.

Siehe auch setFontItalic().

qreal QTextEdit::fontPointSize() const

Gibt die Punktgröße der Schriftart des aktuellen Formats zurück.

Siehe auch „ setFontFamily()“, „ setCurrentFont()“ und „ setFontPointSize()“.

bool QTextEdit::fontUnderline() const

Gibt „ true “ zurück, wenn die Schriftart des aktuellen Formats unterstrichen ist; andernfalls wird „false“ zurückgegeben.

Siehe auch setFontUnderline().

int QTextEdit::fontWeight() const

Gibt die Schriftstärke des aktuellen Formats zurück.

Siehe auch setFontWeight(), setCurrentFont(), setFontPointSize() und QFont::Weight.

[override virtual protected] void QTextEdit::inputMethodEvent(QInputMethodEvent *e)

Implementiert: ` QWidget::inputMethodEvent` (`QInputMethodEvent *event`).

[override virtual] QVariant QTextEdit::inputMethodQuery(Qt::InputMethodQuery property) const

Implementiert neu: ` QWidget::inputMethodQuery` (Qt::InputMethodQuery query) const.

[virtual protected] void QTextEdit::insertFromMimeData(const QMimeData *source)

Diese Funktion fügt den Inhalt des MIME-Datenobjekts, das durch ` source` angegeben wird, an der aktuellen Cursorposition in das Textfeld ein. Sie wird immer dann aufgerufen, wenn Text infolge eines Einfügevorgangs aus der Zwischenablage eingefügt wird oder wenn das Textfeld Daten aus einem Drag-and-Drop-Vorgang übernimmt.

Implementieren Sie diese Funktion neu, um Drag-and-Drop-Unterstützung für weitere MIME-Typen zu ermöglichen.

[slot] void QTextEdit::insertHtml(const QString &text)

Praktischer Platzhalter, der „ text “ – wobei davon ausgegangen wird, dass es sich um HTML-Code handelt – an der aktuellen Cursorposition einfügt.

Dies entspricht:

edit->textCursor().insertHtml(fragment);

Hinweis: Bei Verwendung dieser Funktion mit einem Stylesheet wird das Stylesheet nur auf den aktuellen Block im Dokument angewendet. Um ein Stylesheet dokumentweit anzuwenden, verwenden Sie stattdessen QTextDocument::setDefaultStyleSheet().

[slot] void QTextEdit::insertPlainText(const QString &text)

Praktische Funktion, die „ text “ an der aktuellen Cursorposition einfügt.

Dies entspricht

edit->textCursor().insertText(text);

[override virtual protected] void QTextEdit::keyPressEvent(QKeyEvent *e)

Implementiert: ` QAbstractScrollArea::keyPressEvent(QKeyEvent *e)`.

[override virtual protected] void QTextEdit::keyReleaseEvent(QKeyEvent *e)

Implementiert: ` QWidget::keyReleaseEvent` (`QKeyEvent *event`).

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

Lädt die Ressource, die durch die angegebenen Parameter ` type ` und ` name` festgelegt ist.

Diese Funktion ist eine Erweiterung von ` QTextDocument::loadResource()`.

Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.

Siehe auch QTextDocument::loadResource().

void QTextEdit::mergeCurrentCharFormat(const QTextCharFormat &modifier)

Fügt die unter modifier angegebenen Eigenschaften in das aktuelle Zeichenformat ein, indem die Funktion QTextCursor::mergeCharFormat für den Cursor des Editors aufgerufen wird. Wenn im Editor eine Auswahl markiert ist, werden die Eigenschaften von modifier direkt auf die Auswahl angewendet.

Siehe auch QTextCursor::mergeCharFormat().

[override virtual protected] void QTextEdit::mouseDoubleClickEvent(QMouseEvent *e)

Implementiert: ` QAbstractScrollArea::mouseDoubleClickEvent(QMouseEvent *e)`.

[override virtual protected] void QTextEdit::mouseMoveEvent(QMouseEvent *e)

Implementiert: ` QAbstractScrollArea::mouseMoveEvent(QMouseEvent *e)`.

[override virtual protected] void QTextEdit::mousePressEvent(QMouseEvent *e)

Implementiert: ` QAbstractScrollArea::mousePressEvent(QMouseEvent *e)`.

[override virtual protected] void QTextEdit::mouseReleaseEvent(QMouseEvent *e)

Implementiert: ` QAbstractScrollArea::mouseReleaseEvent(QMouseEvent *e)`.

void QTextEdit::moveCursor(QTextCursor::MoveOperation operation, QTextCursor::MoveMode mode = QTextCursor::MoveAnchor)

Bewegt den Cursor, indem die angegebene Funktion „ operation “ ausgeführt wird.

Wenn ` mode ` den Wert ` QTextCursor::KeepAnchor` hat, markiert der Cursor den Text, über den er sich bewegt. Dies entspricht dem Effekt, den der Benutzer erzielt, wenn er die Umschalttaste gedrückt hält und den Cursor mit den Cursortasten bewegt.

Siehe auch ` QTextCursor::movePosition()`.

[override virtual protected] void QTextEdit::paintEvent(QPaintEvent *event)

Wird neu implementiert: QAbstractScrollArea::paintEvent(QPaintEvent *event).

Dieser Ereignishandler kann in einer Unterklasse neu implementiert werden, um die in „ event “ übergebenen Zeichenereignisse zu empfangen. In der Regel ist es nicht erforderlich, diese Funktion in einer Unterklasse von „ QTextEdit “ neu zu implementieren.

Hinweis: Wenn Sie ein ` QPainter` erstellen, muss dieses auf dem ` viewport()` operieren.

Warnung: Das zugrunde liegende Textdokument darf innerhalb einer Neuimplementierung dieser Funktion nicht verändert werden.

[slot] void QTextEdit::paste()

Fügt den Text aus der Zwischenablage an der aktuellen Cursorposition in das Textfeld ein.

Befindet sich kein Text in der Zwischenablage, geschieht nichts.

Um das Verhalten dieser Funktion zu ändern, d. h. um festzulegen, was „ QTextEdit “ einfügen kann und wie dies geschieht, implementieren Sie die virtuellen Funktionen „ canInsertFromMimeData “ () und „ insertFromMimeData “ () neu.

Siehe auch cut() und copy().

void QTextEdit::print(QPagedPaintDevice *printer) const

Hilfsfunktion zum Drucken des Dokuments des Text-Edit-Objekts an die angegebene Adresse ` printer`. Dies entspricht dem direkten Aufruf der Methode `print` für das Dokument, mit dem Unterschied, dass diese Funktion auch `QPrinter::Selection` als Druckbereich unterstützt.

Siehe auch ` QTextDocument::print()` ().

[slot] void QTextEdit::redo()

Führt die letzte Aktion erneut aus.

Wenn keine Operation wiederhergestellt werden kann, d. h. wenn der Undo-/Redo-Verlauf keinen entsprechenden Schritt enthält, geschieht nichts.

Siehe auch ` undo()`.

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

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

[override virtual protected] void QTextEdit::resizeEvent(QResizeEvent *e)

Implementiert: ` QAbstractScrollArea::resizeEvent(QResizeEvent *event)`.

[override virtual protected] void QTextEdit::scrollContentsBy(int dx, int dy)

Implementiert: QAbstractScrollArea::scrollContentsBy(int dx, int dy).

[slot] void QTextEdit::scrollToAnchor(const QString &name)

Blättert im Textfeld so weit, dass der Anker mit der angegebenen Adresse name sichtbar ist; führt keine Aktion aus, wenn die Adresse name leer ist, bereits sichtbar ist oder nicht gefunden wird.

[slot] void QTextEdit::selectAll()

Wählt den gesamten Text aus.

Siehe auch „ copy()“, „ cut()“ und „ textCursor()“.

[signal] void QTextEdit::selectionChanged()

Dieses Signal wird immer dann ausgegeben, wenn sich die Auswahl ändert.

Siehe auch copyAvailable().

[slot] void QTextEdit::setAlignment(Qt::Alignment a)

Legt die Ausrichtung des aktuellen Absatzes auf „ a “ fest. Gültige Ausrichtungen sind „ Qt::AlignLeft “, „ Qt::AlignRight “, „ Qt::AlignJustify “ und „ Qt::AlignCenter “ (was eine horizontale Zentrierung bewirkt).

Siehe auch alignment().

void QTextEdit::setCurrentCharFormat(const QTextCharFormat &format)

Legt das Zeichenformat fest, das beim Einfügen von neuem Text in format verwendet werden soll, indem QTextCursor::setCharFormat() am Cursor des Editors aufgerufen wird. Wenn im Editor eine Auswahl markiert ist, wird das Zeichenformat direkt auf die Auswahl angewendet.

Siehe auch ` currentCharFormat()`.

[slot] void QTextEdit::setCurrentFont(const QFont &f)

Legt die Schriftart des aktuellen Formats auf „ f “ fest.

Siehe auch „ currentFont()“, „ setFontPointSize()“ und „ setFontFamily()“.

void QTextEdit::setExtraSelections(const QList<QTextEdit::ExtraSelection> &selections)

Diese Funktion ermöglicht es, bestimmte Bereiche im Dokument vorübergehend mit einer bestimmten Farbe zu markieren, die als „ selections “ angegeben wird. Dies kann beispielsweise in einem Programmiereditor nützlich sein, um eine ganze Textzeile mit einer bestimmten Hintergrundfarbe zu markieren und so das Vorhandensein eines Haltepunkts anzuzeigen.

Siehe auch „ QTextEdit::ExtraSelection “ und „ extraSelections()“.

[slot] void QTextEdit::setFontFamily(const QString &fontFamily)

Legt die Schriftart des aktuellen Formats auf „ fontFamily “ fest.

Siehe auch „ fontFamily()“ und „ setCurrentFont()“.

[slot] void QTextEdit::setFontItalic(bool italic)

Wenn „ italic “ wahr ist, wird das aktuelle Format auf „kursiv“ gesetzt; andernfalls wird das aktuelle Format auf „nicht kursiv“ gesetzt.

Siehe auch fontItalic().

[slot] void QTextEdit::setFontPointSize(qreal s)

Setzt die Schriftgröße des aktuellen Formats auf „ s “.

Beachten Sie, dass das Verhalten dieser Funktion nicht definiert ist, wenn „ s “ den Wert Null oder einen negativen Wert hat.

Siehe auch „ fontPointSize()“, „ setCurrentFont()“ und „ setFontFamily()“.

[slot] void QTextEdit::setFontUnderline(bool underline)

Wenn „ underline “ wahr ist, wird das aktuelle Format auf „unterstrichen“ gesetzt; andernfalls wird das aktuelle Format auf „nicht unterstrichen“ gesetzt.

Siehe auch fontUnderline().

[slot] void QTextEdit::setFontWeight(int weight)

Setzt die Schriftstärke des aktuellen Formats auf den angegebenen Wert weight, wobei der verwendete Wert im durch die Enumeration QFont::Weight definierten Bereich liegt.

Siehe auch „ fontWeight()“, „ setCurrentFont()“ und „ setFontFamily()“.

[slot] void QTextEdit::setPlainText(const QString &text)

Ändert den Text des Textfelds in die Zeichenfolge „ text “. Der bisherige Text wird entfernt.

Hinweise:

  • text wird als reiner Text interpretiert.
  • Der Verlauf der Rückgängig-/Wiederherstellungsaktionen wird ebenfalls gelöscht.
  • currentCharFormat() wird zurückgesetzt, es sei denn, textCursor() steht bereits am Anfang des Dokuments.

Hinweis: Setter -Funktion für die Eigenschaft „ plainText “.

Siehe auch toPlainText().

[slot] void QTextEdit::setText(const QString &text)

Legt die „ text “ des Textfelds fest. Der Text kann aus einfachem Text oder HTML bestehen, und das Textfeld versucht, das richtige Format zu ermitteln.

Verwenden Sie direkt „ setHtml()“ oder „ setPlainText()“, um die Erkennung durch das Textfeld zu umgehen.

Siehe auch ` toPlainText()` und ` toHtml()`.

[slot] void QTextEdit::setTextBackgroundColor(const QColor &c)

Setzt die Text-Hintergrundfarbe des aktuellen Formats auf „ c “.

Siehe auch „ textBackgroundColor()“.

[slot] void QTextEdit::setTextColor(const QColor &c)

Legt die Textfarbe des aktuellen Formats auf „ c “ fest.

Siehe auch textColor().

void QTextEdit::setTextCursor(const QTextCursor &cursor)

Legt die sichtbare „ cursor “ fest.

Siehe auch ` textCursor()`.

[override virtual protected] void QTextEdit::showEvent(QShowEvent *)

Implementiert: ` QWidget::showEvent(QShowEvent *event)`.

QColor QTextEdit::textBackgroundColor() const

Gibt die Hintergrundfarbe des Textes im aktuellen Format zurück.

Siehe auch „ setTextBackgroundColor()“.

[signal] void QTextEdit::textChanged()

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.

Hinweis: Benachrichtigungssignal für die Eigenschaften „ html “ und „ markdown “.

QColor QTextEdit::textColor() const

Gibt die Textfarbe des aktuellen Formats zurück.

Siehe auch „ setTextColor()“.

QTextCursor QTextEdit::textCursor() const

Gibt eine Kopie des „ QTextCursor “ zurück, der den aktuell sichtbaren Cursor darstellt. Beachten Sie, dass Änderungen am zurückgegebenen Cursor keinen Einfluss auf den Cursor von „ QTextEdit “ haben; verwenden Sie „ setTextCursor()“, um den sichtbaren Cursor zu aktualisieren.

Siehe auch setTextCursor().

QString QTextEdit::toPlainText() const

QString QTextEdit::toPlainText() const

Gibt den Text des Textfelds als einfachen Text zurück.

Hinweis: Getter -Funktion für die Eigenschaft „ plainText “.

Siehe auch ` QTextEdit::setPlainText()`.

[slot] void QTextEdit::undo()

Macht den letzten Vorgang rückgängig.

Wenn kein Vorgang rückgängig gemacht werden kann, d. h. wenn im Rückgängig-/Wiederherstellen-Verlauf kein Schritt vorhanden ist, geschieht nichts.

Siehe auch ` redo()`.

[signal] void QTextEdit::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).

[override virtual protected] void QTextEdit::wheelEvent(QWheelEvent *e)

Umsetzt: ` QAbstractScrollArea::wheelEvent(QWheelEvent *e)`.

[slot] void QTextEdit::zoomIn(int range = 1)

Vergrößert den Text, indem die Grundschriftgröße um range -Punkte erhöht und alle Schriftgrößen entsprechend der neuen Größe neu berechnet werden. Die Größe der Bilder wird dabei nicht verändert.

Siehe auch zoomOut().

[slot] void QTextEdit::zoomOut(int range = 1)

Vergrößert den Text, indem die Grundschriftgröße um range -Punkte verkleinert und alle Schriftgrößen entsprechend der neuen Größe neu berechnet werden. Die Größe der Bilder wird dabei nicht verändert.

Siehe auch zoomIn().

© 2026 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.