# Usare &kturtle;

Qui c'è un'immagine di &kturtle; in azione
La finestra principale di &kturtle;

La finestra principale di &kturtle; ha tre parti principali: l'editor (1) sulla sinistra, dove inserisci i comandi &turtlescript;, l'area di disegno (2) sulla destra, dove le istruzioni sono trasformate in disegno, e l'ispettore (3), che ti fornisce informazioni mentre i tuoi programmi vengono eseguiti. Oltre a queste vi sono la barra dei menu (5), da cui possono essere raggiunte le azioni, la barra degli strumenti (4), che ti permette di selezionare velocemente le azioni più usate, la casella di inserimento Console, che puoi usare per inserire e per provare comandi di una riga, e infine la barra di stato (in basso), dove troverai le informazioni sullo stato di &kturtle;.

## L'editor

Nell'editor digiti i comandi &turtlescript;. La maggior parte delle funzioni dell'editor si trovano nei menu File e Modifica. L'editor può essere agganciato a ciascun bordo della finestra principale, oppure anche staccato e posizionato in un punto qualsiasi del desktop.

Puoi inserire del codice nell'editor in vari modi. Il modo più semplice è usare un esempio: scegli il sotto-menu File Esempi, e scegli un esempio. Il file dell'esempio che scegli sarà aperto nell'editor, perciò puoi usare la voce di menu Esegui Esegui (scorciatoia: &Alt;F2), oppure il pulsante Esegui nella barra degli strumenti, per eseguire il codice che vuoi.

Puoi aprire i file &turtlescript; scegliendo la voce di menu File Apri....

Il terzo modo è quello di scrivere il codice nell'editor, o copiare e incollare del codice.

## L'area di disegno

L'area di disegno è il "campo" della tartaruga: qui la tartaruga disegna in base ai comandi che riceve. Dopo aver inserito del codice nell'editor ed averlo eseguito, possono accadere due cose: o il codice viene eseguito senza problemi, e nella maggior parte dei casi vedrai dei cambiamenti nell'area di disegno; oppure hai commesso un errore nel codice, e in questo caso apparirà la scheda degli errori con la spiegazione su ciò che hai sbagliato.

Puoi ingrandire e ridurre l'area di disegno con la rotellina del mouse.

## L'ispettore

L'ispettore ti dà le informazioni sulle variabili e sulle funzioni imparate. Ti mostra anche l'albero del codice mentre il programma è in esecuzione.

L'ispettore può essere agganciato a qualsiasi bordo della finestra principale, oppure anche staccato e posizionato in un punto qualsiasi del desktop.

## La barra degli strumenti

Qui puoi raggiungere velocemente le azioni più usate. La barra degli strumenti contiene anche la casella di inserimento Console, da cui puoi eseguire velocemente dei comandi; ciò può essere utile per provare un comando senza modificare il contenuto dell'editor.

Usando Impostazioni Configura le barre degli strumenti... puoi configurare la barra degli strumenti in base alle tue preferenze.

## La barra dei menu

Nella barra dei menu trovi tutte le azioni di &kturtle;. Sono nei seguenti gruppi: File, Modifica, Area di disegno, Esegui, Strumenti, Impostazioni e Aiuto. Questa sezione li descrive tutti.

### Il menu File

&Ctrl;N File Nuovo

  Crea un nuovo file di &turtlescript; vuoto.

&Ctrl;O File Apri...

  Apre un file di &turtlescript;.

File Apri recenti

  Apre un file di &turtlescript; che è stato aperto recentemente.

File Esempi

  Apre i programmi di esempio di &turtlescript;. Gli esempi sono nella tua lingua preferita, che puoi scegliere nel sotto-menu Impostazioni Lingua degli script.

File Scarica altri esempi...

  Apre la finestra Scarica le novità per scaricare da Internet dei file &turtlescript;.

&Ctrl;S File Salva

  Salva il file di &turtlescript; attualmente aperto.

&Ctrl;&Shift;S File Salva come...

  Salva in un percorso specificato il file di &turtlescript; attualmente aperto.

File Esporta come HTML...

  Esporta il contenuto corrente dell'editor come file &HTML;, che include i colori di evidenziazione.

&Ctrl;P File Stampa...

  Stampa il codice nell'editor.

&Ctrl;Q File Esci

  Esce da &kturtle;.

### Il menu Modifica

&Ctrl;Z Modifica Annulla

  Annulla l'ultima modifica al codice. &kturtle; può annullare un numero infinito di modifiche.

&Ctrl;&Shift;Z Modifica Rifai

  Rifa una modifica annullata al codice.

&Ctrl;X Modifica Taglia

  Taglia il testo selezionato nell'editor negli appunti.

&Ctrl;C Modifica Copia

  Copia negli appunti il testo selezionato nell'editor.

&Ctrl;V Modifica Incolla

  Incolla nell'editor il testo degli appunti.

&Ctrl;A Modifica Seleziona tutto

  Seleziona tutto il testo nell'editor.

&Ctrl;F Modifica Trova...

  Con questa azione puoi cercare delle frasi nel codice.

F3 Modifica Trova successivo

  Usalo per trovare l'occorrenza successiva della frase che stavi cercando.

&Shift;F3 Modifica Trova precedente

  Usalo per trovare l'occorrenza precedente della frase che stavi cercando.

&Ins; Modifica Modalità di sovrascrittura

  Passa dalla modalità d'inserimento a quella di sovrascrittura, e viceversa

### Il menu Area di disegno

Area di disegno Esporta come immagine (PNG)...

  Esporta il contenuto corrente dell'area di disegno come immagine raster in formato PNG (Portable Network Graphics).

Area di disegno Esporta come disegno (SVG)...

  Esporta il contenuto corrente dell'area di disegno come immagine vettoriale in formato &SVG; (Scalable Vector Graphics).

Area di disegno Stampa area di disegno...

  Stampa il contenuto corrente dell'area di disegno.

### Il menu Esegui

F5 Esegui Esegui

  Avvia l'esecuzione dei comandi nell'editor.

F6 Esegui Metti in pausa

  Mette in pausa l'esecuzione. Questa azione è abilitata solo quando &kturtle; sta eseguendo dei comandi.

F7 Esegui Termina

  Ferma l'esecuzione. Questa azione è abilitata solo quando &kturtle; sta eseguendo dei comandi.

Esegui Velocità di esecuzione

  Presenta una lista delle velocità di esecuzione possibili, formata da: Velocità massima (nessuna evidenziazione e nessun ispettore), Velocità massima, Lenta, Più lenta,Lentissima e Passo passo. Quando la velocità di esecuzione è impostata a Velocità massima (predefinito), possiamo a mala pena renderci conto di ciò che sta accadendo. Qualche volta questo comportamento è voluto, ma altre vogliamo tener traccia dell'esecuzione. Nel secondo caso, imposta la velocità di esecuzione a Lenta, Più lenta o Lentissima. Quando una delle modalità lente è selezionata, verrà mostrata la posizione corrente del cursore nell'editor. Passo passo eseguirà un comando per volta.

### Il menu Strumenti

Strumenti Scelta della direzione...

  Questa azione apre la finestra per la scelta della direzione.

File Selettore di colore...

  Questa azione apre la finestra per la scelta colore.

### Il menu Impostazioni

Impostazioni Lingua degli script

  >Sceglie la lingua per il codice.

&Ctrl;E Impostazioni Mostra l'editor

  Mostra o nasconde l'editor.

&Ctrl;I Impostazioni Mostra ispettore

  Mostra o nasconde l'ispettore.

Impostazioni Mostra gli errori

  Mostra o nasconde la scheda Errori con la lista degli errori che si sono verificati durante l'esecuzione del codice. Se questa opzione è attivata, per vedere nuovamente la tartaruga fai clic sull'area di disegno.

F11 Impostazioni Mostra i numeri di riga

  Con questa azione puoi mostrare i numeri di riga nell'editor. Ciò può essere utile per trovare gli errori.

Impostazioni Mostra la barra degli strumenti

  Mostra o nasconde la barra degli strumenti principale.

Impostazioni Mostra la barra di stato

  Mostra o nasconde la barra di stato.

Impostazioni Configura le scorciatoie...

  La finestra standard di &kde; per configurare le scorciatoie.

Impostazioni Configura le barre degli strumenti...

  La finestra standard di &kde; per configurare le barre degli strumenti.

### Il menu Aiuto

&kturtle; ha il menu Aiuto predefinito di &kde;, come descritto nei Fondamentali di &kde;, ma con una voce aggiuntiva:

F2 Aiuto Aiuto su: ...

  Questa funzione è molto utile: fornisce un aiuto sul codice sul quale si trova il cursore nell'editor del codice. Così, &eg;, hai usato il comando `scrivi` nel codice, e vuoi sapere cosa dice il manuale su questo comando. Muovi il cursore sul comando `scrivi`, e premi F2. Il manuale mostrerà le informazioni sul comando `scrivi`.

  Questa funzione può rivelarsi molto utile quando si impara ad usare &turtlescript;.

## La barra di stato

Grazie alla barra di stato puoi monitorare lo stato di &kturtle;. Sul lato sinistro ti mostra il risultato dell'ultima azione. Sul destro trovi invece la posizione corrente del cursore (i numeri di riga e di colonna). Nel mezzo della barra di stato è indicata la lingua correntemente usata per i comandi.