サイトトップ

Director Flash 書籍 業務内容 プロフィール

Macromedia Flash非公式テクニカルノート

MovieClip.loadVariables

ID: FN0210002 Product: Flash

Platform: All
Version: 5.0 and above

シンタックス
my_mc.loadVariables(url [, 変数]);

[訳者註] 原文では引数に変数(variables)が必須のように記載されていますが、オプションです。

引数
url   変数の包含された外部ファイルをロードの対象として指定する絶対または相対URL。メソッドを呼出したSWFファイルがブラウザで再生されている場合、URLはそのSWFと同じサブドメインになければなりません(後述「説明」参照)。

[訳者註] 相対パスを使う場合、パスの起点はSWFファイルではなく、SWFファイルの埋込まれたHTMLファイルになります。

変数   省略可能な引数で、変数を送信するHTTPメソッドを指定します。この引数は、ストリングの"GET"または"POST"でなければなりません。送信する変数がなければ、この引数を省略します。GETメソッドは、変数をURLの最後に追加します。これは、変数の数が少ないときに使用します。POSTメソッドは、別途のHTTP ヘッダで変数を送信します。これは、長いストリングの変数に使用されます。

戻り値
なし。

説明
メソッド; 外部ファイルからデータを読込んで、値をmy_mcの変数に設定します。外部ファイルは、CGIスクリプトやASP(Active Server Page)、PHPスクリプトで生成されたテキストファイルでも構いません。また、変数はいくつでも指定できます。

このメソッドを使って、現行ムービーの変数を新たな値に更新することもできます。

このメソッドを使うには、URLのテキストは標準MIME形式のapplication/x-www-urlformencoded(CGIスクリプト形式)にする必要があります。

[訳者註] 複数の変数を定義するテキストファイルの例は、つぎのとおりです。

company=Macromedia&address=600+Townsend&city=San+Francisco&zip=94103

複数の変数を定義したテキストの記述で、アンパサンド(&)は複数の変数の区切り文字となります。また、値の中のプラス記号(+)は、半角スペースとして読込まれます(オンラインヘルプ[ActionScriptリファレンスガイド] > [外部データの操作] > [リモートソースへの変数の送信、およびリモートソースからの変数のロード] > [HTTPを使用したサーバーサイドスクリプトへの接続]を併せてご参照ください)。

SWFファイルがFlash Player 7より前のバージョンで再生されている場合、urlはメソッドを呼出したSWFファイルと同じ上位(super)ドメインに属している必要があります。 たとえば、www.someDomain.comのSWFファイルは、store.someDomain.comのデータソースから変数をロードできます。どちらのファイルも同じ上位ドメインsomeDomain.comに属しているからです。

SWFファイルがFlash Player 7以降で再生されている場合は、urlが完全に同一の上位ドメインに属している必要があります([Flash Playerのセキュリティ機能について]参照)。 たとえば、www.someDomain.comのSWFファイルは、www.someDomain.comのデータソースからしか変数をロードできません。異なるドメインから変数をロードする場合は、アクセスされるソースファイルをホスティングするサーバー上に「クロスドメイン・ポリシーファイル」を置いておく必要があります。詳しくは、[ドメイン間のデータロード許可について]を参照 してください。

[訳者註] 同階層の外部テキストファイル"data.txt"を、スクリプトが定義されたMovieClip(タイムライン)に読込む場合には、以下のステートメントを記述します。

this.loadVariables("data.txt");

Player
Flash Player 5以降。Flash Player 7では(訳者註: ドメイン間の)動作が変更されました。

関連項目
loadMovie  loadVariables  loadVariablesNum  MovieClip.unloadMovie

出典
Flash MX 2004 LiveDocs ActionScript DictionaryMovieClip.loadVariables()の項より邦訳。

_____

作成者: 野中文雄
更新日: 2004年6月11日 Flash MX 2004のドキュメントに合わせて記述を修正
作成日: 2002年10月22日


Copyright © 2001-2006 Fumio Nonaka.  All rights reserved.