# Usando o &kturtle;

Aqui está uma imagem do &kturtle; em ação
Janela principal do &kturtle;

A janela principal do &kturtle; possui três componentes principais: o editor (1) à esquerda, onde você digita os comandos de &turtlescript;; a área de desenho (2) à direita, onde a tartaruga faz o seu desenho; e o inspetor (3) que lhe dá informações sobre as variáveis durante a execução do programa. Além dos componentes você pode encontrar a barra de menus (5) onde todas as ações podem ser acessadas; a barra de ferramentas (4) que permite-lhe selecionar rapidamente as ações mais utilizadas; o Console, que você poderá usar para inserir um comando numa única linha para teste; e a barra de status (na parte inferior da janela) onde você encontrará alguma informação sobre o estado do &kturtle;.

## O editor

No editor, você poderá digitar os comandos de &turtlescript;. A maioria das suas funcionalidades são encontradas no menu Editar e Arquivo. O editor pode ser acoplado a qualquer um dos lados da janela principal ou poderá ser destacado e colocado em qualquer local da sua tela.

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 Arquivo Exemplos no menu Arquivo, onde poderá clicar em um arquivo. O arquivo que escolher será aberto no editor, e você poderá ir então usar o Executar Executar no menu, ou Executar na barra de ferramentas, para rodar o código se desejar.

Você poderá abrir os arquivos de &turtlescript; selecionandoArquivo Abrir....

A terceira forma é digitar diretamente 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 eles desenham uma imagem. Em outras palavras, é o espaço de recreio da tartaruga. Depois de inserir algum código no editor e de executá-lo, duas coisas poderão acontecer: ou o código é executado perfeitamente e você poderá ver algo mudando 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.

Você poderá ampliar ou diminuir a área de desenho com a roda do seu mouse.

## O inspetor

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

O inspetor pode ser embutido em qualquer canto da janela principal ou pode ser desanexado e colocado em qualquer lugar de sua área de trabalho.

## A barra de ferramentas

Aqui você poderá acessar rapidamente às ações mais utilizadas. A barra de ferramentas também contém o Console, 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ções Configurar as Barras de Ferramentas..., para se ajustar às suas preferências.

## A barra de menus

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

### Menu Arquivo

&Ctrl;N Arquivo Novo

  Cria um arquivo de &turtlescript; novo e vazio.

&Ctrl;O Arquivo Abrir...

  Abre um arquivo do &turtlescript;.

Arquivo Abrir recente

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

Arquivo Exemplos

  Um exemplo dos programas do &turtlescript;. Os exemplos estão em seu idioma favorito, que poderá ser escolhido em Configurações Linguagem dos scripts.

Arquivo Obter mais exemplos...

  Abra o diálogo Obter novidades para baixar arquivos do &turtlescript; adicionais da Internet.

&Ctrl;S Arquivo Salvar

  Salva o arquivo de &turtlescript; atualmente aberto.

&Ctrl;&Shift;S Arquivo Salvar como...

  Salva o arquivo do &turtlescript; aberto atualmente num local especificado.

Arquivo Exportar para HTML...

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

&Ctrl;P Arquivo Imprimir...

  Imprime o código atual no editor.

&Ctrl;Q Arquivo Sair

  Sai do &kturtle;.

### Menu Editar

&Ctrl;Z Editar Desfazer

  Desfaz a última alteração no código. O &kturtle; pode fazer desfazer de forma ilimitada.

&Ctrl;&Shift;Z Editar Refazer

  Refaz uma alteração desfeita no código.

&Ctrl;X Editar Recortar

  Corta o texto selecionado do editor para a área de transferência.

&Ctrl;C Editar Copiar

  Copia o texto selecionado 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 Selecionar tudo

  Seleciona todo o texto do editor.

&Ctrl;F Editar Procurar...

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

F3 Editar Procurar próximo

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

&Shift;F3 Editar Localizar anterior

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

Ins Editar Modo de edição

  Alterne entre o modo de 'inserir' e 'sobrescrever'.

### Menu Tela

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

  Exporta o conteúdo atual 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 atual da Área de Desenho como um desenho vetorial no formato SVG (Scalable Vector Graphics).

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

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

### Menu Executar

F5 Arquivo Executar

  Inicia a execução dos comandos no editor.

F6 Executar Pausa

  Coloca a execução em pausa. Esta ação só fica ativa quando os comandos estiverem de fato sendo executados.

F7 Executar Interromper

  Interrompe a execução; esta ação só fica ativa quando os comandos estiverem de fato sendo executados.

Executar Velocidade da Execução

  Apresenta uma lista com as velocidades de execução possíveis, consistindo em: velocidade máxima (sem realce e inspetor), velocidade máxima, velocidade baixa, velocidade mais baixa, velocidade mínima e passo-a-passo. Quando a velocidade de execução é igual velocidade máxima (padrão), você poderá não conseguir ver o que está acontecendo. Em alguns dos casos este comportamento poderá ser o desejado, mas em outros casos você poderá querer ter uma ideia da execução. No último caso, você poderá desejar configurar a velocidade da execução como velocidade baixa, velocidade mais baixa ou velocidade mínima. Quando um dos modos lentos for selecionado, a posição atual de execução será exibida no editor. O passo-a-passo irá executar um comando por vez.

### Menu Ferramentas

Ferramentas Seletor de direção...

  Esta ação abre o diálogo do seletor de direção.

Ferramentas Seletor de cores...

  Esta ação abre o diálogo do seletor de cores.

### Menu Configurações

Configurações Linguagem de Programação

  Escolhe a linguagem para o código.

&Ctrl;E Configurações Mostrar o Editor

  Mostra ou oculta o Editor.

&Ctrl;I Configurações Mostrar o Inspetor

  Mostra ou oculta o Inspetor.

Configurações Mostrar os Erros

  Exiba ou esconda a aba Erro com a lista de erros resultantes do código em execução. Se esta opção estiver habilitada, clique na área de desenho para ver a tartaruga novamente.

F11 Configurações Mostrar números de linha

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

Configurações Mostrar a Barra de Ferramentas

  Ativa ou desativa a barra de ferramentas principal

Configurações Mostrar a Barra de Estado

  Alterna a barra de status

Configurações Configurar atalhos...

  O diálogo padrão do &kde; para configurar os atalhos.

Configurações Configurar barras de ferramentas...

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

### Menu Ajuda

O &kturtle; tem o menu Ajuda padrão do &kde;, tal como se encontra 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, &eg;, você poderá ter usado o comando `mostre` no seu código e deseja ler e aprender o que o manual diz sobre este comando. Basta mover o seu cursor para cima do `mostre` e pressionar então F2. O manual irá então mostrar toda a informação sobre o comando `mostre`.

  Esta função poderá ser útil enquanto aprende o &turtlescript;.

## A barra de status

Na barra de status você poderá saber o estado do &kturtle;. Do lado esquerdo, ela fornece o resultado da última ação. Do lado direito, você encontra a localização atual do cursor (os números da linha e da coluna). No meio da barra de status é indicado o idioma atual usado para os comandos.