Método Application.ReplaceEx (Project)

  • Artigo

Procura um valor não filtrado em um campo especificado ou em todos os campos disponíveis e o substitui com o valor especificado.

Sintaxe

expressão. ReplaceEx (Field, Test, Value, Replacement, ReplaceAll, Next, MatchCase, FieldID, TestID, SearchAllFields)

Expressão Uma expressão que retorna um objeto Application .

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
Field Opcional String O nome do campo a ser pesquisado.
Test Opcional String O tipo de comparação feita entre Field e Value. Pode ser uma das cadeias de caracteres de comparação.
Valor Opcional Variantes O valor a ser comparado com o valor do campo especificado em Campo.
Replacement Opcional Variantes Use "" (uma cadeia de caracteres vazia) para limpar Campo onde ele atende ao teste especificado por Teste e Valor.
ReplaceAll Opcional Variantes True se todas as ocorrências da Value são substituídas. False se somente a primeira ocorrência é substituída. O valor padrão é False.
Next Opcional Variantes True se as pesquisas de projeto para baixo para a próxima ocorrência de correspondência de critérios de pesquisa. False se o projeto de pesquisa acima a próxima ocorrência. O valor padrão é True.
MatchCase Opcional Variantes True se a pesquisa diferencia maiúsculas de minúsculas. O valor padrão é False.
FieldID Opcional Variantes O número de identificação de campo pode ser uma das constantes PjField . FieldID tem precedência sobre qualquer valor Field.
Testid Opcional Variantes O número de identificação de teste pode ser uma das constantes PjComparison . TestID tem precedência sobre qualquer valor Test.
SearchAllFields Opcional Variantes Se True, substitua o valor especificado em todos os campos disponíveis. O valor padrão é False. SearchAllFields prevalece sobre Field e FieldID.

Cadeias de caracteres de comparação

Cadeia de comparação Descrição
"é igual a" O valor de Campo é igual ao de Valor.
"é diferente de" O valor de Campo é diferente do de Valor.
"é maior que" O valor de Campo é maior que o de Valor.
"é maior ou igual a" O valor de Campo é maior ou igual ao de Valor.
"é menor que" O valor de Campo é menor que o de Valor.
"é menor ou igual a" O valor de Campo é menor ou igual ao de Valor.
"está contido em" O valor de Campo está contido em Valor.
"não está contido em" O valor de Campo não está contido em Valor.
"contém" Campo contém valor.
"não contém" Campo não contém valor.
"contém exatamente" O campo contém exatamente Valor.

Valor de retorno

Boolean

True se qualquer substituições são feitas; Caso contrário, False.

Comentários

Usando o método ReplaceEx sem argumentos ou sem especificar Campo, Teste e Valor, exibe a caixa de diálogo Substituir que tem opções definidas para o estado anterior. Se você definir SearchAllFields como True, o uso programático ainda exigirá valores para os parâmetros Campo, Teste e Valor .

Exemplo

Cada linha do exemplo a seguir substitui "Bad" por "Good", dentro do conjunto de todos os campos disponíveis.

Sub Bad2Good() 
    ReplaceEx Field:="Name", Test:="contains", Value:="Bad", Replacement:="Good", _ 
        ReplaceAll:=True, SearchAllFields:=True 
    ReplaceEx Field:="xx", Test:="xx", TestID:=pjCompareContains, Value:="Bad", Replacement:="Good", _ 
        ReplaceAll:=True, SearchAllFields:=True 
End Sub

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.