A função de substituir no conteúdo permite substituir uma string de caracteres por outra dentro dos objetos listados na seção Janela de Resultados. O comando Substituir no conteúdo se encontra disponível no menu de opções da janela:
Quando seleciona este comando, aparece uma caixa de diálogo onde se introduz a string de caracteres que substituirá todas as ocorrências encontradas na pesquisa inicial:
As operações de substituição funcionam da seguinte maneira:
- A substituição é realizada em todos os elementos presentes na lista e não em uma seleção. Entretanto, é possível reduzir a operação de substituição, reduzindo o conteúdo da lista utilizando o comando Remover do menu contextual (usando o botão direito do mouse):
- Apenas as ocorrências mostradas na lista serão substituídas, e somente depois de comprovar os critérios de busca iniciais para os casos em que os objetos foram modificados entre a pesquisa inicial e a operação de substituição..
- A substituição se realiza:
- no conteúdo dos métodos
- nas propriedades dos objetos de formulário
- no conteúdo das mensagens de ajuda
- no conteúdo dos filtros de entrada
- no conteúdo dos elementos de menus (textos e chamadas de métodos)
- no conteúdo das listas de opções
- no conteúdo dos comentários sobre métodos, formulários, tabelas e campos no Explorador.
- Para cada objeto modificado, 4D comprova se ele já foi carregado por outra máquina ou janela. Em caso de conflito, aparece uma caixa de diálogo indicando que o objeto está bloqueado. Pode fechar o objeto e tentar novamente ou cancelar a substituição. A operação de substituição continuará com os demais objetos da lista.
- Se um método ou um formulário afetado por uma operação "substituir no conteúdo" está sendo editado pela aplicação 4D, ele será modificado diretamente no editor aberto (sem advertência). Os formulários e métodos modificados dessa maneira não são guardados de forma automática: terá que utilizar o comando Salvar ou Salvar todos para validar as mudanças.
- Quando uma substituição é realizada em um elemento da lista, o elemento é mostrado em itálico. Aparece na parte inferior da janela a contagem em tempo real das substituições realizadas.
- Os objetos nunca são renomeados pela função Substituir em conteúdo, exceto os objetos nos formulários. Portanto é possível que certas ocorrências da lista não sejam afetadas pela substituição. Isso poderia acontecer quando apenas o nome do elemento corresponde com os critérios de busca iniciais. Nesse caso, não todos os elementos da lista aparecem necessariamente em cursiva e a posterior contagem das substituições é inferior ao número de ocorrências encontradas na busca inicial.