
Este comando é utilizado para aceder à caixa de diálogo Replace Text, a partir da qual pode configurar uma pesquisa para localizar e substituir texto específico - localizado no documento atual, em todos os documentos baseados em texto do projeto ativo, em todos os documentos baseados em texto abertos, ou em todos os documentos baseados em texto de um diretório especificado.
Também é possível aceder a este comando utilizando o atalho de teclado Ctrl+H.
Após executar o comando, a caixa de diálogo Replace Text será apresentada. A caixa de diálogo funciona essencialmente em dois modos, com funcionalidade disponibilizada por dois separadores:
- Replace Text - utilize as opções deste separador para configurar a substituição de texto apenas no documento atual. Para substituir apenas a primeira ocorrência de texto correspondente, clique em OK. Se a opção Prompt on replace estiver ativada, o texto será realçado e será apresentada uma caixa de diálogo para confirmar a substituição. Clique em Yes para substituir apenas esta ocorrência. Terá a oportunidade de substituir todas as ocorrências correspondentes a partir desta caixa de diálogo. Em alternativa, para substituir todas desde o início, clique em Replace All, em vez de OK. Mais uma vez, todas as ocorrências correspondentes do texto pesquisado serão substituídas diretamente, ou através de confirmação individual, dependendo do estado da opção Prompt on replace.
- Replace in Files - utilize as opções deste separador para configurar uma substituição de texto em todos os documentos baseados em texto do projeto ativo, em todos os documentos baseados em texto abertos, ou em todos os documentos baseados em texto de um diretório especificado. Depois de clicar em OK, todas as ocorrências de texto correspondente encontradas nos ficheiros abrangidos pelo âmbito da pesquisa serão substituídas. Mais uma vez, pode optar por receber confirmação antes da substituição definindo previamente a opção Prompt on replace. A caixa de diálogo Replacing será apresentada para mostrar o progresso da substituição. Cada substituição efetuada será listada como entrada no painel Messages panel. Cada mensagem refletirá o ficheiro de origem, a linha em que o texto pesquisado foi encontrado, o texto completo dessa linha e a posição do caráter nessa linha em que a cadeia de texto pesquisada começa.
Em cada caso, será apresentada uma caixa de diálogo de informação, resumindo o número de substituições efetuadas.
Dicas
- Cada mensagem no painel Messages está no formato (x, y): <OriginalLineText>, em que x é a posição do caráter na linha y do documento. O texto mostra o texto original, antes da substituição.
- Os ficheiros não têm de estar abertos para substituir texto utilizando o modo Replace in Files. Esses ficheiros podem opcionalmente ser abertos após a substituição ativando a opção Open changed files in editor, antes de efetuar a substituição.
- Ao utilizar o modo Replace in Files, é possível fazer cross-probing para o texto substituído resultante a partir da entrada no painel Messages - basta fazer duplo clique na mensagem.