Flash Lite 2

Guide de référence du langage ActionScript Flash Lite 2.x > Classes ActionScript > Object > registerClass (méthode Object.registerClass)

registerClass (méthode Object.registerClass)

Associe un symbole de clip à une classe d'objet ActionScript. Si aucun symbole n'existe, Flash crée une association entre un identifiant de chaîne et une classe d'objet.

Lorsqu'une occurrence du symbole de clip spécifié est placée sur le scénario, elle est enregistrée dans la classe spécifiée par le paramètre theClass et non pas dans la classe MovieClip.

Lorsqu'une occurrence du symbole de clip spécifié est créé via MovieClip.attachMovie() ou MovieClip.duplicateMovieClip(), elle est enregistrée dans la classe spécifiée par theClass et non pas dans la classe MovieClip. Si la valeur de theClass est null, cette méthode supprime toutes les définitions de classe ActionScript associées au symbole de clip ou à l'identifiant de classe spécifié. Pour les symboles de clip, toutes les occurrences existantes du clip restent inchangées ; en revanche, les nouvelles occurrences du symbole sont associées à la classe MovieClip par défaut.

Si un symbole est déjà enregistré dans une classe, cette méthode la remplace par le nouvel enregistrement.

Lorsqu'une occurrence de clip est placée par le scénario ou créée via attachMovie() ou duplicateMovieClip(), ActionScript invoque le constructeur pour la classe appropriée en utilisant le mot-clé this pointant vers l'objet. La fonction constructeur est appelée sans paramètre.

Si vous utilisez cette méthode pour enregistrer un clip avec une classe ActionScript autre que MovieClip, le symbole du clip n'hérite pas des méthodes, propriétés et événements de la classe MovieClip intégrée sauf si vous incluez la classe MovieClip dans le chaînage de prototype de la nouvelle classe. Le code suivant crée une nouvelle classe ActionScript appelée theClass héritant des propriétés de la classe MovieClip :

theClass.prototype = new MovieClip();

Disponibilité : ActionScript 1.0 ; Flash Lite 2.0 - Si vous utilisez des classes ActionScript 2.0, vous pouvez utiliser le champ Classe d'ActionScript 2.0 dans la boîte de dialogue Propriétés de liaison ou Propriétés du symbole pour associer un objet à une classe au lieu d'utiliser cette méthode.

Paramètres

name:String - Chaîne ; identifiant de liaison du symbole de clip ou identifiant de chaîne de la classe ActionScript.

theClass:Function - Référence à la fonction constructeur de la classe ActionScript ou null pour annuler l'enregistrement du symbole.

Valeur renvoyée

Boolean - Une valeur booléenne : si l'enregistrement de la classe réussit, la valeur true est renvoyée ; la valeur false est renvoyée dans tous les autres cas.

Voir aussi

attachMovie (méthode MovieClip.attachMovie), duplicateMovieClip (méthode MovieClip.duplicateMovieClip)