TextSelection QML Type
Représente une sélection de texte contiguë ainsi que ses propriétés. En savoir plus…
| Import Statement: | import QtQuick |
| Since: | Qt 6.7 |
Propriétés
- alignment : enumeration
- color : color
- document : TextDocument
(since 6.11) - font : color
- selectionEnd : int
(since 6.11) - selectionStart : int
(since 6.11) - text : string
Méthodes
- 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)
Description détaillée
TextEdit.cursorSelection représente la portion de texte actuellement sélectionnée (par exemple en faisant glisser la souris). Elle peut être utilisée pour interroger et modifier le texte sélectionné, ainsi que les propriétés aux formats character et block.
De plus, depuis la version 6.11, il est possible de créer des instances non visuelles explicites :
TextEdit {
id: textEdit
TextSelection {
id: sel1
}
}TextEdit.cursorSelection et toute instance explicite de `TextSelection` peut être utilisée pour interroger et modifier les portions de texte spécifiées, ainsi que les propriétés des formats ` character ` et ` block `.
Remarque : cette API est considérée comme une préversion technique et est susceptible d’être modifiée ou supprimée dans les futures versions de Qt.
Voir également TextEdit et QTextCursor.
Documentation sur les propriétés
alignment : enumeration
L'alignement du bloc contenant le texte sélectionné.
Voir également QTextBlockFormat::alignment().
color : color
La couleur de premier plan du texte sélectionné.
Voir aussi QTextCharFormat::foreground().
document : TextDocument [since 6.11]
L'QQuickTextDocument e qui contient le texte sélectionné.
Cette propriété a été introduite dans Qt 6.11.
Voir également QtQuick::TextEdit::textDocument.
font : color
La police du texte sélectionné.
Voir aussi QTextCharFormat::font().
selectionEnd : int [since 6.11]
La position située après le dernier caractère de la sélection.
Cette propriété a été introduite dans Qt 6.11.
Voir également QtQuick::TextEdit::selectionEnd.
selectionStart : int [since 6.11]
La position située avant le premier caractère de la sélection.
Cette propriété a été introduite dans Qt 6.11.
Voir également QtQuick::TextEdit::selectionStart.
text : string
Le texte sélectionné, sans aucun balisage de texte enrichi.
La définition de cette propriété remplace le texte sélectionné par la chaîne de caractères indiquée.
Documentation de la méthode
[since 6.11] void duplicate()
Copier le texte sélectionné vers l'avant, en conservant toute la mise en forme dans la copie, et terminer en sélectionnant la copie.
Par exemple, si une ligne entière est sélectionnée, cette fonction insère une copie de cette ligne immédiatement en dessous et sélectionne cette copie. Si un mot est sélectionné, cette fonction le copie à droite et le sélectionne.
Cette méthode a été introduite dans Qt 6.11.
[since 6.11] void linkTo(url destination)
Créer un lien hypertexte à partir du texte sélectionné vers destination.
Cette méthode a été introduite dans Qt 6.11.
Voir également QTextCharFormat::setAnchorHref().
[since 6.11] void moveSelectionEnd(MoveOperation op, int n)
Déplacer selectionEnd n fois selon op, qui est l'une des valeurs de l'énumération utilisées dans moveSelectionStart().
Si la fonction moveSelectionStart() a été appelée juste avant, selectionEnd == selectionStart, et cette fonction le déplace de cet emplacement afin qu’une portion de texte soit sélectionnée.
Cette méthode a été introduite dans Qt 6.11.
Voir également QTextCursor::movePosition, QTextCursor::KeepAnchor, moveSelectionStart() et QTextCursor::MoveOperation.
[since 6.11] bool moveSelectionStart(MoveOperation op, int n)
Désélectionnez le texte et déplacez- selectionStart n fois selon op, qui correspond à l'une des valeurs suivantes de l'énumération :
| Constante | Description |
|---|---|
TextSelection.NoMove | Garder le curseur à sa position actuelle |
TextSelection.Start | Se déplacer au début du document. |
TextSelection.StartOfLine | Se déplacer au début de la ligne actuelle. |
TextSelection.StartOfBlock | Se placer au début du bloc actuel. |
TextSelection.StartOfWord | Se placer au début du mot actuel. |
TextSelection.PreviousBlock | Se placer au début du bloc précédent. |
TextSelection.PreviousCharacter | Se placer sur le caractère précédent. |
TextSelection.PreviousWord | Se placer au début du mot précédent. |
TextSelection.Up | Monter d'une ligne. |
TextSelection.Left | Se déplacer d'un caractère vers la gauche. |
TextSelection.WordLeft | Se déplacer d'un mot vers la gauche. |
TextSelection.End | Aller à la fin du document. |
TextSelection.EndOfLine | Se déplacer à la fin de la ligne actuelle. |
TextSelection.EndOfWord | Aller à la fin du mot actuel. |
TextSelection.EndOfBlock | Se déplacer à la fin du bloc actuel. |
TextSelection.NextBlock | Aller au début du bloc suivant. |
TextSelection.NextCharacter | Se déplacer vers le caractère suivant. |
TextSelection.NextWord | Se déplacer vers le mot suivant. |
TextSelection.Down | Descendre d'une ligne. |
TextSelection.Right | Se déplacer d'un caractère vers la droite. |
TextSelection.WordRight | Se déplacer d'un mot vers la droite. |
TextSelection.NextCell | Se déplacer au début de la cellule suivante du tableau actuel. Si la cellule actuelle est la dernière de la ligne, le curseur se déplacera vers la première cellule de la ligne suivante. |
TextSelection.PreviousCell | Se déplacer au début de la cellule précédente du tableau actuel. Si la cellule actuelle est la première de la ligne, le curseur se place sur la dernière cellule de la ligne précédente. |
TextSelection.NextRow | Se déplacer vers la première nouvelle cellule de la ligne suivante du tableau actuel. |
TextSelection.PreviousRow | Se déplace vers la dernière cellule de la ligne précédente du tableau actuel. |
Renvoie ` true ` si toutes les opérations ont été effectuées avec succès ; sinon, renvoie ` false`.
Cette méthode a été introduite dans Qt 6.11.
Voir également QTextCursor::movePosition, QTextCursor::MoveAnchor et 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.