# Usando o &kturtle;

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

A janela principal do &kturtle; tem dois componentes principais, o editor de código (3) à esquerda, onde você escreve os comandos de &logo; e a área de desenho (4) à 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 três outros locais da janela principal são: o menu (1) onde todas as ações podem ser acessadas, a barra de ferramentas (4) que lhe permite selecionar rapidamente as ações mais utilizadas e a barra de estado (5) 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 de &logo;. 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 tela.

Você dispõe de várias formas de obter algum código no editor. A forma mais fácil é usar um exemplo já feito. Você escolhe o Arquivo Abrir Exemplos no menu Arquivo, onde poderá clicar num arquivo. O nome do arquivo lhe dirá algo sobre o que é o exemplo (por exemplo, o 'square.logo' vai desenhar um quadrado ('square'). O arquivo que escolher será aberto no editor de código, você poderá ir então a Arquivo Executar Comandos para rodar o código se desejar.

Você poderá abrir os arquivos de &logo; 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 estado à direita, com o número da Linha e da Coluna.

## 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 introduzir algum código no editor de código e de executá-lo com Arquivo Executar Comandos, 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ê tem 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.

A imagem que é desenhada pode ser gravada num arquivo (usando o Arquivo Salvar a Área de Desenho) ou impressa (usando o Arquivo Imprimir...).

## A Barra de Menu

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

### O Menu Arquivo

#### Novo

&Ctrl;N Arquivo Novo

  Cria um arquivo de &logo; novo, vazio.

#### Abrir

&Ctrl;O Arquivo Abrir...

  Abre um arquivo de &logo;.

#### Abrir Recente

Arquivo Abrir Recente

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

#### Abrir Exemplos

&Ctrl;E Arquivo Abrir Exemplos

  Mostra a pasta com os programas de exemplo do &logo;. Os exemplos deverão estar no seu idioma favorito, que poderá ser escolhdio em Configurações Configurar o &kturtle;....

#### Executar

&Alt;Return Arquivo Executar Comandos

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

#### Salvar

&Ctrl;S Arquivo Salvar

  Salva o arquivo de &logo; aberto atualmente.

#### Salvar Como

Arquivo Salvar Como...

  Salva o arquivo de &logo; aberto atualmente num local especificado.

#### Salvar a Área de Desenho

Arquivo Salvar Área de Desenho

  Salva a imagem desenhada na área de desenho num arquivo.

#### Pausa

Pause Arquivo Pausar a Execução

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

#### Parar

Escape Arquivo Parar Execução

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

#### Velocidade de Execução

Arquivo Velocidade de Execução

  Apresenta uma lista com as velocidades de execução possíveis, consistindo em: Toda Velocidade, Lento, Mais Lento e Lentíssimo. Quando a velocidade é igual a 'Toda Velocidade' (padrão), você poderá não conseguir ver o que está acontecendo. Em alguns dos casos este comportamento poderá ser o desejado, mas noutros casos você poderá querer ter uma idéia da execução. No último caso, poderá desejar configurar a velocidade da execução como 'Lento', 'Mais Lento' e 'Lentíssimo'. Quando um dos modos lentos for selecionado, a posição atual de execução será mostrada no editor.

#### Imprimir

&Ctrl;P Arquivo Imprimir...

  Imprime o código atual no editor ou então o desenho gerado na área de desenho.

#### Sair

&Ctrl;Q Arquivo 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

  Refaz uma alteração anulada ao código.

&Ctrl;X Editar Cortar

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

&Ctrl;R Editar Substituir...

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

### O Menu Ver

&Ctrl;&Shift;F Ver Modo Tela Cheia

  Com esta ação, você ativa ou desativa o modo de tela cheia.

  Nota: Quando o código é executado, estando no modo de tela cheia, tudo exceto a área de desenho fica escondido. Isto torna possível criar programas de tela cheia no &kturtle;.

F11 Ver Mostrar 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

&Alt;C Ferramentas Extrator de Cor

  Esta ação abre o extrator de cores. Com este extrator, você poderá selecionar facilmente um código de cores e inserí-lo no editor de código.

&Ctrl;I Ferramentas Indentar

  Esta ação indenta (adiciona espaços em branco) as linhas que estão selecionadas. Quando a 'indentação' é usada convenientemente, isto poderá tornar o código muito mais fácil de ler. Todos os exemplos usam indentação, por isso veja-os, por favor.

&Ctrl;&Shift;I Ferramentas Desindentar

  Esta ação desindenta (remove os espaços em branco no início) as linhas que estão selecionadas.

Ferramentas Limpar Indentação

  Est ação limpa a indentação (remove todos os espaços em branco no início) das linhas que estão selecionadas.

&Ctrl;D Ferramentas Comentar

  Esta ação adiciona caracteres de comentário (#) ao início das linhas que são selecionadas. As linhas que começam com um carácter de comentário são ignoradas quando o código é executado. Os comentários permitem ao programador explicar um pouco o seu código ou podem ser usadas para evitar temporariamente que um determinado pedaço de código seja executado.

&Ctrl;&Shift;D Ferramentas Descomentar

  Esta ação remove os caracteres de comentários das linhas selecionadas.

### O Menu Configurações

Configurações Mostrar/Ocultar Barra de Ferramentas

  Ativa ou desativa a Barra Principal

Configurações Mostrar/Ocultar Barra de Estado

  Alterna a Barra de Estado

Configurações Configurações Avançadas

  Aqui você poderá alterar as coisas que você normalmente não necessita mudar. O sub-menu da Configurações Avançadas possui três itens: Configurar o Editor... (a janela de configuração padrão do editor &kate;), Configurar os Atalhos... (a janela de configuração de atalhos padrão do &kde;) e a Configurar as Barras de Ferramentas... (a janela de configuração da barra de ferramentas do &kde;).

Configurações Configurar o &kturtle;...

  Isto é usado para configurar o &kturtle;. Aqui você poderá mudar o idioma dos comandos de &logo; ou definir um novo tamanho inicial para a área de desenho.

### O Menu Ajuda

Ajuda Manual do &kturtle;

  Esta ação mostra o manual que você está atualmente lendo.

&Shift;F1 Ajuda O Que É Isto?

  Depois de ativar esta ação, a seta do cursor irá mudar para uma seta com ponto de interrogação. Este novo tipo de seta é usado para clicar em partes da janela principal do &kturtle;, aparecerá uma descrição da componente em particular.

F2 Ajuda Ajuda sobre: ...

  Esta é uma função bastante útil; ela fornece ajuda sobre o código sobre o qual o cursor se encontra. Por isso, por exemplo, você poderá usar o comando `print` no seu código, e poderá querer ler para saber o que o manual diz sobre este comando. Você poderá mover o cursor para cima do comando `print` e clicar em F2. O manual irá então mostrar toda a informação sobre o comando `print`.

  Esta função é muito importante durante a aprendizagem da programação.

Ajuda Comunicar um Erro...

  Use isto para comunicar um problema no &kturtle; para os programadores. Estes relatórios podem ser usados para tornar as versões futuras do &kturtle; melhores.

Ajuda Sobre o &kturtle;

  Aqui você poderá encontrar informações sobre o &kturtle;, como os seus autores e a licença em que ele se baseia.

Ajuda Sobre o &kde;

  Aqui você poderá encontrar informações sobre o &kde;. Se não souber ainda o que é o &kde;, este é um local que você não poderá perder.

## 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 os Comandos e o Parar a Execução.

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

## A Barra de Estado

Na barra de estado você poderá saber o estado do &kturtle;. Do lado esquerdo, ela fornece o resultado sobre a ú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 estado é indicado idioma usado para os comandos.