Interface ITextSelection (tom.h)

Une sélection de texte est une plage de texte avec sélection mise en surbrillance.

Héritage

L’interface ITextSelection hérite d’ITextRange. ITextSelection a également les types de membres suivants :

Méthodes

L’interface ITextSelection possède ces méthodes.

ITextSelection ::EndKey Imite la fonctionnalité de la clé De fin.
ITextSelection ::GetFlags Obtient les indicateurs de sélection de texte.
ITextSelection ::GetType Obtient le type de sélection de texte.
ITextSelection ::HomeKey Généralise les fonctionnalités de la clé d’accueil.
ITextSelection ::MoveDown Imite les fonctionnalités des touches Flèche bas et Page bas.
ITextSelection ::MoveLeft Généralise les fonctionnalités de la flèche gauche.
ITextSelection ::MoveRight Généralise les fonctionnalités de la touche flèche droite.
ITextSelection ::MoveUp Imite les fonctionnalités des touches Flèche haut et Page haut.
ITextSelection ::SetFlags Définit les indicateurs de sélection de texte.
ITextSelection ::TypeText Tapez la chaîne donnée par bstr à cette sélection comme si quelqu’un l’avait tapée. Cette méthode est similaire à la méthode SetText sous-jacente, mais elle est sensible à l’état de la clé Insert/Overtype et aux paramètres de l’interface utilisateur tels que la correction automatique et les guillemets intelligents.

Remarques

La sélection est associée à un type quelconque de vue et possède certaines méthodes orientées interface utilisateur qui permettent d’émuler l’entrée du clavier. Ainsi, une application peut utiliser les méthodes ITextRange sur une sélection de texte, ainsi que les méthodes ITextSelection .

Pour l’émulation d’entrée au clavier, les plages utilisées dans les sélections utilisent le concept de l’extrémité active, qui est généralement la fin qui a été déplacée pour la dernière fois. Par exemple, si une méthode ITextRange ::Move* fonctionne sur une plage qui est en fait une sélection de texte, l’extrémité la plus récemment déplacée est celle active. Les exemples les plus familiers de l’extrémité active sont ceux impliquant la gestion maj+touche de flèche, où l’extrémité active est celle qui se déplace. En conséquence, les méthodes ITextSelection incluent des méthodes de déplacement pour l’extrémité active, telles que MoveLeft ou MoveRight, et des méthodes permettant d’obtenir et de définir la fin active status. Ces méthodes manipulent les sélections de manière similaire aux opérations standard de curseur-clavier. Cela vous permet d’implémenter, par exemple, une installation d’enregistreur de macros.

Pour voir comment fonctionnent les méthodes de curseur-clavier, consultez le tableau suivant. Une méthode donnée correspond à une touche de curseur-clavier avec les touches Ctrl et Maj. Le paramètre Unit est sélectionné en appuyant ou non sur la touche Ctrl, tandis que le paramètre Étendre est sélectionné en appuyant ou non sur la touche Maj. Notez que MoveUp et MoveDown correspondent à plusieurs touches de pavé numérique. Pour plus d’informations, consultez les descriptions des méthodes.

Méthode	Touche curseur-clavier	Unité donnée par ctrl enfoncée (pas enfoncée)	Étendre donné par maj enfoncé (pas appuyé)
EndKey	End	tomStory (tomLine)	tomExtend (tomMove)
Clé d’accueil	Accueil	tomStory (tomLine)	tomExtend (tomMove)
MoveLeft	Gauche	tomWord (tomCharacter)	tomExtend (tomMove)
MoveRight	Flèche droite	tomWord (tomCharacter)	tomExtend (tomMove)
MoveUp	Flèche haut	tomParagraph (tomLine)	tomExtend (tomMove)
MoveDown	Flèche Bas	tomParagraph (tomLine)	tomExtend (tomMove)
MoveUp	Page précédente	tomWindow (tomScreen)	tomExtend (tomMove)
MoveDown	Page suivante	tomWindow (tomScreen)	tomExtend (tomMove)

 

Les applications n’implémentent généralement pas l’interface ITextSelection . Au lieu de cela, les solutions de texte Microsoft telles que les contrôles d’édition enrichi implémentent ITextSelection dans le cadre de leur implémentation tom (Text Object Model).

Les applications peuvent récupérer un pointeur ITextSelection en appelant la méthode GetSelection .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	tom.h