Sur cette page

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

Méthodes

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 :

ConstanteDescription
TextSelection.NoMoveGarder le curseur à sa position actuelle
TextSelection.StartSe déplacer au début du document.
TextSelection.StartOfLineSe déplacer au début de la ligne actuelle.
TextSelection.StartOfBlockSe placer au début du bloc actuel.
TextSelection.StartOfWordSe placer au début du mot actuel.
TextSelection.PreviousBlockSe placer au début du bloc précédent.
TextSelection.PreviousCharacterSe placer sur le caractère précédent.
TextSelection.PreviousWordSe placer au début du mot précédent.
TextSelection.UpMonter d'une ligne.
TextSelection.LeftSe déplacer d'un caractère vers la gauche.
TextSelection.WordLeftSe déplacer d'un mot vers la gauche.
TextSelection.EndAller à la fin du document.
TextSelection.EndOfLineSe déplacer à la fin de la ligne actuelle.
TextSelection.EndOfWordAller à la fin du mot actuel.
TextSelection.EndOfBlockSe déplacer à la fin du bloc actuel.
TextSelection.NextBlockAller au début du bloc suivant.
TextSelection.NextCharacterSe déplacer vers le caractère suivant.
TextSelection.NextWordSe déplacer vers le mot suivant.
TextSelection.DownDescendre d'une ligne.
TextSelection.RightSe déplacer 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 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.PreviousCellSe 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.NextRowSe déplacer vers la première nouvelle cellule de la ligne suivante du tableau actuel.
TextSelection.PreviousRowSe 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.