Adobe Extending Flash Professional CS5 - Manual (Page 368)

346 EXTENDING FLASH PROFESSIONAL
outputPanel object
Last updated 5/2/2011
outputPanel.save()
Availability
Flash MX 2004; bUseSystemEncoding parameter added in Flash 8.
Usage
outputPanel.save(fileURI [, bAppendToFile [ , bUseSystemEncoding]])
Parameters
fileURI A string, expressed as a file:/// URI, that specifies the local file to contain the contents of the Output panel.
bAppendToFile An optional Boolean value. If true , it appends the Output panel’s contents to the output file, and if
false , the method overwrites the output file if it already exists. The default value is false .
bUseSystemEncoding An optional Boolean value. If true , it saves the Output panel text using the system encoding; if
false , it saves the Output panel text using UTF-8 encoding, with Byte Order Mark characters at the beginning of the
text. The default value is false .
Returns
Nothing.
Description
Method; saves the contents of the Output panel to a local text file, either by overwriting the file or by appending to the
file.
If fileURI is invalid or unspecified, an error is reported.
This method is useful for batch processing. For example, you can create a JSFL file that compiles several components.
Any compile errors appear in the Output panel, and you can use this method to save the resulting errors to a text file,
which can be automatically parsed by the build system in use.
Example
The following example saves the Output panel’s contents to the batch.log file in the /tests folder, overwriting the
batch.log file if it already exists:
fl.outputPanel.save("file:///c|/tests/batch.log");
outputPanel.trace()
Availability
Flash MX 2004.
Usage
outputPanel.trace(message)
Parameters
message A string that contains the text to add to the Output panel.