How To - Auto List 1.2
------------------------------------------------------------------------------------


1. List description file
2. The header
3. List body
4. XML file example



1. List description file
------------------------
	The applet it is configured using the XML list description file. The name of 
the .xml file is set up by the value of the "listDescriptionFile" applet parameter. 
The XML document should contain the root element, <list> with a <listData> child 
element, which also must contain at least one <row> element.

	The <list> element may contain an optional <config> element. The configuration 
elements may be gruped under this optional element or under the root element.

E. g.:	<list>
		... configuration elements (optional) ...
		
		<config>
			... configuration elements (optional) ...
		</config>
		
		<listData>
			<row .../>
			...
		</listData>
	</list>



2. The header
-------------
	The number of columns and the names of the columns printed on the header are 
determined by the first <row> element from the <listData> section. The names of the 
columns correspond to the names of the XML attributes of the first row. The default 
size of each column is the double of its name length.

	The default font for the column names is "Arial 11". It may be changed by 
using the <headerFont> configuration element. This element has three attributes: 
name - the name of the font, style - font style (italic, bold, plain) and size - the 
size of the font.

E. g.:	<list>
		<config>
			<headerFont name="Times New Roman" style="Bold" size="12"/>
		</config>
		
		<listData>
			<row .../>
			...
		</listData>
	</list>
	
	The size of the columns may be changed using the configuration element 
<colSize>. This element has attributes named "colX", where X is the index (starting 
with 1) of the column for each the size is specified. The size of a column having 
the index N can be specified only if all column sizes for indices less than N are 
specified too.	

E. g.: <colSize col1="28" col2="45"/>


The height of the header is predefined and can not be changed.



3. List body
------------
	The body of the list contains the rows from the <listData> section. The 
height of the rows depend on the  size of the used font.

	For the font customization the following element is used <listFont>. This 
element is similar with the <headerFont> element.

E. g.:	<list>
		<config>
			<listFont name="Times New Roman" style="Bold" size="32"/>
		</config>
		
		<listData>
			<row .../>
			...
		</listData>
	</list>
		
	The background color of the list it is controled by the <bkgColor> element.
The default color is white. The <bkgColor> element has the attributes: red, green 
and blue, each of them requiring values form 0 to 255.

E. g.:	<list>
		<config>
			<bkgColor red="255" green="10" blue="10"/>
		</config>
		
		<listData>
			<row .../>
			...
		</listData>
	</list>
	
	
	
	
4. XML file example
-------------------
<list>
	<config>
		<headerFont name="Arial" style="Bold" size="11"/>
		<colSize col1="32" col2="72" col3="48" col4="50" col5="48"/>
	</config>
	<listData>
		<row No.="1" Product="Wood" Qty.="1000" Unit="sq. meter" Price="28"/>
		<row No.="2" Product="Oil" Qty.="2300" Unit="barrel" Price="45"/>
		<row No.="3" Product="Computers" Qty.="100" Unit="-" Price="1200"/>
		<row No.="4" Product="Salt" Qty.="35" Unit="kg" Price="1.43"/>
		<row No.="5" Product="Paper" Qty.="4300" Unit="kg" Price="1.60"/>
		<row No.="6" Product="Chairs" Qty.="87" Unit="-" Price="59"/>
		<row No.="7" Product="Books" Qty.="23566" Unit="-" Price="35"/>
		<row No.="6" Product="Cars" Qty.="200" Unit="-" Price="30000"/>
	</listData>
</list>