Range.GoTo, méthode (Word)

Article
04/07/2023

Renvoie un objet Range qui représente la position de début de l'élément spécifié, par exemple une page, un signet ou un champ.

Syntaxe

expression. GoTo( What , Which , Count , Name )

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

Parameters

Nom	Requis/Facultatif	Type de données	Description
What	Facultatif	Variant	Le type d'élément vers lequel la plage est déplacée. Il peut s’agir de l’une des constantes wdGoToItem .
Which	Facultatif	Variant	Élément vers lequel la plage est déplacée. Il peut s’agir de l’une des constantes wdGoToDirection .
Count	Facultatif	Variant	Le numéro de l'élément dans le document. La valeur par défaut est 1. Seules les valeurs positives sont valides. Pour spécifier un élément précédant la plage, utilisez wdGoToPrevious en tant que la page quel argument et spécifiez une valeur de nombre.
Name	Facultatif	Variant	Si l'argument What a la valeur wdGoToBookmark, wdGoToComment, wdGoToField ou wdGoToObject, cet argument spécifie un nom. Seules les valeurs positives sont valides. Pour spécifier un élément précédant la plage, utilisez wdGoToPrevious en tant que la page quel argument et spécifiez une valeur de nombre.

Remarques

L'exemple suivant montre comment déplacer la plage de deux lignes vers le haut.

ActiveDocument.Range.GoTo What:=wdGoToLine, Which:=wdGoToPrevious, Count:=2

L'exemple suivant montre comment se déplacer vers le champ DATE suivant.

ActiveDocument.Range.GoTo What:=wdGoToField, Name:="Date"

L'exemple suivant montre comment déplacer la plage à la quatrième ligne du document.

ActiveDocument.Range.GoTo What:=wdGoToLine, Which:=wdGoToAbsolute, Count:=4

Les exemples suivants sont équivalents d'un point de vue fonctionnel ; ils permettent tous deux de déplacer la plage au niveau du premier titre du document.

ActiveDocument.Range.GoTo What:=wdGoToHeading, Which:=wdGoToFirst 
ActiveDocument.Range.GoTo What:=wdGoToHeading, Which:=wdGoToAbsolute, Count:=1

Lorsque vous utilisez la méthode GoTo avec la constante wdGoToGrammaticalError, wdGoToProofreadingError ou wdGoToSpellingError constante, la plage qui est renvoyé inclut tout texte d'erreur de grammaire ou d'orthographe.

Exemple

Cet exemple montre comment placer le point d'insertion juste avant le cinquième appel de note de fin du document actif.

If ActiveDocument.Endnotes.Count >= 5 Then 
 ActiveDocument.Range.GoTo What:=wdGoToEndnote, _ 
 Which:=wdGoToAbsolute, Count:=5 
End If

Cet exemple montre comment définir la variable R1 pour qu'elle corresponde à la première marque d'appel de note de bas de page du document actif.

If ActiveDocument.Footnotes.Count >= 1 Then 
 Set R1 = ActiveDocument.Range.GoTo(What:=wdGoToFootnote, _ 
 Which:=wdGoToFirst) 
 R1.Expand Unit:=wdCharacter 
End If

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.

Partager via