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 |