Auf dieser Seite

TextSelection QML Type

Stellt eine zusammenhängende Textauswahl und deren Eigenschaften dar. Mehr...

Import Statement: import QtQuick
Since: Qt 6.7

Eigenschaften

Methoden

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:

KonstanteBeschreibung
TextSelection.NoMoveCursor an der aktuellen Position belassen
TextSelection.StartZum Anfang des Dokuments springen.
TextSelection.StartOfLineAn den Anfang der aktuellen Zeile springen.
TextSelection.StartOfBlockZum Anfang des aktuellen Blocks springen.
TextSelection.StartOfWordZum Anfang des aktuellen Wortes springen.
TextSelection.PreviousBlockSpringe zum Anfang des vorherigen Blocks.
TextSelection.PreviousCharacterZum vorherigen Zeichen springen.
TextSelection.PreviousWordSpringe an den Anfang des vorherigen Wortes.
TextSelection.UpEine Zeile nach oben springen.
TextSelection.LeftEin Zeichen nach links springen.
TextSelection.WordLeftUm ein Wort nach links springen.
TextSelection.EndZum Ende des Dokuments springen.
TextSelection.EndOfLineZum Ende der aktuellen Zeile springen.
TextSelection.EndOfWordZum Ende des aktuellen Wortes springen.
TextSelection.EndOfBlockZum Ende des aktuellen Blocks springen.
TextSelection.NextBlockZum Anfang des nächsten Blocks springen.
TextSelection.NextCharacterZum nächsten Zeichen springen.
TextSelection.NextWordZum nächsten Wort springen.
TextSelection.DownEine Zeile nach unten springen.
TextSelection.RightEin Zeichen nach rechts springen.
TextSelection.WordRightBewegen Sie den Cursor um ein Wort nach rechts.
TextSelection.NextCellSpringe 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.PreviousCellSpringe 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.NextRowSpringe zur ersten neuen Zelle der nächsten Zeile in der aktuellen Tabelle.
TextSelection.PreviousRowSpringe 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.