O KatePart possui uma barra de pesquisa incremental e uma barra avançada de pesquisa e substituição, que possibilita a inserção de um texto de substituição, juntamente com algumas opções adicionais.
As barras oferecem as seguintes opções comuns:
- Procurar
Aqui é onde se digita a string de pesquisa. A interpretação da string depende de algumas das opções escritas a seguir.
- Diferenciar maiúsculas de minúsculas
Se estiver ativo, a pesquisa será limitada aos itens que correspondam a nível de capitalização (maiúsculas ou minúsculas) de cada um dos caracteres no padrão de pesquisa.
A barra de pesquisa e substituição avançadas oferece algumas opções adicionais:
- Texto Simples
Corresponde literalmente a qualquer ocorrência do texto de pesquisa.
- Palavras Completas
Se estiver selecionado, a busca somente combinará se existir uma palavra com os mesmos finais da string encontrada, o que significa que nem caracteres alfanuméricos, nem algum outro caractere visível ou um final de linha.
- Sequências de Escape
Se estiver selecionada, o botão no topo de menu de contexto das caixas de texto ficará ativo permitindo que você adicione sequências de escape para o padrão de pesquisa, usando uma lista pré-definida.
- Expressão regular
Se estiver assinalada, o texto a procurar é interpretado como uma expressão regular. O botão no topo do menu de contexto das caixas de texto ficará ativo permitindo que você crie itens de expressão regular para o padrão de pesquisa, usando como base uma lista pré-definida.
Veja em Expressões regulares para mais informações.
- Procura apenas na área selecionada
Se estiver selecionada, a pesquisa e substituição será feita apenas sobre o texto selecionado.
- Procurar todos
Ao clicar neste botão, serão realçadas todas as ocorrências no documento e será mostrado o número de ocorrências encontradas numa pequena área.
Para procurar texto, invoque a barra de pesquisa incremental com a combinação de teclas Ctrl+F ou com a opção do menu → .
Isto abre a barra de pesquisa incremental no fundo da janela do editor. Do lado esquerdo da barra, existe um botão com ícone para fechar a barra, seguido de um pequeno campo de texto para inserir o padrão a pesquisar.
Quando você começar a inserir os caracteres no seu padrão de pesquisa, a busca inicia imediatamente. Se existir uma ocorrência no texto, ela fica realçada e a cor de fundo do campo muda para verde-claro. Se o padrão de pesquisa não corresponder a nenhum texto, isto é indicado por uma cor de fundo vermelha-clara no campo.
Use os botões
or
para ir para a ocorrência anterior ou seguinte no documento.
As correspondências no documento são realçadas mesmo quando você fecha a barra de pesquisa. Para limpar este realce, pressione a tecla Esc.
Você poderá escolher aqui se a pesquisa faz a distinção entre minúsculas e maiúsculas. Se selecionar a opção
, irá limitar as pesquisas para os itens que correspondam às letras (maiúsculas ou minúsculas) de cada um dos caracteres do padrão de pesquisa.
Clique no botão
à direita da barra de pesquisa incremental, para mudar para a barra mais poderosa de pesquisa e substituição.
Para repetir a última operação de pesquisa, se existir alguma e sem ter que invocar a barra de pesquisa incremental, use a opção → (F3) ou → (Shift+F3).
Para substituir o texto, invoque a barra avançada de pesquisa e substituição com a opção do menu → ou com a combinação de teclas Ctrl+R.
No canto superior esquerdo da barra existe um botão com um ícone para fechar a barra, seguido de um pequeno menu suspenso para inserir o padrão de pesquisa. O menu se lembra dos padrões recentemente usados.
Você poderá controlar o modo de pesquisa selecionando as opções Texto simples, Palavras completas, Sequências de escape ou Expressão regular da caixa suspensa.
Se Sequências de escape ou Expressão regular estiver selecionado, o item de menu na base do menu de contexto de caixas de texto será habilitado e lhe permitirá adicionar sequências de escape ou expressões regulares para pesquisa ou substituição de padrões a partir de listas pré-definidas.
Use os botões
or
para ir para a ocorrência anterior ou seguinte no documento.
Insira o texto de substituição no campo de texto Substituir e clique no botão , para substituir apenas o texto realçado, ou o botão para substituir o texto de pesquisa em todo o documento.
Você poderá modificar o comportamento da pesquisa e da substituição ao selecionar as diferentes opções no lado direito da barra. Se selecionar a opção
, irá limitar as pesquisas apenas aos itens com capitalização correspondente (maiúsculas ou minúsculas) para cada um dos caracteres no padrão de pesquisa. A opção
irá procurar e substituir apenas dentro do texto selecionado no momento. A opção Procurar tudo realça todas as ocorrências no documento e mostra o número de correspondências encontradas em uma pequena janela de contexto.
Clique no botão
à direita da barra avançada de pesquisa e substituição, para mudar para a barra de pesquisa incremental.
Dica
Se estiver usando uma expressão regular para encontrar um texto a ser substituído, você pode empregar referências regressivas, para reutilizar o texto capturado em subpadrões da expressão, com parênteses.
Veja em Expressões regulares para mais informações.
Dica
Você poderá procurar, substituir e procurar de forma incremental na linha de comando.