TechNote

LoadVars クラスを使用して外部テキストファイルを読み込む

LoadVars クラスを使用すると、データのロードが成功したかどうかを確認することや、ダウンロードの進行状況を監視することができます。この文書では、LoadVars クラスを使用した外部テキストファイルの基本的な読み込み方法を案内します。

テキストファイルの準備

以下の手順にて、Flash 上に読み込む外部テキストファイルを準備します。

テキスト編集ソフト(メモ帳、テキストエディット)を起動します。
外部に設定するテキストファイルの内容は、変数名=値の形式で設定します。例えば、変数名が「textContent」で値が「MAcromedia Flash MX 2004」の場合、以下のようになります。

textContent=Macromedia Flash MX 2004
テキストファイルを再生する SWF ファイルと同階層に「myExternalText.txt」という名前で保存します。

Flash 側で外部テキストの読み込みを設定する

Flash の ActionScript で外部テキストファイルのデータを読み込みます。

ステージ上にテキストフィールドを配置して、「my_txt」というインスタンス名を付けます。
以下の ActionScript をフレーム 1 のフレームアクションに記述します。

System.useCodepage = true; //日本語を含む文字を表示させる場合には、「true」の設定にする
var my_lv:LoadVars = new LoadVars();
my_lv.onLoad = function(success:Boolean) {
if (success) {
my_txt.text = my_lv.textContent;
} else {
trace("Error loading/parsing LoadVars.");
}
};
my_lv.load("myExternalText.txt");
読み込むテキストファイルと同階層にファイルを保存して、SWF ファイルをパブリッシュします。

メモ: 上記の方法で外部テキストのデータを Flash 側に受け渡して、表示させることが可能となりますが、日本語のテキストを表示させる場合には、System.useCodepage = true; の設定をして、Flash Player を実行するオペレーティングシステムの通常のコードページを使用して外部テキストファイルを解釈する設定にします。詳細については、文書番号　228624　Macromedia Flash Player 6 以降でのエンコーディングについてを参照してください。