# Usando o &kturtle;

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

A janela principal do &kturtle; tem três partes principais, o editor de código (3) à esquerda, onde você escreve os comandos do &turtlelang;, o inspetor (4) que fornece a você informações sobre variáveis quando o programa é executado, 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 quatro outros locais da janela principal são: a barra do menu (1) onde todas as ações podem ser acessadas, a barra de ferramentas (2) que lhe permite selecionar rapidamente as ações mais utilizadas, o console, que você pode usar para digitar uma linha de comando e testá-la e a barra de status (6) onde você irá encontrar algumas informações sobre o estado do &kturtle;.

## O editor de código

No editor de código, você poderá escrever os comandos do &turtlelang;. Ele tem todos os recursos que você poderia esperar num editor moderno. A maioria dos seus recursos são encontrados nos menus Editar e Ferramentas. 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 da sua área de trabalho.

Você dispõe de várias formas de obter algum código no editor. A forma mais fácil é usar um exemplo já feito: escolha Arquivo Abrir exemplos no menu Arquivo e selecione um exemplo. O arquivo de exemplo que você escolheu será aberto no editor de código, você então poderá usar Arquivo Executar para excutar o código se desejar.

Você poderá abrir os arquivos do &turtlelang; escolhendo Arquivo Abrir....

A terceira forma é escrever diretamente o seu código no editor ou copiar/colar algum código deste guia do usuário.

A posição do cursor é indicada na barra de status à direita, com o número da linha e da coluna.

## O inspetor

O inspetor informa sobre as variáveis, as funções aprendidas e a árvore de código enquanto o programa está executando.

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 á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, é a área de recreio da tartaruga. Depois de introduzir algum código no editor de código e de executá-lo com Arquivo Executar, duas coisas poderão acontecer: ou o código se executa com perfeição e você poderá ver algo mudando na área de desenho, ou você fez um erro no seu código e existirá uma mensagem que lhe dirá qual o erro que você cometeu.

Esta mensagem deverá ajudá-lo a resolver o erro.

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

## A barra de menu

Na barra de menu, você irá encontrar todas as ações do &kturtle;. Elas estão nos seguintes grupos: Arquivo, Editar, Visualizar, Ferramentas, Configurações e Ajuda. Esta seção descreve todas estas opções.

### O menu Arquivo

&Ctrl;N Arquivo Novo

  Cria um arquivo novo e vazio do &turtlelang;.

&Ctrl;O Arquivo Abrir...

  Abre um arquivo do &turtlelang;.

Arquivo Abrir recente

  Abre um arquivo do &turtlelang; que foi aberto recentemente.

Arquivo Exemplos

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

&Ctrl;S Arquivo Salvar

  Salva o arquivo do &turtlelang; aberto atualmente.

Arquivo Salvar como...

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

Arquivo Salvar como figura...

  Salva a área de desenho atual como uma imagem.

F5 Arquivo Executar

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

F6 Arquivo Pausar

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

F7 Arquivo Cancelar

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

Arquivo Velocidade de execução

  Apresenta uma lista com as velocidades de execução possíveis, consistindo em: 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.

&Ctrl;P Arquivo Imprimir...

  Imprime o código atual no editor.

&Ctrl;Q Arquivo Sair

  Sai do &kturtle;.

### O 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 de código para a área de transferência.

&Ctrl;C Editar Copiar

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

&Shift;F3 Editar Localizar anterior

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

Ins Editar Modo de edição

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

### O menu Ver

&Ctrl;E View Exibir editor

  Exibe ou esconde o editor de código.

&Ctrl;I Visualizar Exibir inspetor

  Exibe ou oculta o inspetor.

Visualizar Exibir 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 Ver Exbir números de linha

  Com esta açã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 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.

### O menu Configurações

Configurações Linguagem de script

  Escolhe a linguagem para o código.

Configurações Exibir barra de ferramentas

  Ativa ou desativa a barra de ferramentas principal

Configurações Exibir barra de status

  Alterna a barra de status

Configurações Configurar atalhos...

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

Configurações Configurar barra de ferramentas...

  O diálogo padrão do &kde; para configurar as barras de ferramentas.

### O menu Ajuda

&help.menu.documentation;

## A barra de ferramentas

Aqui você poderá acessar rapidamente às funções mais usadas. Por padrão, você irá encontrar aqui todos os comandos mais úteis, terminando nos ícones Executar, Pausare Cancelar. O último ícone da barra de ferramentas é o console, que você pode usar para digitar uma linha de comando e testá-la.

Você poderá configurar a barra de ferramentas usando o menu Configurações Configurar barra de ferramentas...

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