Método Range.Replace (Excel)
Retorna um Boolean que indica caracteres em células dentro do intervalo especificado. O uso deste método não altera a seleção ou a célula ativa.
Sintaxe
expressão. Substituir (O quê, Substituição, LookAt, SearchOrder, MatchCase, MatchByte, SearchFormat, ReplaceFormat)
expressão Uma variável que representa um objeto de Intervalo.
Parâmetros
| Nome | Obrigatório/Opcional | Tipo de dados | Descrição |
|---|---|---|---|
| What | Obrigatório | Variantes | A cadeia de caracteres que você deseja que o Microsoft Excel pesquise. |
| Replacement | Obrigatório | Variant | A cadeia de caracteres de substituição. |
| LookAt | Opcional | Variant | Pode ser uma das seguintes XlLookAt constantes: xlWhole ou xlPart. |
| SearchOrder | Opcional | Variant | Pode ser uma das seguintes XlSearchOrder constantes: xlByRows ou xlByColumns. |
| MatchCase | Opcional | Variantes | True para tornar fazer com que a pesquisa passe a diferenciar maiúsculas de minúsculas. |
| MatchByte | Opcional | Variantes | Use esse argumento somente se você tiver selecionado ou instalado suporte de idioma de bytes duplos no Microsoft Excel. True para que os caracteres de byte duplo correspondam apenas aos caracteres de byte duplo. False para que os caracteres de byte duplo correspondam aos seus equivalentes de byte único. |
| SearchFormat | Opcional | Variant | O formato de pesquisa para o método. |
| ReplaceFormat | Opcional | Variant | O formato de substituição para o método. |
Valor de retorno
Booliano
Comentários
As configurações de LookAt, SearchOrder, MatchCase e MatchByte são salvas sempre que você usa esse método. Se você não especificar valores para esses argumentos na próxima vez que chamar o método, os valores salvos serão usados. Definir esses argumentos alterará as configurações na caixa de diálogo Find e, ao alterar as configurações na caixa de diálogo Find, os valores salvos que são usados se você omitir os argumentos serão alterados. Para evitar problemas, defina esses argumentos explicitamente sempre que você usar esse método.
Exemplo
Este exemplo substitui todas as ocorrências da função trigonométrica SIN pela função COS. O intervalo de substituição é a coluna A da Planilha1.
Worksheets("Sheet1").Columns("A").Replace _
What:="SIN", Replacement:="COS", _
SearchOrder:=xlByColumns, MatchCase:=True
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.