<!-- 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.1-Based Variant V1.0//EN" "dtd/kdex.dtd">
-->
<chapter id="kugartemplate">
<title><sgmltag class="element">KugarTemplate</sgmltag></title>

<para>
The <sgmltag class="element">KugarTemplate</sgmltag> element defines
report attributes relating to page size, orientation, and margins.
</para>

<synopsis>
&lt;!ELEMENT KugarTemplate (ReportHeader, PageHeader, Detail, PageFooter, ReportFooter)&gt;
&lt;!ATTLIST KugarTemplate
PageSize        CDATA #REQUIRED
PageOrientation CDATA #REQUIRED
TopMargin       CDATA #REQUIRED
BottomMargin    CDATA #REQUIRED
LeftMargin      CDATA #REQUIRED
RightMargin     CDATA #REQUIRED&gt;
</synopsis>

<variablelist>
<varlistentry>
<term>Elements</term>
<listitem>

<para>
The <sgmltag class="element">KugarTemplate</sgmltag> element contains
the following required elements: 
</para>

<variablelist>
<varlistentry>
<term><sgmltag class="element">ReportHeader</sgmltag></term>
<listitem>
<para>
The <sgmltag class="element">ReportHeader</sgmltag> element defines
report sections that are usually printed at the beginning of the report.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><sgmltag class="element">PageHeader</sgmltag></term>
<listitem>
<para>
The <sgmltag class="element">PageHeader</sgmltag> element defines report
sections that are usually printed at the top of every page of the
report.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><sgmltag class="element">Detail</sgmltag></term>
<listitem>
<para>
The <sgmltag class="element">Detail</sgmltag> element defines the report
section that contains the report data.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><sgmltag class="element">PageFooter</sgmltag></term>
<listitem>
<para>
The <sgmltag class="element">PageFooter</sgmltag> element defines report
sections that are usually printed at the end of the every page in the
report.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><sgmltag class="element">ReportFooter</sgmltag></term>
<listitem>
<para>
The <sgmltag class="element">ReportFooter</sgmltag> element defines report
sections that are usually printed at the end of the report.
</para>
</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>

<varlistentry>
<term>Attributes</term>
<listitem>

<variablelist>
<varlistentry>
<term><sgmltag class="attribute">PageSize</sgmltag></term>
<listitem>
<para>
Sets the size of the report page.  The following values are available:
</para>

<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Value</entry>
<entry>Page Size</entry>
</row>
</thead>

<tbody>
<row>
<entry>0</entry>
<entry>A4</entry>
</row>
<row>
<entry>1</entry>
<entry>B5</entry>
</row>
<row>
<entry>2</entry>
<entry>Letter</entry>
</row>
<row>
<entry>3</entry>
<entry>Legal</entry>
</row>
<row>
<entry>4</entry>
<entry>Executive</entry>
</row>
<row>
<entry>5</entry>
<entry>A0</entry>
</row>
<row>
<entry>6</entry>
<entry>A1</entry>
</row>
<row>
<entry>7</entry>
<entry>A2</entry>
</row>
<row>
<entry>8</entry>
<entry>A3</entry>
</row>
<row>
<entry>9</entry>
<entry>A5</entry>
</row>
<row>
<entry>10</entry>
<entry>A6</entry>
</row>
<row>
<entry>11</entry>
<entry>A7</entry>
</row>
<row>
<entry>12</entry>
<entry>A8</entry>
</row>
<row>
<entry>13</entry>
<entry>A9</entry>
</row>
<row>
<entry>14</entry>
<entry>B0</entry>
</row>
<row>
<entry>15</entry>
<entry>B1</entry>
</row>
<row>
<entry>16</entry>
<entry>B2</entry>
</row>
<row>
<entry>17</entry>
<entry>B3</entry>
</row>
<row>
<entry>18</entry>
<entry>B4</entry>
</row>
<row>
<entry>19</entry>
<entry>B6</entry>
</row>
<row>
<entry>20</entry>
<entry>B7</entry>
</row>
<row>
<entry>21</entry>
<entry>B8</entry>
</row>
<row>
<entry>22</entry>
<entry>B9</entry>
</row>
<row>
<entry>23</entry>
<entry>Comm10E</entry>
</row>
<row>
<entry>24</entry>
<entry>DLE</entry>
</row>
<row>
<entry>25</entry>
<entry>Folio</entry>
</row>
<row>
<entry>26</entry>
<entry>Ledger</entry>
</row>
<row>
<entry>27</entry>
<entry>Tabloid</entry>
</row>

</tbody>
</tgroup>
</informaltable>

</listitem>
</varlistentry>

<varlistentry>
<term><sgmltag class="attribute">PageOrientation</sgmltag></term>
<listitem>
<para>
Sets the report page orientation.
</para>

<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Value</entry>
<entry>Orientation</entry>
</row>
</thead>
<tbody>
<row>
<entry>0</entry>
<entry>Portrait</entry>
</row>
<row>
<entry>1</entry>
<entry>Landscape</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</listitem>
</varlistentry>

<varlistentry>
<term><sgmltag class="attribute">TopMargin</sgmltag></term>
<listitem>
<para>
Sets the top margin of the report page <!-- in what scale? -->
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><sgmltag class="attribute">BottomMargin</sgmltag></term>
<listitem>
<para>
Sets the bottom margin of the report page <!-- in what scale? -->
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><sgmltag class="attribute">LeftMargin</sgmltag></term>
<listitem>
<para>
Sets the left margin of the report page <!-- in what scale? -->
</para>
</listitem>
</varlistentry><varlistentry>
<term><sgmltag class="attribute">RightMargin</sgmltag></term>
<listitem>
<para>
Sets the right margin of the report page <!-- in what scale? -->
</para>
</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>
</variablelist>
</chapter>
