Commande WMOVE

Déplace ou étend la sélection courante.

Syntaxe

CHGVAR	VAR(&CMD) VALUE('WMOVE')
CHGVAR	VAR(&PARM1) VALUE(' [From="Signet"] [;Direction="Sens du déplacement"] [;Unit=Unité de déplacement] [;Count=nombre d’unités du déplacement] [;While="Liste de caractères"] [;Until="Liste de caractères"] [;Extend=True/False] ')
CHGVAR	VAR(&PARM2) VALUE(' ')
CALL	PGM(LNCCMD) PARM(&HANDLE &CMD &OPT &PARM1 + &PARM2 &RESULT)

Paramètres

Parm1

From : Désigne un signet dans le document, où la sélection doit commencer.
Si « From » est omis, le début de la sélection reste inchangé.

Direction : Indique le sens du déplacement de la sélection courante.
Le déplacement est opéré en fonction de la propriété Unit.
Les valeurs possibles sont :

Start: Déplace la sélection au début de l’unité.
End: Déplace la sélection à la fin.
Down: Déplace la sélection vers le bas.
Up: Déplace la sélection vers le haut.
Right: Déplace la sélection vers la droite.
Left: Déplace la sélection vers la gauche.

Voir la partie Détails pour utiliser correctement les autres paramètres ci-dessous en fonction du paramètre Direction.

Unit : Indique l’unité de déplacement.
Les valeurs possibles sont : wdCharacter, wdCell, wdWord, wdSentence, wdParagraph, wdSection, wdColumn, wdRow, wdTable, wdLine.

Count : Indique le nombre d’unités du déplacement.
Ce nombre peut être négatif ou positif.

While : Tant que un des caractères de la liste est présent, la sélection est déplacée.

Until : La sélection est déplacée jusqu’à ce qu’un des caractères de la liste soit rencontré.

Extend : Doit être à la valeur « True » pour que la sélection soit étendue, sinon, la sélection courante est remplacée.

Détails

Paramètre Direction

Paramètres utilisables

pas utilisé

while

Déplace la sélection spécifiée tant que l'un des caractères spécifiés est trouvé dans le document.

[count] valeur par défaut: wdForward.

Nombre maximal de caractères dont la sélection spécifiée doit être déplacée. Peut être un nombre ou la constante wdForward ou wdBackward. Si Count est un nombre positif, la sélection spécifiée est avancée dans le document, à partir de la fin. S'il s'agit d'un nombre négatif, la sélection est déplacée vers l'arrière, à partir de la position de départ.

Exemple 1.

until

Déplace la sélection spécifiée jusqu'à ce que l'un des caractères spécifiés soit trouvé dans le document.

[count] valeur par défaut: wdForward.

Exemple 2.

Réduit la sélection spécifiée à sa position de début ou de fin, puis déplace l'objet réduit du nombre d'unités spécifié. Cette méthode renvoie une valeur Long qui représente le nombre d'unités avec lesquelles la sélection a été déplacée, ou renvoie 0 (zéro) si le déplacement a échoué.

[unit] valeur par défaut: wdCharacter

Unité avec laquelle on va déplacer la position du caractère de fin.

[count] valeur par défaut: 1.

Nombre d'unités dont la plage ou la sélection spécifiée doit être déplacée. Si Count est un nombre positif, l'objet est réduit à sa position finale et déplacé vers l'arrière dans le document selon le nombre d'unités spécifié. Si Count est un nombre négatif, l'objet est réduit à sa position de départ et avancé du nombre d'unités spécifié.

Exemple 3.

start

while

Déplace la position de départ de la sélection spécifiée lorsque l'un des caractères spécifiés est trouvé dans le document.

[count]

Nombre maximal de caractères dont la plage spécifiée doit être déplacée. Peut être un nombre ou la constante wdForward ou wdBackward. Si Count est un nombre positif, la plage est avancée dans le document. S'il s'agit d'un nombre négatif, la plage est reculée. La valeur par défaut est wdForward.

Exemple 4.

until

Déplace la position de départ de la sélection spécifiée jusqu'à ce que l'un des caractères spécifiés soit trouvé dans le document. Si le mouvement est en arrière dans le document, la sélection est développée.

[count]

Nombre maximal de caractères par lequel la plage spécifiée doit être déplacée. Peut être un nombre ou la constante wdForward ou wdBackward. Si Count est un nombre positif, la plage est avancée dans le document. S'il s'agit d'un nombre négatif, la plage est reculée. La valeur par défaut est wdForward.

Exemple 5.

Déplace la position de départ de la sélection spécifiée.

[unit]

Unité par laquelle la position de départ de la sélection spécifiée doit être déplacée. Peut être l'une des constantes WdUnits. La valeur par défaut est wdCharacter.

[count]

Nombre maximal d'unités par lesquelles la plage spécifiée doit être déplacée. Si Count est un nombre positif, la position de départ de la plage est avancée dans le document. S'il s'agit d'un nombre négatif, la position de départ est reculée. Si la position de départ est avancée au-delà de la position de fin, la plage est réduite et les positions de début et de fin sont déplacées ensemble. La valeur par défaut est 1.

Exemple 6

End

while

Déplace la position du caractère de fin d'une plage lorsque l'un des caractères spécifiés est trouvé dans le document.

[count]

Nombre maximal de caractères par lequel la plage doit être déplacée. Peut être un nombre ou la constante wdForward ou wdBackward. Si Count est un nombre positif, la plage est avancée dans le document. S'il s'agit d'un nombre négatif, la plage est reculée. La valeur par défaut est wdForward.

Exemple 7.

until

Déplace la position de fin de la sélection spécifiée jusqu'à ce que l'un des caractères spécifiés soit trouvé dans le document.

[count]

Nombre maximal de caractères par lequel la sélection spécifiée doit être déplacée. Peut être un nombre ou wdForward ou wdBackward. Si Count est un nombre positif, la sélection est avancée dans le document. S'il s'agit d'un nombre négatif, la sélection est déplacée vers l'arrière. La valeur par défaut est wdForward.

Exemple 8.

Déplace la position du caractère de fin d'une plage ou d'une sélection.

[unit]

Unité avec laquelle on va déplacer la position du caractère de fin. La valeur par défaut est wdCharacter.

[count]

Le nombre d'unités à déplacer. Si ce nombre est positif, la position du caractère de fin est avancée dans le document. Si ce nombre est négatif, la fin est reculée. Si la position finale dépasse la position de départ, la plage se réduit et les deux positions se déplacent ensemble. La valeur par défaut est 1.

Exemple 9.

down

Déplace la sélection vers le bas et renvoie le nombre d'unités dont elle a été déplacée.

[unit]

L'unité dont la sélection doit être déplacée. La valeur par défaut est wdLine.

[count]

Le nombre d'unités dont la sélection doit être déplacée. La valeur par défaut est 1.

[extend].

Peut être false ou true. Si false est utilisé, la sélection est réduite à la fin et déplacée vers le bas. Si true est utilisé, la sélection est étendue vers le bas. La valeur par défaut est false .

Exemple 10.

Déplace la sélection vers le haut et renvoie le nombre d'unités dont elle a été déplacée.

[unit]

Peut être l’une des constantes suivantes: wdLine, wdParagraph, wdWindow ou wdScreen. La valeur par défaut est wdLine. Vous pouvez utiliser la constante wdWindow pour que l'argument Unit se déplace en haut ou en bas de la fenêtre active. Quelle que soit la valeur de Count (supérieure à 1 ou inférieure à 1), la constante wdWindow ne déplace qu'une unité. Utilisez la constante wdScreen pour déplacer plusieurs écrans.

[count]

Le nombre d'unités dont la sélection doit être déplacée. La valeur par défaut est 1.

[extend]

Spécifie si la sélection est déplacée ou étendue. Peut être false ou true. Si false est utilisé, la sélection est réduite à la fin et déplacée vers le haut. Si true est utilisé, la sélection est étendue. La valeur par défaut est false.

Exemple 11.

right

Déplace la sélection vers la droite et renvoie le nombre d'unités dont elle a été déplacée.

[unit]

Unité avec laquelle la sélection doit être déplacée. La valeur par défaut est wdCharacter.

[count]

Le nombre d'unités dont la sélection doit être déplacée. La valeur par défaut est 1

[extend]

Peut être false ou true. Si false est utilisé, la sélection est réduite à la fin et déplacée à droite. Si true est utilisé, la sélection est étendue à droite. La valeur par défaut est false

Exemple 12.

left

Déplace la sélection vers la gauche et renvoie le nombre d'unités dont elle a été déplacée.

[unit]

Unité avec laquelle la sélection doit être déplacée. La valeur par défaut est wdCharacter.

[count]

Le nombre d'unités dont la sélection doit être déplacée. La valeur par défaut est 1

[extend]

Peut être false ou true. Si false est utilisé, la sélection est réduite à la fin et déplacée vers la gauche. Si true est utilisé, la sélection est étendue à gauche. La valeur par défaut est false.

Exemple 13.

Exemple 1:

LNCCMD CMD(WMOVE) PARM1('While="Z"') : result = 0

LNCCMD CMD(WMOVE) PARM1('While="R"'): le curseur est déplacé d'un caractère. Result = 1

LNCCMD CMD(WMOVE) PARM1('While="R";count=2') : le curseur est déplacé d'un caractère. Result = 1

LNCCMD CMD(WMOVE) PARM1('While=" DOM";count=-5') : return =-4

Exemple 2:

LNCCMD CMD(WMOVE) PARM1('Until="D";count=20') : result=8. le curseur est déplacé de 8 caractères

LNCCMD CMD(WMOVE) PARM1('Until="D";count=2'): result=0

Aucun caractère «D» trouvé dans la plage spécifiée par count = 2. La plage n'est pas modifiée et la méthode renvoie 0 (zéro).

Exemple 3:

LNCCMD CMD(WMOVE) : result=1 . Un caractère déplacé.

LNCCMD CMD(WMOVE) PARM1('Unit=wdWord') : result= 1. Un mot déplacé.

LNCCMD CMD(WMOVE) PARM1('count=4')

LNCCMD CMD(WMOVE) PARM1('count=-3')

Exemple 4:

LNCCMD CMD(WMOVE) PARM1('Direction="Start";While="Z"') : result = 0

LNCCMD CMD(WMOVE) PARM1('Direction="Start";While="R"'): result = 0. La plage commence par le caractère M.

LNCCMD CMD(WMOVE) PARM1('Direction="Start";While="MOR"'): result = 3. Le début de la plage a été déplacé de 3 caractères.

Exemple 5:

LNCCMD CMD(WMOVE) PARM1('Direction="Start";Until="D";count=20') : result=11. Le curseur est déplacé de 11 caractères à partir du début de la sélection.

LNCCMD CMD(WMOVE) PARM1('Direction="Start";Until="D";count=2'): result=0

Aucun caractère «D» trouvé dans la plage spécifiée par count = 2. La plage n'est pas modifiée et la méthode renvoie 0 (zéro).

LNCCMD CMD(WMOVE) PARM1('Direction="Start";Until="O";count=2')

Exemple 6:

LNCCMD CMD(WMOVE) PARM1('Direction="Start"') : result=1 . Un caractère déplacé.

LNCCMD CMD(WMOVE) PARM1('Direction="Start";Unit=wdWord') : result= 1. Un mot déplacé.

Exemple 7:

LNCCMD CMD(WMOVE) PARM1('Direction="End";While="Z"') : result = 0

LNCCMD CMD(WMOVE) PARM1('Direction="End";While="R"'): result =1. Un caractère déplacé.

LNCCMD CMD(WMOVE) PARM1('Direction="End";While="MOR"'): result = 1. La fin de la plage a été déplacée d'un caractère.

Exemple 8:

LNCCMD CMD(WMOVE) PARM1('Direction="End";Until="D";count=20') : result=9. Le curseur a avancé de 9 caractères à partir de la fin de la sélection.

LNCCMD CMD(WMOVE) PARM1('Direction="End";Until="D";count=2'): result=0

Aucun caractère «D» trouvé dans la plage spécifiée par count = 2. La plage n'est pas modifiée et la méthode renvoie 0 (zéro).

Exemple 9:

LNCCMD CMD(WMOVE) PARM1('Direction="End"') : result=1 . Un caractère déplacé.

LNCCMD CMD(WMOVE) PARM1('Direction="End";Unit=wdWord') : result= 1. Un mot déplacé.

Exemple 10:

LNCCMD CMD(WMOVE) PARM1('Direction="Down"') : result=1 . Une ligne déplacée.

LNCCMD CMD(WMOVE) PARM1('Direction="Down";Extend=true') : result=1 . Une ligne déplacée.

Exemple 11:

LNCCMD CMD(WMOVE) PARM1('Direction="Up";Extend=true'): result=1 Une ligne déplacée.

Exemple 12:

LNCCMD CMD(WMOVE) PARM1('Direction="Right";Extend=true'): result=1 . Un caractère déplacé.

Exemple 13:

LNCCMD CMD(WMOVE) PARM1('Direction="Left";Extend=true'): result=1 . Un caractère déplacé.