setInterval
 
Disponibilité
 
Flash Player 6.
 
Usage
 
setInterval( fonction, intervalle[, param1, param2, ..., paramn] )
 
setInterval( objet, nomDeMéthode, intervalle[, param1, param2, ..., paramn] )
 
Paramètres
 
fonction Un nom de fonction ou une référence à une fonction anonyme.
 
objet Un objet dérivé de l'objet Object.
 
nomDeMéthode Le nom de la méthode à appeler pour le paramètre objet.
 
intervalle Le temps en millisecondes entre appels au paramètre fonction ou nomDeMéthode.
 
param1, param2, ..., paramn Paramètres facultatifs transmis au paramètre fonction ou nomDeMéthode.
 
Renvoie
 
Un identifiant d'intervalle que vous pouvez transmettre à clearInterval pour annuler l'intervalle.
 
Description
 
Action ; appelle une fonction, une méthode ou un objet à intervalles périodiques pendant la lecture d'une animation. Vous pouvez utiliser une fonction d'intervalle pour mettre à jour des variables d'une base de données ou mettre à jour un temps affiché.
 
Si intervalle est inférieur à la cadence de l'animation (par exemple, 10 images par seconde est égal à 100 millisecondes), la fonction d'intervalle est appelée aussi près que possible de intervalle. Vous devez utiliser la fonction updateAfterEvent pour assurer un rafraîchissement de l'écran avec une fréquence appropriée. Si intervalle est supérieur à la cadence de l'animation, la fonction d'intervalle est seulement appelée à chaque fois que la tête de lecture entre dans une image, afin de minimiser l'impact de chaque rafraîchissement de l'écran.
 
Le premier exemple de syntaxe ci-dessus est la syntaxe par défaut pour la fonction setInterval dans le panneau Actions en mode Normal. Pour utiliser le deuxième exemple de syntaxe, vous devez utiliser le panneau Action en mode Expert.
 
Exemple
 
Usage 1. L'exemple suivant appelle une fonction anonyme toutes les 1000 millisecondes (toutes les secondes).
 
setInterval( function(){ trace("intervalle appelé" ); }, 1000 );
 
Usage 2. L'exemple suivant définit deux fonctions de rappel et appelle chacune d'elles. Les deux appels à la fonction setInterval envoient la chaîne "intervalle appelé" à la fenêtre Sortie toutes les 1000 millisecondes. Le premier appel à setInterval appelle la fonction callback1, qui contient une action trace. Le deuxième appel à setInterval transmet la chaîne "intervalle appelé" à la fonction callback2 en tant que paramètre.
 
function callback1() { trace("intervalle appelé" ); }function callback2(param) {  trace(param);}setInterval( callback1, 1000 ); setInterval( callback2, 1000, "intervalle appelé" );
 
Usage 3. Cet exemple utilise une méthode d'un objet. Vous devez utiliser cette syntaxe lorsque vous voulez appeler une méthode qui est définie pour un objet. Vous pouvez seulement utiliser cette syntaxe en mode Expert.
 
obj = new Object();obj.interval = function() {  trace("fonction d'intervalle appelée" ); }setInterval( obj, "interval", 1000 ); obj2 = new Object();obj2.interval = function(s) {  trace(s); }setInterval( obj2, "interval", 1000, "fonction d'intervalle appelée" );  
 
Vous devez utiliser la deuxième forme de la syntaxe setInterval pour appeler une méthode d'un objet, comme suit :
 
setInterval( obj2, "interval", 1000, "fonction d'intervalle appelée" );  
 
Voir aussi
 
clearInterval, updateAfterEvent