QPlainTextEdit Class

Dokumentation zu den Member-Funktionen

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

Erstellt ein leeres „QPlainTextEdit“-Objekt, dessen übergeordnetes Element „ parent “ ist.

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

Erstellt ein `QPlainTextEdit`-Objekt, dessen übergeordnetes Element ` parent` ist. Das Textfeld zeigt den Klartext ` text` an.

[virtual noexcept] QPlainTextEdit::~QPlainTextEdit()

Destruktor.

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

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

[slot] void QPlainTextEdit::appendHtml(const QString &html)

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

appendPlainText()

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

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

Siehe auch ` appendHtml()`.

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

Gibt das Begrenzungsrechteck des Text- block s in Inhaltskoordinaten zurück. Verschieben Sie das Rechteck mit der Funktion „ contentOffset “ (), um visuelle Koordinaten im Ansichtsbereich zu erhalten.

Siehe auch ` firstVisibleBlock()` und ` blockBoundingRect()`.

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

Gibt das Begrenzungsrechteck des Textes „ block “ in den blockeigenen Koordinaten zurück.

Siehe auch ` blockBoundingGeometry()`.

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

Dieses Signal wird immer dann ausgelöst, wenn sich die Blockanzahl ändert. 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 beispielsweise aufgerufen, wenn die Maus während eines Drag-Vorgangs in dieses Widget gelangt und festgestellt werden muss, ob der Drag-Vorgang akzeptiert werden kann.

bool QPlainTextEdit::canPaste() const

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

[slot] void QPlainTextEdit::centerCursor()

Blättert im Dokument, um den Cursor vertikal zu zentrieren.

Siehe auch ensureCursorVisible() und centerOnScroll.

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

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

[slot] void QPlainTextEdit::clear()

Löscht den gesamten Text im Textfeld.

Hinweise:

• Der Rückgängig-/Wiederherstellen-Verlauf 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 Viewport-Koordinaten zurück.

Der Ursprung des Inhalts eines Klartext-Bearbeitungsfelds ist immer die obere linke Ecke des ersten sichtbaren Textblocks. Der Offset des Inhalts weicht von (0,0) ab, wenn der Text horizontal gescrollt wurde oder wenn der erste sichtbare Block teilweise aus dem Bildschirm herausgescrollt 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)

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

[slot] void QPlainTextEdit::copy()

Kopiert den ausgewählten Text in die Zwischenablage.

Siehe auch copyAvailable().

[signal] void QPlainTextEdit::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 *QPlainTextEdit::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 muss; beispielsweise beim Starten einer Drag-and-Drop-Operation oder beim Kopieren von Daten in die Zwischenablage.

Wenn Sie diese Funktion neu implementieren, beachten Sie bitte, dass die Eigentümerschaft am zurückgegebenen „ QMimeData “-Objekt an den Aufrufer übergeben wird. Die Auswahl kann mithilfe 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 das Textfeld klickt. Sie wird vom Standard-Handler „ contextMenuEvent()“ aufgerufen. Die Eigentumsrechte am Popup-Menü werden an den Aufrufer übertragen.

Wir empfehlen Ihnen, stattdessen die Version createStandardContextMenu(QPoint) zu verwenden, die Aktionen ermöglicht, 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 das Textfeld klickt. Sie wird vom Standard-Handler „ contextMenuEvent()“ aufgerufen und erhält die Koordinaten „ position “ in Dokumentkoordinaten, an denen der Mausklick erfolgte. Dadurch können Aktionen aktiviert werden, die von der Position abhängen, an der der Benutzer geklickt hat. Die Eigentumsrechte am Popup-Menü werden 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 ein „ QTextCursor “ an der Position „ pos “ (in Viewport-Koordinaten) zurück.

[signal] void QPlainTextEdit::cursorPositionChanged()

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

QRect QPlainTextEdit::cursorRect() const

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

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

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

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

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)

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

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

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

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

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

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

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

void QPlainTextEdit::ensureCursorVisible()

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

Siehe auch centerCursor() und centerOnScroll.

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

Gibt zuvor festgelegte zusätzliche Auswahlen zurück.

Siehe auch setExtraSelections().

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

Sucht das nächste Vorkommen der Zeichenfolge „ exp “ unter Verwendung der 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 QPlainTextEdit::find(const QRegularExpression &exp, QTextDocument::FindFlags options = QTextDocument::FindFlags())

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

Gibt „ true “ zurück, wenn eine Übereinstimmung gefunden wurde, und setzt den Cursor so, dass die Übereinstimmung markiert ist; 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)

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

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

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

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

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

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

Gibt den Zeichenkontext für die Funktion „ viewport()“ zurück; dies ist nur bei der Neuimplementierung von „ paintEvent()“ von Bedeutung.

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

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

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

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

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

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

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

Dies entspricht

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

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

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

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

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

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

Siehe auch QTextDocument::loadResource().

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

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

Dieses Signal wird immer dann ausgelöst, wenn sich der Inhalt des Dokuments in einer Weise ändert, die sich auf den Änderungsstatus auswirkt. Ist „ changed “ wahr, wurde das Dokument geändert; andernfalls ist der Wert falsch.

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

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

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

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

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

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

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

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

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

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

Umsetzt: ` QAbstractScrollArea::paintEvent` (`QPaintEvent *event`).

[slot] void QPlainTextEdit::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 „ QPlainTextEdit “ einfügen kann und wie dies geschieht, implementieren Sie die virtuellen Funktionen „ canInsertFromMimeData “() und „ insertFromMimeData “() neu.

Siehe auch cut() und copy().

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

Führt die letzte Aktion erneut aus.

Wenn keine Operation wiederhergestellt werden kann, d. h. wenn im Undo-/Redo-Verlauf kein Wiederherstellungsschritt vorhanden ist, geschieht nichts.

Siehe auch ` undo()`.

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

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

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

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

[slot] void QPlainTextEdit::selectAll()

Wählt den gesamten Text aus.

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

[signal] void QPlainTextEdit::selectionChanged()

Dieses Signal wird immer dann 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 “ 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()`.

void QPlainTextEdit::setDocument(QTextDocument *document)

Macht document zum neuen Dokument des Texteditors.

Das übergeordnete Dokument „ QObject “ des angegebenen Dokuments bleibt Eigentümer des Objekts. Ist das aktuelle Dokument ein untergeordnetes Dokument des Texteditors, wird es gelöscht.

Das Dokument muss über ein Dokumentlayout verfügen, das von „ QPlainTextDocumentLayout “ erbt (siehe „ QTextDocument::setDocumentLayout()“).

Siehe auch document().

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

Ändert den Text im Textfeld in die Zeichenfolge „ text “. Der bisherige Text wird entfernt.

text wird als Klartext interpretiert.

Hinweise:

• Der Rückgängig-/Wiederherstellungsverlauf 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 den sichtbaren cursor fest.

Siehe auch ` textCursor()`.

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

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

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

QTextCursor QPlainTextEdit::textCursor() const

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

Siehe auch setTextCursor().

QString QPlainTextEdit::toPlainText() const

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

Siehe auch ` QPlainTextEdit::setPlainText()`.

[slot] void QPlainTextEdit::undo()

Macht den letzten Vorgang rückgängig.

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

Siehe auch ` redo()`.

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

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

Dieses Signal wird ausgelöst, wenn das Textdokument eine Aktualisierung des angegebenen „ rect “ benötigt. Wenn der Text horizontal gescrollt wird, deckt „ rect “ den gesamten Viewport-Bereich ab. Wenn der Text vertikal gescrollt wird, enthält „ dy “ die Anzahl der Pixel, um die der Viewport gescrollt wurde.

Der Zweck des Signals besteht darin, zusätzliche Widgets in Unterklassen der Plain-Text-Edit-Klasse zu unterstützen, die z. B. Zeilennummern, Haltepunkte oder andere Zusatzinformationen anzeigen.

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

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

[slot] void QPlainTextEdit::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 QPlainTextEdit::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 bleibt dabei unverändert.

Siehe auch zoomIn().