Registerclass (Object.registerclass Method) - MACROMEDIA FLASH 8-ACTIONSCRIPT 2.0 LANGUAGE Reference

registerClass (Object.registerClass method)

public static registerClass(name:String, theClass:Function) : Boolean
Associates a movie clip symbol with an ActionScript object class. If a symbol doesn't exist,
Flash creates an association between a string identifier and an object class.
When an instance of the specified movie clip symbol is placed on the Timeline, it is registered
to the class specified by the parameter rather than to the class MovieClip.
theClass
When an instance of the specified movie clip symbol is created by using
or , it is registered to the
MovieClip.attachMovie() MovieClip.duplicateMovieClip()
class specified by rather than to the MovieClip class. If is , this
theClass theClass null
method removes any ActionScript class definition associated with the specified movie clip
symbol or class identifier. For movie clip symbols, any existing instances of the movie clip
remain unchanged, but new instances of the symbol are associated with the default class
MovieClip.
If a symbol is already registered to a class, this method replaces it with the new registration.
When a movie clip instance is placed by the Timeline or created using or
attachMovie()
, ActionScript invokes the constructor for the appropriate class with
duplicateMovieClip()
the keyword pointing to the object. The constructor function is invoked with no
this
parameters.
If you use this method to register a movie clip with an ActionScript class other than
MovieClip, the movie clip symbol doesn't inherit the methods, properties, and events of the
built-in MovieClip class unless you include the MovieClip class in the prototype chain of the
new class. The following code creates a new ActionScript class called that inherits
theClass
the properties of the MovieClip class:
theClass.prototype = new MovieClip();
Availability: ActionScript 1.0; Flash Player 6 - If you are using ActionScript 2.0 classes, you
can use the ActionScript 2.0 Class field in the Linkage Properties or Symbol Properties dialog
box to associate an object with a class instead of using this method.
Parameters
- String; the linkage identifier of the movie clip symbol or the string identifier
name:String
for the ActionScript class.
- A reference to the constructor function of the ActionScript class or
theClass:Function
to unregister the symbol.
null
1000 ActionScript classes