# Trabalhando com o Editor &kappname;

## Visão geral

O editor &kappname; é a área de edição da janela do &kappname;. Este editor também é usado pelo &kate; e pelo &kwrite;, e ele pode também ser usado pelo &konqueror; para exibir arquivos texto de seu computador local ou da rede.

O editor é composto pelos seguintes componentes:

A Área do Editor

- Esta é a área onde o texto de seu documento está localizado.

As barras de rolagem

- Indicam a posição da parte visível do texto do documento, e pode ser usada para mover-se pelo documento. Arrastar as barras não fará com que o cursor de inserção seja movido.

  As barras de rolagem podem ser exibidas e ocultas, caso necessário.

A Borda do Ícone

- A borda do ícone é um pequeno painel do lado esquerdo do editor, exibindo um pequeno ícone próximo às linhas marcadas.

  Você pode ajustar ou remover um favorito em uma linha visível clicando com o &LMB; na borda do ícone, próximo àquela linha.

  A exibição da borda do ícone pode ser alternada usando o item de menu Ver Mostrar Borda do Ícone.

O Painel dos Números de Linha

- O painel de números de linha exibem os números de linha de todas as linhas visíveis no documento.

  A exibição do Painel de Números de linha pode ser alternado usando o item de menu Ver Mostrar Números da Linha.

Painel Dobragem

- A área de dobragem/desdobramento permite-lhe expandir ou recolher blocos de linhas de código. O cálculo das regiões dobráveis é feito de acordo com regras na definição de realce de sintaxe do documento.

## Também Neste Capítulo:

- Navegando no texto

- Trabalhando com seleção

- Copiando e colando o texto

- Procurando e substituindo texto

- Usando os favoritos

- Quebra de Texto Automática

- Usando o recuo automático

## Navegando no Texto

A movimentação pelo texto no &kappname; é como na maioria dos editores de texto gráficos. O usuário poderá mover o cursor com as teclas dos cursores e com as teclas Page Up, Page Down, Home e End, em conjunto com as teclas modificadoras &Ctrl; e &Shift;. A tecla &Shift; é sempre usada para gerar uma seleção, enquanto a tecla &Ctrl; pode ter efeitos diferentes nas diferentes teclas:

- Para as teclas Cima e Baixo, isto significa deslocar o cursor, em vez de movê-lo.

- Para as teclas Esquerda e Direita, isto significa saltar as palavras em vez de simples caracteres.

- Para as teclas Page Up e Page Down, isto significa ir para o limite visível da janela, em vez de navegar.

- Para as teclas Home e End, isto significa ir para o início ou fim do documento, em vez de ir para o início ou fim da linha.

O &kappname; também lhe oferece uma forma de saltar rapidamente para um parênteses correspondente: Coloque o cursor no interior de um parênteses e pressione &Ctrl;6 para saltar para o parênteses correspondente.

Além disso, você poderá colocar ou retirar um favorito, para saltar para posições definidas por você.

## Trabalhando com Seleção

Existem duas maneiras básicas de selecionar texto no &kappname;: usando o mouse e usando o teclado.

Para selecionar usando o mouse, pressione e mantenha pressionado o &LMB; enquanto arrasta o cursor do mouse de onde a seleção deve iniciar, até o ponto final desejado. O texto fica selecionado quando você arrasta.

O clique duplo em uma palavra seleciona a mesma.

O clique triplo em uma linha seleciona a linha inteira.

Se o &Shift; estiver pressionado enquanto se clica, o texto será selecionado:

- Se nenhum texto já estiver selecionado, da posição do cursor do texto até a posição do cursor do mouse.

- Se existe uma seleção, deste essa seleção até a posição do ponteiro do mouse.

Ao selecionar o texto arrastando o mouse, o texto selecionado é copiado para a área de transferência, e pode ser coloca clicando-se com o botão do meio do mouse no editor, ou em qualquer outro aplicativo para o qual você deseja colar o texto.

Para selecionar usando o teclado, pressione mantenha pressionada a tecla &Shift; usando as teclas de navegação (as setas, Page Up, Page Down, Home e End , possivelmente em combinação com o &Ctrl; para aumentar o movimento do cursor de texto).

Veja também a seção Navegando no Texto , neste capítulo.

Para Copiar a seleção atual, use o item de menu Editar Copiar ou o atalho de teclado (o padrão é &Ctrl;C).

Para Desmarcar a seleção atual, use o item de menu Editar Desmarcar ou o atalho de teclado (o padrão é &Ctrl;&Shift;A), ou clique com o &LMB; no editor.

### Usando a Seleção de Blocos

Quando a Seleção de Bloco estiver habilitada, você pode fazer seleções verticais no texto, o que significa selecionar colunas limitadas de múltiplas linhas. Isto é útil em trabalhos com linhas separadas com tabulações, por exemplo.

A Seleção de Bloco pode ser alternada usando-se o item de menu Editar Modo de Seleção de Bloco. O atalho padrão no teclado é &Ctrl;&Shift;B.

### Usando Seleção de Sobrescrita

Se a Seleção de Sobrescrita estiver habilitada, a digitação ou colagem de texto dentro da seleção causará a substituição do texto selecionado. Se não estiver habilitada, o novo texto será adicionado na posição do cursor do texto.

A Seleção de Sobrescrita está habilitada, por padrão.

Para alterar a configuração desta opção, veja a página Cursor & Seleção da Janela de Configuração.

### Usando Seleção Persistente

Quando a Seleção Persistente estiver habilitada, a digitação de caracteres ou a movimentação do cursor não fará com que a seleção desapareça. Isto significa que você pode mover o cursor para fora da seleção e digitar o texto.

A Seleção Persistente está desabilitada, por padrão.

A Seleção Persistente pode ser ativada na página Cursor & Seleção da Janela de Configuração.

Se a Seleção Persistente e a Seleção de Sobrescrita estiverem ambas habilitadas, a digitação e a colagem de texto, quando o cursor estiver dentro da seleção, farão com que ela seja substituída ou desmarcada.

## Copiando e Colando Texto

Para copiar texto, selecione-o e use a opção do menu Editar Copiar. Adicionalmente, a seleção de texto com o mouse fará com que o texto selecionado seja copiado para a área de transferência.

Para colar o texto contido atualmente na área de transferência, use o item de menu Editar Colar .

Adicionalmente, o texto selecionado com o mouse pode ser colando clicando-se com o botão do meio do mouse na posição desejada.

Se você está usando o ambiente de trabalho &kde;, você pode recuperar textos copiados recentemente de qualquer aplicativo, usando o ícone do &klipper; na área de notificação.

## Procurando e Substituindo Texto

### As Barras para Procurar e Substituir

O &kappname; 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 busca. 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 Adicionar 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 Adicionar 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.

Apenas a seleção

- 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.

### Procurando Texto

Para procurar texto, invoque a barra de pesquisa incremental com a combinação de teclas &Ctrl;F ou com a opção do menu Editar Procurar....

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 e com uma mensagem Não encontrado do lado direito da barra.

Use o botão Próximo ou Anterior para saltar para a próxima ocorrência ou a anterior no documento.

As correspondências 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 Diferenciar maiúsculas de minúsculas, 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 com um ícone da seta verde, à 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 Editar Procurar Próximo ou &Shift;F3 Editar Procurar Anterior.

### Substituindo Texto

Para substituir o texto, invoque a barra avançada de pesquisa e substituição com a opção do menu Editar Substituir 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 campo de texto para inserir o padrão de pesquisa.

Você poderá controlar o modo de pesquisa selecionando as opções Texto Simples, Palavras Completas, Sequências de Escape ou Expressão Regular, que estão descritas acima.

Use o botão Próximo ou Anterior para saltar para a próxima ocorrência ou a anterior no documento.

Insira o texto de substituição no campo de texto Substituir e clique no botão Substituir, para substituir apenas o texto realçado, ou o botão Substituir Tudo para substituir o texto de pesquisa em todo o documento.

Você poderá modificar o comportamento da pesquisa e da substituição se selecionar as diferentes opções no fundo da barra. Selecionar a opção Distinguir a Capitalização irá limitar as pesquisas aos itens que correspondam, a nível de maiúsculas/minúsculas, a cada um dos caracteres no padrão de pesquisa. A opção Apenas a Seleção irá procurar e substituir apenas dentro da seleção atual. O botão Procurar Tudo irá realçar todas as ocorrências no documento e mostrar o número de ocorrências encontradas numa pequena janela.

Clique no botão com o ícone da seta verde, à direita da barra avançada de pesquisa e substituição, para mudar para a barra de pesquisa incremental.

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.

Você poderá `procurar`, `substituir` e `procurar de forma incremental` na linha de comando.

## Usando os favoritos

A característica de favoritos permite a você marcar certas linhas, para ser capaz de encontrá-las facilmente de novo.

Você pode ajustar ou remover um favorito de uma linha de duas maneiras:

- Movendo o cursor de inserção para essa linha e ativando o comando Favoritos Definir Favorito (&Ctrl;B).

- Carregando na Borda do Ícone junto a essa linha.

Os Favoritos estão disponíveis no menu Favoritos. Os favoritos individuais estão disponíveis como itens de menu, rotulados com o número da linha que contém o favorito, e os primeiros caracteres da linha. Para mover o cursor para o início da linha marcada, abra o menu e selecione o favorito.

Para saltar rapidamente entre favoritos ou para o favorito anterior/seguinte, use as opções Favoritos Seguinte (&Alt; PgDown) ou Favoritos Anterior (&Alt;PgUp ).

## Quebra de Texto Automática

Esta característica permite a você ter o texto formatado de uma maneira muito simples: o texto será quebrado, e assim nenhuma linha excederá o número máximo de caracteres por linha, a menos que exista uma string mais longa sem espaços em branco.

Para desabilitar/habilitar isto, desmarque/marque a caixa de verificação Quebra de Linha Estática na página de edição do diálogo de configuração.

Para definir o tamanho máximo da linha (número máximo de caracteres por linha), use a opção Quebrar Linha Em na página de Edição da janela de configuração.

Se habilitada, ele terá os seguintes efeitos:

- Ao digitar, o editor inserirá automaticamente uma quebra de linha após o último espaço em branco na posição antes que o comprimento máximo de linha seja alcançado.

- Ao carregar um documento, o editor quebrará o texto de modo similar, e assim nenhuma linha será maior que o comprimento máximo por linha, se elas contiverem quaisquer espaços em branco pertencentes a ela.

Não existe atualmente um modo de ajustar a quebra de linha por tipo de documento, ou até mesmo habilitar ou desabilitar a característica em um nível de documento. Isto será corrigido em versões futuras do &kappname;.

## Usando o recuo automático

O componente de edição do &kappname; suporta uma variedade de modos de recuo automático, desenhado para os diferentes formatos de texto. Você poderá escolhê-los, entre os modos disponíveis, com a opção Ferramentas Recuar. Os módulos de recuo automático também oferecem uma função Ferramentas Alinhamento, que irá calcular novamente o recuo da linha atual ou a selecionada. Assim, você poderá mudar o recuo do seu documento inteiro, selecionando o texto e ativando essa opção.

Todos os modos de recuo usam a configuração de recuo no documento ativo.

Você poderá definir todos os tipos de variáveis de configuração, incluindo aqueles relacionados com o recuo com as Variáveis do documento e os Tipos de arquivo.

## Modos de recuo automático disponíveis

Nenhum

- Se selecionar este modo, irá desativar o recuo automático.

Normal

- Este sistema de recuo simplesmente mantém o recuo semelhante ao da linha anterior, com o conteúdo que não corresponda a espaços em branco. Você poderá combinar isto com a utilização das ações de recuo e remoção de recuo, para poder recuar de acordo com a sua vontade.

Estilo C

- Um sistema de recuo para o C e para as linguagens semelhantes, como o C++, C#, Java, JavaScript, entre outros. Este sistema não irá funcionar para as linguagens de 'scripting', como o Perl ou o PHP.

Haskell

- Um sistema de recuo específico para a linguagem de programação Haskell.

Lilypond

- Um sistema de recuo específico para a linguagem de notação musical Lilypond.

Lisp

- Um sistema de recuo específico para a linguagem de programação Lisp e respectivos dialetos.

Python

- Um sistema de recuo específico para a linguagem de programação Python.

Estilo XML

- Um sistema de recuo específico para linguagens semelhantes ao XML.

## Indicadores de modificação de linhas

Os indicadores de modificação de linhas do &kappname; permitem-lhe ver facilmente o que você alterou recentemente em um arquivo. Por padrão, as alterações gravadas são indicadas com uma barra verde à esquerda de um documento, enquanto as alterações não gravadas são indicadas com uma barra laranja.

Os indicadores de modificação de linhas em ação.

Você poderá alterar as cores usadas no painel de configuração das Cores & Fontes ou poderá desativar esta funcionalidade por completo na página Bordas do painel de configuração da Aparência.

## O minimapa na barra de rolagem

O minimapa na barra de rolagem exibe uma miniatura dos documentos no local da barra de rolagem. A parte visível do documento será realçada.

O minimapa na barra de rolagem mostra uma miniatura do código-fonte do &kate;.

Você pode ativar ou desativar o minimapa temporariamente selecionando Exibir Mostrar minimapa na barra de rolagem ou de forma permanente na seção Aparência, da configuração do &kappname;.