Compartilhar via


Método Range.MoveEndUntil (Word)

Move a posição final do intervalo especificado até um dos caracteres especificados ser localizado no documento. Se o movimento for para frente no documento, o intervalo será expandido.

Sintaxe

expression. MoveEndUntil( _Cset_ , _Count_ )

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

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
Cset Obrigatório Variant Um ou mais caracteres. Esse argumento é sensível a casos.
Count Opcional Variant O número máximo de caracteres pelo qual o intervalo especificado deve ser movido. Pode ser um número ou o wdForward ou wdBackward constante. Se Count for um número positivo, o intervalo será movido para frente no documento. Se for um número negativo, o intervalo é movido para trás. O valor padrão é wdForward.

Comentários

Esse método retorna o número de caracteres pelos quais a posição final do intervalo especificado foi movida, como um valor Long. Se Count for maior do que 0 (zero), esse método retorna o número de caracteres movidos mais 1. Se Count for menor que 0 (zero), esse método retorna o número de caracteres movidos menos 1. Se nenhum caractere Cset forem encontrada, o intervalo não for alterado e o método retornará 0 (zero). Se a posição final for movida para trás até um ponto que precede a posição inicial original, a posição inicial é definida para a nova posição final.

Exemplo

Este exemplo estende o texto selecionado para frente no documento até a letra "a" ser localizada. Em seguida, o exemplo expande a seleção em um caractere para incluir a letra "a".

With Selection.Range 
 .MoveEndUntil Cset:="a", Count:=wdForward 
 .MoveRight Unit:=wdCharacter, Count:=1, Extend:=wdExtend 
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.