GoTo Method

See Also         Example         Applies To

Document or Range object: Returns a Range object that represents the start position of the specified item, such as a page, bookmark, or field.

Selection object: Moves the insertion point to the character position immediately preceding the specified item, and returns a Range object (except for the wdGoToGrammaticalError, wdGoToProofreadingError, or wdGoToSpellingError constant).

Note   When you use this method with the wdGoToGrammaticalError, wdGoToProofreadingError, or wdGoToSpellingError constant, the Range that's returned includes any grammar error text or spelling error text.

Syntax

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

expression   Required. An expression that returns a Document, Range, or Selection object.

What   Optional Variant. The kind of item that the range or selection is to be moved to. Can be one of the following WdGoToItem constants:

wdGoToBookmark

wdGoToComment

wdGoToEndnote

wdGoToEquation

wdGoToField

wdGoToFootnote

wdGoToGrammaticalError

wdGoToGraphic

wdGoToHeading

 wdGoToLine

wdGoToObject

wdGoToPage

wdGoToPercent

wdGoToProofreadingError

wdGoToSection

wdGoToSpellingError

wdGoToTable

Which   Optional Variant. The item that the range or selection is to be moved to. Can be one of the following WdGoToDirection constants: wdGoToAbsolute, wdGoToFirst, wdGoToLast, wdGoToNext, wdGoToPrevious, or wdGoToRelative.

The following examples are functionally equivalent, they both move the selection to the first heading in the document.

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

Count   Optional Variant. The number of the item in the document. The default value is 1. The following example moves the selection to the fourth line in the document.

Selection.GoTo What:=wdGoToLine, Which:=wdGoToAbsolute, Count:=4

Only positive values are valid. To specify an item that precedes the range or selection, use wdGoToPrevious as the Which argument and specify a Count value. The following example moves the selection up two lines.

Selection.GoTo What:=wdGoToLine, Which:=wdGoToPrevious, Count:=2

Name   Optional Variant. If the What argument is wdGoToBookmark, wdGoToComment, wdGoToField, or wdGoToObject, this argument specifies a name. The following example moves to the next DATE field.

Selection.GoTo What:=wdGoToField, Name:="Date"