QPlainTextEdit Class

Dokumentation der Mitgliedsfunktionen

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

Konstruiert ein leeres QPlainTextEdit mit übergeordnetem parent.

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

Konstruiert ein QPlainTextEdit mit übergeordnetem parent. Die Textbearbeitung zeigt den reinen Text text an.

[virtual noexcept] QPlainTextEdit::~QPlainTextEdit()

Zerstörer.

QString QPlainTextEdit::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 QPlainTextEdit::appendHtml(const QString &html)

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

appendPlainText()

[slot] void QPlainTextEdit::appendPlainText(const QString &text)

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

Siehe auch appendHtml().

[protected] QRectF QPlainTextEdit::blockBoundingGeometry(const QTextBlock &block) const

Gibt das begrenzende Rechteck des Textes block in Inhaltskoordinaten zurück. Translate the rectangle with the contentOffset() to get visual coordinates on the viewport.

Siehe auch firstVisibleBlock() und blockBoundingRect().

[protected] QRectF QPlainTextEdit::blockBoundingRect(const QTextBlock &block) const

Liefert das begrenzende Rechteck des Textes block in den eigenen Koordinaten des Blocks.

Siehe auch blockBoundingGeometry().

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

Dieses Signal wird bei jeder Änderung der Blockanzahl ausgegeben. Die neue Blockanzahl wird in newBlockCount übergeben.

[virtual protected] bool QPlainTextEdit::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 gelangt und festgestellt werden muss, ob das Ziehen akzeptiert werden kann.

bool QPlainTextEdit::canPaste() const

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

[slot] void QPlainTextEdit::centerCursor()

Scrollt das Dokument, um den Cursor vertikal zu zentrieren.

Siehe auch ensureCursorVisible() und centerOnScroll.

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

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

[slot] void QPlainTextEdit::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() und setPlainText().

[protected] QPointF QPlainTextEdit::contentOffset() const

Gibt den Ursprung des Inhalts in Ansichtsfenster-Koordinaten zurück.

Der Ursprung des Inhalts einer einfachen Textbearbeitung ist immer die linke obere Ecke des ersten sichtbaren Textblocks. Der Content-Offset ist anders als (0,0), wenn der Text horizontal gescrollt wurde, oder wenn der erste sichtbare Block teilweise aus dem Bildschirm gescrollt wurde, d.h. der sichtbare Text beginnt nicht mit der ersten Zeile des ersten sichtbaren Blocks, oder wenn der erste sichtbare Block der allererste Block ist und der Editor einen Rand anzeigt.

Siehe auch firstVisibleBlock(), horizontalScrollBar(), und verticalScrollBar().

[override virtual protected] void QPlainTextEdit::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 MyQPlainTextEdit::contextMenuEvent(QContextMenuEvent *event)
{
    QMenu *menu = createStandardContextMenu();
    menu->addAction(tr("My Menu Item"));
    //...
    menu->exec(event->globalPos());
    delete menu;
}

[slot] void QPlainTextEdit::copy()

Kopiert einen beliebigen markierten Text in die Zwischenablage.

Siehe auch copyAvailable().

[signal] void QPlainTextEdit::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 *QPlainTextEdit::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 *QPlainTextEdit::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 *QPlainTextEdit::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 QPlainTextEdit::currentCharFormat() const

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

Siehe auch setCurrentCharFormat().

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

gibt eine QTextCursor an der Position pos (in Ansichtskoordinaten) zurück.

[signal] void QPlainTextEdit::cursorPositionChanged()

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

QRect QPlainTextEdit::cursorRect() const

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

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

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

[slot] void QPlainTextEdit::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().

QTextDocument *QPlainTextEdit::document() const

Gibt einen Zeiger auf das zugrunde liegende Dokument zurück.

Siehe auch setDocument().

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

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

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

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

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

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

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

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

void QPlainTextEdit::ensureCursorVisible()

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

Siehe auch centerCursor() und centerOnScroll.

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

Liefert die zuvor eingestellten Extra-Auswahlen zurück.

Siehe auch setExtraSelections().

bool QPlainTextEdit::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 QPlainTextEdit::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.

[protected] QTextBlock QPlainTextEdit::firstVisibleBlock() const

Gibt den ersten sichtbaren Block zurück.

Siehe auch blockBoundingRect().

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

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

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

Reimplements: QWidget::focusNextPrevChild(bool next).

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

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

[protected] QAbstractTextDocumentLayout::PaintContext QPlainTextEdit::getPaintContext() const

Gibt den Farbkontext für viewport() zurück, nützlich nur bei der Neuimplementierung von paintEvent().

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

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

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

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

[virtual protected] void QPlainTextEdit::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 aus einer Drag&Drop-Operation annimmt.

[slot] void QPlainTextEdit::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 QPlainTextEdit::keyPressEvent(QKeyEvent *e)

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

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

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

[virtual] QVariant QPlainTextEdit::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 QPlainTextEdit::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().

[signal] void QPlainTextEdit::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 true ist, wurde das Dokument geändert; andernfalls ist es false.

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.

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

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

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

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

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

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

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

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

void QPlainTextEdit::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 QPlainTextEdit::paintEvent(QPaintEvent *e)

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

[slot] void QPlainTextEdit::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 QPlainTextEdit 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 QPlainTextEdit::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 QPlainTextEdit::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 QPlainTextEdit::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 QPlainTextEdit::resizeEvent(QResizeEvent *e)

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

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

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

[slot] void QPlainTextEdit::selectAll()

Markiert den gesamten Text.

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

[signal] void QPlainTextEdit::selectionChanged()

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

Siehe auch copyAvailable().

void QPlainTextEdit::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().

void QPlainTextEdit::setDocument(QTextDocument *document)

Macht document zum neuen Dokument des Texteditors.

Das übergeordnete QObject des bereitgestellten Dokuments bleibt der Eigentümer des Objekts. Wenn das aktuelle Dokument ein Kind des Texteditors ist, wird es gelöscht.

Das Dokument muss ein Dokumentenlayout haben, das QPlainTextDocumentLayout erbt (siehe QTextDocument::setDocumentLayout()).

Siehe auch document().

void QPlainTextEdit::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 QPlainTextEdit::setPlainText(const QString &text)

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

text wird als reiner Text interpretiert.

Anmerkungen:

• 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().

void QPlainTextEdit::setTextCursor(const QTextCursor &cursor)

Legt die sichtbare cursor fest.

Siehe auch textCursor().

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

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

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

QTextCursor QPlainTextEdit::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 QPlainTextEdit auswirken; verwenden Sie setTextCursor(), um den sichtbaren Cursor zu aktualisieren.

Siehe auch setTextCursor().

QString QPlainTextEdit::toPlainText() const

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

Siehe auch QPlainTextEdit::setPlainText().

[slot] void QPlainTextEdit::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 QPlainTextEdit::undoAvailable(bool available)

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

[signal] void QPlainTextEdit::updateRequest(const QRect &rect, int dy)

Dieses Signal wird ausgesendet, wenn das Textdokument eine Aktualisierung des angegebenen rect benötigt. Wenn der Text gescrollt wird, deckt rect den gesamten Bereich des Ansichtsfensters ab. Wenn der Text vertikal gescrollt wird, überträgt dy die Anzahl der Pixel, um die das Ansichtsfenster gescrollt wurde.

Der Zweck des Signals ist es, zusätzliche Widgets in Unterklassen für die Textbearbeitung zu unterstützen, die z.B. Zeilennummern, Haltepunkte oder andere zusätzliche Informationen anzeigen.

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

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

[slot] void QPlainTextEdit::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 QPlainTextEdit::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().