Selection.Move, méthode (Word)

  • Article

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 indiqué. Cette méthode renvoie une valeur de type Long représentant le nombre d’unités de déplacement de la sélection ou la valeur 0 (zéro) si le déplacement a échoué.

Syntaxe

expression. Move( _Unit_ , _Count_ )

expression Obligatoire. Variable qui représente un objet Selection.

Paramètres

Nom Requis/Facultatif Type de données Description
Unit Facultatif WdUnits Unité en fonction de laquelle l'emplacement du caractère de fin doit être déplacé.
Count Facultatif Variante Nombre d'unités de déplacement de la plage ou de la sélection. Si l'argument Nombre est un nombre positif, l'objet est réduit à sa position de fin et reculé du nombre d'unités spécifié dans le document. Si nombre est un nombre négatif, l'objet est réduit à sa position de début et déplacé vers l'avant le nombre d'unités spécifié. La valeur par défaut est 1. Pour contrôler le sens de la réduction, utilisez la méthode Collapse avant la méthode Move. Si la plage se trouve au milieu d’une unité ou si elle n’est pas réduite, un déplacement vers le début ou la fin de l’unité est compté comme un déplacement d’une unité entière.

Valeur renvoyée

Entier long

Remarques

Les positions de début et de fin d'une plage ou d'une sélection réduite sont les mêmes.

L'application de la méthode Move à une plage ne réorganise le texte dans le document. Au lieu de cela, elle permet de redéfinir la plage pour faire référence à un nouvel emplacement dans le document.

Si vous appliquez la méthode Move à une plage autre qu’une variable objet Range (par exemple, Selection.Paragraphs(3).Range.Move), la méthode n’a aucun effet.

Le déplacement d’un objet Selection réduit la sélection et déplace le point d’insertion vers l’avant ou vers l’arrière du document.

Exemple

Cet exemple montre comment déplacer la sélection de deux mots vers la droite et placer le point d'insertion après l'espace qui suit le deuxième mot. Si le déplacement échoue, une boîte de message indique que la sélection se trouve à la fin du document.

If Selection.StoryType = wdMainTextStory Then 
 wUnits = Selection.Move(Unit:=wdWord, Count:=2) 
 If wUnits < 2 Then _ 
 MsgBox "Selection is at the end of the document" 
End If

Cet exemple montre comment déplacer la sélection de trois cellules vers l'avant dans le tableau.

If Selection.Information(wdWithInTable) = True Then 
 Selection.Move Unit:=wdCell, Count:=3 
End If

Voir aussi

Selection, objet

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.