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

&Ctrl;&Shift;S 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 da Á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

O &kturtle; tem um menu de Ajuda comum do &kde;, como está descrito nos Fundamentos do &kde;, com um item adicional:

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, ⪚, 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.