The K Desktop Environment

Página seguinte Página anterior Índice geral

7. Trabalhar com o Editor

Uma parte importante do ambiente integrado de desenvolvimento é o editor. Você usa-o para:

Geralmente, o editor em si não faz muita diferença em comparação com outros editores; especialmente pois é uma versão incorporada do popular KWrite, também conhecido como "Editor Extendido". Se está familiarizado com ele, não terá quaisquer problemas a utiliza-lo para gerir os seus projectos. Em adição aos editores normais, o KDevelop contém um novo sistema de impressão, que tem muitas mais características para utilização com código fonte- e você pode escolher qual o programa de impressão que deseja utilizar.

Esta secção dá-lhe mais informação sobre como gerir os ficheiros do seu projecto e familiariza-lo com as funcionalidades do editor. Muitos dos utilizadores mais antigos de Unix prefeririam utilizar o Emacs ou XEmacs- estão à vontade com eles. Mas não é necessário simplesmente para programar, e especialmente para iniciados, é difícil habituarem-se a editores potentes que irão, no fim de contas, apenas permitir introduzir o seu código.

7.1 Gerir Ficheiros do Projecto

As secções seguintes descrevem como criar, gravar, abrir e fechar os ficheiros do seu projecto que necessita editar- lembre-se que isto não inclui os ficheiros de tradução ou imagens. Esses são reconhecidos automaticamente e o programa de edição correspondente tal como o KTranslator abre esses ficheiros para sí.

Para lhe permitir um acesso fácil aos seus ficheiros, o KDevelop contém duas vistas de árvore fáceis de utilizar, similares a um gestor de ficheiros, que reconhece se seleccionou um ficheiro, e abre-o na janela de edição correspondente. A vista principal contém duas janelas que são utilizadas independentemente, mas conectadas através do Editor de Projecto, pelo que pode fazer todas as acções de menu da mesma forma. A intenção por trás disto é que lhe permite manusear duas janelas ao mesmo tempo, apesar de que apenas uma se encontra visível. A janela C/C++ toma assim outra tarefa, que lhe permite facilmente compilar o seu código ficheiro a ficheiro, para que possa verificar as implementações sem ter de executar um processo de construção completo do seu projecto.

Isto pode ser conseguido tendo a janela C/C++ no topo. Seleccione "Compilar Ficheiro" a partir do menu Construir ou pressione o botão correspondente na barra de ferramentas. O seu ficheiro é gravado e compilado, e pode controlar quaisquer erros do compilador pela janela de output.

Dentro do ambiente de desenvolvimento pode ter abertas quantos ficheiros de texto desejar. Todos os ficheiros abertos são listados no menu Janela, para que possa alternar entre eles seleccionando o correspondente nome de ficheiro a partir do menu. Ainda mais, o ficheiro actualmente aberto é apresentado com o seu nome na moldura de janela do KDevelop.

Criar e Gravar Ficheiros

Para criar um ficheiro novo, escolhe "Novo" a partir do menu Ficheiro ou seleccione "Adicionar Ficheiro(s) ao projecto"->"Novo Ficheiro". Isto abre o diálogo "Novo Ficheiro", onde pode especificar o nome e tipo de ficheiro. Adicionalmente, tem de definir o directório de destino bem como se o ficheiro é adicionado ao projecto ou não. Finalmente, pode também utilizar o seu modelo de cabeçalho para o projecto no caso de querer adicionar um novo ficheiro de código sem gerar uma nova classe através do Gerador de Classes.

Após o ficheiro ter sido criado, pode editar o novo ficheiro normalmente; se tem de alternar entre ficheiros diferentes, pode sempre voltar atrás ao ficheiro quer através da árvore de ficheiros ou do menu Janela.

Para gravar quaisquer alterações, o KDevelop oferece uma variedade de opções. A forma standard seria gravar o ficheiro seleccionando "Gravar" ou "Gravar Como " a partir do menu Ficheiro ou através do botão Gravar na barra de ferramentas. Para gravar todos os ficheiros alterados de uma vez, poderia também seleccionar "Gravar Todos" a partir do menu Ficheiro.

Agora, quando a trabalhar num projecto, é muito irritante se algo crítico acontece após ter feito imensas alterações aos seus ficheiros; algumas vezes irá morder-se a si próprio por se ter esquecido de gravar as alterações. O KDevelop toma conta disto oferecendo "Auto-gravação", que está activada por defeito e definida para gravar todos os ficheiros em intrevalos de 5 minutos. Para seleccionar outro período de gravação ou desactivar isto, veja Configuração do KDevelop, onde as opções de configuração são descritas.

Adicionalmente, o KDevelop toma conta de todas as alterações se abrir outro projecto ou sair do KDevelop. Ser-lhe-á perguntado se deseja gravar os ficheiros modificados, onde poderá também ter a opção de espeificar quais gravar e quais manter como estavam anteriormente. Além disso, quando se invoca qualquer processo de construção, os seus ficheiros são gravados automaticamente, pelo que nunca se perguntará porque a sua aplicação não corre da forma que esperava após ter modificado o seu código fonte. A única excepção é o comando "Compilar Ficheiro", que apenas grava o ficheiro de código actualmente aberto e visível na janela de código do editor.

Abrir e Fechar Ficheiros

Para abrir um ficheiro de código, também tem imensas opções. Uma poderia ser, como é standard para os editores, seleccionar "Abrir" a partir do menu Ficheiro. Ser-lhe-á apresentado um diálogo "Abrir Ficheiro", que lhe permite escolher o ficheiro que deseja editar. Outra forma, provavelmente mais frequentemente utilizada é seleccionar o ficheiro a partir do VLF, o Visualizador Lógico de Ficheiros, ou do VRF, o Visualizador Real de Ficheiros (veja Overview ). A vantagem das árvores de ficheiro é que proporcionam um acesso visual rápido aos seus ficheiros, especialmente o VLF, que apenas apresenta os ficheiros do seu projecto pelo seu tipo, agregados dentro de pastas. Pode também configurar o VLF no sentido de ordenar os seus ficheiros de outra forma através de um clique do botão direito do rato sobre a árvore. Seleccione "Novo Grupo" a partir do menu de contexto, e pode configurar um novo grupo, ou seleccionar "Editar Grupo" para instalar um novo filtro de ficheiro especificando as extenções de ficheiros do grupo, separadas por vírgulas.

Os grupos de ficheiros standard para um projecto gerado pelo KAppWizard são os Headers, Código, GNU e Outros. Adicionalmente, após adicionar um ficheiro de tradução, o KDevelop adiciona uma pasta "Traduções", contendo os seus ficheiros *.po.

Para fechar ficheiros, seleccione o ficheiro a fechar a partir do menu Janelamenu, que lê o ficheiro aberto para o editor de topo. Depois seleccione "Fechar" a partir do menu Ficheiro. Se o seu ficheiro tiver sido modificado, ser-lhe-á perguntado se o deseja gravar. Quando fechar um projecto, todos os ficheiros correntemente abertos serão verificados por alterações e ser-lh-é também perguntado se os deseja gravar.

7.2 Navegar dentro dos Ficheiros

De seguida ser-lhe-ão dadas linhas gerais de orientação sobre como localizar certas posições dentro dos seus ficheiros para um acesso mais rápido.

» Como encontrar uma certa linha num ficheiro

  1. Seleccione "Linha" no menu "Ver" ou prima STRG+L. O diálogo preenchido "Ir para Linha" surge.
  2. Insira o número da linha para onde deseja ir.
  3. Prima OK.

» Como definir uma marca de leitura

  1. Coloque o cursor na linha que deseja aceder através da marca de leitura
  2. Seleccione "Definir Marca de Leitura" através do menu "Marcas de Leitura".
  3. Um menu de contexto surge que lhe permite seleccionar o número da marca de leitura que deseja definir para a nova marca.
  4. Seleccione o número da marca de leitura.

Outra forma de definir marcas de leitura seria seleccionar "Adicionar Marca de Leitura" a partir do menu "Marcas de Leitura". Isto define uma marca para a linha actual e acrescenta a marca à lista de marcas de leitura. O navegador de documentação também oferece a definição de marcas de leitura para a página actual através de um menu de contexto na entrada "Adicionar Marca de Leitura".

» Como apagar marcas de leitura

As marcas de leitura são definidas para cada janela de edição separadamente- lembre-se que as suas marcas não estão conectadas com um dado ficheiro em que tenha definido uma marca de leitura. Para apagar todas as marcas de leitura, seleccione "Apagar Marcas de Leitura" a partir do menu "Marcas de Leitura". Isto apaga as marcas para a janela actualmente no topo, quer seja a janela de Header, a janela C++ ou a janela de navegação.

» Como ir para uma linha marcada

  1. Seleccione o menu "Marcas de Leitura" e abra o menu de contexto contendo as marcas de leitura para a janela cujas marcas deseja ver; poderá ser a entrada de janela C++ ou de janela Header.
  2. Seleccione a linha marcada.

Seleccionar uma marca de leitura para uma janela de navegação irá abrir o navegador e ler a página.

7.3 Trabalhar com Atalhos de teclado

Para utilizar o editor, deverá tornar-se acostumado com alguns atalhos de teclado que lhe tornam a vida mais fácil para posicionar o cursor e editar o ficheiro. A referência completa de atalhos de teclado está também listada na secção Descrição Geral.


uma letra para a esquerda                        Seta para a Esquerda
uma letra para a direita                         Seta para a Direita
uma palavra para a esquerda                      CTRL+Seta para a Esquerda
uma palavra para a direita                       CTRL+Seta para a Direita
uma linha para cima                              Seta para Cima
uma linha para baixo                             Seta para Baixo
para o princípio da linha                        POS 1
para o fim da linha                              END
uma página para cima                             PageUp
uma página para baixo                            PageDown
para o princípio do ficheiro actual              CTRL+PageUp
para o fim do ficheiro actual                    CTRL+PageDown
uma letra para a esquerda                        SHIFT+Seta para a Esquerda
uma letra para a direita                         SHIFT+Seta para a Direita
uma palavra para a esquerda                      CTRL+SHIFT+Seta para a Esquerda
uma palavra para a direita                       CTRL+SHIFT+Seta para a Direita
uma linha para cima                              CTRL+Seta para Cima
uma linha para baixo                             CTRL+Seta para Baixo
para o princípio da linha                        CTRL+POS 1
para o fim da linha                              CTRL+END
uma página para cima                             SHIFT+PageUp
uma página para baixo                            SHIFT+PageDown
para o princípio do ficheiro actual              CTRL+SHIFT+PageUp
para o fim do ficheiro actual                    CTRL+SHIFT+PageDown
(des)activar modo de inserção                    INS
copiar selecção para a área de transferência     CTRL+C, CTRL+INS
inserir texto da área de transferência           CTRL+V, SHIFT+INS
apagar a linha actual                            CTRL+K
inserir linha após a linha actual                END, depois Enter
inserir linha antes da linha actual              POS 1, depois Enter
desfazer passo de edição                         CTRL+Z
re-fazer passo de edição                         CTRL+Y
tabulador                                        TAB
apagar letra à esquerda da posição do cursor     Backspace
apagar letra à direita da posição do cursor      Delete
apagar texto seleccionado                        Seleccionar texto, depois Backspace

7.4 Editar Definições de Janelas

O editor dentro do KDevelop pode ser configurado no sentido de necessidades especiais de edição com efeito global para todas as janelas de edição. Assim pode definir modos de cores, cores de realce (também configurável em relação à linguagem de programação do ficheiro) e definições de texto automaticas tais como dimensão da tabulação e modos de selecção. De seguida iremos ver como definir estas opções através dos diálogos de configuração disponibilizados no menu de "Opções"menu.

Definições Gerais

As definições gerais do editor podem ser configuradas com a entrada "Editor" no menu de "Opções". Seleccione os valores desejados e prima OK após terminar com a sua configuração.

Opções de Edição

Indentação Automática:

especifica que o editor deverá colocar o cursor por baixo do primeiro literal quando se inicia uma nova linha.

Indentação de Backspace:

esta opção define que o cursor deverá ser movido para baixo do primeiro literal da linha de cima quando a tecla backspace é premida.

Translineamento:

as palavras são levadas para a linha seguinte após a coluna definida em "Translinear Palavras em:"

Substituir Tabs:

tabuladores no texto actual são substituidos por tabuladores do valor "Comprimento de Tab:"

Remover Espaços Finais:

remove os espaços no final das linhas

Translinear Cursor:

coloca o cursor no final da última linha quando o backspace leva ao início de uma linha

Parentesis Automáticos:

cria um parentesis de fecho em frente do cursor sempre que (qualquer tipo de) parentesis é aberto (parentesis curvos e rectos, chavetas, etc.).

Seleccionar Opções

Selecções Persistentes:

selecções feitas ficam marcadas após colocar o cursor noutro local

Selecções Multiplas:

permite selecções multiplas independentes dentro de um texto

Selecções Verticais:

quando a seleccionar multiplas linhas, a selecção é também feita na horizontal e não cobre toda a linha

Apagar na Inserção:

apaga uma selecção quando se escreve na selecção.

Alternar Antiga:

permite apenas uma selecção. Uma selecção feita é des-seleccionada quando outra selecção é feita.

Translinear Palavras em:

define o número máximo de colunas que uma linha pode ter. A palavra que contém a letra que alcança este valor será automaticamente quebrada para a linha seguinte.

Cores

Para alterar a aparência geral do editor, pode definir um conjunto de cores que o editor utiliza através da entrada "Cores do Editor" a partir do menu "Opções". Pode configurar as cores para:

Realce de Sintaxe

O modo de realce de sintaxe do editor do KDevelop pode ser configurado através de dois diálogos; primeiro pode definir as cores por defeito para o realce de sintaxe através da entrada "Defeitos do Editor" no menu "Opções". Aí, pode definir cores e fontes bem como o tamanho das fontes por ex. palavras-chave. Seleccione o item por defeito e defina todas as opções necessárias.

O segundo diálogo de configuração é acedido através da entrada "Realce de Sintaxe" no menu "Opções". Isto permite-lhe definir os filtros de ficheiros para a linguagem de programação, por ex. *.cpp, *.h para C++. Depois seleccione o item que deseja configurar. Se desejar utilizar os valores por defeito que definiu no diálogo "Defeitos do Editor", seleccione as caixas de escolha "defeito" nas selecções Estilo-Item e Fonte-Item. Isto lê as definições por defeito para o item seleccionado. Após premir OK, os seus novos valores serão activados e utilizados pelo editor.

7.5 Procurar e Substituir

Procura num Único Ficheiro

» Como encontrar um ou mais caracteres na janela de edição actual

  1. Seleccione "Procurar" a partir do menu "Editar". Isto abre um diálogo de procura.
  2. Especifique a expressão a procurar no campo de edição. O menu de caixa permite a escolha de uma expressão de busca anterior.
  3. Seleccione opções adicionais tais como "Apenas Palavras Inteiras"
  4. Prima OK.

Para repetir a busca por uma expressão inserida no diálogo de procura, prima F3.

Procurar em Vários Ficheiros

Como a função de procura está a realizar buscas sobre apenas um ficheiro que está actualmente visível, encontra-se limitado a isto. Mas muitas vezes você deseja procurar a mesma expressão em todo o seu projecto. Assim, o KDevelop contém um diálogo grep, que lhe permite procurar sobre todos os ficheiros que especificar quer através da definição do directório onde iniciar a busca e/ou por tipos mime. Especificando o directório exacto e o tipo mime irá assim reduzir o tempo que o KDevelop necessita para ler os ficheiros e apresentar os resultados. Para iniciar uma busca sobre vários ficheiros, seleccione "Procurar nos ficheiros..." a partir do menu "Editar". O diálogo deprocura abre e permite-lhe inserir:

Por defeito, o diálogo grep está definido para iniciar no directório do seu projecto e trabalhar recursivamente sobre os ficheiros de implementação e header.

Pode até ampliar o seu padrão de busca utilizando as seguintes opções:

  1. . Equivale a qualquer caractere
  2. ^ Equivale ao princípio de uma linha
  3. $ Equivale ao fim de uma linha
  4. \< Equivale ao princípio de uma palavra
  5. \> Equivale ao fim de uma palavra

Para uma busca repetida, pode também utilizar os operadores disponíbilizados:

  1. ? O item precedente é encontrado menos de uma vez
  2. * O item precedente é encontrado zero ou mais vezes
  3. + O item precedente é encontrado uma ou mais vezes
  4. { n } O item precedente é encontrado exactamente n vezes
  5. { n,} O item precedente é encontrado n ou mais vezes
  6. {,n } O item precedente é encontrado menos de n vezes
  7. {n,m} O item precedente é encontrado pelo menos n vezes mas menos de m vezes

Referências anteriores a subexpressões dentro de aspas estão também disponíveis através da notação \n.

Após especificar a sua busca, prima "Procurar". Os resultados são então apresentados na janela de resultado. Para ir para um ficheiro e número de linha, seleccione a linha do resultado e prima Enter ou clique duplo sobre o resultado. O editor irá automaticamente abrir o ficheiro correspondente e colocar o cursor na linha do resultado. Isto permite uma especificação completa para qualquer acção de procura e devolve resultados exactos.

O KDevelop oferece também algumas funcionalidades mais específicas para a utilização do grep dentro do editor e do navegador. Seleccione a expressão que deseja procurar em qualquer uma das janelas e prima SHIFT+F2 ou seleccione "grep:<sua_expressão>" a partir do menu de contexto acessível pelo botão direito do rato. Isto irá pedir ao grep para procurar pela selecção nos ficheiros no directório do seu projecto e mostrará os resultados imediatamente. Ir para o resultado funciona como descrito acima. A partir da janela de navegação, basta colocar o cursor sobre uma palavra e iniciar a procura; a palavra por baixo do cursor será o padrão de procura.

Procurar dentro da Documentação

Enquanto a trabalhar num projecto, muitas vezes você necessita de ter informação sobre parâmetros de funções membras que deseja utilizar- quase sempre você lembra-se do nome da função que responde às suas necessidades, mas os parâmetros são algo muito difícil de memorizar. Assim, e para outros propósitos que possam ocorrer, o KDevelop contém uma funcionalidade de procura que combina a busca de expressões que surgem dentro dos seus ficheiros com o navegador de documentação. Para fazer uso desta funcionalidade de busca, você deverá ter definido o navegador de documentação correctamente e criado a base de dados de pesquisa. Para invocar uma procura através da documentação, faça o seguinte:

  1. coloque o cursor na palavra que deseja procurar ou seleccione uma expressão
  2. seleccione "Procurar Texto Marcado" a partir do menu "Ajuda" ou prima o botão direito do rato para abrir o menu de contexto; depois seleccione "Procurar : "expressão".
  3. após a página de resultados da busca ser apresentada no navegador de documentação, seleccione a página que pensa conter a informação de que necessita.
  4. a página de documentação seleccionada é apresentada e o resultado da sua procura é marcado. Para observar o resultado seguinte dentro da mesma página de documentação, prima F3.

Isto permite-lhe procurar facilmente a informação de que necessita. Para utilizar os resultados, o navegador de documentação permite marcar uma selecção e copia-la para a área de transferência. Depois volte para o ficheiro que estava a editar e seleccione "Colar" a partir do menu "Editar".

Para uma descrição completa de como utilizar a Documentação, veja Utilizar o Índice de Busca.

Substituir Texto

Para substituir uma expressão, seleccione "Procurar e Substituir" a partir do menu "Editar". O diálogo de "Procurar e Substituir" permite-lhe especificar a expressão a ser substituida bem como a expressão de substituição. Depois prima OK. A primeira expressão que for encontrada será marcada, pelo que pode ver onde a expressão está e em que contexto. Depois pode especificar através de um diálogo se a expressão será substituida ou não. Quando a busca estiver terminada por atingir o final do ficheiro actual, ser-lhe-á perguntado se deseja re-iniciar a procura de novo a partir do início do ficheiro. Se tiver terminado, seleccione "Cancelar".

7.6 Imprimir

Como o KDevelop está desenhado para dar aos programadores o melhor acesso aos ficheiros e informação para reduzir o ciclo de desenvolvimento, também contém um novo utilitário de impressão que faz uso de dois programas de impressão comuns disponíveis para sistemas Unix, a2ps (ASCII-para-Postscript) e enscript. Para além destes, pode também imprimir directamente utilizando o lpr (o dispositivo de impressão linear). Como a utilização do a2ps ou enscript oferecem o maior número de opções de impressão, deverá instalar qualquer um deles no seu sistema; ambos os programas são normalmente enviados com as distribuições, pelo que não deverá ter qualquer problema em os obter. Mas antes de imprimir, deverá percorrer os diálogos de configuração disponíveis para preparar o resultado final de acordo com as suas necessidades. As secções seguintes descrevem como configurar o KDevelop para imprimir ficheiros.

Configurar a Impressora

Ambos os programas de impressão podem ser configurados seleccionando "Imprimir" a partir do menu "Ficheiro"; no diálogo de impressão, seleccione o programa através do menu de caixa no canto superior esquerdo. Depois prima o botão "Opções" à direita. Isto irá abrir a configuração para o programa seleccionado que será utilizado. Outra forma de configurar os programas é seleccionando "Configuração de Impressora..." a partir do menu "Opções"; depois seleccione "a2ps" ou "enscript".

As Opções de Configuração do a2ps

Imprimir

Impressão de Texto

Numeração

As Opções de Configuração enscript

Cabeçalho

Data & Hora

Aspecto Final

Marca de Água

O Diálogo de Impressão

Opções de Impressão Directa

Selecção de Ficheiros

O diálogo de selecção de ficheiros é acedido através do botão "Ficheiros" no diálog de impressão. A selecção de ficheiros permite especificar que ficheiros imprimir através de certos critérios:

Ver Antes

Ver Antes está disponível para que você possa controlar qual será o aspecto do resultado final. Assim, o KDevelop utiliza o programa ghostview ou kghostview. Quando o botão de ver antes for premido em qualquer um dos diálogos de impressão, ser-lhe-á apresentado um modelo de output que lhe mostra o efeito das opções actualmente definidas.

Página seguinte Página anterior Índice geral