# 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;, o inspetor (2) que lhe dá informações sobre as 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 ações podem ser acessadas, a barra de ferramentas (4) que lhe permite 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 estado (no fundo da janela) onde você irá 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 menu

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.

### O 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 escolhdio em Configurações Linguagem dos scripts.

&Ctrl;S Arquivo Salvar

  Salva o arquivo de &turtlescript; atualmente aberto.

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

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

### O Menu Área de Desenho

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

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

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

Executar Velocidade da Execução

  Present a list of possible execution speeds, consisting of: Full Speed, Slow, Slower, Slowest and Step-by-Step. When the execution speed is set to Full Speed (default) we can barely keep up with what is happening. Sometimes this behavior is wanted, but sometimes we want to keep track of the execution. In the latter case you want to set the execution speed to Slow, Slower or Slowest. When one of the slow modes is selected the current position of the executor will be shown in the editor. Step-by-Step will execute one command at a time.

### 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 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 Ver Exbir 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 barra de ferramentas...

  A janela padrão 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;, você poderá ter usado o comando `print` 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 `print` e pressionar então F2. O manual irá então mostrar toda a informação sobre o comando `print`.

  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.