Método Selection.Extend (Word)

Ativa o modo de extensão, ou se este modo já estiver ativado, estende a seleção para próxima maior unidade do texto.

Sintaxe

expressão. Estender (caractere)

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

Parâmetros

Nome	Obrigatório/Opcional	Tipo de dados	Descrição
Caractere	Opcional	Variant	O caractere através do qual a seleção será estendida. Esse argumento é sensível a casos e deve ser avaliado para uma Cadeia de Caracteres ou ocorrerá um erro. Além disso, se o valor deste argumento for maior do que um único caractere, o Microsoft Word ignora o comando inteiramente.

Comentários

O uso desse método define a propriedade ExtendMode como True, se ainda não estiver.

A progressão das unidades de texto selecionadas é a seguinte: palavra, frase, parágrafo, seção, documento inteiro. Se Character for especificado, esse método estende a seçeção até a próxima instância do caractere especificado. A seleção é estendida movendo o final ativo da seleção.

Exemplo

Este exemplo recolhe a seleção atual em um ponto de inserção e, em seguida, seleciona a frase atual.

With Selection 
 ' Collapse current selection to insertion point. 
 .Collapse 
 ' Turn extend mode on. 
 .Extend 
 ' Extend selection to word. 
 .Extend 
 ' Extend selection to sentence. 
 .Extend 
End With

Aqui está um exemplo que realiza a mesma tarefa sem o método Extend.

With Selection 
 ' Collapse current selection. 
 .Collapse 
 ' Expand selection to current sentence. 
 .Expand Unit:=wdSentence 
End With

Este exemplo torna o final da seleção ativa e estende a seleção até a próxima instância do "R" maiúsculo.

With Selection 
 .StartIsActive = False 
 .Extend Character:="R" 
End Wit

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.