Documentazione di Flash CS3

Programmazione in ActionScript 3.0 > Guida introduttiva ad ActionScript > Esempi successivi

Esempi successivi

Dopo aver sviluppato ed eseguito l'applicazione ActionScript 3.0 "Hello World", si posseggono già le conoscenze di base necessarie per eseguire gli altri esempi di codice presentati nel manuale.

Sezioni

Prova degli esempi di codice contenuti nei capitoli

Mentre si consulta il manuale, è possibile provare gli esempi di codice utilizzati per illustrare i vari argomenti. Questa prova può consistere nel visualizzare il valore delle variabili in punti specifici del programma oppure nel visualizzare o nell'interagire con il contenuto visualizzato sullo schermo. Per provare l'interazione o il contenuto visivo, gli elementi richiesti vengono indicati prima o all'interno del codice: è sufficiente creare un documento con gli elementi descritti. Per visualizzare il valore di una variabile in un punto specifico nel programma, è possibile procedere in vari modi. Ad esempio, utilizzare una funzione di debug, come quella incorporata in Flex Builder e Flash. Tuttavia, il modo più semplice consiste nello stampare i valori delle variabili in una determinata posizione in cui siano visibili.

La procedura seguente spiega come creare un documento Flash da utilizzare per la prova di un codice e la visualizzazione di valori di variabili:

Per creare un documento Flash per provare gli esempi contenuti nei capitoli:

1. Creare un documento Flash e salvarlo sul disco rigido.
2. Per visualizzare i valori di prova in un campo di testo sullo stage, attivare lo strumento Testo e creare un nuovo campo di testo dinamico sullo stage. L'ideale è un campo di testo largo e alto con il tipo di riga Multiriga e il bordo attivato. Nella finestra di ispezione Proprietà, assegnare al campo di testo un nome di istanza (ad esempio "outputText"). Per scrivere i valori nel campo di testo, aggiungere al codice di esempio un codice che chiama il metodo appendText() (come descritto sotto).
3. In alternativa, per visualizzare i risultati dell'esempio, è possibile aggiungere al codice di esempio una chiamata alla funzione trace() (come descritto sotto).
4. Per provare un determinato esempio, copiare il codice nel pannello Azioni; se necessario, aggiungere una chiamata alla funzione trace() oppure un valore al campo di testo utilizzando il relativo metodo appendText().
5. Dal menu principale, selezionare Controllo > Prova filmato per creare un file SWF e visualizzare i risultati.

Esistono due modi per visualizzare i valori delle variabili mentre si effettua la prova degli esempi: scrivere i valori in un'istanza di campo di testo sullo stage oppure utilizzare la funzione trace() per stampare i valori sul pannello Output.

• La funzione trace(): la funzione trace() di ActionScript scrive il valore di qualsiasi parametro che le viene inviato (variabile o espressione letterale) nel pannello Output. Molti esempi di codice contenuti nel manuale includono già una chiamata alla funzione trace(), pertanto è sufficiente copiare tali codici nel documento e provare il progetto. Per utilizzare la funzione trace() per provare il valore di una variabile contenuta in un codice che non la include, aggiungere al codice una chiamata a trace(), che passa la variabile come parametro. Ad esempio, nel caso di un codice come quello riportato in questo capitolo,

  var albumName:String = "Three for the money";
  

  è possibile copiare il codice nel pannello Azioni, quindi aggiungere una chiamata alla funzione trace(), come mostrato di seguito, per provare il risultato del codice:

  var albumName:String = "Three for the money";
  trace("albumName =", albumName);
  

  Quando si esegue il programma, viene stampata la riga seguente:

  albumName = Three for the money
  

  Ciascuna chiamata alla funzione trace() può richiedere più parametri che vengono legati tra loro per formare una singola riga stampata. Al termine di ciascuna chiamata viene aggiunta un'interruzione di riga, in modo che le chiamate separate vengano stampate su righe separate.

• Un campo di testo sullo stage: se si preferisce non utilizzare la funzione trace(), è possibile creare un campo di testo dinamico sullo stage mediante lo strumento Testo e scrivere i valori in questo campo per visualizzare i risultati di un codice. Il metodo appendText() della classe TextField può essere utilizzato per aggiungere un valore stringa al termine del contenuto del campo di testo. Per accedere a un campo di testo utilizzando ActionScript, assegnarvi un nome di istanza nella finestra di ispezione Proprietà. Ad esempio, se il campo di testo presenta il nome di istanza outputText, il codice seguente può essere utilizzato per controllare il valore della variabile albumName:

  var albumName:String = "Three for the money";
  outputText.appendText("albumName = ");
  outputText.appendText(albumName);
  

  Questo codice scrive il testo seguente nel campo di testo outputText:

  albumName = Three for the money
  

  Come indica l'esempio, il metodo appendText() aggiunge il testo nella stessa riga del contenuto precedente, pertanto è possibile aggiungere più valori alla stessa riga di testo utilizzando più chiamate al metodo appendText(). Per fare in modo che il testo venga scritto nella riga successiva, è possibile aggiungere un carattere nuova riga ("\n"):

  outputText.appendText("\n"); // adds a line break to the text field
  

  A differenza della funzione trace(), il metodo appendText() accetta esclusivamente un valore come parametro. Questo valore deve essere una stringa (un'istanza String oppure un valore letterale di stringa). Per stampare il valore di una variabile non stringa, è necessario prima convertire il valore in una stringa. A tal scopo, il modo più semplice è chiamare il metodo toString() dell'oggetto:

  var albumYear:int = 1999;
  outputText.appendText("albumYear = ");
  outputText.appendText(albumYear.toString());
  

Operazioni con gli esempi di fine capitolo

La maggior parte dei capitoli, come il presente, si concludono con un esempio significativo che combina molti dei concetti trattati nel capitolo. A differenza dell'esempio "Hello World" di questo capitolo, tuttavia, tali esempi non vengono presentati sotto forma di esercitazione dettagliata. Per ciascun esempio viene evidenziato e discusso il codice ActionScript 3.0 da utilizzare, ma non vengono fornite istruzioni per l'esecuzione degli esempi in un ambiente di sviluppo specifico. Tuttavia, con il manuale vengono distribuiti tutti i file necessari per compilare ed eseguire gli esempi con facilità nell'ambiente di sviluppo in uso.

Flash CS3

Inviami un messaggio e-mail quando vengono aggiunti dei commenti a questa | Rapporto sui commenti

Pagina corrente: http://livedocs.adobe.com/flash/9.0_it/main/00000036.html

Aggiungi commento