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

Article
08/26/2023

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

Syntaxe

HRESULT MoveLeft(
  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	Gauche	Déplacez une position de caractère vers la gauche. Il s’agit de la valeur par défaut.
tomWord	Ctrl+Gauche	Déplacez un mot vers la gauche.

Remarque : Si Le nombre est inférieur à zéro, le mouvement est à droite.

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 à droite.

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 WordBasic telles que CharRight, CharLeft, WordRight et WordLeft sont des hybrides qui peuvent effectuer quatre opérations étroitement liées au comportement de modification de touche de direction standard :

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 composée d’une seule plage, vous avez les correspondances suivantes (pour les caractères de gauche à droite).

ITextSelection	WordBasic	Fonction
Sélection. MoveRight tomWord, 1, 1	WordRight 1,1	Déplace la fin active d’un mot vers la droite.
Sélection. 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 gauche, l’appel MoveLeft ( Unit, Count) d’une sélection dégénérée déplace le point d’insertion du nombre spécifié d’unités. Sur une plage dégénérée, l’appel MoveLeft( Unit, Count, 1) où Count est supérieur à zéro entraîne la non-dégénération de la plage, l’extrémité gauche étant l’extrémité active.

Quand Étendre est tomExtend (ou est différent de zéro), MoveLeft 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, MoveLeft(Unit, Count) où Count est supérieur à zéro déplace l’extrémité Count active - 1 unités à gauche, 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, MoveLeft(tomCharacter) convertit une sélection non dégénérée en une sélection dégénérée à l’extrémité gauche 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 gauche. 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


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