# 5.4. Comandos da Barra de Menu

## 5.4.1. Gestão de Ficheiros e Impressão

Esta secção cobre as funções que o KDevelop disponibiliza em relação a ficheiros; acedido através do menu de Ficheiros na barra de menu ou pelos respectivos itens na barra de ferramentas:

- Novo Ctrl+N Abre o diálogo "Novo Ficheiro", permitindo criar um novo ficheiro. O ficheiro pode ser criado utilizando diferentes modelos e o nome do ficheiro tem de ser dado bem como o caminho onde o ficheiro será criado.

- Abrir Ctrl+O apresenta o diálogo "Abrir Ficheiro..." e permite-lhe escolher um ficheiro para ser aberto.

- Fechar Ctrl+W Fecha o ficheiro de topo na janela de edição

- Gravar Ctrl+S Grava o ficheiro aberto no topo da janela de edição. Se o ficheiro não tiver ainda sido gravado , o diálogo "Gravar Ficheiro Como..." será aberto para lhe permitir escolher um caminho e nome de ficheiro para o ficheiro a ser gravado.

- Gravar Como... Abre o diálogo "Gravar Ficheiro Como..." para lhe permitir gravar o ficheiro actual com um novo nome de ficheiro

- Gravar Todos Grava todos os ficheiros modificados

- Imprimir... Ctrl+P Abre o diálogo "Imprimir Ficheiro" onde pode definir várias opções de impressão quer utilizando o a2ps, o enscript ou o lpr

- Sair Ctrl+Q Sai do KDevelop. Se ficheiros tiverem sido modificados, ser-lhe-á perguntado se os deseja gravar.

## 5.4.2. Editar Ficheiros

Aqui, o menu "Editar" e os icons correspondentes na barra de ferramentas são cobertos o que permite editar ficheiros. As funções de edição estão também disponíveis através de um menu de contexto no editor.

- Desfazer Ctrl+Z Desfaz a última operação de edição

- Refazer Ctrl+Z permite-lhe fazer de novo o último passo desfeito

- Cortar Ctrl+X corta a selecção e copia-a para a área de transferência do sistema.

- Copiar Ctrl+C copia a selecção para a área de transferência do sistema. Isto também inclui selecções feitas no navegador de documentação.

- Colar Ctrl+V insere o conteúdo da área de transferência na posição actual do cursor.

- Indentar Ctrl+I Indentar move a selecção para a direita

- Des-Indentar Ctrl+U Des-Indentar move a selecção para a esquerda

- Inserir Ficheiro...Ctrl+Insert Permite-lhe inserir um ficheiro e insere o seu conteudo na posição actual do cursor

- Procurar... Ctrl+F Abre um diálogo de busca que procura uma expressão no ficheiro actual. Para uma busca através de vários ficheiros, "Procurar nos Ficheiros..." deverá ser utilizado.

- Repetir Busca F3 Repete a última busca por uma expressão. Isto também inclui buscas que foram feitas sobre a documentação, em que mais de uma ocorrência foi encontrada na mesma página. A ocorrência seguinte será apresentada escolhendo "Repetir Busca" ou F3 e assinalar como marcado.

- Substituir... Ctrl+R Abre o diálogo de "Busca e Substituição" que permite a busca por uma expressão e substituir o texto encontrado por uma nova expressão.

- Procurar nos Ficheiros... Ctrl+Alt+F Apresenta o diálogo "Procurar nos Ficheiros...", que gere o `grep` em directorias inteiras com restrições (wildcards). Os resultados da busca são apresentados com uma lista de ficheiros, linhas e expressões. Escolhendo uma entrada é aberto o ficheiro e o cursor é colocado na linha do resultado da busca

- Seleccionar Tudo Ctrl+A Selecciona todo o texto do ficheiro correntemente aberto na janela de edição de topo

- Des-seleccionar Tudo Des-selecciona todo o texto do ficheiro actual. Isto é utilizado para selecções múltiplas para que não tenha de des-seleccionar cada um separadamente

- Inverter Selecção Inverte a selecção, o que significa que a selecção fica des-seleccionada e o texto que não está seleccionado fica seleccionado.

## 5.4.3. Configuração de Vista

O Menu Ver cobre as funções de abertura e fecho de janelas e comandos para activar/desactivar as barras de ferramentas e estados bem como para ir para erros no código.

- Ir Para a Linha... Ctrl+G Abre um diálogo "Ir Para Linha..." que lhe permite inserir um número de linha para mostrar no ficheiro corrente. O último número de linha é recordado e marcado, para que possa saltar para essa linha de novo ou apenas inserir um novo número de linha que deseje ver.

- Erro Seguinte F4 Salta para o erro seguinte que o KDevelop detectar a partir do output. A mensagem de output do Make ou outra ferramenta deve dar-lhe uma ajuda descritiva do que é o problema, para que possa corrigir o erro.

- Erro Anterior Shift+F4 Salta para o erro anterior que tenha sido reportado.

- Editor de Diálogos Ctrl+D Alterna para o Editor de Diálogos

- Vista de Árvore Shift+T (Des)Activa a janela de Árvore no lado esquerdo da vista principal contendo o Navegador de Classes, VFL, VFR e ADOC.

- Vista de Output Shift+O (Des)Activa a janela de Output no fundo da vista principal.

- Barra de Ferramentas (Des)Activa a barra de ferramentas.

- Barra de Navegação (Des)Activa a barra de navegação, contendo os botões de Seguinte, Anterior e Procurar do Navegador

- Barra de Estados Ctrl+B (Des)Activa a barra de estados.

- Refrescar percorre novamente todos os ficheiros para reconstruir o Navegador de Classes. O progresso do processo de percorrer os ficheiros é mostrado na barra de estados.

## 5.4.4. Criar e Manter Projectos

Esta secção descreve funções que estão disponíveis no menu "Projecto" e é suposto cobrirem a criação e manutenção dos projectos

- Novo... Inicia o KAppWizard e permite-lhe criar um novo projecto escolhendo o tipo de aplicação, nome, versão e outras opções.

- Abrir Mostra o diálogo de Abertura de Projecto, onde pode escolher um ficheiro de projecto KDevelop para ser aberto. Após a selecção, o projecto é aberto.

- Abrir projecto recente... contem um submenu com pelo menos 5 projectos que foram abertos. Pode abrir um projecto mais facilmente utilizando o menu de projectos recentes.

- Fechar Fecha o projecto actual. Isto é basicamente feito automaticamente quando sai do KDevelop, invoca o KAppWizard ou abre outro projecto.

- Nova Classe... Inicia o gerador de classes para crear uma nova classe que será adicionada ao projecto actual. O gerador de classes permite-lhe especificar um nome de classe, herança e nome de ficheiro para a nova classe.

- Adicionar Ficheiro(s) Existente(s) Abre um diálogo de selecção onde pode escolher os ficheiros que deseja adicionar ao projecto actual e o caminho para onde serão copiados. Se escolher um destino que não estava actualmente incluido no projecto, por ex. criando um novo subdirectório, o KDevelop copiará os ficheiros a adicionar ao novoa subdirectório e criará um novo Makefile.am. Após o processo de cópia, o seu projecto será reconstruido pelo automake e autoconf para incluir o novo subdirectório criado no processo do make.

- Adicionar novo ficheiro de tradução Abre um diálogo de selecção de idioma que lhe permite escolher o idioma do ficheiro de tradução que irá ser adicionado ao projecto. Isto é principalmente utilizado por tradutores que podem facilmente adicionar o seu idioma ao projecto e trabalhar na tradução sem ter de se preocupar com os Makefile.am's

- Propriedades de Ficheiros Shift+F7 Abre o diálogo de Propriedades de Ficheiros mostrando uma cópia do VFL e as opções do ficheiro de projecto. Aqui, as propriedades para os seus ficheiros têm de ser definidas tal como o caminho de instalação e tipo de ficheiro.

- Fazer mensagens e juntar Isto tem como objectivo criar o ficheiro de mensagens para o seu projecto. O ficheiro de mensagens é o que contém todas as frases que estão definidas no código para internacionalização e é utilizado pelos tradutores para criar o ficheiro .po para o seu idioma alvo.

- Fazer Doc-API Chama o KDoc sobre os seus ficheiros header e gera um output em HTML com a documentação das classes do seu projecto.

- Fazer Manual do Utilizador executa o ksgml2html sobre o ficheiro sgml do seu manual, criando um manual do utilizador em HTML. Se o ksgml2html não está instalado, o sgml2html será utilizado para fazer isto.

- Fazer Distribuição:

  - tar.gz cria um ficheiro de distribuição do seu projecto actual no directório do projecto e que está pronto para enviar aos utilizadores finais contendo o código fonte do projecto. O utilizador final tem de `tar zxvf seuprojecto.tar.gz` para descompactar o código para um directório e utilizar os comandos standard `./configure, make` e `make install`.

- Opções F7 Abre o diálogo de Opções do Projecto que lhe permite modificar várias definições para o seu projecto. Isto pode ser um novo número de versão ou as opções de compilador para definir -02 para uma distribuição com optimização.

## 5.4.5. Construir Projectos

Esta secção descreve o menu Construir que cobre todas as acções a serem feitas com o make ou acções como reconstruir a documentação ou ajuda electrónica do projecto.

- Compilar ficheiro... Ctrl+F8 Activo, se a janela de topo de edição é a Janela C++. Isto apenas compila o ficheiro actual de implementação e permite-lhe poupar tempo no caso de suspeitar de erros.

- Make F8 Invoca o comando make para o seu projecto e constroi o alvo.

- Reconstruir Tudo Reconstroi todos os ficheiros objecto e o alvo do seu projecto.

- Limpar Reconstruir Tudo Limpa o directório do projecto de todos os ficheiros criados pelo make e reconstroi o alvo.

- Parar Construção F10 Pára o processo em curso.

- Executar F9 Executa o seu alvo após construir o programa com o make.

- Executar com Argumentos Alt+F9 Executa o seu alvo com argumentos. Primeiro, um diálogo surge para lhe permitir especificar os argumentos de execução (que são gravados no projecto para a próxima sessão), depois a sua aplicação utiliza a linha de comando inserida. Lembre-se que a sua aplicação é iniciada directamente do directório do projecto

- Depurar... Abre o KDbg na Janela de Ferramentas para depurar a sua aplicação. Neste caso, o KDbg abre automaticamente o ficheiro contendo a função main() e executa a sua aplicação.

- Distclean Remove todos os ficheiros que são gerados pelo projecto tal como ficheiros objecto etc. Distclean tem de ser feito antes de distribuir o seu projecto, para que o ficheiro de distribuição não contenha nenhum ficheiro específico de plataforma tal como aquelas geradas pelo seu compilador.

- Autoconf e automake Chama o Make sobre o ficheiro Makefile.dist, localizado no seu directório principal do projecto. O Makefile.dist contém todos os comandos para o automake, autoconf etc. para construir o seu projecto. Se adicionou ficheiros manualmente ou modificou macros, deve correr o Autoconf depois, seguido do Configure para recriar todos os Makefiles.

- Configurar Executa o script configure gerado pelo autoconf. Se este comando não puder ser executado, corra o Autoconf e depois o Configure de novo.

## 5.4.6. Chamar Ferramentas

O menu de Ferramentas cont´me por defeito as entradas para o Editor de Diálogos interno (que pode também ser iniciado pelo botão da barra de ferramentas) e os seguintes programas se instalados: KDbg, KIconEdit e KTranslator. Estes são procurados pelo programa de instalação do KDevelop e inseridos na ordem indicada no menu. Invocar uma ferramenta irá abrir a janela de "Ferramentas" e iniciar o programa seleccionado dentro desta janela. O menu de Ferramentas pode ser editado pela entrada Ferramentas no menu de Opções; veja Configurar o Menu "Ferramentas").

## 5.4.7. Alterar as Definições do KDevelop

O menu de Opções contém todas as entradas para invocar diálogos de configuração com os quais pode alterar as definições de defeito do KDevelop. Definições principais tais como as do editor ou impressão têm as suas entradas específicas; definições gerais do comportamento do KDevelop podem ser feitas com o diálogo de Configuração do KDevelop.

- Editor... Permite a configuração do comportamento do editor tal como a quebra de palavras, selecções etc.

- Cores do Editor... Aqui, pode definir a configuração de cores do editor tal como por ex. o fundo.

- Defeitos do Editor... Isto define a apresentação por defeito tal como fontes e tamanho de letra do editor

- Realce de Sintaxe Este diálogo permite-lhe definir as fontes e cores para o realce de várias linguagens de programação, incluindo HTML, e o realce dos tipos-mime também será activada.

- Navegador de Documentação Neste diálogo de pastas, pode definir as fontes, tamanhos e cores para o navegador de ajuda interno

- Configuração de Impressora... Contém as entradas para o diálogo de configuração da impressora de acordo com o programa de impressão utilizado, a2ps ou enscript.

  - a2ps Configura a impressora para utilização com o a2ps. Veja Imprimir para mais informações.

  - enscript Configura a impressora para utilização com o enscript. Veja Imprimir para mais informações.

- Ferramentas... Abre o diálogo de Configuração de Ferramentas. Aqui, pode configurar o menu "Ferramentas" adicionando ou removendo programas que serão iniciados na janela de Ferramentas.

- Configuração do KDevelop Abre o diálogo de Configuração do KDevelop. A primeira pasta configura definições gerais, seguida das definições principais e de Documentação. As definições de Documentação também incluem a geração dum novo conjunto de documentação HTML de bibliotecas e a reconstrução do index de busca para o navegador de Ajuda.

## 5.4.8. O Menu Janela

O menu Janela contém uma lista com todos os ficheiros actualmente abertos. Isto permite ir rapidamente para outro ficheiro em que esteja correntemente a trabalhar.

## 5.4.9. Gerir Marcas de Leitura

O menu de Marcas de Leitura é destinado para adicionar e remover marcas de leitura que deseje colocar no ficheiro correntemente em edição. Como o KDevelop utiliza duas janelas de edição, cada uma configura as suas marcas de leitura separadamente.

- Definir Marca de Leitura Abre um menu de contexto com até nove marcas de leitura configuráveis. Isto permite definir uma marca de leitura para uma dada entrada no menu de marcas de leitura por razões lógicas.

- Adicionar Marca de Leitura Ctrl+Alt+A Adiciona a linha da posição actual do cursor ao menu de marcas de leitura como uma marca de leitura. tenha em atenção que isto pode sobrepor uma marca de leitura definida com a opção Definir Marca de Leitura. Se o navegador estiver aberto, uma marca de leitura será adicionada ao menu de marcas de leitura da Janela de Navegação.

- Limpar Marcas de Leitura Ctrl+Alt+C Limpa as entradas de marcas de leitura para a janela de edição no topo ou o navegador, por ex. se a Janela de Header é visível e chamar Limpar Marcas de Leitura, as entradas para a Janela de Header serão apagadas.

- Janela de Header Contém a lista de marcas de leitura para a Janela de Header. Seleccionando uma marca de leitura colocará o cursor na linha da maraca de leitura seleccionada. Tome nota que a marca de leitura só é atribuida ao ficheiro em que é definida, pelo que se mudar de ficheiro, as marcas de leitura não são apagadas mas escolher uma marca de leitura não irá para o ficheiro onde ela foi definida.

- Janela C/C++ Contém a lista de marcas de leitura para a Janela C/C++. As opções são as mesmas que para a Janela de Header.

- Janela de Navegação Contém as marcas de leitura do navegador. Seleccionando uma marca de leitura irá abrir o navegador na página seleccionada.

## 5.4.10. Ajuda Electrónica

O menu de Ajuda contém entradas para navegação no navegador de Ajuda bem como as entradas para documentação electrónica e de bibliotecas para os mais utilizados recentemente. Aceder a documentação electrónica adicional pode ser conseguido com a ADOC na vista de árvore automaticamente aberta (se a Auto-Alternância estiver activa) quando se muda para a janela do Navegador de Documentação.

- Recuar Alt+ Seta para Esquerda Abre a página aberta antes da actual.

- Recuar Alt+ Seta para Direita Abre a página seguinte na história do navegador, disponível após se ter feito um "Recuar".

- Procurar Texto Marcado F2 Procura no índice de busca o texto correntemente marcado nas janelas de edição ou na janela de navegação. Após a busca, uma página com os resultados é apresentada que lhe permite seleccionar a página de ajuda para onde ir. Após escolher a página, o navegador irá realçar a ocorrência encontrada para a expressão com que a busca foi invocada. Com a tecla F3 o próximo resultado de busca na mesma página será apresentado se mais de uma ocorrência foi reportada para a busca numa página.

- Procurar Ajuda Sobre... Abre o diálogo Procurar Ajuda Sobre... que lhe permite procurar por uma expressão específica sobre a qual deseja ajuda.

- Manual do Utilizador F1 Abre o Manual do Utilizador do KDevelop na página de ínice para que tenha acesso a este manual.

- Manual de Programação Abre o Manual de Programação do KDevelop na página de índice para aceder ao manual de programação.

- Dica do Dia Abre o diálogo da Dica do Dia para o informar sobre as características do KDevelop.

- Página do KDevelop Abre a página de internet do KDevelop na janela de navegação se existir acesso à internet.

- Reporte de Erros... Abre o diálogo de Reporte de Erros do KDevelop, onde pode enviar um relatório de erro directamente para a Equipa do KDevelop por e-mail. Veja Reporte de Erros de Código (Bugs)

- Referência C/C++ Apresenta a página de índice da referência da linguagem. Se a referência não estiver instalada, uma página de erro explica-lhe como obter a referência e como a instalar correctamente.

- Biblioteca Qt Vai para a página de índice da documentação da biblioteca Qt disponibilizada com a sua cópia da biblioteca Qt.

- Biblioteca KDE-Core Abre o ficheiro de índice de classes da documentação da biblioteca KDE-Core.

- Biblioteca KDE-GUI O que acima foi dito mas para a biblioteca GUI

- Biblioteca KDE-KFile O que acima foi dito mas para a biblioteca KFile

- Biblioteca KDE-HTML O que acima foi dito mas para a biblioteca HTML

- Doc da API do Projecto Vai para o índice da documentação das classes do projecto.

- Manual do Utilizador do Projecto Abre o ficheiro de índice do manual do utilizador para o projecto actual. Isto pode ser utilizado para rever o resultado em HTML gerado pelo ksgml2html

- Sobre o KDevelop... Mostra a caixa Sobre o KDevelop contendo o número da versão utilizada e os nomes dos autores e endereços de e-mail bem como a referência ao licenciamento do KDevelop.