TextSelection QML Type
Stellt eine zusammenhängende Auswahl von Text und dessen Eigenschaften dar. Mehr...
| Import Statement: | import QtQuick |
| Since: | Qt 6.7 |
Eigenschaften
- alignment : enumeration
- color : color
- document : TextDocument
(since 6.11) - font : color
- selectionEnd : int
(since 6.11) - selectionStart : int
(since 6.11) - text : string
Methoden
- void duplicate()
(since 6.11) - void linkTo(url destination)
(since 6.11) - void moveSelectionEnd(MoveOperation op, int n)
(since 6.11) - bool moveSelectionStart(MoveOperation op, int n)
(since 6.11)
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:
| Konstante | Beschreibung |
|---|---|
TextSelection.NoMove | Den Cursor an der Stelle belassen, an der er sich befindet |
TextSelection.Start | An den Anfang des Dokuments gehen. |
TextSelection.StartOfLine | An den Anfang der aktuellen Zeile gehen. |
TextSelection.StartOfBlock | Bewegt sich zum Anfang des aktuellen Blocks. |
TextSelection.StartOfWord | Geht zum Anfang des aktuellen Wortes. |
TextSelection.PreviousBlock | Zum Anfang des vorherigen Satzes. |
TextSelection.PreviousCharacter | Sprung zum vorherigen Zeichen. |
TextSelection.PreviousWord | Sprung zum Anfang des vorherigen Wortes. |
TextSelection.Up | Eine Zeile nach oben gehen. |
TextSelection.Left | Bewegen Sie sich ein Zeichen nach links. |
TextSelection.WordLeft | Bewegen Sie sich ein Wort nach links. |
TextSelection.End | Bewegen Sie sich zum Ende des Dokuments. |
TextSelection.EndOfLine | Bewegen zum Ende der aktuellen Zeile. |
TextSelection.EndOfWord | Bewegen Sie sich zum Ende des aktuellen Wortes. |
TextSelection.EndOfBlock | Bewegen zum Ende des aktuellen Blocks. |
TextSelection.NextBlock | Geht zum Anfang des nächsten Blocks. |
TextSelection.NextCharacter | Wechseln zum nächsten Zeichen. |
TextSelection.NextWord | Wechseln zum nächsten Wort. |
TextSelection.Down | Bewegen Sie sich eine Zeile nach unten. |
TextSelection.Right | Bewegen Sie sich ein Zeichen nach rechts. |
TextSelection.WordRight | Bewegen Sie sich ein Wort nach rechts. |
TextSelection.NextCell | Bewegt 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.PreviousCell | Bewegt 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.NextRow | Bewegen Sie sich zur ersten neuen Zelle der nächsten Zeile in der aktuellen Tabelle. |
TextSelection.PreviousRow | Bewegt 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.