TextSelection QML Type
Représente une sélection contiguë de texte et ses propriétés. Plus d'informations...
| 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 plage de texte actuellement sélectionnée (par exemple en faisant glisser la souris). Il peut être utilisé pour interroger et modifier le texte sélectionné, ainsi que les propriétés aux formats character et block.
En outre, depuis la version 6.11, il est possible de créer des instances explicites non visuelles :
TextEdit { id: textEdit TextSelection { id: sel1 } }
TextEdit.cursorSelection et toutes les instances TextSelection explicites peuvent être utilisées pour interroger et modifier les plages de texte spécifiées, ainsi que les propriétés aux formats character et block.
Remarque : cette API est considérée comme un aperçu technique et peut ê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 aussi QTextBlockFormat::alignment().
color : color
La couleur d'avant-plan du texte sélectionné.
Voir également QTextCharFormat::foreground().
document : TextDocument [since 6.11]
Le site QQuickTextDocument qui contient le texte sélectionné.
Cette propriété a été introduite dans Qt 6.11.
Voir aussi QtQuick::TextEdit::textDocument.
font : color
La police du texte sélectionné.
Voir aussi QTextCharFormat::font().
selectionEnd : int [since 6.11]
La position après le dernier caractère de la sélection.
Cette propriété a été introduite dans Qt 6.11.
Voir aussi QtQuick::TextEdit::selectionEnd.
selectionStart : int [since 6.11]
La position avant le premier caractère de la sélection.
Cette propriété a été introduite dans Qt 6.11.
Voir aussi QtQuick::TextEdit::selectionStart.
text : string
Le texte sélectionné, sans aucune marque de texte riche.
La définition de cette propriété remplace le texte sélectionné par la chaîne de caractères donnée.
Documentation de la méthode
[since 6.11] void duplicate()
Copier le texte sélectionné vers l'avant, en conservant toutes les mises en forme intactes dans la copie, et terminer avec la copie comme sélection.
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 la 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 aussi QTextCharFormat::setAnchorHref().
[since 6.11] void moveSelectionEnd(MoveOperation op, int n)
Déplace selectionEnd n fois en fonction de op, qui est l'une des valeurs de l'énumération utilisée dans moveSelectionStart().
Si moveSelectionStart() a été appelé immédiatement avant, selectionEnd == selectionStart, et cette fonction le déplace à partir de là de manière à ce qu'une plage de texte soit sélectionnée.
Cette méthode a été introduite dans Qt 6.11.
Voir aussi QTextCursor::movePosition, QTextCursor::KeepAnchor, moveSelectionStart(), et QTextCursor::MoveOperation.
[since 6.11] bool moveSelectionStart(MoveOperation op, int n)
Désélectionner le texte et déplacer selectionStart n fois en fonction de op, qui est l'une des valeurs enum suivantes :
| Constante | Description |
|---|---|
TextSelection.NoMove | Maintient le curseur à l'endroit où il se trouve |
TextSelection.Start | Se déplace au début du document. |
TextSelection.StartOfLine | Se déplacer au début de la ligne en cours. |
TextSelection.StartOfBlock | Se déplacer au début du bloc actuel. |
TextSelection.StartOfWord | Aller au début du mot en cours. |
TextSelection.PreviousBlock | Aller au début du bloc précédent. |
TextSelection.PreviousCharacter | Aller au caractère précédent. |
TextSelection.PreviousWord | Aller au début du mot précédent. |
TextSelection.Up | Remonter d'une ligne. |
TextSelection.Left | Déplacement 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 | Aller à la fin de la ligne en cours. |
TextSelection.EndOfWord | Aller à la fin du mot en cours. |
TextSelection.EndOfBlock | Aller à la fin du bloc en cours. |
TextSelection.NextBlock | Se déplacer au début du bloc suivant. |
TextSelection.NextCharacter | Passer au caractère suivant. |
TextSelection.NextWord | Passer au mot suivant. |
TextSelection.Down | Descendre d'une ligne. |
TextSelection.Right | Déplacement 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 à l'intérieur du tableau actuel. Si la cellule actuelle est la dernière cellule de la ligne, le curseur se déplace vers la première cellule de la ligne suivante. |
TextSelection.PreviousCell | Se déplacer au début de la cellule du tableau précédent dans le tableau actuel. Si la cellule actuelle est la première cellule de la ligne, le curseur se déplace vers 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 dans le tableau actuel. |
TextSelection.PreviousRow | Déplacement vers la dernière cellule de la ligne précédente dans le 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 aussi 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.