Partilhar via


Método Selection.GoTo (Word)

Move o ponto de inserção para a posição de caractere imediatamente anterior ao item especificado e retorna um objeto Range (exceto para a constante wdGoToGrammaticalError, wdGoToProofreadingError ou wdGoToSpellingError ).

Sintaxe

expression. GoTo( _What_ , _Which_ , _Count_ , _Name_ )

expressão Obrigatório. Uma variável que representa um objeto Selection.

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
What Opcional Variant O tipo de item para o qual o intervalo ou a seleção é movido(a). Pode ser uma das constantes WdGoToItem.
Which Opcional Variant O item para o qual o intervalo ou a seleção é movido(a). Pode ser uma das constantes WdGoToDirection.
Count Opcional Variant O número do item no documento. O valor padrão é 1. Apenas valores positivos são válidos. Para especificar um item que precede a seleção ou o intervalo, use wdGoToPrevious como o qual argumento e especificar um valor de contagem.
Name Opcional Variant Se o argumento What for wdGoToBookmark, wdGoToComment, wdGoToField ou wdGoToObject, este argumento especificará um nome.

Valor de retorno

O Intervalo que agora está selecionado.

Comentários

Quando você usa o método GoTo com a constante wdGoToGrammaticalError, wdGoToProofreadingError ou wdGoToSpellingError constante, o objeto Range retornado inclui qualquer texto de erro gramatical ou o texto de erro de ortografia.

Exemplos

Os exemplos a seguir são funcionalmente equivalentes, ambos movem a seleção para o primeiro título do documento.

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

O exemplo a seguir move a seleção para a quarta linha do documento.

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

O exemplo a seguir move a seleção duas linhas para cima.

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

O exemplo a seguir vai para o próximo campo DATE.

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

Este exemplo move a seleção para a primeira célula da próxima tabela.

Selection.GoTo What:=wdGoToTable, Which:=wdGoToNext

Este exemplo move o ponto de inserção para imediatamente antes da quinta marca de nota de fim do documento ativo.

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

Este exemplo move a seleção quatro linhas para baixo.

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

Este exemplo move a seleção duas linhas para trás.

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

Confira também

Objeto Selection

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.