registerClass (Object.registerClass メソッド)

public static registerClass(name: String, theClass: Function) : Boolean

ムービークリップシンボルと ActionScript オブジェクトクラスを関連付けます。シンボルが存在しない場合は、ストリング識別子とオブジェクトクラスが関連付けられます。

指定されたムービークリップシンボルのインスタンスがタイムラインで挿入された場合、そのシンボルは MovieClip クラスではなく、theClass パラメータで指定されたクラスに登録されます。

指定したムービークリップシンボルのインスタンスが MovieClip.attachMovie() または MovieClip.duplicateMovieClip() によって作成された場合は、MovieClip クラスではなく、theClass で指定したクラスに登録されます。theClass が null である場合、このメソッドは指定されたムービークリップシンボルまたはクラス識別子に関連する ActionScript classes 定義を削除します。ムービークリップシンボルの場合、ムービークリップの既存のインスタンスは変更されませんが、シンボルの新しいインスタンスはデフォルトクラス MovieClip に関連付けられます。

シンボルが既にクラスに登録されている場合は、それを新しい登録に置き換えます。

ムービークリップインスタンスがタイムラインで挿入されたか、attachMovie() または duplicateMovieClip() で作成された場合、ActionScript はそのオブジェクトを指すキーワード this を使用して対応するクラスのコンストラクタを呼び出します。コンストラクタ関数の呼び出しにはパラメータを使用しません。

このメソッドを使って、MovieClip 以外の ActionScript classes にムービークリップを登録すると、新しいクラスのプロトタイプチェーンに MovieClip クラスを含めない限り、ムービークリップシンボルは、ビルトイン MovieClip クラスのメソッド、プロパティ、およびイベントを継承しません。次のコードでは、MovieClip クラスのプロパティを継承する theClass という新しい ActionScript classes を作成します。

theClass.prototype = new MovieClip();

使用できるバージョン : ActionScript 1.0、Flash Lite 2.0 - ActionScript 2.0 クラスを使用している場合は、[リンケージプロパティ] ダイアログボックスまたは [シンボルプロパティ] ダイアログボックスの [ActionScript 2.0 クラス] フィールドを使用して、このメソッドを使用する代わりにオブジェクトをクラスに関連付けることができます。

パラメータ

name: String - ムービークリップシンボルのリンケージ識別子、または ActionScript classes のストリング識別子。

theClass: Function - ActionScript classes のコンストラクタ関数への参照、またはシンボルを登録解除する null。

戻り値

Boolean - ブール値 : クラスが正常に登録されると、true が返されます。それ以外は、false が返されます。

関連項目

attachMovie (MovieClip.attachMovie メソッド), duplicateMovieClip (MovieClip.duplicateMovieClip メソッド)