# Usar o &kturtle;

Aqui está uma imagem do &kturtle; em acção
Janela Principal do &kturtle;

A janela principal do &kturtle; tem três componentes principais: o editor de código (3) à esquerda, onde você escreve os comandos de &turtlelang;, o inspector (4) que lhe dá informações acerca das variáveis durante a execução do programa e a área de desenho (5) à direita, onde as instruções são visualizadas. A área de desenho é a área de recreio da tartaruga; é na área de desenho que a tartaruga se move e desenha. Os três outros locais da janela principal são: o menu (1) onde todas as acções podem ser acedidas, a barra de ferramentas (2) que lhe permite seleccionar rapidamente as acções mais utilizadas e a barra de estado (6) onde você irá encontrar alguma informação sobre o estado do &kturtle;.

## O Editor de Código

No editor de código, você poderá escrever os comandos de &turtlelang;. Ele tem todas as funcionalidades que você estaria à espera num editor moderno. A maioria das suas funcionalidades são encontradas no menu Editar. O editor de código pode ser acoplado a qualquer um dos lados da janela principal ou poderá ser destacado e colocado em qualquer local do seu ecrã.

Você tem várias formas de obter algum código no editor. A forma mais fácil é usar um exemplo já feito. Você escolhe o Ficheiro Exemplos no menu Ficheiro, onde poderá carregar num ficheiro. O ficheiro que escolher será aberto no editor de código, você poderá ir então a Ficheiro Executar para correr o código se o desejar.

Você poderá abrir os ficheiros de &turtlelang; se escolher Ficheiro Abrir....

A terceira forma é escrever directamente o seu código no editor ou copiar/colar algum código deste guia de utilizador.

A posição do cursor é indicada na barra de estado à direita, com o número da Linha e da Coluna.

## O Inspector

O inspector informa-o das variáveis, as funções aprendidas e a árvore de código enquanto o programa está em execução.

O inspector poderá ser acoplado a cada extremo da janela principal ou poderá ser destacado e colocado em qualquer ponto do seu ecrã.

## A Área de Desenho

A área de desenho é a área onde os comandos são visualizados, ou seja, onde estes desenham uma imagem. Por outras palavras, é o espaço de recreio da tartaruga. Depois de introduzir algum código no editor de código e de o executar com Ficheiro Executar, duas coisas poderão acontecer: ou o código executa na perfeição e você poderá ver algo a mudar na área de desenho, ou você tem um erro no seu código e existirá uma mensagem que lhe dirá qual o erro que você cometeu.

Esta mensagem devê-lo-á ajudar a resolver o erro.

Poderá ampliar e reduzir a área de desenho com a roda do seu rato.

## A Barra de Menu

No menu, você irá encontrar todas as acções do &kturtle;. Estas estão nos seguintes grupos: Ficheiro, Editar, Ver, Ferramentas, Configuração e Ajuda. Esta secção descreve-as a todas.

### O Menu Ficheiro

&Ctrl;N Ficheiro Novo

  Cria um ficheiro de &turtlelang; novo, vazio.

&Ctrl;O Ficheiro Abrir...

  Abre um ficheiro de &turtlelang;.

Ficheiro Abrir um Recente

  Abre um ficheiro de &turtlelang; que foi aberto recentemente.

&Ctrl;S Ficheiro Gravar

  Grava o ficheiro de &turtlelang; aberto de momento.

Ficheiro Gravar Como...

  Grava o ficheiro de &turtlelang; aberto de momento num local à escolha.

Ficheiro Exemplos

  Mostra a pasta com os programas de exemplo do &turtlelang;. Os exemplos deverão estar na sua língua favorita, a qual poderá escolher em Configuração Linguagem de Programação.

Ficheiro Velocidade

  Apresenta uma lista com as velocidades de execução possíveis, consistindo em: Velocidade Completa, Lento, Mais Lento, Lentíssimo e Passo-a-Passo. Quando a velocidade é igual a Velocidade Completa (por omissão), poderá não conseguir ver o que se está a passar. Em alguns dos casos este comportamento poderá ser o desejado, mas noutros casos poder-se-á querer ter uma ideia da execução. No último caso, poderá querer configurar a velocidade da execução como Lento, Mais Lento e Lentíssimo. Quando um dos modos lentos for seleccionado, a posição actual de execução será mostrada no editor. O Passo-a-Passo irá executar um comando de cada vez.

F5 Ficheiro Executar

  Inicia a execução dos comandos no editor de código.

F6 Ficheiro Pausa

  Coloca a execução em pausa. Esta acção só fica activa quando os comandos estiverem de facto a ser executados.

F7 Ficheiro Interromper

  Pára a execução; esta acção só fica activa quando os comandos estiverem de facto a ser executados.

&Ctrl;P Ficheiro Imprimir...

  Imprime o código actual no editor.

&Ctrl;Q Ficheiro Sair

  Sai do &kturtle;.

### O Menu Editar

&Ctrl;Z Editar Desfazer

  Anula a última alteração ao código. O &kturtle; pode fazer anulações de forma ilimitada.

&Ctrl;&Shift;Z Editar Refazer

  Volta a fazer uma alteração anulada ao código.

&Ctrl;X Editar Cortar

  Corta o texto seleccionado do editor de código para a área de transferência.

&Ctrl;C Editar Copiar

  Copia o texto seleccionado do editor de código para a área de transferência.

&Ctrl;V Editar Colar

  Cola o texto na área de transferência no editor.

&Ctrl;A Editar Seleccionar Tudo

  Selecciona todo o texto do editor.

&Ctrl;F Editar Procurar...

  Com esta acção, você poderá procurar frases no código.

F3 Editar Procurar o Seguinte

  Use isto para procurar a próxima ocorrência da frase.

&Shift;F3 Editar Procurar o Anterior

  Use isto para procurar a ocorrência anterior da frase.

Ins Editar Comutar a Inserção

  Comuta entre o modo de 'inserção' e 'sobreposição'.

### O Menu Ver

Configuração Mostrar o Editor de Código

  Mostra ou esconde o Editor de Código.

F11 Ver Mostrar os Números de Linha

  Com esta acção, você poderá mostrar os números de linha no editor de código. Isto poderá ser útil para procurar um erro.

Ver Mostrar o Inspector

  Mostra ou esconde o Inspector.

### O Menu Ferramentas

Ferramentas Selector da Direcção

  Esta acção abre a janela de selecção da direcção.

### O Menu Configuração

Configuração Linguagem de Programação

  Escolhe a língua para o código.

Configuração Mostrar a Barra de Ferramentas

  Activa ou desactiva a Barra Principal

Configuração Mostrar a Barra de Estado

  Comutar a Barra de Estado

Configuração Configurar os Atalhos...

  A janela-padrão do &kde; para configurar os atalhos de teclado.

Configuração Configurar as Barras de Ferramentas...

  A janela-padrão do &kde; para configurar as barras de ferramentas.

### O Menu Ajuda

F1 Ajuda Manual do &kturtle;

  Esta acção mostra o manual que você está a ler de momento.

&Shift;F1 Ajuda O Que É Isto?

  Depois de activar esta acção, a seta do cursor irá mudar para uma seta com ponto de interrogação. Este novo tipo de seta é usado para carregar em partes da janela principal do &kturtle;, aparecerá uma descrição da componente em particular.

F2 Help Help on: ...

  This is a very useful function: it provides help on the code where the cursor in the code editor is at. So, &eg;, you have used the `print` command in your code, and you want to read and to know what the handbook says on this command. You just move your cursor so it is in the `print` command and you press F2. The handbook will then show all info on the `print` command.

  This function is very important while learning programming.

<-->

Ajuda Comunicar um Erro...

  Use isto para comunicar um problema no &kturtle; com os programadores. Estes relatórios podem ser usados para tornar as versões futuras do &kturtle; melhores.

Ajuda Acerca do &kturtle;

  Aqui você poderá encontrar informações sobre o &kturtle;, como os seus autores e a licença com que este se baseia.

Ajuda Acerca do &kde;

  Aqui você poderá encontrar informações sobre o &kde;. Se não souber ainda o que é o &kde;, este é um local que você não poderá perder.

## A Barra de Ferramentas

Aqui você poderá aceder rapidamente às funções mais usadas. Por omissão, você irá encontrar aqui todos os comandos mais úteis, terminando nos ícones Executar, Pausa e Interromper.

Você poderá configurar a barra de ferramentas se usar o menu Configuração Configurar as Barras de Ferramentas...

## A Barra de Estado

Na barra de estado você poderá saber o estado do &kturtle;. Do lado esquerdo, dá o resultado sobre a última acção. Do lado direito, você encontra a localização actual do cursor (os números da linha e da coluna). A meio da barra de estado, é indicada a língua usada para os comandos.