(this is the content of LoadText_readme.txt)


:::::: LoadText Component v1.1 ::::::
:::::::::::: Raz-L 2002 :::::::::::::

http://www.raz-l.com


VERSION HISTORY

v1.1 added properties and tracing option
v1.0 first launch



DESCRIPTION

The loadtext component use an undocumented feature that enables it to load raw data from external sources like TXT, PHP, CFM, ...
as it is RAW data, you don't need to add a variable name in front of your text (&dummyvar=text...)
Simply write normal text in a txt file, or simply print text with server-side languages like PHP
Plus, loadtext is easy to set up by a simple drag and drop
Version 1.1 added support for dynamically attaching the component (directly by AS)



HOW TO USE ?

Simply create your dynamic textfield (don't forget the 'multiline' option).
Give an instance name to the textfield (if you don't, flash will generate one when you attach the component).
Now, simply drag loadtext from the component list and drop it on the textfield, it will stick in the corner.
Click the loadtext gray rectangle, you'll see the component parameters in the specific panel and in the properties panel.
Edit the 'text source' parameter and type the location+name of the textfile you want to load
That's all !
The exported .swf will load the text and will put the raw content in the textfield



PARAMETERS

- 'text source'		: put the location and name of the file you want to load (examples: /texts/text1.txt  or  http://www.yourserver.com/subdirectory/text.php)

- 'target texfield'	: name of the textField, flash will put the name of the textfield on which you dropped the component

- 'waiting text'	: the line that will appear in the field when flash is loading the data, this option can be left blank if you don't want any loading text

- 'enable accents'	: 'true' by default, this one tells flash to use System.codepage, usefull when your text may contain accents (in some european languages, ...)

- 'enable html ?'	: 'true' by default, converts the basic HTML tags that flash supports (<br>, <b>...</b>, ...)

- 'enable tracing ?'	: 'true' by default, traces the component actions in the output window (errormessages,...)



PROPERTIES (when attached by AS or when accessing a dropped one by the instance name you gave)

_text (string)		url + text filename
_targetField (string)	target dynamic textfield
_waitingText (string)	the text displayed while the text loads (can be left blank)
_html (bool)		enable/disable html formatting
_accents (bool)		enable/disable the use of accents (attention this option is set for the whole movie)
_tracing (bool)		enable/disable tracing in output window



EXAMPLE 1:
	drag and drop on a dynamic textfield then fill the parameters :)

EXAMPLE 2:
	_root.attachMovie("LoadText","myLoadedText",69);
	myLoadedText._waitingText="..LOADING..";
	myLoadedText._html=false;
	myLoadedText.loadText("atextfile.txt","textfieldInstanceName");

EXAMPLE 3:
	_root.attachMovie("LoadText","myLoadedText",69);
	myLoadedText._targetField="textfieldInstanceName";
	myLoadedText.loadText("http://localhost/text/text.php");

EXAMPLE 4:
	_root.attachMovie("LoadText","myLoadedText",69);
	myLoadedText._targetField="textfieldInstanceName";
	myLoadedText._text="atextfile.txt";
	myLoadedText.loadText();

EXAMPLE 5:
	// you can get the parameters names from "variables names" in the "component definition"
	params={_targetInstanceName:"textfieldz", textfile:"autretexte.txt", waitingtext:"loading...", enablehtml:true, enabletracing:true, usecodepage:true};
	_root.attachMovie("LoadText","myLoadedText",69,params);





viva FLASH MX !

Benoit 'Raz-L' Jadinon
raz-l@raz-l.com
