Méthode ITextSelection ::MoveRight (tom.h)

Article
08/26/2023

Généralise les fonctionnalités de la touche flèche droite.

Syntaxe

HRESULT MoveRight(
  long Unit,
  long Count,
  long Extend,
  long *pDelta
);

Paramètres

Unit

Type : long

Unité à utiliser. Il peut s’agir de l’un des éléments suivants.

Valeur	Combinaison de touches correspondante	Signification
tomCharacter	Flèche droite	Déplacez une position de caractère vers la droite. Il s’agit de la valeur par défaut.
tomWord	Ctrl+Droite	Déplacez un mot vers la droite.

Notez que si Le nombre est inférieur à zéro, le mouvement se trouve à gauche.

Count

Type : long

Nombre d’unités à passer. La valeur par défaut est 1. Si Le nombre est inférieur à zéro, le mouvement se trouve à gauche.

Extend

Type : long

Indicateur qui indique comment modifier la sélection. Si Extend a la valeur zéro (ou tomMove), la méthode réduit la sélection à un point d’insertion à l’extrémité active, puis la déplace. Si l’extension a la valeur 1 (ou tomExtend), la méthode déplace l’extrémité active et laisse l’autre extrémité seule. La valeur par défaut est zéro. Une valeur Extend différente de zéro correspond à la touche Maj enfoncée en plus de la combinaison de touches décrite dans Unité.

pDelta

Type : long*

Le nombre réel d’unités du point d’insertion ou de l’extrémité active est déplacé vers la gauche. Ce paramètre peut avoir la valeur Null. L’effondrement de la sélection, quand Étendre a la valeur 0, compte comme une unité.

Valeur retournée

Type : HRESULT

La méthode retourne une valeur HRESULT . Si la méthode réussit, elle retourne S_OK. Si la méthode échoue, elle retourne l’un des codes d’erreur suivants. Pour plus d’informations sur les codes d’erreur COM, consultez Gestion des erreurs dans COM.

Code de retour	Description
E_INVALIDARG	L’unité n’est pas valide.
S_FALSE	Échec pour une autre raison.

Remarques

Les méthodes de déplacement Microsoft WordBasic telles que CharRight, CharLeft, WordRight et WordLeft sont des hybrides qui peuvent effectuer quatre opérations étroitement liées au comportement de modification standard des touches de direction :

Déplacez le point d’insertion actuel s’il n’y a pas de sélection.
Déplacez l’extrémité active de la sélection s’il existe une sélection.
Transformer un point d’insertion en sélection et vice versa.
Retourne une valeur booléenne indiquant si un mouvement s’est produit.

L’argument Extend de MoveLeft et MoveRight vous permet d’être cohérent avec les trois premiers éléments ci-dessus, et le pDelta est une généralisation du quatrième. Par exemple, avec une sélection, s, composée d’une seule plage, vous avez les correspondances suivantes (pour les caractères de gauche à droite).

ITextSelection	WordBasic	Fonction
s.MoveRight tomWord, 1, 1	WordRight 1,1	Déplace la fin active d’un mot vers la droite.
s.MoveLeft tomCharacter, 1, 1	CharLeft 1,1	Déplace la fin active d’un caractère vers la gauche.

Comme dans WordBasic, si Count est inférieur à zéro, les significations de gauche et de droite sont échangées, ce qui équivaut MoveLeft (Unit, Count, Extend) à MoveRight(Unit, -Count, Extend).

Comme pour WordBasic et le comportement de l’interface utilisateur de la touche flèche droite, l’appel MoveRight(Unit, Count) d’une sélection dégénérée déplace le point d’insertion du nombre d’unités spécifié. Sur une plage dégénérée, l’appel MoveRight(Unit, Count, 1) où Count est supérieur à zéro fait que la plage devient non dégénérée, l’extrémité droite étant l’extrémité active.

Lorsque l’extension est tomExtend (ou n’est pas nulle), MoveRight déplace uniquement l’extrémité active de la sélection, laissant l’autre extrémité là où elle se trouve. Toutefois, si Étendre est égal à zéro et que la sélection commence comme une plage non dégénérée, MoveRight(Unit, Count) où Count est supérieur à zéro déplace l’extrémité Count active - 1 unités vers la droite, puis déplace l’autre extrémité vers l’extrémité active. En d’autres termes, il crée un point d’insertion à l’extrémité active. La réduction de la plage compte comme une unité. Ainsi, MoveRight(tomCharacter) convertit une sélection non dégénérée en une sélection dégénérée à l’extrémité droite de la sélection. Ici, Count a la valeur par défaut 1 et Extend a la valeur par défaut de zéro. Cet exemple correspond à appuyer sur la flèche droite. MoveLeft et MoveRight sont liés aux méthodes de déplacement ITextRange , mais diffèrent en ce qu’ils utilisent explicitement l’extrémité active (la fin déplacée en appuyant sur la touche Maj).

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
DLL	Msftedit.dll