USO DEI COMPONENTI ACTIONSCRIPT 3.0

USO DEI COMPONENTI ACTIONSCRIPT 3.0

2007 Adobe Systems Incorporated. Tutti i diritti riservati. Uso dei componenti ActionScript 3.0 Se la presente guida viene distribuita con software che include un accordo di licenza per l utente finale, la guida e il software in essa descritto sono concessi in licenza e possono essere usati e copiati solo in conformità con i termini di tale licenza. Ad eccezione di quanto eventualmente concesso da tale licenza, nessuna parte di questa guida può essere riprodotta, memorizzata in un sistema per il recupero dati o trasmessa in qualsiasi forma o con qualsiasi mezzo, elettronico, meccanico, di registrazione o altro, senza il previo consenso scritto da parte di Adobe Systems Incorporated. Il contenuto di questa guida è protetto dalla legge sul copyright, anche se non distribuito con software corredato di accordo di licenza per l utente finale. Il contenuto di questa guida viene fornito unicamente a scopo informativo, è soggetto a modifiche senza preavviso e non comporta alcun impegno per Adobe Systems Incorporated. Adobe Systems Incorporated declina ogni responsabilità per eventuali errori o imprecisioni presenti in questa guida. Se si inseriscono in un progetto grafica e immagini esistenti, si tenga presente che tali materiali potrebbero essere protetti dalla legge sul copyright. L inserimento non autorizzato di tali materiali nel proprio lavoro potrebbe rappresentare una violazione dei diritti del titolare del copyright. Assicurarsi sempre di ottenere le eventuali autorizzazioni necessarie dal titolare del copyright. Tutti i riferimenti a nomi di società negli esempi forniti hanno scopo puramente dimostrativo e non intendono fare riferimento ad alcuna organizzazione realmente esistente. Adobe, il logo Adobe, ActionScript, Flash, Flash Player e Flash Video sono marchi registrati o marchi commerciali di Adobe Systems Incorporated negli Stati Uniti e/o in altri Paesi. Macintosh è un marchio di Apple Inc. registrato negli Stati Uniti e in altri Paesi. Windows è un marchio registrato o un marchio commerciale di Microsoft Corporation negli Stati Uniti e/o in altri Paesi. Tutti gli altri marchi appartengono ai rispettivi proprietari. Questo prodotto include software sviluppato dalla Apache Software Foundation (http://www.apache.org/). Tecnologia di compressione audio MPEG Layer-3 concessa in licenza da Fraunhofer IIS e Thomson Multimedia (http://www.iis.fhg.de/amm/). Non è consentito l uso dell audio compresso MP3 con il Software per eseguire trasmissioni in tempo reale o dal vivo. Se l utente necessita di un decodificatore MP3 per trasmissioni in tempo reale o dal vivo, spetta all utente stesso ottenere la licenza per questa tecnologia MP3. Tecnologia per la compressione e la decompressione vocale concessa in licenza da Nellymoser, Inc. (www.nellymoser.com). Il video di Flash CS3 è basato sulla tecnologia video On2 TrueMotion. 1992-2005 On2 Technologies, Inc. Tutti i diritti riservati. http://www.on2.com. Questo prodotto include software sviluppato da OpenSymphony Group (http://www.opensymphony.com/). Tecnologia per la compressione e la decompressione video Sorenson Spark, concessa in licenza da Sorenson Media, Inc. Adobe Systems Incorporated, 345 Park Avenue, San Jose, California 95110, USA. Avviso agli utenti finali di enti governativi degli Stati Uniti d America: il Software e la Documentazione sono Commercial Items (Prodotti commerciali) secondo la definizione contenuta nell articolo 48 C.F.R. 2.101, costituiti da Commercial Computer Software (Software commerciale per Computer) e Commercial Computer Software Documentation (Documentazione relativa a software commerciale per Computer) secondo la definizione contenuta nell articolo 48 C.F.R. 12.212 o 48 C.F.R. 227.7202, secondo i casi. In conformità con l articolo 48 C.F.R. 12.212 o con gli articoli da 48 C.F.R. 227.7202-1 a 227.7202-4 incluso, secondo i casi, i Commercial Computer Software e Commercial Computer Software Documentation vengono concessi in licenza agli utenti appartenenti al Governo degli Stati Uniti d America (a) esclusivamente come Commercial Items e (b) con i soli diritti concessi a tutti gli altri utenti finali in base ai termini e alle condizioni qui contenuti. Tutti i diritti non pubblicati riservati, ai sensi della legge sul copyright vigente negli Stati Uniti d America. Adobe Systems Incorporated, 345 Park Avenue, San Jose, CA 95110-2704, USA. Nei confronti degli utenti finali del Governo degli Stati Uniti, Adobe accetta di rispettare tutte le leggi applicabili sul diritto alle pari opportunità, comprese, ove applicabili, le direttive dell Executive Order 11246, secondo revisione, la sezione 402 del Vietnam Era Veterans Readjustment Assistance Act del 1974 (38 USC 4212) e la sezione 503 del Rehabilitation Act del 1973, secondo revisione, oltre ai regolamenti esposti in 41 CFR da 60-1 a 60-60, 60-250 e 60-741. La clausola di azione affermativa e i regolamenti sopra elencati saranno incorporati tramite riferimento.

Sommario Introduzione.............................................11 A chi è destinato questo manuale................................ 12 Requisiti di sistema............................................ 12 Informazioni sulla documentazione.............................. 12 Convenzioni tipografiche....................................... 13 Termini utilizzati in questo manuale.............................. 13 Altro materiale di riferimento.................................... 13 Capitolo 1: Informazioni sui componenti ActionScript 3.0...... 15 Vantaggi dell uso dei componenti................................ 16 Tipi di componente............................................. 18 Aggiunta ed eliminazione da un documento..................... 20 Eliminazione di un componente............................ 23 Ricerca della versione......................................... 23 Modello di gestione degli eventi ActionScript 3.0................ 25 Una semplice applicazione..................................... 26 Progettazione dell applicazione.............................. 26 Creazione dell applicazione Greetings........................ 26 Esempi successivi.......................................... 34 Capitolo 2: Operazioni con i componenti................... 35 Architettura dei componenti.................................... 36 Componenti ActionScript 3.0 basati su FLA.................. 36 Componenti basati su SWC..................................37 API dei componenti ActionScript 3.0......................... 38 File dei componenti........................................... 39 Percorso di memorizzazione dei file dei componenti........... 39 Percorso di memorizzazione dei file di origine................. 40 File di origine dei componenti e variabile Classpath............ 40 Modifica dei file dei componenti............................... 41 Debug delle applicazioni di componenti......................... 42 Impostazione dei parametri e delle proprietà..................... 43 Impostazione delle proprietà dei componenti in ActionScript.... 45 La libreria.................................................... 46 3

Ridimensionamento dei componenti............................ 48 Anteprima dal vivo............................................. 49 Gestione degli eventi.......................................... 50 Listener di eventi............................................ 50 Informazioni sull oggetto evento.............................. 51 Elenco di visualizzazione....................................... 52 Aggiunta di un componente all elenco di visualizzazione........ 53 Spostamento di un componente nell elenco di visualizzazione... 54 Rimozione di un componente dall elenco di visualizzazione...... 55 Classe FocusManager......................................... 56 Componenti basati su List...................................... 58 DataProvider................................................. 59 Creazione di un componente DataProvider.................... 59 Uso del parametro dataprovider............................ 59 Uso di ActionScript....................................... 61 Gestione di un oggetto DataProvider.......................... 65 CellRenderer.................................................. 69 Formattazione delle celle.................................... 69 Definizione di una classe CellRenderer personalizzata.......... 70 Proprietà di CellRenderer.................................... 76 Applicazione di un oggetto CellRenderer per una colonna di un oggetto DataGrid.................................... 76 Definizione di un oggetto CellRenderer per una cella modificabile.............................................. 77 Uso immagini, file SWF o clip filmato come CellRenderer....... 77 Accessibilità dei componenti................................... 77 Capitolo 3: Uso dei componenti UI......................... 79 Uso del componente Button.................................... 79 Interazione dell utente con il componente Button............... 80 Parametri del componente Button............................ 81 Creazione di un applicazione con il componente Button......... 81 Uso del componente CheckBox................................ 84 Interazione dell utente con il componente CheckBox........... 84 Parametri del componente CheckBox......................... 85 Creazione di un applicazione con il componente CheckBox..... 85 Uso del componente ColorPicker............................... 88 Interazione dell utente con il componente ColorPicker.......... 88 Parametri del componente ColorPicker........................ 89 Creazione di un applicazione con il componente ColorPicker.... 89 Uso del componente ComboBox................................ 91 Interazione dell utente con il componente ComboBox........... 91 Parametri del componente ComboBox........................ 92 Creazione di un applicazione con il componente ComboBox.... 93 4 Sommario

Uso del componente DataGrid................................. 95 Interazione dell utente con il componente DataGrid............ 96 Parametri del componente DataGrid.......................... 98 Creazione di un applicazione con il componente DataGrid...... 98 Uso del componente Label....................................102 Interazione dell utente con il componente Label...............103 Parametri del componente Label.............................103 Creazione di un applicazione con il componente Label.........103 Uso del componente List......................................105 Interazione dell utente con il componente List.................106 Parametri del componente List............................... 107 Creazione di un applicazione con il componente List...........107 Uso del componente NumericStepper........................... 111 Interazione dell utente con il componente NumericStepper...... 111 Parametri del componente NumericStepper................... 112 Creazione di un applicazione con il componente NumericStepper......................................... 112 Uso del componente ProgressBar.............................. 114 Interazione dell utente con il componente ProgressBar......... 115 Parametri del componente ProgressBar...................... 115 Creazione di un applicazione con il componente ProgressBar............................................ 116 Uso del componente RadioButton.............................. 121 Interazione dell utente con il componente RadioButton.........122 Parametri del componente RadioButton......................123 Creazione di un applicazione con il componente RadioButton..123 Uso del componente ScrollPane...............................125 Interazione dell utente con il componente ScrollPane..........126 Parametri del componente ScrollPane........................126 Creazione di un applicazione con il componente ScrollPane.... 127 Uso del componente Slider....................................128 Interazione dell utente con il componente Slider...............129 Parametri del componente Slider.............................129 Creazione di un applicazione con il componente Slider.........130 Uso del componente TextArea.................................132 Interazione dell utente con il componente TextArea............133 Parametri del componente TextArea.........................133 Creazione di un applicazione con il componente TextArea......134 Uso del componente TextInput.................................136 Interazione dell utente con il componente TextInput............136 Parametri del componente TextInput......................... 137 Creazione di un applicazione con il componente TextInput...... 137 Sommario 5

Uso del componente TileList.................................. 140 Interazione dell utente con il componente TileList............. 140 Parametri del componente TileList............................141 Creazione di un applicazione con il componente TileList....... 142 Uso del componente UILoader................................ 144 Interazione dell utente con il componente UILoader........... 144 Parametri del componente UILoader......................... 144 Creazione di un applicazione con il componente UILoader..... 145 Uso del componente UIScrollBar.............................. 146 Interazione dell utente con il componente UIScrollBar......... 146 Parametri del componente UIScrollBar....................... 146 Creazione di un applicazione con il componente UIScrollBar... 147 Capitolo 4: Personalizzazione dei componenti UI........... 149 Personalizzazione dei componenti dell interfaccia utente......... 150 Impostazione di stili........................................... 150 Nozioni fondamentali sulle impostazioni di stile.................151 Accesso agli stili predefiniti di un componente................ 152 Impostazione e recupero degli stili in un istanza di componente............................................. 152 Uso dell oggetto TextFormat per impostare le proprietà di testo...................................... 153 Impostazione di uno stile per tutte le istanze di un componente............................................. 153 Impostazione di uno stile per tutti i componenti................ 154 Informazioni sugli skin........................................ 154 Creazione di un nuovo skin.................................. 157 Creazione di un skin per tutte le istanze.................... 158 Creazione di skin per alcune istanze....................... 158 Personalizzazione del componente Button...................... 159 Uso degli stili con il componente Button...................... 160 Uso degli skin con il componente Button......................161 Personalizzazione del componente CheckBox.................. 163 Uso degli stili con il componente CheckBox................... 163 Uso degli skin con il componente CheckBox.................. 164 Personalizzazione del componente ColorPicker................. 165 Uso degli stili con il componente ColorPicker................. 165 Uso degli skin con il componente ColorPicker................. 166 Personalizzazione del componente ComboBox................. 167 Uso degli stili con il componente ComboBox.................. 168 Uso degli skin con il componente ComboBox................. 169 6 Sommario

Personalizzazione del componente DataGrid.................... 170 Uso degli stili con il componente DataGrid.................... 170 Impostazione di stili per una singola colonna................ 171 Impostazione di stili dell intestazione....................... 173 Uso degli skin con il componente DataGrid.................... 174 Personalizzazione del componente Label....................... 176 Uso degli stili con il componente Label........................ 177 Uso degli skin con il componente Label....................... 177 Personalizzazione del componente List......................... 178 Uso degli stili con il componente List......................... 178 Uso degli skin con il componente List......................... 179 Personalizzazione del componente NumericStepper............. 181 Uso degli stili con il componente NumericStepper.............182 Uso degli skin con il componente NumericStepper.............182 Personalizzazione del componente ProgressBar.................184 Uso degli stili con il componente ProgressBar.................184 Uso degli skin con il componente ProgressBar................185 Personalizzazione del componente RadioButton.................186 Uso degli stili con il componente RadioButton................. 187 Uso degli skin con il componente RadioButton................188 Personalizzazione del componente ScrollPane..................189 Uso degli stili con il componente ScrollPane...................190 Uso degli skin con il componente ScrollPane.................. 191 Personalizzazione del componente Slider....................... 191 Uso degli stili con il componente Slider....................... 191 Uso degli skin con il componente Slider.......................192 Personalizzazione del componente TextArea....................193 Uso degli stili con il componente TextArea....................194 Uso degli skin con il componente TextArea....................195 Personalizzazione del componente TextInput....................196 Uso degli stili con il componente TextInput.................... 197 Uso degli skin con il componente TextInput...................198 Personalizzazione del componente TileList......................199 Uso degli stili con il componente TileList......................199 Uso degli stili con il componente TileList..................... 200 Personalizzazione del componente UILoader....................201 Personalizzazione del componente UIScrollBar................. 202 Uso degli stili con il componente UIScrollBar................. 202 Uso degli skin con il componente UIScrollBar................ 203 Sommario 7

Capitolo 5: Uso del componente FLVPlayback............ 205 Uso del componente FLVPlayback............................ 205 Creazione di un applicazione con il componente FLVPlayback............................................207 Parametri del componente FLVPlayback......................211 Impostazione del parametro source.........................211 Uso di Anteprima dal vivo................................... 214 Supporto della modalità a schermo intero..................... 215 Allineamento del layout per riprodurre più file FLV............. 215 Riproduzione automatica dei file FLV a scaricamento progressivo............................................. 215 Uso dei cue point........................................... 216 Uso della finestra di dialogo Cue point Flash Video.......... 217 Uso di ActionScript con i cue point........................ 219 Aggiunta di cue point ActionScript......................... 219 Intercettazione degli eventi cuepoint...................... 220 Ricerca dei cue point.................................... 220 Ricerca dei cue point di navigazione....................... 221 Attivazione e disattivazione dei cue point incorporati del file FLV...............................................222 Rimozione di un cue point ActionScript....................223 Riproduzione di più file FLV.................................223 Uso di più lettori video....................................224 Streaming di file FLV da Flash Media Server..................226 Per il rilevamento nativo della larghezza di banda o nessun rilevamento....................................227 Per il rilevamento non nativo della larghezza di banda........227 Personalizzazione del componente FLVPlayback...............227 Selezione di uno skin predefinito.............................228 Associazione di skin ai singoli componenti UI FLV di riproduzione personalizzati.............................. 230 Componenti Button..................................... 230 Componente BufferingBar................................232 Componenti SeekBar e VolumeBar........................232 Connessione dei componenti UI FLV di riproduzione personalizzati.........................................235 Creazione di un nuovo skin..................................238 Uso del layout dello skin..................................239 Barra di bufferizzazione..................................242 Barra di ricerca e barra del volume.........................242 Clip di sfondo e di primo piano........................... 244 Modifica del comportamento degli skin...................... 245 8 Sommario

Uso di un file SMIL........................................... 245 <smil>..................................................... 247 <head>.................................................... 248 <meta>.................................................... 249 <layout>................................................... 250 <root-layout>................................................251 <body>.................................................... 252 <video>.................................................... 253 <ref>...................................................... 254 <switch>................................................... 255 Capitolo 6: Uso del componente FLVPlaybackCaptioning... 257 Uso del componente FLVPlaybackCaptioning.................. 258 Aggiunta di didascalie al componente FLVPlayback.......... 258 Impostazione dei parametri del componente FLVPlaybackCaptioning................................. 260 Impostazione del parametro source....................... 260 Visualizzazione delle didascalie............................261 Uso delle didascalie Timed Text................................261 Uso dei cue point con le didascalie............................. 263 Nozioni fondamentali sugli standard relativi ai cue point del componente FLVPlaybackCaptioning...... 263 Nozioni fondamentali sulla creazione di didascalie per i cue point di evento incorporati......................... 264 Supporto di tracce in più lingue con cue point incorporati.... 266 Riproduzione di più file FLV con didascalie..................... 266 Personalizzazione del componente FLVPlaybackCaptioning..... 267 Appendice A: Tag Timed Text........................... 269 Indice analitico........................................ 275 Sommario 9

10 Sommario

Introduzione Adobe Flash CS3 Professional è lo strumento standard per la creazione di contenuti che consentono di offrire esperienze Web di grande impatto. I componenti sono gli elementi strutturali di base delle applicazioni Internet dinamiche che assicurano tali esperienze. Un componente è un clip filmato con parametri che ne consentono la personalizzazione in fase di creazione in Flash o in fase di runtime con metodi, proprietà ed eventi ActionScript. I componenti sono concepiti per consentire agli sviluppatori di riutilizzare e condividere il codice, nonché di incorporare funzionalità complesse che i designer possono usare e personalizzare senza avvalersi di ActionScript. I componenti consentono di creare in modo facile e rapido applicazioni complesse con un aspetto e un comportamento omogenei. In questo manuale viene illustrato come creare applicazioni con componenti ActionScript 3.0. Nella Guida di riferimento del linguaggio e dei componenti ActionScript 3.0 è illustrata l API (Application Programming Interface) di ogni componente. È possibile usare i componenti creati da Adobe, scaricare i componenti realizzati da altri sviluppatori oppure ideare componenti personalizzati. In questo capitolo sono contenute le seguenti sezioni: A chi è destinato questo manuale........................................... 12 Requisiti di sistema....................................................... 12 Informazioni sulla documentazione......................................... 12 Convenzioni tipografiche.................................................. 13 Termini utilizzati in questo manuale......................................... 13 Altro materiale di riferimento............................................... 13 11

A chi è destinato questo manuale Il manuale è rivolto agli sviluppatori che creano applicazioni Flash e desiderano utilizzare i componenti per accelerare la fase di sviluppo. È necessario disporre di una buona conoscenza dello sviluppo di applicazioni in Flash e della creazione di script ActionScript. Se non si è molto esperti nella creazione di script ActionScript, è possibile aggiungere i componenti a un documento, impostare i relativi parametri nella finestra di ispezione Proprietà o nella finestra di ispezione dei componenti e gestirne gli eventi nel pannello Comportamenti. Ad esempio, è possibile associare un comportamento Vai alla pagina Web a un componente Button che apre un URL in un browser Web quando si fa clic sul pulsante, senza scrivere codice ActionScript. Se invece si desidera creare applicazioni più complesse, è possibile creare i componenti in modo dinamico, usare ActionScript per impostare le proprietà e chiamare i metodi in fase di runtime, utilizzare il modello di listener per gestire gli eventi. Per ulteriori informazioni, vedere Capitolo 2, Operazioni con i componenti a pagina 35. Requisiti di sistema Per i componenti Flash non sono richiesti altri requisiti di sistema oltre a quelli definiti per Flash. Eventuali file SWF che utilizzano i componenti Flash CS3 devono essere visualizzati con Adobe Flash Player 9.0.28.0 o una versione successiva e devono essere pubblicati per ActionScript 3.0 (a questo scopo selezionare File > Impostazioni di pubblicazione e scegliere la scheda Flash). Informazioni sulla documentazione In questa pubblicazione è illustrato in dettaglio come usare i componenti per sviluppare le applicazioni Flash. È necessario disporre di un adeguata conoscenza di Flash e ActionScript. La documentazione specifica su Flash e i prodotti correlati è disponibile separatamente. Questo documento è disponibile come file PDF e Guida in linea. Per visualizzare la Guida in linea, avviare Flash e selezionare? > Guida di Flash > Uso dei componenti ActionScript 3.0. Per informazioni su Flash, consultare i seguenti documenti: Uso di Flash Programmazione in ActionScript 3.0 Guida di riferimento del linguaggio e dei componenti ActionScript 3.0 12 Introduzione

Convenzioni tipografiche In questo manuale vengono utilizzate le seguenti convenzioni tipografiche: Carattere corsivo: indica un valore che deve essere sostituito dall utente (ad esempio, il percorso di una cartella). Carattere codice: indica il codice ActionScript, inclusi i nomi dei metodi e delle proprietà. Carattere codice corsivo: indica un elemento di codice che deve essere sostituito, ad esempio un parametro ActionScript. Carattere grassetto: indica un valore da inserire. Termini utilizzati in questo manuale In questo manuale vengono utilizzati i termini seguenti: In (fase di) runtime Durante la (fase di) creazione creazione Flash. Durante l esecuzione del codice in Flash Player. Nel corso delle operazioni eseguite nell ambiente di Altro materiale di riferimento Oltre al contenuto di questi manuali, Adobe offre articoli aggiornati periodicamente, idee per la progettazione ed esempi disponibili nel Centro per sviluppatori Adobe e nell Adobe Design Center. Ulteriori esempi di componenti sono disponibili all indirizzo www.adobe.com/go/learn_fl_samples_it. Centro per sviluppatori Adobe Nel Centro per sviluppatori Adobe sono disponibili informazioni aggiornate su ActionScript, articoli relativi allo sviluppo di applicazioni reali e informazioni su importanti problemi emergenti. Visitare il Centro per sviluppatori all indirizzo www.adobe.com/go/flash_devcenter_it. Altro materiale di riferimento 13

Adobe Design Center Consente di ottenere le informazioni più aggiornate sulla progettazione digitale e di immagini in movimento. È possibile accedere alla produzione dei più noti artisti, scoprire le nuove tendenze di progettazione e affinare le proprie competenze con esercitazioni, flussi di lavoro di base e tecniche avanzate. Si consiglia di controllare un paio di volte al mese se sono disponibili esercitazioni e articoli aggiornati, nonché elementi di gallerie fotografiche da cui trarre ispirazione. Visitare il Design Center all indirizzo www.adobe.com/go/fl_designcenter_it. 14 Introduzione

CAPITOLO 1 Informazioni sui componenti ActionScript 3.0 1 I componenti Adobe Flash CS3 Professional sono clip filmato con parametri che consentono di modificarne l aspetto e il comportamento. Un componente può essere un semplice controllo dell interfaccia utente, ad esempio RadioButton o CheckBox, oppure può includere contenuto, ad esempio List o DataGrid. I componenti consentono di creare in modo facile e rapido applicazioni Flash complesse con un comportamento e un aspetto omogenei. Anziché creare pulsanti, caselle combinate ed elenchi personalizzati, è infatti possibile usare i componenti Flash che implementano questi controlli trascinandoli dal pannello Componenti nel documento dell applicazione. Anche l aspetto dei componenti può essere facilmente personalizzato in base alla progettazione dell applicazione. Mentre tutte queste operazioni possono essere effettuate senza una conoscenza approfondita di ActionScript, è possibile usare ActionScript 3.0 per modificare il comportamento di un componente o implementare un nuovo comportamento. Tutti i componenti dispongono inoltre di un set univoco di metodi, proprietà ed eventi di ActionScript, che costituiscono la relativa API (Application Programming Interface) con la quale è possibile creare e modificare i componenti mentre l applicazione è in esecuzione. Usando le API si possono creare autonomamente componenti nuovi e personalizzati. È possibile scaricare componenti creati da membri della comunità Flash dal sito Adobe Exchange all indirizzo http://www.adobe.com/go/flash_exchange_it. Per ulteriori informazioni sulla creazione di un componente, vedere www.adobe.com/go/learn_fl_creating_components_it. 15

L architettura dei componenti ActionScript 3.0 include classi sulle quali si basano tutti i componenti, skin e stili che consentono di personalizzare l aspetto dei componenti, un modello di gestione degli eventi, la gestione dell attivazione, un interfaccia per l accessibilità e altro ancora. NOTA Adobe Flash CS3 include sia i componenti ActionScript 2.0 che i componenti ActionScript 3.0. Non è possibile usare insieme questi due set di componenti, ma è necessario usare alternativamente un set o l altro per una determinata applicazione. Tramite Flash CS3 vengono presentati componenti ActionScript 2.0 o componenti ActionScript 3.0 a seconda che venga aperto un file ActionScript 2.0 o un file ActionScript 3.0. Quando si crea un nuovo documento Flash CS3, è necessario specificare se si tratta di un file Flash ActionScript 3.0 o ActionScript 2.0. All apertura di un documento esistente, vengono esaminati automaticamente i valori di Impostazioni pubblicazioni per determinare quale set di componenti usare. Per informazioni sui componenti ActionScript 2.0, consultare la guida Uso dei componenti ActionScript 2.0. Per un elenco completo dei componenti disponibili in Flash ActionScript 3.0, vedere Tipi di componente a pagina 18. In questo capitolo sono contenute le seguenti sezioni: Vantaggi dell uso dei componenti........................................... 16 Tipi di componente........................................................ 18 Aggiunta ed eliminazione da un documento................................. 20 Ricerca della versione..................................................... 23 Modello di gestione degli eventi ActionScript 3.0............................ 25 Una semplice applicazione................................................. 26 Vantaggi dell uso dei componenti Grazie ai componenti è possibile separare il processo di progettazione dell applicazione dal processo di codifica. Consentono agli sviluppatori di creare funzionalità che i designer possono usare nelle applicazioni. Da una parte, gli sviluppatori possono incorporare nei componenti le funzionalità usate di frequente, dall altra i designer possono personalizzare le dimensioni, la posizione e il comportamento dei componenti modificandone i parametri e, inoltre, cambiare l aspetto di un componente modificandone gli elementi grafici o skin. I componenti condividono funzionalità di base quali stili, skin e gestione dell attivazione. Quando si aggiunge il primo componente a un applicazione, le funzionalità di base occupano circa 20 kilobyte delle dimensioni. Con l aggiunta di altri componenti, l allocazione di memoria iniziale viene condivisa dai componenti aggiunti, limitando l aumento delle dimensioni dell applicazione. 16 Informazioni sui componenti ActionScript 3.0

In questa sezione sono descritti alcuni vantaggi offerti dai componenti ActionScript 3.0. ActionScript 3.0 offre un potente linguaggio di programmazione orientato agli oggetti che costituisce una fase importante nell evoluzione delle funzionalità di Flash Player. Il linguaggio è concepito per la creazione di applicazioni Internet complesse con una base di codice riutilizzabile. ActionScript 3.0 si basa su ECMAScript, il linguaggio standard internazionale per la creazione di script. È conforme con la specifica del linguaggio ECMAScript (ECMA-262), terza edizione. Per un introduzione esaustiva ad ActionScript 3.0, consultare il manuale Programmazione in ActionScript 3.0. Per informazioni di riferimento sul linguaggio, consultare la Guida di riferimento del linguaggio e dei componenti ActionScript 3.0. I componenti dell interfaccia utente basati su FLA consentono di accedere facilmente agli skin per la personalizzazione durante la fase di creazione. Questi componenti dispongono inoltre di stili, tra cui quelli degli skin, per personalizzare l aspetto dei componenti stessi e caricare gli skin in fase di runtime. Per ulteriori informazioni, vedere Capitolo 4, Personalizzazione dei componenti UI a pagina 149 e la Guida di riferimento del linguaggio e dei componenti ActionScript 3.0. Il nuovo componente FVLPlayback consente di aggiungere il componente FLVPlaybackCaptioning unitamente al supporto per la visualizzazione a schermo intero, l anteprima dal vivo migliorata, gli skin per l aggiunta di impostazioni di colore e trasparenza, nonché funzioni migliorate per lo scaricamento di file FLV e il controllo del layout. La finestra di ispezione Proprietà e la finestra di ispezione dei componenti consentono di cambiare i parametri dei componenti durante la fase di creazione in Flash. Per ulteriori informazioni, vedere Aggiunta ed eliminazione da un documento a pagina 20 e Impostazione dei parametri e delle proprietà a pagina 43. La nuova finestra di dialogo relativa alla raccolta disponibile per i componenti ComboBox, List e TileList consente di compilare la relativa proprietà dataprovider tramite l interfaccia utente. Per ulteriori informazioni, vedere Creazione di un componente DataProvider apagina59. Il modello di eventi di ActionScript 3.0 consente all applicazione di ascoltare gli eventi e di richiamare i gestori di eventi per rispondere. Per ulteriori informazioni, vedere Modello di gestione degli eventi ActionScript 3.0 a pagina 25 e Gestione degli eventi a pagina 50. Le classi di gestori offrono un modo rapido di gestire l attivazione e gli stili in un applicazione. Per ulteriori informazioni, consultare la Guida di riferimento del linguaggio e dei componenti ActionScript 3.0. Vantaggi dell uso dei componenti 17

La classe di base UIComponent fornisce i metodi, le proprietà e gli eventi principali per i componenti che estendono tale classe. Tutti i componenti dell interfaccia utente di ActionScript 3.0 ereditano dalla classe UIComponent. Per ulteriori informazioni, vedere la classe UIComponent nella Guida di riferimento del linguaggio e dei componenti ActionScript 3.0. L uso di un file SWC nei componenti UI basati su FLA fornisce le definizioni di ActionScript come risorsa all interno della linea temporale del componente per accelerare la compilazione. La gerarchia di classi facile da estendere tramite ActionScript 3.0 consente di creare spazi dei nomi univoci, importare agevolmente le classi necessarie e creare sottoclassi per estendere i componenti. Per ulteriori informazioni, consultare la Guida di riferimento del linguaggio e dei componenti ActionScript 3.0. NOTA Flash CS3 supporta sia i componenti basati su FLA che i componenti basati su SWC. Per ulteriori informazioni, vedere Architettura dei componenti a pagina 36. Tipi di componente I componenti Flash vengono installati quando si installa Flash CS3. Tra i componenti ActionScript 3.0 sono inclusi i seguenti componenti dell interfaccia utente (UI): UIComponent Button List TextArea CheckBox NumericStepper TextInput ColorPicker RadioButton TileList ComboBox ProgressBar UILoader DataGrid ScrollPane UIScrollBar Label Slider Oltre ai componenti dell interfaccia utente, i componenti Flash ActionScript 3.0 comprendono i componenti e le classi di supporto seguenti: Il componente FLVPlayback (fl.video.flvplayback) è basato su SWC. Il componente FLVPlayback consente di includere con facilità un lettore video in un applicazione Flash per la riproduzione di video in streaming progressivo via HTTP, da un servizio FVSS (Adobe Flash Video Streaming Service) o da Macromedia Flash Media Server di Adobe (FMS). Per ulteriori informazioni, vedere Capitolo 5, Uso del componente FLVPlayback a pagina 205. 18 Informazioni sui componenti ActionScript 3.0

I componenti UI personalizzati FLVPlayback sono basati su FLA e possono essere usati con le versioni ActionScript 2.0 e ActionScript 3.0 del componente FLVPlayback. Per ulteriori informazioni, vedere Capitolo 5, Uso del componente FLVPlayback apagina205. Il componente FLVPlaybackCaptioning fornisce funzionalità di didascalia per FLVPlayback. Capitolo 6, Uso del componente FLVPlaybackCaptioning a pagina 257 Per un elenco completo di classi dei componenti ActionScript 3.0 e delle relative classi di supporto, consultare la Guida di riferimento del linguaggio e dei componenti ActionScript 3.0. Per visualizzare i componenti Flash: Per visualizzare i componenti Flash ActionScript 3.0 nel pannello Componenti, attenersi alla procedura riportata di seguito. 1. Avviare Flash. 2. Creare un nuovo file Flash (ActionScript 3.0) o aprire un documento Flash esistente nella cui finestra di dialogo Impostazioni pubblicazione sia specificato ActionScript 3.0. 3. Selezionare Finestra > Componenti per aprire il pannello Componenti, se non è già visualizzato. Pannello Componenti con componenti dell interfaccia utente e video Tipi di componente 19

I componenti dell interfaccia utente e i componenti video sono visualizzati separatamente per risparmiare spazio. Nel pannello Componenti sono presenti tutti i componenti visualizzati. È inoltre possibile scaricare componenti aggiuntivi da Adobe Exchange all indirizzo http://www.adobe.com/go/flash_exchange_it. Per installare i componenti scaricati da Exchange, scaricare e installare Adobe Extension Manager dall indirizzo http://www.adobe.com/go/exchange_it. Fare clic sul collegamento Adobe Exchange Home e cercare il collegamento Extension Manager. Nel pannello Componenti di Flash è possibile visualizzare qualsiasi componente. Attenersi alla procedura riportata di seguito per installare i componenti su un computer Windows o Macintosh. Per installare i componenti su un computer Windows o Macintosh: 1. Uscire da Flash. 2. Inserire il file SWC o FLA che contiene il componente desiderato nella cartella seguente sul disco rigido: In Windows: C:\Programmi\Adobe\Flash CS3\lingua\Configuration\Components In Macintosh: Macintosh HD:Applicazioni:Adobe Flash CS3:Configuration/Components 3. Avviare Flash. 4. Selezionare Finestra > Componenti per visualizzare il componente nel pannello Componenti, se non è già visualizzato. Per ulteriori informazioni sui file dei componenti, vedere File dei componenti a pagina 39 Aggiunta ed eliminazione da un documento Quando si trascina un componente basato su FLA dal pannello Componenti allo stage, Flash importa un clip filmato modificabile nella libreria. Quando si trascina un componente basato su SWC dal pannello Componenti allo stage, Flash importa un clip compilato nella libreria. Dopo avere importato un componente nella libreria, è possibile trascinarne delle istanze nello stage sia dal pannello Libreria che dal pannello Componenti. 20 Informazioni sui componenti ActionScript 3.0

Aggiunta di componenti durante la fase di creazione È possibile aggiungere un componente a un documento trascinandolo dal pannello Componenti. Le proprietà di ogni istanza di un componente possono essere impostate nella scheda Parametri della finestra di ispezione Proprietà o nella finestra di ispezione dei componenti. Per aggiungere un componente a un documento Flash tramite il pannello Componenti: 1. Selezionare Finestra > Componenti. 2. Fare doppio clic sul componente nel pannello Componenti o trascinarlo nello stage. 3. Selezionare il componente nello stage. 4. Se la finestra di ispezione Proprietà non è visualizzata, selezionare Finestra > Proprietà > Proprietà. 5. Nella finestra di ispezione Proprietà inserire un nome per l istanza del componente. 6. Fare clic sulla scheda Parametri e specificare i parametri dell istanza. Nella seguente figura è illustrata la finestra di ispezione Proprietà relativa al componente Button. Impostazioni del componente nella finestra di ispezione Proprietà Per ulteriori informazioni, vedere Impostazione dei parametri e delle proprietà apagina43. 7. Ridimensionare il componente nel modo desiderato modificando i valori per larghezza (W:) e altezza (H:). Per ulteriori informazioni sul ridimensionamento di determinati tipi di componenti, vedere Capitolo 4, Personalizzazione dei componenti UI a pagina 149. 8. Selezionare Controllo > Prova filmato o premere Ctrl+Invio per compilare il documento e visualizzare i risultati delle impostazioni. Aggiunta ed eliminazione da un documento 21

È inoltre possibile cambiare la formattazione del testo e il colore di un componente impostandone le proprietà dello stile oppure personalizzarne l aspetto modificando gli skin del componente. Per ulteriori informazioni su questi argomenti, vedere Capitolo 4, Personalizzazione dei componenti UI a pagina 149. Se si trascina un componente nello stage durante la fase di creazione, è possibile farvi riferimento utilizzando il relativo nome di istanza, ad esempio mybutton. Aggiunta di componenti in fase di runtime mediante ActionScript Per aggiungere un componente a un documento in fase di runtime con ActionScript, è necessario che il componente si trovi nella libreria dell applicazione (Finestra > Libreria) quando si compila il file SWF. Per aggiungere un componente alla libreria, trascinare il componente dal pannello Componenti al pannello Libreria. Per ulteriori informazioni sulla libreria, vedere La libreria a pagina 46. Per rendere disponibile l API di un componente in un applicazione, è necessario importare anche il relativo file di classe. I file di classe dei componenti sono installati in pacchetti contenenti una o più classi. Per importare la classe di un componente, usare l istruzione import e specificare il nome del pacchetto e della classe. Per importare, ad esempio, la classe Button, usare l istruzione import riportata di seguito: import fl.controls.button; Per informazioni sul pacchetto in cui è contenuto un determinato componente, consultare la Guida di riferimento del linguaggio e dei componenti ActionScript 3.0. Per informazioni sulla posizione dei file di origine dei componenti, vedere File dei componenti a pagina 39. Per creare un istanza di un componente, richiamare il metodo della funzione di costruzione ActionScript del componente. Ad esempio, con la seguente istruzione viene creata un istanza Button chiamata abutton: var abutton:button = new Button(); Il passaggio conclusivo consiste nel chiamare il metodo statico addchild() per aggiungere l istanza del componente allo stage o al contenitore dell applicazione. Ad esempio, con la seguente istruzione viene aggiunta l istanza abutton: addchild(abutton); A questo punto, è possibile usare l API del componente per specificare dinamicamente le dimensioni e la posizione del componente sullo stage, impostare l ascolto degli eventi e definire le proprietà per modificarne il comportamento. Per ulteriori informazioni sull API di un determinato componente, consultare la Guida di riferimento del linguaggio e dei componenti ActionScript 3.0. 22 Informazioni sui componenti ActionScript 3.0

Per ulteriori informazioni sul metodo addchild(), vedere Elenco di visualizzazione apagina52. Eliminazione di un componente Per eliminare l istanza di un componente dallo stage durante la creazione, selezionare semplicemente l istanza e premere il tasto Canc. Viene rimossa l istanza dallo stage, ma non il componente dall applicazione. Per eliminare un componente da un documento Flash dopo averlo posizionato nello stage o nella libreria, eliminare dalla libreria il componente e le risorse ad esso associate. Non è sufficiente eliminare il componente dallo stage. Se il componente non viene rimosso dalla libreria, sarà incluso nell applicazione al momento della compilazione. Per eliminare un componente da un documento: 1. Selezionare il simbolo relativo al componente nel pannello Libreria. 2. Fare clic sul pulsante Elimina nella parte inferiore del pannello Libreria oppure selezionare Elimina dal menu del pannello Libreria. Ripetere questi passaggi per eliminare le eventuali risorse associate al componente. Per informazioni su come rimuovere un componente dal relativo contenitore mentre l applicazione è in esecuzione, vedere Rimozione di un componente dall elenco di visualizzazione a pagina 55. Ricerca della versione I componenti Flash ActionScript 3.0 sono dotati di una proprietà version che può essere visualizzata qualora fosse necessario fornirla al Supporto tecnico di Adobe o conoscere la versione del componente utilizzato. Per visualizzare il numero di versione di un componente dell interfaccia utente: 1. Creare un nuovo documento File Flash (ActionScript 3.0). 2. Trascinare il componente nello stage e assegnare un nome all istanza. Ad esempio, trascinare un componente ComboBox nello stage e denominarlo acb. 3. Premere il tasto F9 o selezionare Finestra > Azioni per aprire il pannello Azioni. Ricerca della versione 23

.. 4. Fare clic sul fotogramma 1 della linea temporale principale e aggiungere il codice seguente nel pannello Azioni. trace(acb.version); Nel pannello Output dovrebbe essere visualizzato il numero di versione, simile a quello riportato nell illustrazione seguente. Per i componenti FLVPlayback e FLVPlaybackCaptioning è necessario usare il nome di classe anziché il nome di istanza, poiché il numero di versione è memorizzato in una costante di classe. Per visualizzare il numero di versione dei componenti FLVPlayback e FLVPlaybackCaptioning: 1. Creare un nuovo documento File Flash (ActionScript 3.0). 2. Trascinare i componenti FLVPlayback e FLVPlaybackCaptioning nel pannello Libreria. 3. Premere il tasto F9 o selezionare Finestra > Azioni per aprire il pannello Azioni. 4. Fare clic sul fotogramma 1 della linea temporale principale e aggiungere il codice seguente nel pannello Azioni. import fl.video.*; trace("flvplayback.version: " + FLVPlayback.VERSION); trace("flvplaybackcaptioning.version: " + FLVPlaybackCaptioning.VERSION); Nel pannello Output dovrebbero essere visualizzati i numeri di versione, simili a quelli riportati nell illustrazione seguente. Numeri di versione di FLVPlayback e FLVPlaybackCaptioning 24 Informazioni sui componenti ActionScript 3.0

Modello di gestione degli eventi ActionScript 3.0 In ActionScript 3.0 viene introdotto un unico modello di gestione degli eventi che sostituisce i meccanismi di gestione degli eventi inclusi nella versioni precedenti di ActionScript. Il nuovo modello di gestione si basa sulla specifica DOM (Document Object Model) Level 3. Per gli sviluppatori esperti nell uso del metodo addlistener() di ActionScript 2.0 può essere utile sottolineare le differenze tra il modello di eventi listener di ActionScript 2.0 e il modello di eventi di ActionScript 3.0. Nell elenco riportato di seguito sono descritte alcune delle principali differenze tra i due modelli di evento: Per aggiungere listener di eventi in ActionScript 2.0 si usa addlistener() in alcuni casi e addeventlistener() in altri, mentre in ActionScript 3.0 si usa sempre addeventlistener(). In ActionScript 2.0 non è presente un flusso di eventi, quindi il metodo addlistener() può essere chiamato solo sull oggetto che trasmette l evento, mentre in ActionScript 3.0 il metodo addeventlistener() può essere chiamato su qualsiasi oggetto appartenente al flusso di eventi. In ActionScript 2.0 i listener di eventi possono essere funzioni, metodi o oggetti, mentre in ActionScript 3.0 solo le funzioni o i metodi possono essere listener di eventi. La sintassi on(event) non è più supportata in ActionScript 3.0, quindi non è possibile associare codice di eventi ActionScript a un clip filmato. Per aggiungere un listener di eventi, è possibile usare solo addeventlistener(). L esempio seguente, impostato per l intercettazione di un evento MouseEvent.CLICK su un componente Button denominato abutton, illustra il modello di base per la gestione degli eventi di ActionScript 3.0: abutton.addeventlistener(mouseevent.click, clickhandler); function clickhandler(event:mouseevent):void { trace("clickhandler detected an event of type: " + event.type); trace("the event occurred on: " + event.target.name); } Per ulteriori informazioni sulla gestione degli eventi in ActionScript 3.0, consultare la guida Programmazione in ActionScript 3.0. Per ulteriori informazioni sulla gestione degli eventi relativi ai componenti in ActionScript 3.0, vedere Gestione degli eventi a pagina 50. Modello di gestione degli eventi ActionScript 3.0 25

Una semplice applicazione In questa sezione sono illustrate le varie fasi necessarie per creare una semplice applicazione ActionScript 3.0 utilizzando i componenti Flash e lo strumento di creazione Flash. L esempio viene fornito sia sotto forma di file FLA con il codice ActionScript incluso nella linea temporale, sia come file di classe ActionScript esterno con un file FLA contenente solo i componenti presenti nella libreria. In generale, è consigliabile sviluppare le applicazioni di grandi dimensioni usando file di classe esterni, per avere la possibilità di condividere il codice tra classi e applicazioni e facilitare la gestione delle applicazioni. Per ulteriori informazioni sulla programmazione in ActionScript 3.0, consultare la guida Programmazione in ActionScript 3.0. Progettazione dell applicazione Il primo esempio di applicazione di componenti ActionScript è una variante dell applicazione "Hello World" standard, il cui schema è quindi piuttosto semplice: L applicazione si chiamerà Greetings. Il componente TextArea consente di visualizzare un saluto, che inizialmente è Hello World. Il componente ColorPicker consente di cambiare il colore del testo. I tre componenti RadioButton consentono di impostare la dimensione del testo scegliendo tra piccolo, grande e più grande. Il componente ComboBox consente di selezionare un saluto diverso da un elenco a discesa. Nell applicazione vengono usati i componenti disponibili nel pannello Componenti e vengono creati gli elementi dell applicazione tramite il codice ActionScript. Con questa definizione del progetto, è possibile iniziare a realizzare l applicazione. Creazione dell applicazione Greetings Nella procedura seguente viene creata l applicazione Greetings usando lo strumento di creazione Flash per ottenere un file FLA, posizionare i componenti sullo stage e aggiungere codice ActionScript alla linea temporale. 26 Informazioni sui componenti ActionScript 3.0