Nome
| TGetProperty | ||||||
Plugin
| 4, 5, 6 | ||||||
Sintassi
| filmato.TGetProperty( movieclip, indiceProprietà ) | ||||||
Descrizione
| Restituisce una stringa contenente il valore della proprietà, indicata da indiceProprietà, del clip filmato movieclip.
Il percorso e il nome del movieclip può essere indicato sia con la sintassi del Flash4: filmato.TGetProperty("/percorso/movieclip", 2) che del Flash5: filmato.TGetProperty("_root.percorso.movieclip", 2) indiceProprietà è un numero intero positivo associato alle proprietà dei movieclip secondo questa tabella. Il parametro movieclip è una stringa. | ||||||
Esempio
| Funzione minima:
Ad esempio, al quinto pulsante (le proprietà partono dallo 0) è associato questo script:
| ||||||
File
|
Nome
| TGetPropertyAsNumber | ||||||
Plugin
| 4, 5, 6 | ||||||
Sintassi
| filmato.TGetPropertyAsNumber( movieclip, indiceProprietà ) | ||||||
Descrizione
| Restituisce un numero contenente il valore della proprietà, indicata da indiceProprietà, del clip filmato movieclip. Il percorso e il nome del movieclip può essere indicato sia con la sintassi del Flash4: filmato.TGetPropertyAsNumber("/percorso/movieclip", 2) che del Flash5: filmato.TGetPropertyAsNumber("_root.percorso.movieclip", 2) indiceProprietà è un numero intero positivo associato alle proprietà dei movieclip secondo questa tabella. Questo metodo è identico al TGetProperty, solo che restituisce il valore come numero invece che come stringa. Il parametro movieclip è una stringa. | ||||||
Esempio
| Funzione minima:
Nel secondo filmato è presente un movieclip con nome di istanza ball, del quale sono state modificate volutamente alcune proprietà (larghezza, alpha, altezza...). Nel primo filmato, sono presenti 19 pulsanti (uno per ciascuna proprietà). Ogni pulsante chiama la stessa funzione definita nel primo frame della timeline principale, passando come parametro un numero identificativo. Ad esempio, al quinto pulsante (le proprietà partono dallo 0) è associato questo script:
Il codice html dell'immagine (per conoscere la proprietà identificata da numero 6):
Inoltre, viene effettuato, tramite l'operatore ternario, un controllo sul tipo di dato del valore restituito dal metodo. In questo caso risulta "numero", mentre nel metodo precedente, TGetProperty, risulta "stringa". | ||||||
File
|
Nome
| TSetProperty | |||||
Plugin
| 4, 5, 6 | |||||
Sintassi
| filmato.TSetProperty( movieclip, indiceProprietà, valoreProprietà ) | |||||
Descrizione
| Setta la proprietà, indicata da indiceProprietà, del clip filmato movieclip, con il valore indicato da valoreProprietà.
Il percorso e il nome del movieclip può essere indicato sia con la sintassi del Flash4: filmato.TSetProperty("/percorso/movieclip", 2, 100) che del Flash5: filmato.TSetProperty("_root.percorso.movieclip", 2, 100) indiceProprietà è un numero intero positivo associato alle proprietà dei movieclip secondo questa tabella. Il parametro movieclip è una stringa, valoreProprietà un numero. | |||||
Esempio
|
La funzione riceve tre parametri: clip è una stringa contenente nome e percorso del movieclip di riferimento, prop è il numero identificativo della proprietà secondo questa tabella, val è un numero contenente il valore da attribuire alla proprietà. Nel secondo filmato è presente un movieclip con nome di istanza ball, movieclip del quale vengono modificate le proprietà. Nel primo filmato sono invece presenti non 19 pulsanti, bensì 13 (13 sono le proprietà di cui può essere settato il valore). C'è un campo di testo di input, a cui è associata la variabile valore. I pulsanti chiamano una funzione definita nel primo frame della timeline principale, e passano come parametro il numero identificativo della proprietà che si vuole modificare:
La funzione riceve come parametro l'identificatore, l'unisce nella stringa del getURL con il richiamo al metodo, il nome di istanza del movieclip da modificare, e il valore, convertito in numero, della variabile associata al campo di testo di input. Scrivendo un valore nel campo di testo, e premendo uno dei pulsanti, la funzione Javascript viene chiamata in questa forma:
Anche in questo caso, dal momento che identificativo della proprietà e valore sono due numeri, non sono necessari i singoli apici. Il codice html dell'immagine (modifica la proprietà identificata dal 6, cioè l'alpha, impostadola a 50%):
| |||||
File
|
Nome
| TGotoFrame | ||||
Plugin
| 3, 4, 5, 6 | ||||
Sintassi
| filmato.TGotoFrame( movieclip, numeroFrame ) | ||||
Descrizione
| Sposta la testina di riproduzione del clip filmato movieclip al frame numeroFrame. Il parametro movieclip è una stringa, numeroFrame un numero intero positivo.
La numerazione dei frame, per Javascript, inizia dallo 0. Quindi il frame 1 in Flash è il frame 0 in Javascript, il frame 2 è il frame 1, eccetera. Per questo motivo, si può indicare il frame di destinazione tramite la numerazione in Flash, e sottrarrgli una unità al momento di usarlo tramite Javascript (in Javascript usiamo 4 per mandare il movieclip al frame 3)
Il percorso e il nome del movieclip può essere indicato sia con la sintassi del Flash4: filmato.TGotoFrame("/percorso/movieclip", 2) che del Flash5: filmato.TGotoFrame("_root.percorso.movieclip", 2) | ||||
Esempio
|
Quando il radiobutton attivo è quello con la scritta "MovieClip 1", il valore di selezionato è "clip1", quando è attivo l'altro, il valore di selezionato è "clip2". I dieci pulsanti chiamano una funzione definita nel primo frame della timeline principale, passando come parametro un numero che va da 1 a 10. Il seguente è lo script associato, ad esempio, al quinto pulsante:
| ||||
File
|
Nome
| TGotoLabel | ||||
Plugin
| 3, 4, 5, 6 | ||||
Sintassi
| filmato.TGotoLabel( movieclip, label ) | ||||
Descrizione
| Sposta la testina di riproduzione del clip filmato movieclip al frame a cui è associata l'etichetta label. Entrambi i parametri sono stringhe. Il percorso e il nome del movieclip può essere indicato sia con la sintassi del Flash4: filmato.TGotoLabel("/percorso/movieclip", "etichetta") che del Flash5: filmato.TGotoLabel("_root.percorso.movieclip", "etichetta") | ||||
Esempio
|
Nel primo filmato sono presenti due radiobutton che cambiano, a seconda della selezione, il valore della variabile selezionato definita nella _root. Quando il radiobutton attivo è quello con la scritta "MovieClip 1", il valore di selezionato è "clip1", quando è attivo l'altro, il valore di selezionato è "clip2". I dieci pulsanti chiamano una funzione definita nel primo frame della timeline principale, passando come parametro l'etichetta di un frame. Il seguente è lo script associato, ad esempio, al quinto pulsante:
Codice html dell'immagine (manda il movieclip "clip3" al frame con etichetta "cinque"):
| ||||
File
|
Nome
| TPlay | ||||
Plugin
| 3, 4, 5, 6 | ||||
Sintassi
| filmato.TPlay( movieclip ) | ||||
Descrizione
| Avvia la riproduzione del clip filmato movieclip. Il parametro movieclip è una stringa. Il percorso e il nome del movieclip può essere indicato sia con la sintassi del Flash4: filmato.TPlay("/percorso/movieclip") che del Flash5: filmato.TPlay("_root.percorso.movieclip") | ||||
Esempio
|
La funzione riceve come parametro una stringa contenente il percorso e il nome del movieclip da riprodurre (clip). Nel secondo filmato sono presenti tre movieclip, con nomi di istanza clip1, clip2 e clip3. Nel primo frame di ciascun movieclip c'è uno stop(), in modo da fermare la riproduzione per permettere di provare il metodo. Nel primo filmato, sono presenti due pulsanti, che avviano la riproduzione dei primi due movieclip. Lo script associato:
Il codice html dell'immagine (avvia la riproduzione del movieclip "clip3"):
Notazione importante: i pulsanti nel filmato indicano il percorso dei movieclip con la notazione del punto (Flash5), mentre l'immagine con la notazione della barra rovesciata (Flash4). I due sistemi funzionano allo stesso modo, e sono interscambiabili. | ||||
File
|
Nome
| TStopPlay | ||||
Plugin
| 3, 4, 5, 6 | ||||
Sintassi
| filmato.TStopPlay( movieclip ) | ||||
Descrizione
| Interrompe la riproduzione del clip filmato movieclip. Il parametro movieclip è una stringa. Il percorso e il nome del movieclip può essere indicato sia con la sintassi del Flash4: filmato.TStopPlay("/percorso/movieclip") che del Flash5: filmato.TStopPlay("_root.percorso.movieclip") | ||||
Esempio
|
Nel secondo filmato sono presenti tre movieclip, con nomi di istanza clip1, clip2 e clip3. All'interno di ciascun movieclip c'è un pulsante per riprenderne la riproduzione, in modo da permettere di provare il metodo. Nel primo filmato, sono presenti due pulsanti, che interrompono la riproduzione dei primi due movieclip. Lo script associato:
Notazione importante: i pulsanti nel filmato indicano il percorso dei movieclip con la notazione del punto (Flash5), mentre l'immagine con la notazione della barra rovesciata (Flash4). I due sistemi funzionano allo stesso modo, e sono interscambiabili. | ||||
File
|