Auf dieser Seite

TextSelection QML Type

Stellt eine zusammenhängende Auswahl von Text und dessen Eigenschaften dar. Mehr...

Import Statement: import QtQuick
Since: Qt 6.7

Eigenschaften

Methoden

Detaillierte Beschreibung

TextEdit.cursorSelection stellt den Bereich des Textes dar, der gerade ausgewählt ist (z.B. durch Ziehen mit der Maus). Er kann zum Abfragen und Ändern des markierten Textes sowie der Eigenschaften in den Formaten character und block verwendet werden.

Zusätzlich ist es seit 6.11 möglich, explizite nicht-visuelle Instanzen zu erstellen:

TextEdit {
    id: textEdit

    TextSelection {
        id: sel1
    }
}

TextEdit.cursorSelection und alle expliziten TextSelection-Instanzen können verwendet werden, um die angegebenen Textbereiche abzufragen und zu ändern, sowie Eigenschaften in den Formaten character und block.

Hinweis: Diese API wird als technische Vorschau betrachtet und kann sich in zukünftigen Versionen von Qt ändern oder entfernt werden.

Siehe auch TextEdit und QTextCursor.

Dokumentation zu Eigenschaften

alignment : enumeration

Die Ausrichtung des Blocks, der den markierten Text enthält.

Siehe auch QTextBlockFormat::alignment().

color : color

Die Vordergrundfarbe des markierten Textes.

Siehe auch QTextCharFormat::foreground().

document : TextDocument [since 6.11]

Die QQuickTextDocument, die den ausgewählten Text enthält.

Diese Eigenschaft wurde in Qt 6.11 eingeführt.

Siehe auch QtQuick::TextEdit::textDocument.

font : color

Die Schriftart des ausgewählten Textes.

Siehe auch QTextCharFormat::font().

selectionEnd : int [since 6.11]

Die Position nach dem letzten Zeichen in der Auswahl.

Diese Eigenschaft wurde in Qt 6.11 eingeführt.

Siehe auch QtQuick::TextEdit::selectionEnd.

selectionStart : int [since 6.11]

Die Position vor dem ersten Zeichen in der Auswahl.

Diese Eigenschaft wurde in Qt 6.11 eingeführt.

Siehe auch QtQuick::TextEdit::selectionStart.

text : string

Der markierte Text, ohne Rich-Text-Auszeichnung.

Wenn Sie diese Eigenschaft setzen, wird der markierte Text durch die angegebene Zeichenfolge ersetzt.

Dokumentation der Methode

[since 6.11] void duplicate()

Kopiert den markierten Text vorwärts, wobei alle Formatierungen in der Kopie erhalten bleiben, und endet mit der Kopie als Auswahl.

Wenn beispielsweise eine ganze Zeile markiert ist, fügt diese Funktion eine Kopie dieser Zeile unmittelbar darunter ein und markiert die Kopie. Wenn ein Wort markiert ist, kopiert diese Funktion es nach rechts und markiert es.

Diese Methode wurde in Qt 6.11 eingeführt.

[since 6.11] void linkTo(url destination)

Erstellt einen Hyperlink vom markierten Text zu destination.

Diese Methode wurde in Qt 6.11 eingeführt.

Siehe auch QTextCharFormat::setAnchorHref().

[since 6.11] void moveSelectionEnd(MoveOperation op, int n)

Verschiebt selectionEnd n mal entsprechend op, was einer der Enum-Werte ist, die in moveSelectionStart() verwendet werden.

Wenn moveSelectionStart() unmittelbar vorher aufgerufen wurde, selectionEnd == selectionStart, und diese Funktion verschiebt es von dort, so dass ein Textbereich ausgewählt wird.

Diese Methode wurde in Qt 6.11 eingeführt.

Siehe auch QTextCursor::movePosition, QTextCursor::KeepAnchor, moveSelectionStart(), und QTextCursor::MoveOperation.

[since 6.11] bool moveSelectionStart(MoveOperation op, int n)

Heben Sie die Markierung des Textes auf und verschieben Sie selectionStart n mal entsprechend op, was einer der folgenden Enum-Werte ist:

KonstanteBeschreibung
TextSelection.NoMoveDen Cursor an der Stelle belassen, an der er sich befindet
TextSelection.StartAn den Anfang des Dokuments gehen.
TextSelection.StartOfLineAn den Anfang der aktuellen Zeile gehen.
TextSelection.StartOfBlockBewegt sich zum Anfang des aktuellen Blocks.
TextSelection.StartOfWordGeht zum Anfang des aktuellen Wortes.
TextSelection.PreviousBlockZum Anfang des vorherigen Satzes.
TextSelection.PreviousCharacterSprung zum vorherigen Zeichen.
TextSelection.PreviousWordSprung zum Anfang des vorherigen Wortes.
TextSelection.UpEine Zeile nach oben gehen.
TextSelection.LeftBewegen Sie sich ein Zeichen nach links.
TextSelection.WordLeftBewegen Sie sich ein Wort nach links.
TextSelection.EndBewegen Sie sich zum Ende des Dokuments.
TextSelection.EndOfLineBewegen zum Ende der aktuellen Zeile.
TextSelection.EndOfWordBewegen Sie sich zum Ende des aktuellen Wortes.
TextSelection.EndOfBlockBewegen zum Ende des aktuellen Blocks.
TextSelection.NextBlockGeht zum Anfang des nächsten Blocks.
TextSelection.NextCharacterWechseln zum nächsten Zeichen.
TextSelection.NextWordWechseln zum nächsten Wort.
TextSelection.DownBewegen Sie sich eine Zeile nach unten.
TextSelection.RightBewegen Sie sich ein Zeichen nach rechts.
TextSelection.WordRightBewegen Sie sich ein Wort nach rechts.
TextSelection.NextCellBewegt sich an den Anfang der nächsten Tabellenzelle innerhalb der aktuellen Tabelle. Wenn die aktuelle Zelle die letzte Zelle in der Zeile ist, bewegt sich der Cursor auf die erste Zelle in der nächsten Zeile.
TextSelection.PreviousCellBewegt sich zum Anfang der vorherigen Tabellenzelle innerhalb der aktuellen Tabelle. Wenn die aktuelle Zelle die erste Zelle in der Zeile ist, bewegt sich der Cursor auf die letzte Zelle in der vorherigen Zeile.
TextSelection.NextRowBewegen Sie sich zur ersten neuen Zelle der nächsten Zeile in der aktuellen Tabelle.
TextSelection.PreviousRowBewegt sich auf die letzte Zelle der vorherigen Zeile in der aktuellen Tabelle.

Gibt true zurück, wenn alle Operationen erfolgreich abgeschlossen wurden; andernfalls wird false zurückgegeben.

Diese Methode wurde in Qt 6.11 eingeführt.

Siehe auch QTextCursor::movePosition, QTextCursor::MoveAnchor, und QTextCursor::MoveOperation.

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