Selection.GoTo Method

  • Article
Word Developer Reference

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).

Syntax

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

expression   Required. A variable that represents a Selection object.

Parameters

Name Required/Optional Data Type Description
What Optional Variant The kind of item to which the range or selection is moved. Can be one of the WdGoToItem constants.
Which Optional Variant The item to which the range or selection is moved. Can be one of the WdGoToDirection constants.
Count Optional Variant The number of the item in the document. The default value is 1. 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.
Name Optional Variant If the What argument is wdGoToBookmark, wdGoToComment, wdGoToField, or wdGoToObject, this argument specifies a name.

Return Value
Range

Remarks

When you use the GoTo method with the wdGoToGrammaticalError, wdGoToProofreadingError, or wdGoToSpellingError constant, the Range object that is returned includes any grammar error text or spelling error text.

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

Visual Basic for Applications 
  Selection.GoTo What:=wdGoToHeading, Which:=wdGoToFirst
Selection.GoTo What:=wdGoToHeading, Which:=wdGoToAbsolute, Count:=1

The following example moves the selection to the fourth line in the document.

Visual Basic for Applications 
  Selection.GoTo What:=wdGoToLine, Which:=wdGoToAbsolute, Count:=4

The following example moves the selection up two lines.

Visual Basic for Applications 
  Selection.GoTo What:=wdGoToLine, Which:=wdGoToPrevious, Count:=2

The following example moves to the next DATE field.

Visual Basic for Applications 
  Selection.GoTo What:=wdGoToField, Name:="Date"

Example

This example moves the selection to the first cell in the next table.

Visual Basic for Applications 
  Selection.GoTo What:=wdGoToTable, Which:=wdGoToNext

This example moves the insertion point just before the fifth endnote reference mark in the active document.

Visual Basic for Applications 
  If ActiveDocument.Endnotes.Count >= 5 Then
    Selection.GoTo What:=wdGoToEndnote, _
        Which:=wdGoToAbsolute, Count:=5
End If

This example moves the selection down four lines.

Visual Basic for Applications 
  Selection.GoTo What:=wdGoToLine, Which:=wdGoToRelative, Count:=4

This example moves the selection back two pages.

Visual Basic for Applications 
  Selection.GoTo What:=wdGoToPage, Which:=wdGoToPrevious, Count:=2

See Also