TextSelection QML Type
Stellt eine zusammenhängende Textauswahl und deren 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)
Ausführliche Beschreibung
TextEdit.cursorSelection Stellt den derzeit ausgewählten Textbereich dar (z. B. durch Ziehen mit der Maus). Er kann verwendet werden, um den ausgewählten Text sowie Eigenschaften in den Formaten „ character “ und „ block “ abzufragen und zu ändern.
Darüber hinaus ist es seit Version 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 sowie Eigenschaften in den Formaten ` character ` und ` block ` abzufragen und zu ändern.
Hinweis: Diese API gilt als „Tech Preview“ und kann sich in zukünftigen Versionen von Qt ändern oder entfernt werden.
Siehe auch „ TextEdit “ und „ QTextCursor “.
Dokumentation zu den Eigenschaften
alignment : enumeration
Die Ausrichtung des Blocks, der den ausgewählten Text enthält.
Siehe auch QTextBlockFormat::alignment().
color : color
Die Vordergrundfarbe des markierten Textes.
Siehe auch „ QTextCharFormat::foreground()“.
document : TextDocument [since 6.11]
Das ` QQuickTextDocument `, das 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 ausgewählte Text ohne Rich-Text-Markup.
Durch das Setzen dieser Eigenschaft wird der ausgewählte Text durch die angegebene Zeichenfolge ersetzt.
Methodendokumentation
[since 6.11] void duplicate()
Kopiere den ausgewählten Text nach vorne, wobei die gesamte Formatierung in der Kopie erhalten bleibt, und setze die Auswahl auf die Kopie.
Wenn beispielsweise eine ganze Zeile ausgewählt ist, fügt diese Funktion eine Kopie dieser Zeile unmittelbar darunter ein und markiert die Kopie. Wenn ein Wort ausgewählt 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)
Erstellen Sie einen Hyperlink vom ausgewählten 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)
Verschiebe selectionEnd n -mal gemäß op, was einer der Enum-Werte ist, wie sie in moveSelectionStart() verwendet werden.
Wenn moveSelectionStart() unmittelbar zuvor aufgerufen wurde, selectionEnd == selectionStart, und diese Funktion verschiebt den Cursor von dort, sodass 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)
Text abwählen und selectionStart n -mal gemäß op verschieben, wobei es sich um einen der folgenden Enum-Werte handelt:
| Konstante | Beschreibung |
|---|---|
TextSelection.NoMove | Cursor an der aktuellen Position belassen |
TextSelection.Start | Zum Anfang des Dokuments springen. |
TextSelection.StartOfLine | An den Anfang der aktuellen Zeile springen. |
TextSelection.StartOfBlock | Zum Anfang des aktuellen Blocks springen. |
TextSelection.StartOfWord | Zum Anfang des aktuellen Wortes springen. |
TextSelection.PreviousBlock | Springe zum Anfang des vorherigen Blocks. |
TextSelection.PreviousCharacter | Zum vorherigen Zeichen springen. |
TextSelection.PreviousWord | Springe an den Anfang des vorherigen Wortes. |
TextSelection.Up | Eine Zeile nach oben springen. |
TextSelection.Left | Ein Zeichen nach links springen. |
TextSelection.WordLeft | Um ein Wort nach links springen. |
TextSelection.End | Zum Ende des Dokuments springen. |
TextSelection.EndOfLine | Zum Ende der aktuellen Zeile springen. |
TextSelection.EndOfWord | Zum Ende des aktuellen Wortes springen. |
TextSelection.EndOfBlock | Zum Ende des aktuellen Blocks springen. |
TextSelection.NextBlock | Zum Anfang des nächsten Blocks springen. |
TextSelection.NextCharacter | Zum nächsten Zeichen springen. |
TextSelection.NextWord | Zum nächsten Wort springen. |
TextSelection.Down | Eine Zeile nach unten springen. |
TextSelection.Right | Ein Zeichen nach rechts springen. |
TextSelection.WordRight | Bewegen Sie den Cursor um ein Wort nach rechts. |
TextSelection.NextCell | Springe zum Anfang der nächsten Tabellenzelle innerhalb der aktuellen Tabelle. Wenn die aktuelle Zelle die letzte Zelle in der Zeile ist, springt der Cursor zur ersten Zelle in der nächsten Zeile. |
TextSelection.PreviousCell | Springe zum Anfang der vorherigen Tabellenzelle innerhalb der aktuellen Tabelle. Wenn die aktuelle Zelle die erste Zelle der Zeile ist, springt der Cursor zur letzten Zelle der vorherigen Zeile. |
TextSelection.NextRow | Springe zur ersten neuen Zelle der nächsten Zeile in der aktuellen Tabelle. |
TextSelection.PreviousRow | Springe zur letzten 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.