onLoad (LoadVars.onLoad ハンドラ)

onLoad = function(success: Boolean) {}

LoadVars.load() 処理または LoadVars.sendAndLoad() 処理が完了したときに呼び出されます。処理が成功した場合は、その処理によってダウンロードされた変数が my_lv に格納されています。これらの変数は、このハンドラが呼び出されると使用できるようになります。

このハンドラはデフォルトでは定義されていません。

このイベントハンドラは XML.onLoad と似ています。

使用できるバージョン : ActionScript 1.0、Flash Lite 2.0

パラメータ

success: Boolean - ブール値。ロード処理が正常に完了した場合は true、正常に完了しなかった場合は false に設定されます。

次の例では、TextInput インスタンス name_ti、TextArea インスタンス result_ta、Button インスタンス submit_button をステージに追加します。ユーザーがこの例の Login ボタンインスタンスをクリックすると、send_lv および result_lv の 2 つの LoadVars オブジェクトが作成されます。send_lv オブジェクトは、name_ti インスタンスから名前をコピーし、そのデータを greeting.cfm に送信します。このスクリプトの実行結果を result_lv オブジェクトにロードし、サーバーの応答を TextArea インスタンス (result_ta) に表示します。タイムラインのフレーム 1 に次の ActionScript を追加します。

var submitListener: Object = new Object();
submitListener.click = function(evt: Object) {
    var result_lv: LoadVars = new LoadVars();
    result_lv.onLoad = function(success: Boolean) {
        if (success) {
            result_ta.text = result_lv.welcomeMessage;
        } else {
            result_ta.text = "Error connecting to server.";
        }
    };
    var send_lv: LoadVars = new LoadVars();
    send_lv.name = name_ti.text;
    send_lv.sendAndLoad("http: //www.flash-mx.com/mm/greeting.cfm", result_lv, "POST");
};
submit_button.addEventListener("click", submitListener);

より堅牢な例については、ActionScript のサンプルフォルダにある "login.fla" ファイルを参照してください。通常、"ActionScript" サンプルのフォルダへのパスは次のようになります。

関連項目

onLoad (XML.onLoad ハンドラ), loaded (LoadVars.loaded プロパティ), load (LoadVars.load メソッド), sendAndLoad (LoadVars.sendAndLoad メソッド)