User Guide

XML 1305
onLoad (XML.onLoad handler)
onLoad = function(success:Boolean) {}
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 is
false. The default, implementation of this method is not active. To override the
default implementation, you must assign a function that contains custom actions.
Availability: ActionScript 1.0; Flash Player 5
Parameters
success:Boolean - 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.
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);