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

Article
03/06/2024

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

Syntaxe

HRESULT MoveUp(
  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 haut	Se déplace d’une ligne vers le haut. Il s’agit de la valeur par défaut.
tomParagraph	Ctrl+Haut	Déplace un paragraphe vers le haut.
tomScreen	Page précédente	Se déplace vers le haut d’un écran.
tomWindow	Ctrl+Page haut	Passe au premier 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*

Le nombre réel d’unités du point d’insertion ou de l’extrémité active est déplacé vers le bas. Ce paramètre peut avoir la valeur Null. L’effondrement de la sélection 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 MoveUp et MoveDown sont similaires aux méthodes MoveLeft et 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