Compartilhar via


Método Selection.Move (Word)

Recolhe a seleção especificada para sua posição inicial ou final e move o objeto recolhido pelo número especificado de unidades. Esse método retorna um valor Long que representa o número de unidades pelas quais a seleção foi movida ou retorna 0 (zero) se a movimentação não tiver sido bem sucedida.

Sintaxe

expression. Move( _Unit_ , _Count_ )

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

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
Unit Opcional WdUnits A unidade usada para mover a posição do caractere final.
Count Opcional Variant O número de unidades pelas quais deve ser movido o intervalo ou seleção especificada. Se Count for um número positivo, o objeto é recolhido para sua posição final e movido para trás no documento pelo número especificado de unidades. Se Count for um número negativo, o objeto é recolhido para sua posição inicial e movido para frente pelo número especificado de unidades. O valor padrão é 1. Você também pode controlar a direção de recolhimento usando o método Collapse antes de usar o método Move. Se a seleção ou o intervalo estiver no meio de uma unidade ou não estiver recolhida, movê-lo para o início ou fim da unidade contará como colocá-lo em uma unidade completa.

Valor de retorno

Long

Comentários

A posição inicial e a posição final de um intervalo ou uma seleção recolhida são iguais.

Aplicar o método Move a um intervalo não reorganiza o texto do documento. Em vez disso, ela redefine o intervalo para fazer referência a um novo local do documento.

Se você aplicar o método Move a qualquer intervalo que não seja uma variável de objeto Range (por exemplo, Selection.Paragraphs(3).Range.Move), o método não terá efeito.

Mover um objeto Selection recolhe a seleção e move o ponto de inserção para frente ou para trás no documento.

Exemplo

Este exemplo move a seleção duas palavras para a direita e posiciona o ponto de inserção após o espaço de fim da segunda palavra. Se a movimentação não for bem sucedida, uma caixa de mensagem indicará que a seleção se encontra no final do documento.

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

Este exemplo move a seleção três células para a frente na tabela.

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

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.