User Guide

ManualsBrandsMacromedia ManualsOtherFLASH MX 2004-ACTIONSCRIPT LANGUAGE REFERENCE

1041

XML.onLoad 1045

XML.onLoad

Availability

Flash Player 5.

Usage

my_xml.onLoad = function (success:Boolean) {

//your statements here

}

Parameters

success

A Boolean value that evaluates to true if the XML object is successfully loaded with a

XML.load() or XML.sendAndLoad() operation; otherwise, it is

false.

Returns

Nothing.

Description

Event handler; invoked by Flash Player when an XML document is received from the server. If the

XML document is received successfully, the

success parameter is true. If the document was not

received, or if an error occurred in receiving the response from the server, the

success parameter

false. The default, implementation of this method is not active. To override the default

implementation, you must assign a function that contains custom actions.

Example

The following example includes ActionScript for a simple e-commerce storefront application.

The

sendAndLoad() method transmits an XML element that contains the user’s name and

password, and uses an

XML.onLoad handler to process the reply from the server.

var login_str:String = "<login username=\""+username_txt.text+"\"

password=\""+password_txt.text+"\" />";

var my_xml:XML = new XML(login_str);

var myLoginReply_xml:XML = new XML();

myLoginReply_xml.ignoreWhite = true;

myLoginReply_xml.onLoad = function(success:Boolean){

if (success) {

if ((myLoginReply_xml.firstChild.nodeName == "packet") &&

(myLoginReply_xml.firstChild.attributes.success == "true")) {

gotoAndStop("loggedIn");

} else {

gotoAndStop("loginFailed");

}

} else {

gotoAndStop("connectionFailed");

}

};

my_xml.sendAndLoad("http://www.flash-mx.com/mm/login_xml.cfm",

myLoginReply_xml);