# 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 (1) à esquerda, onde você escreve os comandos de &turtlescript;, o inspector (2) que lhe dá informações acerca das variáveis durante a execução do programa e a área de desenho (3) à direita, onde as instruções são visualizadas. Os três outros locais da janela principal são: o menu (5) onde todas as acções podem ser acedidas, a barra de ferramentas (4) que lhe permite seleccionar rapidamente as acções mais utilizadas, a Consola, que poderá usar para introduzir um comando numa única linha para o testar e a barra de estado (no fundo da janela) onde você irá encontrar alguma informação sobre o estado do &kturtle;.

## O Editor

No editor, você poderá escrever os comandos de &turtlescript;. A maioria das suas funcionalidades são encontradas no menu Editar e Ficheiro. O editor 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, você poderá ir então a Ficheiro Executar no menu, ou Executar na barra de ferramentas, para correr o código se o desejar.

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

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

## 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 e de o 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.

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

## 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 Barra de Ferramentas

Aqui poderá aceder rapidamente às acções mais utilizadas. A barra de ferramentas também contém a Consola, onde poderá invocar rapidamente os comandos; isto poderá ser útil no caso de querer testar um comando sem modificar o conteúdo do Editor.

Você poderá configurar a barra de ferramentas se usar o menu Configuração Configurar as Barras de Ferramentas..., para se ajustar às suas preferências.

## A Barra de Menu

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

### O Menu Ficheiro

&Ctrl;N Ficheiro Novo

  Cria um ficheiro de &turtlescript; novo e vazio.

&Ctrl;O Ficheiro Abrir...

  Abre um ficheiro de &turtlescript;.

Ficheiro Abrir um Recente

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

Ficheiro Exemplos

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

Ficheiro Obter mais exemplos...

  Abra a janela para Obter Coisas Novas, de modo a transferir novos ficheiros em &turtlescript; da Internet.

&Ctrl;S Ficheiro Gravar

  Grava o ficheiro de &turtlescript; aberto de momento.

Ficheiro Gravar Como...

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

Ficheiro Exportar para HTML...

  Exporta o conteúdo actual do Editor como um ficheiro em HTML que inclui as cores do realce.

&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 para a área de transferência.

&Ctrl;C Editar Copiar

  Copia o texto seleccionado do editor 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 que estava a pesquisar.

&Shift;F3 Editar Procurar o Anterior

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

Ins Editar Modo de Sobreposição

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

### O Menu Área de Desenho

Área de Desenho Exportar para Imagem (PNG)...

  Exporta o conteúdo actual da Área de Desenho como uma imagem rasterizada no formato PNG (Portable Network Graphics).

Área de Desenho Exportar para Desenho (SVG)...

  Exporta o conteúdo actual da Área de Desenho como um desenho vectorial no formato SVG (Scalable Vector Graphics).

Área de Desenho Imprimir a Área de Desenho...

  Imprime o conteúdo actual da Área de Desenho.

### O Menu Executar

F5 Executar Executar

  Inicia a execução dos comandos no editor.

F6 Executar Pausa

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

F7 Executar Interromper

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

Executar Velocidade da Execução

  Apresenta uma lista com as velocidades de execução possíveis, consistindo em: Velocidade Completa (sem realce nem inspecção), 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.

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

&Ctrl;E Configuração Mostrar o Editor

  Mostra ou esconde o Editor.

&Ctrl;I Configuração Mostrar o Inspector

  Mostra ou esconde o Inspector.

Configuração 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 Configuração Mostrar os Números de Linha

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

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 normal do &kde; para configurar as barras de ferramentas.

### O Menu Ajuda

&help.menu.documentation;

F2 Ajuda Ajuda sobre: ...

  Esta é uma função muito útil: ela oferece ajuda sobre o código sob o cursor na janela do editor. Por isso, &eg;, poderá ter usado o comando `print` no seu código e querer ler e aprender o que o manual diz sobre este comando. Basta mover o seu cursor para cima do `print` e carregar então em F2. O manual irá então mostrar toda a informação sobre o comando `print`.

  Esta função poder-se-á tornar útil enquanto aprende o &turtlescript;.

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