You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
koffice/doc/kugar/template-elements.docbook

2494 lines
55 KiB

<!-- If you want to edit or validate this document separately, uncomment -->
<!-- this prolog
<?xml version="1.0" ?>
<!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd">
-->
<sect1 id="template-elements">
<sect1info>
<authorgroup>
<author>
<firstname>Alexander</firstname>
<surname>Dymo</surname>
<affiliation>
<address><email>cloudtemple@mksat.net</email></address>
</affiliation>
</author>
<author>
<firstname>Phil</firstname>
<surname>Thompson</surname>
<affiliation>
<address><email>phil@river-bank.demon.co.uk</email></address>
</affiliation>
</author>
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>
</sect1info>
<title><sgmltag class="element">KugarTemplate</sgmltag> template
elements</title>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Section bands</entry>
<entry>Section elements</entry>
</row>
</thead>
<tbody>
<row>
<entry><link linkend="report-header-and-footer"><sgmltag class="element">ReportHeader</sgmltag></link></entry>
<entry><link linkend="line-element"><sgmltag class="element">Line</sgmltag></link></entry>
</row>
<row>
<entry><link linkend="page-header-and-footer"><sgmltag class="element">PageHeader</sgmltag></link></entry>
<entry><link linkend="label-element"><sgmltag class="element">Label</sgmltag></link></entry>
</row>
<row>
<entry><link linkend="detail-header-and-footer"><sgmltag class="element">DetailHeader</sgmltag></link></entry>
<entry><link linkend="field-element"><sgmltag class="element">Field</sgmltag></link></entry>
</row>
<row>
<entry><link linkend="detail"><sgmltag class="element">Detail</sgmltag></link></entry>
<entry><link linkend="calculated-field-element"><sgmltag class="element">CalculatedField</sgmltag></link></entry>
</row>
<row>
<entry><link linkend="detail-header-and-footer"><sgmltag class="element">DetailFooter</sgmltag></link></entry>
<entry><link linkend="special-element"><sgmltag class="element">Special</sgmltag></link></entry>
</row>
<row>
<entry><link linkend="page-header-and-footer"><sgmltag class="element">PageFooter</sgmltag></link></entry>
<entry>Page Footer</entry>
</row>
<row>
<entry><link linkend="report-header-and-footer"><sgmltag class="element">ReportFooter</sgmltag></link></entry>
<entry>Report Footer</entry>
</row>
</tbody>
</tgroup>
</informaltable>
<sect2 id="report-header-and-footer">
<title><sgmltag class="element">ReportHeader</sgmltag> and <sgmltag
class="element">ReportFooter</sgmltag> sections</title>
<para>
The <sgmltag class="element">ReportHeader</sgmltag> and <sgmltag
class="element">ReportFooter</sgmltag> elements define report sections
that are usually printed at the beginning and end of the report.
</para>
<synopsis>
&lt;!ELEMENT ReportHeader (<link linkend="line-element">Line</link>*, <link linkend="label-element">Label</link>*, <link linkend="special-element">Special</link>*)&gt;
&lt;!ATTLIST ReportHeader
Height CDATA #REQUIRED
PrintFrequency CDATA #REQUIRED&gt;
</synopsis>
<synopsis>
&lt;!ELEMENT ReportFooter (<link linkend="line-element">Line</link>*, <link linkend="label-element">Label</link>*, <link linkend="special-element">Special</link>*, <link linkend="calculated-field-element">CalculatedField</link>*)&gt;
&lt;!ATTLIST ReportFooter
Height CDATA #REQUIRED
PrintFrequency CDATA #REQUIRED&gt;
</synopsis>
<variablelist>
<varlistentry>
<term>Attributes</term>
<listitem>
<variablelist>
<varlistentry>
<term><anchor id="rhf-height"/><sgmltag class="attribute">Height</sgmltag></term>
<listitem>
<para>Sets the height of the report section. If you don't want
this section, set this value to <sgmltag class="attvalue">0</sgmltag>.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="rhf-printfrequency"/><sgmltag class="attribute">PrintFrequency</sgmltag></term>
<listitem>
<para>
Set the print frequency of the section.
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Value</entry>
<entry>Print Frequency</entry>
</row>
</thead>
<tbody>
<row>
<entry><sgmltag class="attvalue">0</sgmltag></entry>
<entry>First Page</entry>
</row>
<row>
<entry><sgmltag class="attvalue">1</sgmltag></entry>
<entry>Every Page</entry>
</row>
<row>
<entry><sgmltag class="attvalue">2</sgmltag></entry>
<entry>Last Page</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>
</variablelist>
</sect2>
<sect2 id="page-header-and-footer">
<title><sgmltag class="element">PageHeader</sgmltag> and <sgmltag
class="element">PageFooter</sgmltag> sections</title>
<para>
The <sgmltag class="element">PageHeader</sgmltag> and <sgmltag
class="element">PageFooter</sgmltag> elements define report sections
that are usually printed on every page of the report.
</para>
<synopsis>
&lt;!ELEMENT PageHeader (<link linkend="line-element">Line</link>*, <link linkend="label-element">Label</link>*, <link linkend="special-element">Special</link>*)&gt;
&lt;!ATTLIST PageHeader
Height CDATA #REQUIRED
PrintFrequency CDATA #REQUIRED&gt;
</synopsis>
<synopsis>
&lt;!ELEMENT PageFooter (<link linkend="line-element">Line</link>*, <link linkend="label-element">Label</link>*, <link linkend="special-element">Special</link>*)&gt;
&lt;!ATTLIST PageFooter
Height CDATA #REQUIRED
PrintFrequency CDATA #REQUIRED&gt;
</synopsis>
<variablelist>
<varlistentry>
<term>Attributes</term>
<listitem>
<variablelist>
<varlistentry>
<term><anchor id="phf-height"/><sgmltag class="attribute">Height</sgmltag></term>
<listitem>
<para>Sets the height of the report section. If you don't want
this section, set this value to <sgmltag class="attvalue">0</sgmltag>.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="phf-printfrequency"/><sgmltag class="attribute">PrintFrequency</sgmltag></term>
<listitem>
<para>
Set the print frequency of the section.
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Value</entry>
<entry>Print Frequency</entry>
</row>
</thead>
<tbody>
<row>
<entry><sgmltag class="attvalue">0</sgmltag></entry>
<entry>First Page</entry>
</row>
<row>
<entry><sgmltag class="attvalue">1</sgmltag></entry>
<entry>Every Page</entry>
</row>
<row>
<entry><sgmltag class="attvalue">2</sgmltag></entry>
<entry>Last Page</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>
</variablelist>
</sect2>
<sect2 id="detail-header-and-footer">
<title><sgmltag class="element">DetailHeader</sgmltag> and <sgmltag
class="element">DetailFooter</sgmltag> sections</title>
<para>
The <sgmltag class="element">DetailHeader</sgmltag> and <sgmltag
class="element">DetailFooter</sgmltag> elements define report sections
that are printed before and after details of a given level and below on the report.
</para>
<synopsis>
&lt;!ELEMENT DetailHeader (<link linkend="line-element">Line</link>*, <link linkend="label-element">Label</link>*, <link linkend="special-element">Special</link>*)&gt;
&lt;!ATTLIST DetailHeader
Height CDATA #REQUIRED
Level CDATA #REQUIRED&gt;
</synopsis>
<synopsis>
&lt;!ELEMENT DetailFooter (<link linkend="line-element">Line</link>*, <link linkend="label-element">Label</link>*, <link linkend="special-element">Special</link>*)&gt;
&lt;!ATTLIST DetailFooter
Height CDATA #REQUIRED
Level CDATA #REQUIRED&gt;
</synopsis>
<variablelist>
<varlistentry>
<term>Attributes</term>
<listitem>
<variablelist>
<varlistentry>
<term><anchor id="dhf-height"/><sgmltag class="attribute">Height</sgmltag></term>
<listitem>
<para>Sets the height of the report section. If you don't want
this section, set this value to <sgmltag class="attvalue">0</sgmltag>.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="dhf-level"/><sgmltag class="attribute">Level</sgmltag></term>
<listitem>
<para>
Set the hierarchy level of the section. Sections with higher levels will be printed
before sections with lower ones. Level can be any number beginning from 0.
</para>
</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>
</variablelist>
</sect2>
<sect2 id="detail">
<title><sgmltag class="element">Detail</sgmltag> section</title>
<para>
The <sgmltag class="element">Detail</sgmltag> element defines the report
section that contains the report data. The report can have multiple details,
which are accessed by the detail's Level attribute.
</para>
<synopsis>
&lt;!ELEMENT Detail (<link linkend="line-element">Line</link>*, <link linkend="label-element">Label</link>*, <link linkend="special-element">Special</link>*, <link linkend="field-element">Field</link>*)&gt;
&lt;!ATTLIST Detail
Height CDATA #REQUIRED
Level CDATA #REQUIRED&gt;
</synopsis>
<variablelist>
<varlistentry>
<term>Attributes</term>
<listitem>
<variablelist>
<varlistentry>
<term><anchor id="d-height"/><sgmltag class="attribute">Height</sgmltag></term>
<listitem>
<para>Sets the height of the report section. If you don't want
this section, set this value to <sgmltag class="attvalue">0</sgmltag>.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="d-level"/><sgmltag class="attribute">Level</sgmltag></term>
<listitem>
<para>
Set the hierarchy level of the section. Sections with higher levels will be printed
before sections with lower ones. Level can be any number beginning from 0. This is an attribute
of a <sgmltag class="attribute">row</sgmltag> element in a data file.
</para>
</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>
</variablelist>
</sect2>
<sect2 id="line-element">
<title><sgmltag class="element">Line</sgmltag></title>
<para>
The <sgmltag class="element">Line</sgmltag> element defines a report
object used to draw lines on a report.
</para>
<synopsis>
&lt;!ELEMENT Line EMPTY&gt;
&lt;!ATTLIST Line
X1 CDATA #REQUIRED
Y1 CDATA #REQUIRED
X2 CDATA #REQUIRED
Y2 CDATA #REQUIRED
Width CDATA #REQUIRED
Color CDATA #REQUIRED
Style CDATA #REQUIRED&gt;
</synopsis>
<variablelist>
<varlistentry>
<term>Attributes</term>
<listitem>
<variablelist>
<varlistentry>
<term><anchor id="l-x1"/><sgmltag class="attribute">X1</sgmltag></term>
<listitem>
<para>
Sets the starting x coordinate (relative to the section's upper left corner) for the line.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="l-y1"/><sgmltag class="attribute">Y1</sgmltag></term>
<listitem>
<para>
Sets the starting y coordinate (relative to the section's upper left corner) for the line.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="l-x2"/><sgmltag class="attribute">X2</sgmltag></term>
<listitem>
<para>
Sets the ending x coordinate (relative to the section's upper left corner) for the line.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="l-y2"/><sgmltag class="attribute">Y2</sgmltag></term>
<listitem>
<para>
Sets the ending y coordinate (relative to the section's upper left corner) for the line.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="l-width"/><sgmltag class="attribute">Width</sgmltag></term>
<listitem>
<para>
Sets the width of the line.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="l-color"/><sgmltag class="attribute">Color</sgmltag></term>
<listitem>
<para>
Sets the color of the line. The color is defined as an RGB (Red Green Blue) value
(r,g,b). r, g and b must be in the range 0..255.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="l-style"/><sgmltag class="attribute">Style</sgmltag></term>
<listitem>
<para>
Sets the drawing style for the line.
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Value</entry>
<entry>Line Style</entry>
</row>
</thead>
<tbody>
<row>
<entry><sgmltag class="attvalue">0</sgmltag></entry>
<entry>No Pen</entry>
</row>
<row>
<entry><sgmltag class="attvalue">1</sgmltag></entry>
<entry>Solid</entry>
</row>
<row>
<entry><sgmltag class="attvalue">2</sgmltag></entry>
<entry>Dash</entry>
</row>
<row>
<entry><sgmltag class="attvalue">3</sgmltag></entry>
<entry>Dot</entry>
</row>
<row>
<entry><sgmltag class="attvalue">4</sgmltag></entry>
<entry>Dash Dot</entry>
</row>
<row>
<entry><sgmltag class="attvalue">5</sgmltag></entry>
<entry>Dash Dot Dot</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>
</variablelist>
</sect2>
<sect2 id="label-element">
<title><sgmltag class="element">Label</sgmltag></title>
<para>
The <sgmltag class="element">Label</sgmltag> element defines a report
object used to draw fixed text on a report.
</para>
<synopsis>
&lt;!ELEMENT Label EMPTY&gt;
&lt;!ATTLIST Label
Text CDATA #REQUIRED
X CDATA #REQUIRED
Y CDATA #REQUIRED
Width CDATA #REQUIRED
Height CDATA #REQUIRED
BackgroundColor CDATA #REQUIRED
ForegroundColor CDATA #REQUIRED
BorderColor CDATA #REQUIRED
BorderWidth CDATA #REQUIRED
BorderStyle CDATA #REQUIRED
FontFamily CDATA #REQUIRED
FontSize CDATA #REQUIRED
FontWeight CDATA #REQUIRED
FontItalic CDATA #REQUIRED
HAlignment CDATA #REQUIRED
VAlignment CDATA #REQUIRED
WordWrap CDATA #REQUIRED&gt;
</synopsis>
<variablelist>
<varlistentry>
<term>Attributes</term>
<listitem>
<variablelist>
<varlistentry>
<term><anchor id="la-text"/><sgmltag class="attribute">Text</sgmltag></term>
<listitem>
<para>
Sets the label's text.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="la-x"/><sgmltag class="attribute">X</sgmltag></term>
<listitem>
<para>
Sets the x coordinate (relative to the section's upper left corner) for positioning the label.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="la-y"/><sgmltag class="attribute">Y</sgmltag></term>
<listitem>
<para>
Sets the y coordinate (relative to the section's upper left corner) for positioning the label.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="la-width"/><sgmltag class="attribute">Width</sgmltag></term>
<listitem>
<para>
Sets the width of the label.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="la-height"/><sgmltag class="attribute">Height</sgmltag></term>
<listitem>
<para>
Sets the height of the label.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="la-backgroundcolor"/><sgmltag class="attribute">BackgroundColor</sgmltag></term>
<listitem>
<para>
Sets the background color of the label. The color is defined as an
RGB (Red Green Blue) value (r,g,b). r, g and b must be in the range 0..255.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="la-foregroundcolor"/><sgmltag class="attribute">ForegroundColor</sgmltag></term>
<listitem>
<para>
Sets the foreground color of the label. The color is defined as an RGB (Red Green Blue)
value (r,g,b). r, g and b must be in the range 0..255.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="la-bordercolor"/><sgmltag class="element">BorderColor</sgmltag></term>
<listitem>
<para>
Sets the border color of the label. The color is defined as an RGB (Red Green Blue)
value (r,g,b). r, g and b must be in the range 0..255.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="la-borderwidth"/><sgmltag class="element">BorderWidth</sgmltag></term>
<listitem>
<para>
Sets the border width for the label.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="la-borderstyle"/><sgmltag class="element">BorderStyle</sgmltag></term>
<listitem>
<para>
Sets the border style for the label.
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Value</entry>
<entry>Border Style</entry>
</row>
</thead>
<tbody>
<row>
<entry><sgmltag class="attvalue">0</sgmltag></entry>
<entry>None</entry>
</row>
<row>
<entry><sgmltag class="attvalue">1</sgmltag></entry>
<entry>Solid</entry>
</row>
<row>
<entry><sgmltag class="attvalue">2</sgmltag></entry>
<entry>Dash</entry>
</row>
<row>
<entry><sgmltag class="attvalue">3</sgmltag></entry>
<entry>Dot</entry>
</row>
<row>
<entry><sgmltag class="attvalue">4</sgmltag></entry>
<entry>Dash Dot</entry>
</row>
<row>
<entry><sgmltag class="attvalue">5</sgmltag></entry>
<entry>Dash Dot Dot</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="la-fontfamily"/><sgmltag class="attribute">FontFamily</sgmltag></term>
<listitem>
<para>
Sets the font family for the label's text.
</para>
<!--<informalexample>
<para>For example: <userinput><sgmltag
class="attribute">FontFamily</sgmltag>="<sgmltag
class="attvalue">Helvetica</sgmltag>"</userinput></para>
</informalexample>-->
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="la-fontsize"/><sgmltag class="attribute">FontSize</sgmltag></term>
<listitem>
<para>
Sets the font size for the label's text.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="la-fontweight"/><sgmltag class="attribute">FontWeight</sgmltag></term>
<listitem>
<para>
Sets the font weight for the label's text.
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Value</entry>
<entry>Font Weight</entry>
</row>
</thead>
<tbody>
<row>
<entry><sgmltag class="attvalue">25</sgmltag></entry>
<entry>Light</entry>
</row>
<row>
<entry><sgmltag class="attvalue">50</sgmltag></entry>
<entry>Normal</entry>
</row>
<row>
<entry><sgmltag class="attvalue">63</sgmltag></entry>
<entry>Demi Bold</entry>
</row>
<row>
<entry><sgmltag class="attvalue">75</sgmltag></entry>
<entry>Bold</entry>
</row>
<row>
<entry><sgmltag class="attvalue">87</sgmltag></entry>
<entry>Black</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="la-fontitalic"/><sgmltag class="attribute">FontItalic</sgmltag></term>
<listitem>
<para>
Sets the font italic flag for the label's text.
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Value</entry>
<entry>Italic</entry>
</row>
</thead>
<tbody>
<row>
<entry><sgmltag class="attvalue">0</sgmltag></entry>
<entry>False</entry>
</row>
<row>
<entry><sgmltag class="attvalue">1</sgmltag></entry>
<entry>True</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="la-halignment"/><sgmltag class="attribute">HAlignment</sgmltag></term>
<listitem>
<para>
Sets the label's horizontal text alignment.
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Value</entry>
<entry>Horizontal Alignment</entry>
</row>
</thead>
<tbody>
<row>
<entry><sgmltag class="attvalue">0</sgmltag></entry>
<entry>Left</entry>
</row>
<row>
<entry><sgmltag class="attvalue">1</sgmltag></entry>
<entry>Center</entry>
</row>
<row>
<entry><sgmltag class="attvalue">2</sgmltag></entry>
<entry>Right</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="la-valignment"/><sgmltag class="attribute">VAlignment</sgmltag></term>
<listitem>
<para>
Sets the label's vertical text alignment.
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Value</entry>
<entry>Vertical Alignment</entry>
</row>
</thead>
<tbody>
<row>
<entry><sgmltag class="attvalue">0</sgmltag></entry>
<entry>Top</entry>
</row>
<row>
<entry><sgmltag class="attvalue">1</sgmltag></entry>
<entry>Middle</entry>
</row>
<row>
<entry><sgmltag class="attvalue">2</sgmltag></entry>
<entry>Bottom</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="la-wordwrap"/><sgmltag class="attribute">WordWrap</sgmltag></term>
<listitem>
<para>
Sets the word wrap flag for the label's text.
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Value</entry>
<entry>Word Wrap</entry>
</row>
</thead>
<tbody>
<row>
<entry><sgmltag class="attvalue">0</sgmltag></entry>
<entry>False</entry>
</row>
<row>
<entry><sgmltag class="attvalue">1</sgmltag></entry>
<entry>True</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>
</variablelist>
</sect2>
<sect2 id="field-element">
<title><sgmltag class="element">Field</sgmltag></title>
<para>
The <sgmltag class="element">Field</sgmltag> element defines a report
object used to draw data on a report.
</para>
<synopsis>
&lt;!ELEMENT Field EMPTY&gt;
&lt;!ATTLIST Field
Field CDATA #REQUIRED
Text CDATA #REQUIRED
X CDATA #REQUIRED
Y CDATA #REQUIRED
Width CDATA #REQUIRED
Height CDATA #REQUIRED
BackgroundColor CDATA #REQUIRED
ForegroundColor CDATA #REQUIRED
BorderColor CDATA #REQUIRED
BorderWidth CDATA #REQUIRED
BorderStyle CDATA #REQUIRED
FontFamily CDATA #REQUIRED
FontSize CDATA #REQUIRED
FontWeight CDATA #REQUIRED
FontItalic CDATA #REQUIRED
HAlignment CDATA #REQUIRED
VAlignment CDATA #REQUIRED
WordWrap CDATA #REQUIRED
DataType CDATA #REQUIRED
DateFormat CDATA #REQUIRED
Precision CDATA #REQUIRED
Currency CDATA #REQUIRED
NegValueColor CDATA #REQUIRED
CommaSeparator CDATA #REQUIRED&gt;
</synopsis>
<variablelist>
<varlistentry>
<term>Attributes</term>
<listitem>
<variablelist>
<varlistentry>
<term><anchor id="f-field"/><sgmltag class="attribute">Field</sgmltag></term>
<listitem>
<para>
Sets the data field for the object. This is an attribute of a <sgmltag
class="attribute">row</sgmltag> element in a data file.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="f-text"/><sgmltag class="attribute">Text</sgmltag></term>
<listitem>
<para>
Not used.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="f-x"/><sgmltag class="attribute">X</sgmltag></term>
<listitem>
<para>
Sets the x coordinate (relative to the section's upper left corner) for positioning the field.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="f-y"/><sgmltag class="attribute">Y</sgmltag></term>
<listitem>
<para>
Sets the y coordinate (relative to the section's upper left corner) for positioning the field.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="f-width"/><sgmltag class="attribute">Width</sgmltag></term>
<listitem>
<para>
Sets the width of the field.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="f-height"/><sgmltag class="attribute">Height</sgmltag></term>
<listitem>
<para>
Sets the height of the field.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="f-backgroundcolor"/><sgmltag class="attribute">BackgroundColor</sgmltag></term>
<listitem>
<para>
Sets the background color of the field. The color is defined as an RGB (Red Green Blue)
value (r,g,b). r, g and b must be in the range 0..255.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="f-foregroundcolor"/><sgmltag class="attribute">ForegroundColor</sgmltag></term>
<listitem>
<para>
Sets the foreground color of the field. The color is defined as an RGB (Red Green Blue)
value (r,g,b). r, g and b must be in the range 0..255.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="f-bordercolor"/><sgmltag class="attribute">BorderColor</sgmltag></term>
<listitem>
<para>
Sets the border color of the field. The color is defined as an RGB (Red Green Blue)
value (r,g,b). r, g and b must be in the range 0..255.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="f-borderwidth"/><sgmltag class="element">BorderWidth</sgmltag></term>
<listitem>
<para>
Sets the border width for the field.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="f-borderstyle"/><sgmltag class="element">BorderStyle</sgmltag></term>
<listitem>
<para>
Sets the border style for the field.
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Value</entry>
<entry>Border Style</entry>
</row>
</thead>
<tbody>
<row>
<entry><sgmltag class="attvalue">0</sgmltag></entry>
<entry>None</entry>
</row>
<row>
<entry><sgmltag class="attvalue">1</sgmltag></entry>
<entry>Solid</entry>
</row>
<row>
<entry><sgmltag class="attvalue">2</sgmltag></entry>
<entry>Dash</entry>
</row>
<row>
<entry><sgmltag class="attvalue">3</sgmltag></entry>
<entry>Dot</entry>
</row>
<row>
<entry><sgmltag class="attvalue">4</sgmltag></entry>
<entry>Dash Dot</entry>
</row>
<row>
<entry><sgmltag class="attvalue">5</sgmltag></entry>
<entry>Dash Dot Dot</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="f-fontfamily"/><sgmltag class="attribute">FontFamily</sgmltag></term>
<listitem>
<para>
Sets the font family for the field's text.
</para>
<!--<informalexample>
<para><userinput><sgmltag
class="attribute">FontFamily</sgmltag>="<sgmltag
class="attvalue">Helvetica</sgmltag>"</userinput></para>
</informalexample>-->
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="f-fontsize"/><sgmltag class="attribute">FontSize</sgmltag></term>
<listitem>
<para>
Sets the font size for the field's text.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="f-fontweight"/><sgmltag class="attribute">FontWeight</sgmltag></term>
<listitem>
<para>
Sets the font weight for the field's text.
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Value</entry>
<entry>Font Weight</entry>
</row>
</thead>
<tbody>
<row>
<entry><sgmltag class="attvalue">25</sgmltag></entry>
<entry>Light</entry>
</row>
<row>
<entry><sgmltag class="attvalue">50</sgmltag></entry>
<entry>Normal</entry>
</row>
<row>
<entry><sgmltag class="attvalue">63</sgmltag></entry>
<entry>Demi Bold</entry>
</row>
<row>
<entry><sgmltag class="attvalue">75</sgmltag></entry>
<entry>Bold</entry>
</row>
<row>
<entry><sgmltag class="attvalue">87</sgmltag></entry>
<entry>Black</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="f-fontitalic"/><sgmltag class="attribute">FontItalic</sgmltag></term>
<listitem>
<para>
Sets the font italic flag for the field's text.
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Value</entry>
<entry>Italic</entry>
</row>
</thead>
<tbody>
<row>
<entry><sgmltag class="attvalue">0</sgmltag></entry>
<entry>False</entry>
</row>
<row>
<entry><sgmltag class="attvalue">1</sgmltag></entry>
<entry>True</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="f-halignment"/><sgmltag class="attribute">HAlignment</sgmltag></term>
<listitem>
<para>
Sets the field's horizontal text alignment.
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Value</entry>
<entry>Horizontal Alignment</entry>
</row>
</thead>
<tbody>
<row>
<entry><sgmltag class="attvalue">0</sgmltag></entry>
<entry>Left</entry>
</row>
<row>
<entry><sgmltag class="attvalue">1</sgmltag></entry>
<entry>Center</entry>
</row>
<row>
<entry><sgmltag class="attvalue">2</sgmltag></entry>
<entry>Right</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="f-valignment"/><sgmltag class="attribute">VAlignment</sgmltag></term>
<listitem>
<para>
Sets the field's vertical text alignment
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Value</entry>
<entry>Vertical Alignment</entry>
</row>
</thead>
<tbody>
<row>
<entry><sgmltag class="attvalue">0</sgmltag></entry>
<entry>Top</entry>
</row>
<row>
<entry><sgmltag class="attvalue">1</sgmltag></entry>
<entry>Middle</entry>
</row>
<row>
<entry><sgmltag class="attvalue">2</sgmltag></entry>
<entry>Bottom</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="f-wordwrap"/><sgmltag class="attribute">WordWrap</sgmltag></term>
<listitem>
<para>
Sets the word wrap flag for the field's text.
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Value</entry>
<entry>Word Wrap</entry>
</row>
</thead>
<tbody>
<row>
<entry><sgmltag class="attvalue">0</sgmltag></entry>
<entry>False</entry>
</row>
<row>
<entry><sgmltag class="attvalue">1</sgmltag></entry>
<entry>True</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</listitem>
</varlistentry>
<!--</variablelist>
</listitem>
</varlistentry>-->
<varlistentry>
<term><anchor id="f-datatype"/><sgmltag class="attribute">DataType</sgmltag></term>
<listitem>
<para>
Sets the field's data type.
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Value</entry>
<entry>Data Type</entry>
</row>
</thead>
<tbody>
<row>
<entry><sgmltag class="attvalue">0</sgmltag></entry>
<entry>String</entry>
</row>
<row>
<entry><sgmltag class="attvalue">1</sgmltag></entry>
<entry>Integer</entry>
</row>
<row>
<entry><sgmltag class="attvalue">2</sgmltag></entry>
<entry>Float</entry>
</row>
<row>
<entry><sgmltag class="attvalue">3</sgmltag></entry>
<entry>Date</entry>
</row>
<row>
<entry><sgmltag class="attvalue">4</sgmltag></entry>
<entry>Currency</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="f-dateformat"/><sgmltag class="attribute">DateFormat</sgmltag></term>
<listitem>
<para>
Sets the field's date format. For this to work, the format of the date
from the data document must be in the format mm/dd/yyyy or mm-dd-yyyy,
otherwise the original date format is used. If the data type is other than
date, set this to <sgmltag class="attvalue">0</sgmltag>.
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Value</entry>
<entry>Date Format</entry>
</row>
</thead>
<tbody>
<row>
<entry><sgmltag class="attvalue">0</sgmltag></entry>
<entry>m/d/yy</entry>
</row>
<row>
<entry><sgmltag class="attvalue">1</sgmltag></entry>
<entry>m-d-yy</entry>
</row>
<row>
<entry><sgmltag class="attvalue">2</sgmltag></entry>
<entry>mm/dd/yy</entry>
</row>
<row>
<entry><sgmltag class="attvalue">3</sgmltag></entry>
<entry>mm-dd-yy</entry>
</row>
<row>
<entry><sgmltag class="attvalue">4</sgmltag></entry>
<entry>m/d/yyyy</entry>
</row>
<row>
<entry><sgmltag class="attvalue">5</sgmltag></entry>
<entry>m-d-yyyy</entry>
</row>
<row>
<entry><sgmltag class="attvalue">6</sgmltag></entry>
<entry>mm/dd/yyyy</entry>
</row>
<row>
<entry><sgmltag class="attvalue">7</sgmltag></entry>
<entry>mm-dd-yyyy</entry>
</row>
<row>
<entry><sgmltag class="attvalue">8</sgmltag></entry>
<entry>yyyy/m/d</entry>
</row>
<row>
<entry><sgmltag class="attvalue">9</sgmltag></entry>
<entry>yyyy-m-d</entry>
</row>
<row>
<entry><sgmltag class="attvalue">10</sgmltag></entry>
<entry>dd.mm.yy</entry>
</row>
<row>
<entry><sgmltag class="attvalue">11</sgmltag></entry>
<entry>dd.mm.yyyy</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="f-precision"/><sgmltag class="attribute">Precision</sgmltag></term>
<listitem>
<para>
Sets the field's numeric precision. If the data type is other than a numeric
type, set this to 0.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="f-currency"/><sgmltag class="attribute">Currency</sgmltag></term>
<listitem>
<para>
Sets the field's currency symbol If the data type is other than currency, set
this to <sgmltag class="attvalue">36</sgmltag> ($). The value is a number
representing a Unicode character.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="f-negvaluecolor"/><sgmltag class="attribute">NegValueColor</sgmltag></term>
<listitem>
<para>
Sets the color for negative numeric values. The color is defined as an
RGB (Red Green Blue) value (r,g,b). r, g and b must be in the range 0..255. If data is
other than a numeric type, set to 255,0,0.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="f-commaseparator"/><sgmltag class="attribute">CommaSeparator</sgmltag></term>
<listitem>
<para>
Sets whether commas are used in numeric fields. If the data type is other than
a numeric type, set this to <sgmltag class="attvalue">0</sgmltag>.
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Value</entry>
<entry>Comma Separator</entry>
</row>
</thead>
<tbody>
<row>
<entry><sgmltag class="attvalue">0</sgmltag></entry>
<entry>False</entry>
</row>
<row>
<entry><sgmltag class="attvalue">1</sgmltag></entry>
<entry>True</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>
</variablelist>
</sect2>
<sect2 id="calculated-field-element">
<title><sgmltag class="element">CalculatedField</sgmltag></title>
<para>
The <sgmltag class="element">CalculatedField</sgmltag> element defines a report
object used to draw calculated values on a report.
</para>
<synopsis>
&lt;!ELEMENT CalculatedField EMPTY&gt;
&lt;!ATTLIST CalculatedField
CalculationType CDATA #REQUIRED
Field CDATA #REQUIRED
Text CDATA #REQUIRED
X CDATA #REQUIRED
Y CDATA #REQUIRED
Width CDATA #REQUIRED
Height CDATA #REQUIRED
BackgroundColor CDATA #REQUIRED
ForegroundColor CDATA #REQUIRED
BorderColor CDATA #REQUIRED
BorderWidth CDATA #REQUIRED
BorderStyle CDATA #REQUIRED
FontFamily CDATA #REQUIRED
FontSize CDATA #REQUIRED
FontWeight CDATA #REQUIRED
FontItalic CDATA #REQUIRED
HAlignment CDATA #REQUIRED
VAlignment CDATA #REQUIRED
WordWrap CDATA #REQUIRED
DataType CDATA #REQUIRED
DateFormat CDATA #REQUIRED
Precision CDATA #REQUIRED
Currency CDATA #REQUIRED
NegValueColor CDATA #REQUIRED
CommaSeparator CDATA #REQUIRED&gt;
</synopsis>
<variablelist>
<varlistentry>
<term>Attributes</term>
<listitem>
<variablelist>
<varlistentry>
<term><anchor id="c-calculationtype"/><sgmltag class="attribute">CalculationType</sgmltag></term>
<listitem>
<para>
Sets the calculation type for the field.
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Value</entry>
<entry>Calculation</entry>
</row>
</thead>
<tbody>
<row>
<entry><sgmltag class="attvalue">0</sgmltag></entry>
<entry>Count</entry>
</row>
<row>
<entry><sgmltag class="attvalue">1</sgmltag></entry>
<entry>Sum</entry>
</row>
<row>
<entry><sgmltag class="attvalue">2</sgmltag></entry>
<entry>Average</entry>
</row>
<row>
<entry><sgmltag class="attvalue">3</sgmltag></entry>
<entry>Variance</entry>
</row>
<row>
<entry><sgmltag class="attvalue">4</sgmltag></entry>
<entry>Std Deviation</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="c-field"/><sgmltag class="attribute">Field</sgmltag></term>
<listitem>
<para>
Sets the data field for the object. This is an attribute of a <sgmltag
class="attribute">row</sgmltag> element in a data file.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="c-text"/><sgmltag class="attribute">Text</sgmltag></term>
<listitem>
<para>
Not used.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="c-x"/><sgmltag class="attribute">X</sgmltag></term>
<listitem>
<para>
Sets the x coordinate (relative to the section's upper left corner) for positioning the field.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="c-y"/><sgmltag class="attribute">Y</sgmltag></term>
<listitem>
<para>
Sets the y coordinate (relative to the section's upper left corner) for positioning the field.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="c-width"/><sgmltag class="attribute">Width</sgmltag></term>
<listitem>
<para>
Sets the width of the field.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="c-height"/><sgmltag class="attribute">Height</sgmltag></term>
<listitem>
<para>
Sets the height of the field.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="c-backgroundcolor"/><sgmltag class="attribute">BackgroundColor</sgmltag></term>
<listitem>
<para>
Sets the background color of the field. The color is defined as an RGB (Red Green Blue)
value (r,g,b). r, g and b must be in the range 0..255.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="c-foregroundcolor"/><sgmltag class="attribute">ForegroundColor</sgmltag></term>
<listitem>
<para>
Sets the foreground color of the field. The color is defined as an RGB (Red Green Blue)
value (r,g,b). r, g and b must be in the range 0..255.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="c-bordercolor"/><sgmltag class="attribute">BorderColor</sgmltag></term>
<listitem>
<para>
Sets the border color of the field. The color is defined as an RGB (Red Green Blue)
value (r,g,b). r, g and b must be in the range 0..255.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="c-borderwidth"/><sgmltag class="element">BorderWidth</sgmltag></term>
<listitem>
<para>
Sets the border width for the field.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="c-borderstyle"/><sgmltag class="element">BorderStyle</sgmltag></term>
<listitem>
<para>
Sets the border style for the field.
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Value</entry>
<entry>Border Style</entry>
</row>
</thead>
<tbody>
<row>
<entry><sgmltag class="attvalue">0</sgmltag></entry>
<entry>None</entry>
</row>
<row>
<entry><sgmltag class="attvalue">1</sgmltag></entry>
<entry>Solid</entry>
</row>
<row>
<entry><sgmltag class="attvalue">2</sgmltag></entry>
<entry>Dash</entry>
</row>
<row>
<entry><sgmltag class="attvalue">3</sgmltag></entry>
<entry>Dot</entry>
</row>
<row>
<entry><sgmltag class="attvalue">4</sgmltag></entry>
<entry>Dash Dot</entry>
</row>
<row>
<entry><sgmltag class="attvalue">5</sgmltag></entry>
<entry>Dash Dot Dot</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="c-fontfamily"/><sgmltag class="attribute">FontFamily</sgmltag></term>
<listitem>
<para>
Sets the font family for the field's text.
</para>
<!--<informalexample>
<para><userinput><sgmltag
class="attribute">FontFamily</sgmltag>="<sgmltag
class="attvalue">Helvetica</sgmltag>"</userinput></para>
</informalexample>-->
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="c-fontsize"/><sgmltag class="attribute">FontSize</sgmltag></term>
<listitem>
<para>
Sets the font size for the field's text.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="c-fontweight"/><sgmltag class="attribute">FontWeight</sgmltag></term>
<listitem>
<para>
Sets the font weight for the field's text.
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Value</entry>
<entry>Font Weight</entry>
</row>
</thead>
<tbody>
<row>
<entry><sgmltag class="attvalue">25</sgmltag></entry>
<entry>Light</entry>
</row>
<row>
<entry><sgmltag class="attvalue">50</sgmltag></entry>
<entry>Normal</entry>
</row>
<row>
<entry><sgmltag class="attvalue">63</sgmltag></entry>
<entry>Demi Bold</entry>
</row>
<row>
<entry><sgmltag class="attvalue">75</sgmltag></entry>
<entry>Bold</entry>
</row>
<row>
<entry><sgmltag class="attvalue">87</sgmltag></entry>
<entry>Black</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="c-fontitalic"/><sgmltag class="attribute">FontItalic</sgmltag></term>
<listitem>
<para>
Sets the font italic flag for the field's text.
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Value</entry>
<entry>Italic</entry>
</row>
</thead>
<tbody>
<row>
<entry><sgmltag class="attvalue">0</sgmltag></entry>
<entry>False</entry>
</row>
<row>
<entry><sgmltag class="attvalue">1</sgmltag></entry>
<entry>True</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="c-halignment"/><sgmltag class="attribute">HAlignment</sgmltag></term>
<listitem>
<para>
Sets the field's horizontal text alignment.
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Value</entry>
<entry>Horizontal Alignment</entry>
</row>
</thead>
<tbody>
<row>
<entry><sgmltag class="attvalue">0</sgmltag></entry>
<entry>Left</entry>
</row>
<row>
<entry><sgmltag class="attvalue">1</sgmltag></entry>
<entry>Center</entry>
</row>
<row>
<entry><sgmltag class="attvalue">2</sgmltag></entry>
<entry>Right</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="c-valignment"/><sgmltag class="attribute">VAlignment</sgmltag></term>
<listitem>
<para>
Sets the field's vertical text alignment.
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Value</entry>
<entry>Vertical Alignment</entry>
</row>
</thead>
<tbody>
<row>
<entry><sgmltag class="attvalue">0</sgmltag></entry>
<entry>Top</entry>
</row>
<row>
<entry><sgmltag class="attvalue">1</sgmltag></entry>
<entry>Middle</entry>
</row>
<row>
<entry><sgmltag class="attvalue">2</sgmltag></entry>
<entry>Bottom</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="c-wordwrap"/><sgmltag class="attribute">WordWrap</sgmltag></term>
<listitem>
<para>
Sets the word wrap flag for the field's text.
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Value</entry>
<entry>Word Wrap</entry>
</row>
</thead>
<tbody>
<row>
<entry><sgmltag class="attvalue">0</sgmltag></entry>
<entry>False</entry>
</row>
<row>
<entry><sgmltag class="attvalue">1</sgmltag></entry>
<entry>True</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="c-datatype"/><sgmltag class="attribute">DataType</sgmltag></term>
<listitem>
<para>
Sets the field's data type.
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Value</entry>
<entry>Data Type</entry>
</row>
</thead>
<tbody>
<row>
<entry><sgmltag class="attvalue">0</sgmltag></entry>
<entry>String</entry>
</row>
<row>
<entry><sgmltag class="attvalue">1</sgmltag></entry>
<entry>Integer</entry>
</row>
<row>
<entry><sgmltag class="attvalue">2</sgmltag></entry>
<entry>Float</entry>
</row>
<row>
<entry><sgmltag class="attvalue">3</sgmltag></entry>
<entry>Date</entry>
</row>
<row>
<entry><sgmltag class="attvalue">4</sgmltag></entry>
<entry>Currency</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="c-dateformat"/><sgmltag class="attribute">DateFormat</sgmltag></term>
<listitem>
<para>
Sets the field's date format. For this to work, the format of the date
from the data document must be in the format mm/dd/yyyy or mm-dd-yyyy,
otherwise the original date format is used. If the data type is other than
date, set this to <sgmltag class="attvalue">0</sgmltag>.
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Value</entry>
<entry>Date Format</entry>
</row>
</thead>
<tbody>
<row>
<entry><sgmltag class="attvalue">0</sgmltag></entry>
<entry>m/d/yy</entry>
</row>
<row>
<entry><sgmltag class="attvalue">1</sgmltag></entry>
<entry>m-d-yy</entry>
</row>
<row>
<entry><sgmltag class="attvalue">2</sgmltag></entry>
<entry>mm/dd/yy</entry>
</row>
<row>
<entry><sgmltag class="attvalue">3</sgmltag></entry>
<entry>mm-dd-yy</entry>
</row>
<row>
<entry><sgmltag class="attvalue">4</sgmltag></entry>
<entry>m/d/yyyy</entry>
</row>
<row>
<entry><sgmltag class="attvalue">5</sgmltag></entry>
<entry>m-d-yyyy</entry>
</row>
<row>
<entry><sgmltag class="attvalue">6</sgmltag></entry>
<entry>mm/dd/yyyy</entry>
</row>
<row>
<entry><sgmltag class="attvalue">7</sgmltag></entry>
<entry>mm-dd-yyyy</entry>
</row>
<row>
<entry><sgmltag class="attvalue">8</sgmltag></entry>
<entry>yyyy/m/d</entry>
</row>
<row>
<entry><sgmltag class="attvalue">9</sgmltag></entry>
<entry>yyyy-m-d</entry>
</row>
<row>
<entry><sgmltag class="attvalue">10</sgmltag></entry>
<entry>dd.mm.yy</entry>
</row>
<row>
<entry><sgmltag class="attvalue">11</sgmltag></entry>
<entry>dd.mm.yyyy</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="c-precision"/><sgmltag class="attribute">Precision</sgmltag></term>
<listitem>
<para>
Sets the field's numeric precision. If the data type is other than a numeric
type, set this to 0.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="c-currency"/><sgmltag class="attribute">Currency</sgmltag></term>
<listitem>
<para>
Sets the field's currency symbol. If the data type is other than currency, set
this to <sgmltag class="attvalue">36</sgmltag> ($). The value is a number
representing an unicode character.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="c-negvaluecolor"/><sgmltag class="attribute">NegValueColor</sgmltag></term>
<listitem>
<para>
Sets the color for negative numeric values. The color is defined as an
RGB (Red Green Blue) value (r,g,b). r, g and b must be in the range 0..255. If data is
other than a numeric type, set to 255,0,0.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="c-commaseparator"/><sgmltag class="attribute">CommaSeparator</sgmltag></term>
<listitem>
<para>
Sets whether commas are used in numeric fields. If the data type is other than
a numeric type, set this to <sgmltag class="attvalue">0</sgmltag>.
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Value</entry>
<entry>Comma Separator</entry>
</row>
</thead>
<tbody>
<row>
<entry><sgmltag class="attvalue">0</sgmltag></entry>
<entry>False</entry>
</row>
<row>
<entry><sgmltag class="attvalue">1</sgmltag></entry>
<entry>True</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>
</variablelist>
</sect2>
<sect2 id="special-element">
<title><sgmltag class="element">Special</sgmltag></title>
<para>
The <sgmltag class="element">Special</sgmltag> element defines a report
object used to draw page numbers and the current date on a report.
</para>
<synopsis>
&lt;!ELEMENT Special EMPTY&gt;
&lt;!ATTLIST Special
Type CDATA #REQUIRED
Text CDATA #REQUIRED
X CDATA #REQUIRED
Y CDATA #REQUIRED
Width CDATA #REQUIRED
Height CDATA #REQUIRED
BackgroundColor CDATA #REQUIRED
ForegroundColor CDATA #REQUIRED
BorderColor CDATA #REQUIRED
BorderWidth CDATA #REQUIRED
BorderStyle CDATA #REQUIRED
FontFamily CDATA #REQUIRED
FontSize CDATA #REQUIRED
FontWeight CDATA #REQUIRED
FontItalic CDATA #REQUIRED
HAlignment CDATA #REQUIRED
VAlignment CDATA #REQUIRED
WordWrap CDATA #REQUIRED
DateFormat CDATA #REQUIRED&gt;
</synopsis>
<variablelist>
<varlistentry>
<term>Attributes</term>
<listitem>
<variablelist>
<varlistentry>
<term><anchor id="s-type"/><sgmltag class="attribute">Type</sgmltag></term>
<listitem>
<para>
Sets the type of special object.
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Value</entry>
<entry>Type</entry>
</row>
</thead>
<tbody>
<row>
<entry><sgmltag class="attvalue">0</sgmltag></entry>
<entry>Current Date</entry>
</row>
<row>
<entry><sgmltag class="attvalue">1</sgmltag></entry>
<entry>Page Number</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="s-text"/><sgmltag class="attribute">Text</sgmltag></term>
<listitem>
<para>
Not used.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="s-x"/><sgmltag class="attribute">X</sgmltag></term>
<listitem>
<para>
Sets the x coordinate (relative to the section's upper left corner) for positioning the field.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="s-y"/><sgmltag class="attribute">Y</sgmltag></term>
<listitem>
<para>
Sets the y coordinate (relative to the section's upper left corner) for positioning the field.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="s-width"/><sgmltag class="attribute">Width</sgmltag></term>
<listitem>
<para>
Sets the width of the field.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="s-height"/><sgmltag class="attribute">Height</sgmltag></term>
<listitem>
<para>
Sets the height of the field.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="s-backgroundcolor"/><sgmltag class="attribute">BackgroundColor</sgmltag></term>
<listitem>
<para>
Sets the background color of the field. The color is defined as an RGB (Red Green Blue)
value (r,g,b). r, g and b must be in the range 0..255.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="s-foregroundcolor"/><sgmltag class="attribute">ForegroundColor</sgmltag></term>
<listitem>
<para>
Sets the foreground color of the field. The color is defined as an RGB (Red Green Blue)
value (r,g,b). r, g and b must be in the range 0..255.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="s-bordercolor"/><sgmltag class="attribute">BorderColor</sgmltag></term>
<listitem>
<para>
Sets the border color of the field. The color is defined as an RGB (Red Green Blue)
value (r,g,b). r, g and b must be in the range 0..255.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="s-borderwidth"/><sgmltag class="element">BorderWidth</sgmltag></term>
<listitem>
<para>
Sets the border width for the field.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="s-borderstyle"/><sgmltag class="element">BorderStyle</sgmltag></term>
<listitem>
<para>
Sets the border style for the field.
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Value</entry>
<entry>Border Style</entry>
</row>
</thead>
<tbody>
<row>
<entry><sgmltag class="attvalue">0</sgmltag></entry>
<entry>None</entry>
</row>
<row>
<entry><sgmltag class="attvalue">1</sgmltag></entry>
<entry>Solid</entry>
</row>
<row>
<entry><sgmltag class="attvalue">2</sgmltag></entry>
<entry>Dash</entry>
</row>
<row>
<entry><sgmltag class="attvalue">3</sgmltag></entry>
<entry>Dot</entry>
</row>
<row>
<entry><sgmltag class="attvalue">4</sgmltag></entry>
<entry>Dash Dot</entry>
</row>
<row>
<entry><sgmltag class="attvalue">5</sgmltag></entry>
<entry>Dash Dot Dot</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="s-fontfamily"/><sgmltag class="attribute">FontFamily</sgmltag></term>
<listitem>
<para>
Sets the font family for the field's text.
</para>
<!--<informalexample>
<para><userinput><sgmltag
class="attribute">FontFamily</sgmltag>="<sgmltag
class="attvalue">Helvetica</sgmltag>"</userinput></para>
</informalexample>-->
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="s-fontsize"/><sgmltag class="attribute">FontSize</sgmltag></term>
<listitem>
<para>
Sets the font size for the field's text.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="s-fontweight"/><sgmltag class="attribute">FontWeight</sgmltag></term>
<listitem>
<para>
Sets the font weight for the field's text.
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Value</entry>
<entry>Font Weight</entry>
</row>
</thead>
<tbody>
<row>
<entry><sgmltag class="attvalue">25</sgmltag></entry>
<entry>Light</entry>
</row>
<row>
<entry><sgmltag class="attvalue">50</sgmltag></entry>
<entry>Normal</entry>
</row>
<row>
<entry><sgmltag class="attvalue">63</sgmltag></entry>
<entry>Demi Bold</entry>
</row>
<row>
<entry><sgmltag class="attvalue">75</sgmltag></entry>
<entry>Bold</entry>
</row>
<row>
<entry><sgmltag class="attvalue">87</sgmltag></entry>
<entry>Black</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="s-fontitalic"/><sgmltag class="attribute">FontItalic</sgmltag></term>
<listitem>
<para>
Sets the font italic flag for the field's text.
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Value</entry>
<entry>Italic</entry>
</row>
</thead>
<tbody>
<row>
<entry><sgmltag class="attvalue">0</sgmltag></entry>
<entry>False</entry>
</row>
<row>
<entry><sgmltag class="attvalue">1</sgmltag></entry>
<entry>True</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="s-halignment"/><sgmltag class="attribute">HAlignment</sgmltag></term>
<listitem>
<para>
Sets the field's horizontal text alignment.
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Value</entry>
<entry>Horizontal Alignment</entry>
</row>
</thead>
<tbody>
<row>
<entry><sgmltag class="attvalue">0</sgmltag></entry>
<entry>Left</entry>
</row>
<row>
<entry><sgmltag class="attvalue">1</sgmltag></entry>
<entry>Center</entry>
</row>
<row>
<entry><sgmltag class="attvalue">2</sgmltag></entry>
<entry>Right</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="s-valignment"/><sgmltag class="attribute">VAlignment</sgmltag></term>
<listitem>
<para>
Sets the field's vertical text alignment.
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Value</entry>
<entry>Vertical Alignment</entry>
</row>
</thead>
<tbody>
<row>
<entry><sgmltag class="attvalue">0</sgmltag></entry>
<entry>Top</entry>
</row>
<row>
<entry><sgmltag class="attvalue">1</sgmltag></entry>
<entry>Middle</entry>
</row>
<row>
<entry><sgmltag class="attvalue">2</sgmltag></entry>
<entry>Bottom</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="s-wordwrap"/><sgmltag class="attribute">WordWrap</sgmltag></term>
<listitem>
<para>
Sets the word wrap flag for the field's text.
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Value</entry>
<entry>Word Wrap</entry>
</row>
</thead>
<tbody>
<row>
<entry><sgmltag class="attvalue">0</sgmltag></entry>
<entry>False</entry>
</row>
<row>
<entry><sgmltag class="attvalue">1</sgmltag></entry>
<entry>True</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="s-dateformat"/><sgmltag class="attribute">DateFormat</sgmltag></term>
<listitem>
<para>
Sets the field's date format. For this to work, the format of the date
from the data document must be in the format mm/dd/yyyy or mm-dd-yyyy,
otherwise the original date format is used. If the data type is other than
date, set this to <sgmltag class="attvalue">0</sgmltag>.
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Value</entry>
<entry>Date Format</entry>
</row>
</thead>
<tbody>
<row>
<entry><sgmltag class="attvalue">0</sgmltag></entry>
<entry>m/d/yy</entry>
</row>
<row>
<entry><sgmltag class="attvalue">1</sgmltag></entry>
<entry>m-d-yy</entry>
</row>
<row>
<entry><sgmltag class="attvalue">2</sgmltag></entry>
<entry>mm/dd/yy</entry>
</row>
<row>
<entry><sgmltag class="attvalue">3</sgmltag></entry>
<entry>mm-dd-yy</entry>
</row>
<row>
<entry><sgmltag class="attvalue">4</sgmltag></entry>
<entry>m/d/yyyy</entry>
</row>
<row>
<entry><sgmltag class="attvalue">5</sgmltag></entry>
<entry>m-d-yyyy</entry>
</row>
<row>
<entry><sgmltag class="attvalue">6</sgmltag></entry>
<entry>mm/dd/yyyy</entry>
</row>
<row>
<entry><sgmltag class="attvalue">7</sgmltag></entry>
<entry>mm-dd-yyyy</entry>
</row>
<row>
<entry><sgmltag class="attvalue">8</sgmltag></entry>
<entry>yyyy/m/d</entry>
</row>
<row>
<entry><sgmltag class="attvalue">9</sgmltag></entry>
<entry>yyyy-m-d</entry>
</row>
<row>
<entry><sgmltag class="attvalue">10</sgmltag></entry>
<entry>dd.mm.yy</entry>
</row>
<row>
<entry><sgmltag class="attvalue">11</sgmltag></entry>
<entry>dd.mm.yyyy</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="s-precision"/><sgmltag class="attribute">Precision</sgmltag></term>
<listitem>
<para>
Sets the field's numeric precision. If the data type is other than a numeric
type, set this to 0.
</para>
</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>