QTextEdit Class

Dokumentation der Mitgliedsfunktionen

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

Konstruiert ein leeres QTextEdit mit übergeordnetem parent.

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

Konstruiert ein QTextEdit mit übergeordnetem parent. Die Textbearbeitung zeigt den Text text an. Der Text wird als html interpretiert.

[virtual noexcept] QTextEdit::~QTextEdit()

Zerstörer.

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 Zeichenkette, wenn an dieser Stelle kein Anker existiert.

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

Hängt einen neuen Absatz mit text an das Ende der Textbearbeitung an.

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 z. B. aufgerufen, wenn die Maus während eines Ziehvorgangs in dieses Widget eintritt und festgestellt werden muss, ob der Zieh- und Ablegevorgang akzeptiert werden kann.

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

bool QTextEdit::canPaste() const

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

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

Reimplements: QFrame::changeEvent(QEvent *ev).

[slot] void QTextEdit::clear()

Löscht den gesamten Text in der Textbearbeitung.

Anmerkungen:

• Der Verlauf des Rückgängigmachens/Wiederholens 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)

Reimplements: QAbstractScrollArea::contextMenuEvent(QContextMenuEvent *e).

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

Wenn Sie nicht wollen, dass die Texteingabe ein Kontextmenü hat, können Sie contextMenuPolicy auf Qt::NoContextMenu setzen. Wenn Sie das Kontextmenü anpassen wollen, implementieren Sie diese Funktion neu. Wenn Sie das Standard-Kontextmenü erweitern wollen, implementieren Sie diese Funktion neu, rufen createStandardContextMenu() auf und erweitern das zurückgegebene Menü.

Die Informationen über das 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 einen beliebigen markierten Text in die Zwischenablage.

Siehe auch copyAvailable().

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

Dieses Signal wird ausgegeben, wenn Text in der Textbearbeitung ausgewählt oder abgewählt wird.

Wenn Text markiert ist, wird dieses Signal mit yes auf true gesetzt. Wenn kein Text markiert ist oder der markierte Text abgewählt wird, wird dieses Signal ausgegeben, wobei yes auf false gesetzt ist.

Wenn yes wahr ist, kann copy() verwendet werden, um die Auswahl in die Zwischenablage zu kopieren. Wenn yes falsch ist, bewirkt copy() nichts.

Siehe auch selectionChanged().

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

Diese Funktion gibt ein neues MIME-Datenobjekt zurück, das den Inhalt der aktuellen Auswahl der Textbearbeitung darstellt. Sie wird aufgerufen, wenn die Auswahl in ein neues QMimeData Objekt gekapselt werden soll, z.B. wenn eine Drag & Drop Operation gestartet wird oder wenn Daten in die Zwischenablage kopiert werden.

Wenn Sie diese Funktion neu implementieren, beachten Sie, dass der Besitz des zurückgegebenen QMimeData Objekts an den Aufrufer übergeben wird. Die Auswahl kann mit Hilfe 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 den zu bearbeitenden Text klickt. Sie wird vom Standardhandler contextMenuEvent() aufgerufen. Das Eigentum an dem Popup-Menü wird an den Aufrufer übertragen.

Wir empfehlen Ihnen, stattdessen die Version createStandardContextMenu(QPoint) zu verwenden, die die Aktionen aktiviert, 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 den zu bearbeitenden Text klickt. Sie wird vom Standardhandler contextMenuEvent() aufgerufen und nimmt die position in Dokumentenkoordinaten, wo der Mausklick war. Dadurch können Aktionen aktiviert werden, die von der Position abhängen, an der der Benutzer geklickt hat. Der Besitz des Popup-Menüs 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, zum Beispiel durch eine Änderung der Cursorposition.

Das neue Format ist 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 eine QTextCursor an der Position pos (in Ansichtskoordinaten) zurück.

[signal] void QTextEdit::cursorPositionChanged()

Dieses Signal wird ausgegeben, wenn sich die Position des Cursors geändert hat.

QRect QTextEdit::cursorRect() const

gibt ein Rechteck (in Ansichtsfenster-Koordinaten) zurück, das den Cursor der Textbearbeitung einschließt.

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

gibt ein Rechteck (in Ansichtsfensterkoordinaten) zurück, das die cursor einschließt.

[slot] void QTextEdit::cut()

Kopiert den markierten Text in die Zwischenablage und löscht ihn aus der Textbearbeitung.

Wenn kein Text markiert ist, geschieht nichts.

Siehe auch copy() und paste().

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

Reimplements: QAbstractScrollArea::dragEnterEvent(QDragEnterEvent *event).

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

Reimplements: QAbstractScrollArea::dragLeaveEvent(QDragLeaveEvent *event).

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

Reimplements: QAbstractScrollArea::dragMoveEvent(QDragMoveEvent *event).

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

Reimplements: QAbstractScrollArea::dropEvent(QDropEvent *event).

void QTextEdit::ensureCursorVisible()

Stellt sicher, dass der Cursor sichtbar ist, indem er gegebenenfalls die Textbearbeitung durchläuft.

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

Liefert die zuvor eingestellten Extra-Auswahlen zurück.

Siehe auch setExtraSelections().

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

Findet das nächste Vorkommen der Zeichenkette exp unter Verwendung der angegebenen options. Gibt true zurück, wenn exp gefunden wurde, und ändert den Cursor, um die Übereinstimmung auszuwählen; andernfalls wird false zurückgegeben.

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

Dies ist eine überladene Funktion.

Findet das nächste Vorkommen, das mit dem regulären Ausdruck exp übereinstimmt, unter Verwendung des angegebenen options.

Gibt true zurück, wenn eine Übereinstimmung gefunden wurde, und ändert den Cursor, um die Übereinstimmung auszuwählen; andernfalls wird false zurückgegeben.

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

Reimplements: QWidget::focusInEvent(QFocusEvent *event).

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

Reimplements: QWidget::focusNextPrevChild(bool next).

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

Reimplements: 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 Schrift 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 Schrift 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)

Reimplements: QWidget::inputMethodEvent(QInputMethodEvent *event).

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

Reimplements: QWidget::inputMethodQuery(Qt::InputMethodQuery query) const.

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

Diese Funktion fügt den Inhalt des durch source angegebenen MIME-Datenobjekts in die Texteingabe an der aktuellen Cursorposition ein. Sie wird immer dann aufgerufen, wenn Text als Ergebnis einer Einfügeoperation in die Zwischenablage eingefügt wird oder wenn die Texteingabe Daten von einer Drag-and-Drop-Operation annimmt.

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

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

Bequemer Slot, der text an der aktuellen Cursorposition einfügt, wobei davon ausgegangen wird, dass es sich um eine html-Formatierung handelt.

Sie ist äquivalent zu:

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

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

Bequemer Slot, der text an der aktuellen Cursorposition einfügt.

Er ist äquivalent zu

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

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

Reimplements: QAbstractScrollArea::keyPressEvent(QKeyEvent *e).

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

Reimplements: QWidget::keyReleaseEvent(QKeyEvent *event).

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

Lädt die durch die angegebenen type und name spezifizierte Ressource.

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

Siehe auch QTextDocument::loadResource().

void QTextEdit::mergeCurrentCharFormat(const QTextCharFormat &modifier)

Fügt die in modifier angegebenen Eigenschaften in das aktuelle Zeichenformat ein, indem QTextCursor::mergeCharFormat am Cursor des Editors aufgerufen wird. Wenn der Editor eine Auswahl hat, werden die Eigenschaften von modifier direkt auf die Auswahl angewendet.

Siehe auch QTextCursor::mergeCharFormat().

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

Reimplements: QAbstractScrollArea::mouseDoubleClickEvent(QMouseEvent *e).

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

Reimplements: QAbstractScrollArea::mouseMoveEvent(QMouseEvent *e).

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

Reimplements: QAbstractScrollArea::mousePressEvent(QMouseEvent *e).

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

Reimplements: QAbstractScrollArea::mouseReleaseEvent(QMouseEvent *e).

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

Bewegt den Cursor, indem er den angegebenen operation ausführt.

Wenn mode gleich QTextCursor::KeepAnchor ist, markiert der Cursor den Text, über den er sich bewegt. Dies ist der gleiche 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)

Reimplements: QAbstractScrollArea::paintEvent(QPaintEvent *event).

Dieser Event-Handler kann in einer Unterklasse neu implementiert werden, um Paint-Ereignisse zu empfangen, die in event übergeben werden. Es ist normalerweise nicht notwendig, diese Funktion in einer Unterklasse von QTextEdit neu zu implementieren.

[slot] void QTextEdit::paste()

Fügt den Text aus der Zwischenablage in die Texteingabe an der aktuellen Cursorposition ein.

Wenn sich kein Text in der Zwischenablage befindet, passiert nichts.

Um das Verhalten dieser Funktion zu ändern, d.h. um zu modifizieren, was QTextEdit einfügen kann und wie es eingefügt wird, müssen die virtuellen Funktionen canInsertFromMimeData() und insertFromMimeData() neu implementiert werden.

Siehe auch cut() und copy().

void QTextEdit::print(QPagedPaintDevice *printer) const

Convenience-Funktion, um das Dokument der Textbearbeitung auf die angegebene printer zu drucken. Dies ist äquivalent zum direkten Aufruf der Druckmethode für das Dokument, außer dass diese Funktion auch QPrinter::Selection als Druckbereich unterstützt.

Siehe auch QTextDocument::print().

[slot] void QTextEdit::redo()

Wiederholt den letzten Vorgang.

Wenn es keinen Vorgang gibt, der wiederhergestellt werden kann, d. h. kein Wiederherstellungsschritt in der Undo-/Redo-Historie vorhanden ist, passiert nichts.

Siehe auch undo().

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

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

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

Reimplements: QAbstractScrollArea::resizeEvent(QResizeEvent *event).

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

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

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

Scrollt die Texteingabe so, dass der Anker mit der angegebenen name sichtbar ist; tut nichts, wenn die name leer ist oder bereits sichtbar ist oder nicht gefunden wird.

[slot] void QTextEdit::selectAll()

Markiert den gesamten Text.

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

[signal] void QTextEdit::selectionChanged()

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

Siehe auch copyAvailable().

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

Setzt die Ausrichtung des aktuellen Absatzes auf a. Gültige Ausrichtungen sind Qt::AlignLeft, Qt::AlignRight, Qt::AlignJustify und Qt::AlignCenter (mit horizontaler Zentrierung).

Siehe auch alignment().

void QTextEdit::setCurrentCharFormat(const QTextCharFormat &format)

Legt das Zeichenformat fest, das beim Einfügen von neuem Text in format durch den Aufruf von QTextCursor::setCharFormat() am Cursor des Editors verwendet werden soll. Wenn der Editor eine Auswahl hat, wird das Zeichenformat direkt auf die Auswahl angewendet.

Siehe auch currentCharFormat().

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

Setzt die Schriftart des aktuellen Formats auf f.

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

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

Mit dieser Funktion können bestimmte Bereiche im Dokument vorübergehend mit einer bestimmten Farbe markiert werden, die als selections angegeben wird. Dies kann z.B. in einem Programmiereditor nützlich sein, um eine ganze Textzeile mit einer bestimmten Hintergrundfarbe zu markieren, um das Vorhandensein eines Haltepunktes anzuzeigen.

Siehe auch QTextEdit::ExtraSelection und extraSelections().

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

Setzt die Schriftfamilie des aktuellen Formats auf fontFamily.

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 Punktgröße des aktuellen Formats auf s.

Beachten Sie, dass das Verhalten dieser Funktion nicht definiert ist, wenn s Null oder negativ ist.

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 weight, wobei der verwendete Wert in dem durch das QFont::Weight enum definierten Bereich liegt.

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

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

Ändert den Text der Texteingabe in die Zeichenkette text. Jeder vorherige Text wird entfernt.

Anmerkungen:

• text wird als reiner Text interpretiert.
• Die Undo/Redo-Historie wird ebenfalls gelöscht.
• currentCharFormat() wird zurückgesetzt, es sei denn, textCursor() befindet sich bereits am Anfang des Dokuments.

Siehe auch toPlainText().

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

Legt die text der Textverarbeitung fest. Der Text kann normaler Text oder HTML sein und die Textverarbeitung wird versuchen, das richtige Format zu erraten.

Verwenden Sie setHtml() oder setPlainText() direkt, um das Raten der Textverarbeitung zu vermeiden.

Siehe auch toPlainText() und toHtml().

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

Setzt die Texthintergrundfarbe des aktuellen Formats auf c.

Siehe auch textBackgroundColor().

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

Setzt die Textfarbe des aktuellen Formats auf c.

Siehe auch textColor().

void QTextEdit::setTextCursor(const QTextCursor &cursor)

Legt die sichtbare cursor fest.

Siehe auch textCursor().

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

Reimplements: QWidget::showEvent(QShowEvent *event).

QColor QTextEdit::textBackgroundColor() const

Gibt die Texthintergrundfarbe des aktuellen Formats zurück.

Siehe auch setTextBackgroundColor().

[signal] void QTextEdit::textChanged()

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.

QColor QTextEdit::textColor() const

Gibt die Textfarbe des aktuellen Formats zurück.

Siehe auch setTextColor().

QTextCursor QTextEdit::textCursor() const

Gibt eine Kopie von QTextCursor zurück, die den derzeit sichtbaren Cursor darstellt. Beachten Sie, dass sich Änderungen am zurückgegebenen Cursor nicht auf den Cursor von QTextEdit auswirken; verwenden Sie setTextCursor(), um den sichtbaren Cursor zu aktualisieren.

Siehe auch setTextCursor().

QString QTextEdit::toPlainText() const

QString QTextEdit::toPlainText() const

Gibt den Text der Texteingabe als reinen Text zurück.

Siehe auch QTextEdit::setPlainText().

[slot] void QTextEdit::undo()

Macht den letzten Vorgang rückgängig.

Wenn es keinen Vorgang gibt, der rückgängig zu machen ist, d.h. wenn es keinen Rückgängig-Schritt in der Undo/Redo-Historie gibt, passiert nichts.

Siehe auch redo().

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

Dieses Signal wird ausgegeben, wenn Rückgängigmachungen verfügbar (available ist true) oder nicht verfügbar (available ist false) werden.

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

Reimplements: QAbstractScrollArea::wheelEvent(QWheelEvent *e).

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

Vergrößert den Text, indem es die Basisschriftgröße range Punkte vergrößert und alle Schriftgrößen auf die neue Größe umrechnet. Die Größe der Bilder wird dabei nicht verändert.

Siehe auch zoomOut().

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

Verkleinert den Text, indem die Basisschriftgröße range verkleinert wird und alle Schriftgrößen auf die neue Größe neu berechnet werden. Die Größe der Bilder wird dabei nicht verändert.

Siehe auch zoomIn().