import ステートメント

import className
import packageName.*

完全修飾名を指定しなくてもクラスにアクセスできるようにします。たとえば、スクリプト内でカスタムクラス macr.util.users.UserClass を使用する場合、このクラスを完全修飾名で参照するか、import で読み込む必要があります。import で読み込んでおくと、クラス名での参照が可能になります。

// before importing 
var myUser:macr.util.users.UserClass = new macr.util.users.UserClass(); 
// after importing 
import macr.util.users.UserClass; 
var myUser:UserClass = new UserClass();

アクセス対象のクラスファイルがパッケージ (working_directory /macr/utils/users) 内に複数存在する場合は、次の例に示すように、1 つのステートメントですべてのクラスファイルを読み込むことができます。

import macr.util.users.*;

import ステートメントは最初に指定しておく必要があります。そうすると、このステートメントで読み込まれたクラスは以降、完全修飾名を使わずにアクセスできます。

読み込んだクラスがスクリプト内で使用されなかった場合、そのクラスは SWF ファイルには出力されません。したがって、SWF ファイルのサイズを気にすることなく、大きなパッケージを読み込むことができます。クラスに関連付けられたバイトコードは、それが実際に使用された場合にのみ、SWF ファイルに含まれます。

import ステートメントは、それを呼び出している現在のスクリプト (フレームまたはオブジェクト) にのみ適用されます。たとえば、macr.util パッケージのすべてのクラスを Flash ドキュメントのフレーム 1 に読み込んだと仮定します。そのフレームでは、そのパッケージ内のクラスを簡単な名前で参照できます。

// On Frame 1 of a FLA: 
import macr.util.*; 
var myFoo:foo = new foo();

ただし、他のフレームのスクリプトでは、そのパッケージのクラスを完全修飾名 (var myFoo:foo = new macr.util.foo();) で参照するか、そのパッケージのクラスを読み込む import ステートメントを追加する必要があります。

パラメータ

className:String - 外部クラスファイルで定義したクラスの完全修飾名。