MACROMEDIA FLASH MX, Reference

Page: 392 / 1104

392 Chapter 2:
LoadVars.onData
Availability
Flash Player 6.
Usage
my_lv .onData = function( src:String ) {
// your statements here
}
Parameters
src
A string or
undefined
; the raw (unparsed) data from a
LoadVars.load()
or
LoadVars.sendAndLoad()
method call.
Returns
Nothing.
Description
Event handler; invoked when data has completely downloaded from the server or when an error
occurs while data is downloading from a server. This handler is invoked before the data is parsed
and can be used to call a custom parsing routine instead of the one built in to Flash Player. The
value of the
src
parameter passed to the function assigned to
LoadVars.onData
can be either
undefined
or a string that contains the URL-encoded name-value pairs downloaded from the
server. If the
src
parameter is
undefined
, an error occurred while downloading the data from the
server.
The default implementation of
LoadVars.onData
invokes
LoadVars.onLoad
. You can override
this default implementation by assigning a custom function to
LoadVars.onData
, but
LoadVars.onLoad
is not called unless you call it in your implementation of
LoadVars.onData
.
Example
The following example loads a text file and displays content in a TextArea instance called
content_ta
when the operation completes. If an error occurs, then information displays in the
Output panel.
var my_lv:LoadVars = new LoadVars();
my_lv.onData = function(src:String) {
if (src == undefined) {
trace("Error loading content.");
return;
}
content_ta.text = src;
};
my_lv.load("content.txt", my_lv, "GET");