Contrôler une occurrence et naviguer sur la scène
CHAPITRE 4
107
Connaître le nombre d’occurrences dans un conteneur d’objets
d’affichage
Nous allons très rapidement avoir besoin de connaître le nombre d’occurrences contenues
sur la scène ou dans un conteneur d’objets d’affichage ; vous allez donc devoir faire appel
à la propriété numChildren. Son utilisation est très simple car il suffit de saisir uniquement
ce terme avec le nom du conteneur en préfixe (aucun préfixe n’est nécessaire pour
connaître le nombre d’occurrences contenues sur la scène). Effectuez une mise en pages à
base d’occurrences, de formes et de textes puis saisissez la ligne d’instruction ci-dessous.
trace(numChildren);
Dans la fenêtre Sortie, vous découvrirez un nombre qui correspond au nombre d’occurrences contenues sur la scène.
Lorsque vous utiliserez la valeur renvoyée par cette propriété pour régler le niveau d’une
occurrence, gardez toujours à l’esprit que le numéro d’index de la première occurrence
sur la scène ou dans un conteneur d’objets d’affichage porte le numéro 0. De ce fait,
l’occurrence qui se trouve au premier plan portera, par exemple, le numéro d’index 6 s’il
y a sept occurrences.
Pour placer une occurrence au premier plan sur la scène, il faut donc utiliser la ligne
d’instruction suivante :
setChildIndex(nomOccurrence,numChildren-1);
La méthode setChildIndex()
Revenons sur le fonctionnement de la méthode setChildIndex(), qui est extrêmement
simple (il suffit de préciser le nom de l’objet d’affichage que vous souhaitez placer sur la
scène, comme une occurrence de type Clip, ainsi que son niveau, défini par un indice).
setChildIndex(nomOccurrence,3);
Pour information, lorsque vous placez un symbole sur la scène, que ce soit manuellement
par un glisser-déposer ou dynamiquement à l’aide de lignes d’instructions en ActionScript, la gestion des plans est automatique. La dernière occurrence placée sur la scène
vient toujours se placer au premier plan, au-dessus de toutes les autres.
À la lecture de l’unique ligne d’instruction ci-dessus, nous serions tentés de croire que
cette action est simple mais, dans certains cas, elle peut s’avérer plus complexe. Nous
aborderons ce problème dans le développement suivant, Cibler une occurrence cliquée.
Concentrons-nous d’abord sur un premier script qui permet de placer une carte à jouer au
premier plan. Trois occurrences intitulées bt1, bt2 et bt3 ont été placées sur la scène (sous
Remarque
Toutes les formes tracées à l’aide des outils de dessin qui n’ont pas été transformées en symbole ne sont
pas, par définition, des occurrences, mais elles sont tout de même comptabilisées.
CHAPITRE 4
107
Connaître le nombre d’occurrences dans un conteneur d’objets
d’affichage
Nous allons très rapidement avoir besoin de connaître le nombre d’occurrences contenues
sur la scène ou dans un conteneur d’objets d’affichage ; vous allez donc devoir faire appel
à la propriété numChildren. Son utilisation est très simple car il suffit de saisir uniquement
ce terme avec le nom du conteneur en préfixe (aucun préfixe n’est nécessaire pour
connaître le nombre d’occurrences contenues sur la scène). Effectuez une mise en pages à
base d’occurrences, de formes et de textes puis saisissez la ligne d’instruction ci-dessous.
trace(numChildren);
Dans la fenêtre Sortie, vous découvrirez un nombre qui correspond au nombre d’occurrences contenues sur la scène.
Lorsque vous utiliserez la valeur renvoyée par cette propriété pour régler le niveau d’une
occurrence, gardez toujours à l’esprit que le numéro d’index de la première occurrence
sur la scène ou dans un conteneur d’objets d’affichage porte le numéro 0. De ce fait,
l’occurrence qui se trouve au premier plan portera, par exemple, le numéro d’index 6 s’il
y a sept occurrences.
Pour placer une occurrence au premier plan sur la scène, il faut donc utiliser la ligne
d’instruction suivante :
setChildIndex(nomOccurrence,numChildren-1);
La méthode setChildIndex()
Revenons sur le fonctionnement de la méthode setChildIndex(), qui est extrêmement
simple (il suffit de préciser le nom de l’objet d’affichage que vous souhaitez placer sur la
scène, comme une occurrence de type Clip, ainsi que son niveau, défini par un indice).
setChildIndex(nomOccurrence,3);
Pour information, lorsque vous placez un symbole sur la scène, que ce soit manuellement
par un glisser-déposer ou dynamiquement à l’aide de lignes d’instructions en ActionScript, la gestion des plans est automatique. La dernière occurrence placée sur la scène
vient toujours se placer au premier plan, au-dessus de toutes les autres.
À la lecture de l’unique ligne d’instruction ci-dessus, nous serions tentés de croire que
cette action est simple mais, dans certains cas, elle peut s’avérer plus complexe. Nous
aborderons ce problème dans le développement suivant, Cibler une occurrence cliquée.
Concentrons-nous d’abord sur un premier script qui permet de placer une carte à jouer au
premier plan. Trois occurrences intitulées bt1, bt2 et bt3 ont été placées sur la scène (sous
Remarque
Toutes les formes tracées à l’aide des outils de dessin qui n’ont pas été transformées en symbole ne sont
pas, par définition, des occurrences, mais elles sont tout de même comptabilisées.