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

Ficheiro Exemplos

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

&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 Gravar Como Imagem...

  Grava a área de desenho actual como uma imagem.

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.

Ficheiro Velocidade da Execução

  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.

&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 Modo de Sobreposição

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

### O Menu Ver

&Ctrl;Q Ver Mostrar o Editor

  Mostra ou esconde o Editor de Código.

&Ctrl;I Ver Mostrar o Inspector

  Mostra ou esconde o Inspector.

Ver Mostrar os Erros

  Mostra ou esconde a página de Erro com uma lista dos erros resultantes da execução do código. Se esta opção estiver activa, carregue na Área de Desenho para ver a tartaruga de novo.

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.

### O Menu Ferramentas

Ferramentas Selector da Direcção...

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

Ferramentas Extractor de Cores...

  Esta acção abre a janela de extracção de cores.

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

&help.menu.documentation;

## 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. O último item no fundo da barra de ferramentas é a Consola, a qual poderá usar para introduzir um comando de uma linha e testá-lo.

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.