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
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.