Método Range.Move (Word)

  • Artigo

Recolhe o intervalo especificado para sua posição inicial ou final e move o objeto recolhido pelo número especificado de unidades.

Sintaxe

expression. Move( _Unit_ , _Count_ )

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

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
Unit Opcional WdUnits A unidade pela qual o intervalo será movido.
Count Opcional Variant O número de unidades pelas quais o intervalo especificado deve ser movido. 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 o intervalo estiver no meio de uma unidade ou não estiver recolhido, movê-lo para o início ou fim da unidade contará como colocá-lo em uma unidade completa.

Valor de retorno

Long

Comentários

Esse método retorna um valor Long que indica o número de unidades pelas quais o objeto foi realmente movido ou retorna 0 (zero) se a movimentação não tiver sido bem sucedida.

A posição inicial e a posição final de um intervalo recolhido 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.

Exemplo

Este exemplo define Range1 como o primeiro parágrafo do documento ativo e move o intervalo três parágrafos para a frente. Após essa macro ser executada, o ponto de inserção é posicionado no início do quarto parágrafo.

Set Range1 = ActiveDocument.Paragraphs(1).Range 
With Range1 
 .Collapse Direction:=wdCollapseStart 
 .Move Unit:=wdParagraph, Count:=3 
 .Select 
End With

Confira também

Objeto Range

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.