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

Article
03/03/2024

Imite les fonctionnalités des touches Flèche bas et Page bas.

Syntaxe

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

Paramètres

Unit

Type : long

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

Valeur	Combinaison de touches correspondante	Signification
tomLine	Flèche Bas	Se déplace d’une ligne vers le bas. Il s’agit de la valeur par défaut.
tomParagraph	Ctrl+Bas	Déplace un paragraphe vers le bas.
tomScreen	Page suivante	Se déplace vers le bas d’un écran.
tomWindow	Ctrl+Page bas	Passe au dernier caractère de la fenêtre.

Count

Type : long

Nombre d’unités à passer. La valeur par défaut est 1.

Extend

Type : long

Indicateur qui indique comment modifier la sélection. Si Étendre a la valeur zéro (ou tomMove), la méthode réduit la sélection à un point d’insertion, puis se 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*

Pointeur vers une variable qui reçoit le nombre réel d’unités dont le point d’insertion ou l’extrémité active est déplacé vers le bas. L’effondrement de la sélection compte comme une unité. Ce paramètre peut avoir la valeur Null.

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 ITextSelection ::MoveUp et ITextSelection ::MoveDown sont similaires aux méthodes ITextSelection ::MoveLeft et ITextSelection ::MoveRight , sauf qu’elles reflètent le comportement des touches Flèche haut, Flèche bas, Page haut et Page bas sur le curseur-clavier.

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