Autolist
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) ...
</>
<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>
A row may be linked to several URLs or can be used to call one or more
javascript procedures. The XML element used in this cases is "link". This should be
a child element for the row which it refers to.
E. g.:
<row No.="4" Product="Salt" Qty.="35" Unit="kg" Price="1.43">
<link url="http://www.carpathia.ro" target="_blank"/>
<link url="javascript:alert('You have clicked on: Product:Salt Qty:35 Unit:kg Price:1.43')"/>
<link url="javascript:alert('This can be a link to multiple URLs or a call to javascrip procedures.')"/>
</row>
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>
The color of the following items is configurable: background, text, selected text,
selection, grid lines.
E. g.:
<bkgColor red="10" green="10" blue="10"/>
<selectionColor red="120" green="120" blue="120"/>
<selectedTextColor red="200" green="200" blue="200"/>
<gridLinesColor red="150" green="200" blue="217"/>
<textColor red="150" green="200" blue="217"/>
A default target for the links is supported: <defaultTarget value="_self"/>
The presence of grid: <useGrid value="yes"/>
4. XML file example
<list>
<config>
<headerFont name="Arial" style="Bold" size="11"/>
<colSize col1="32" col2="72" col3="48" col4="50" col5="48"/>
<bkgColor red="10" green="10" blue="10"/>
<selectionColor red="120" green="120" blue="120"/>
<gridLinesColor red="150" green="200" blue="217"/>
<textColor red="150" green="200" blue="217"/>
<useGrid value="yes"/>
</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">
<link url="http://www.computers.com" target="_blank"/>
</row>
<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>
Back to Autolist
New on the Java Boutique:
New Review:
Time Management Made Easy with the Quartz Enterprise Job Scheduler
Why not just use the Java timer API? This open source scheduling
API boasts simplicity, ease-of-integration, a well-rounded feature
set, and it's free!
New Applet:
Reverse Complement
Reverse Complement is a simple applet that converts DNA or RNA
sequences into three useful formats.
Elsewhere on internet.com:
WebDeveloper Java
Lots of Java information on webdeveloper.com
WDVL Java
Thorough Java resource at the Web Developer's Virtual Library.
ScriptSearch Java
Hundreds of free Java code files to download.
jGuru: Your View of the Java Universe
Customizable portal with online training, FAQs, regular news updates, and tutorials.
| 
