Sur cette page

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

Méthodes

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 :

ConstanteDescription
TextSelection.NoMoveMaintient le curseur à l'endroit où il se trouve
TextSelection.StartSe déplace au début du document.
TextSelection.StartOfLineSe déplacer au début de la ligne en cours.
TextSelection.StartOfBlockSe déplacer au début du bloc actuel.
TextSelection.StartOfWordAller au début du mot en cours.
TextSelection.PreviousBlockAller au début du bloc précédent.
TextSelection.PreviousCharacterAller au caractère précédent.
TextSelection.PreviousWordAller au début du mot précédent.
TextSelection.UpRemonter d'une ligne.
TextSelection.LeftDéplacement d'un caractère vers la gauche.
TextSelection.WordLeftSe déplacer d'un mot vers la gauche.
TextSelection.EndAller à la fin du document.
TextSelection.EndOfLineAller à la fin de la ligne en cours.
TextSelection.EndOfWordAller à la fin du mot en cours.
TextSelection.EndOfBlockAller à la fin du bloc en cours.
TextSelection.NextBlockSe déplacer au début du bloc suivant.
TextSelection.NextCharacterPasser au caractère suivant.
TextSelection.NextWordPasser au mot suivant.
TextSelection.DownDescendre d'une ligne.
TextSelection.RightDéplacement d'un caractère vers la droite.
TextSelection.WordRightSe déplacer d'un mot vers la droite.
TextSelection.NextCellSe 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.PreviousCellSe 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.NextRowSe déplacer vers la première nouvelle cellule de la ligne suivante dans le tableau actuel.
TextSelection.PreviousRowDé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.