iReport .JRXML報表模板的元素
JRXML報表模板的元素
下面列出了<jasperReporot>根元素的全部子元素。
<property>
此元素用來給報表模板新增任意的資訊。
<property name="someproperty" value="somevalue"/>
加裁了報表的Java應用程式通過呼叫JasperReport.getProperty()方法可以載入這些屬性。JRXML模板可以包含零個或多個<property>元素。
<import>
此元素用於匯入個別的Java類或完整的包。
<import value="java.util.HashMap"/>
JRXML模板可以包含零個或多個<import>元素。
<reportFont>
此元素用來定義一個或多個字型，這些字型可用於報表中顯示的文字。
<reportFont name="Arial" isDefault="true" fontName="Arial" size="12"
isBold="true" isItalic="false" isUnderline="false" isStrikeThrough="false"
pdfFontName="Helvetica" pdfEncoding="CP1252" isPdfEmbedded="false"/>
JRXML模板可以包含零個或多個<reportFont>元素。
<parameter>
此元素用於定義報表引數，引數值通過呼叫JasperReports API中的相應方法以java.uitl.Map來提供。
<parameter name="SomeParameter" class="java.lang.String"/>
JRXML模板可以包含零個或多個<parameter>元素。
<queryString>
此元素用於定義從資料庫獲取資料的SQL查詢。
<queryString>
<![CDATA[SELECT column_name FROM table_name]]>
</queryString>
JRXML模板可以包含零個或一個<queryString>元素。如果我們希望把SQL查詢嵌入到報表模板中，必需使用此元素。
<field>
此元素用於把從資料來源或查詢獲取的資料對映到報表模板。Field可以嵌入到報表表示式中，從而獲得所需的輸出。
<field name="FieldName" class="java.lang.String"/>
JRXML模板可以包含零個或多個<field>元素。
<variable>
報表中多次使用的表示式可以賦值給變數，從而簡化模板。
<variable name="VariableName" class="java.lang.Double" calculation="Sum">
<variableExpression>
$F{FieldName}
</variableExpression>
</variable>
JRXML模板可以包含零個或多個<variable>元素。
<group>
此元素用於對連續的紀錄進行分組，分組的依據是資料來源的一些共同特徵。
<group name="GroupName">
<groupExpression>
<![CDATA[$F{FieldName}]]>
</groupExpression>
</group>
JRXML模板可以包含零個或多個<group>元素。
<background>
此元素定義頁的背景，它對報表的所有頁有效。它可以顯示圖片、文字或水印。
<background>
<band height="745">
<image scaleImage="Clip" hAlign="Left" vAlign="Bottom">
<reportElement x="0" y="0" width="160" height="745"/>
<imageExpression>"image.gif"</imageExpression>
</image>
</band>
</background>
JRXML模板可以包含零個或一個<background>元素。
<title>
這是報表的標題，它只在報表起始處顯示一次。
<title>
<band height="50">
<staticText>
<reportElement x="180" y="0" width="200" height="20"/>
<text>
<![CDATA[Title]]>
</text>
</staticText>
</band>
</title>
JRXML模板可以包含零個或一個<title>元素。
<pageHeader>
此元素定義頁首，它在報表每一頁的起始處列印。
<pageHeader>
<band height="20">
<staticText>
<reportElement x="180" y="30" width="200" height="20"/>
<text>
<![CDATA[Page Header]]>
</text>
</staticText>
</band>
</pageHeader>
JRXML模板可以包含零個或一個<pageHeader>元素。
<columnHeader>
如果報表只有一列，些元素將被忽略掉。
<columnHeader>
<band height="20">
<staticText>
<reportElement x="180" y="50" width="200" height="20"/>
<text>
<![CDATA[Column Header]]>
</text>
</staticText>
</band>
</columnHeader>
JRXML模板可以包含零個或多個<columnHeader>元素，模板中<columnHeader>元素的數量必需和列數相同。
<detail>
此元素定義報表的詳情段，報表資料來源的每條紀錄都會重複地使用它。
<detail>
<band height="20">
<textField>
<reportElement x="10" y="0" width="600" height="20"/>
<textFieldExpression class="java.lang.String">
<![CDATA[$F{FieldName}]]>
</textFieldExpression>
</textField>
</band>
</detail>
JRXML模板可以包含零個或一個<detail>元素。大多資料報表模板只包含一個<detail>元素，因為通常情況下，這是顯示報表主要資料的地方。
<columnFooter>
如果報表只有一列，此元素將被忽略掉。
<columnFooter>
<band height="20">
<staticText>
<reportElement x="0" y="0" width="200" height="20"/>
<text>
<![CDATA[Column Footer]]>
</text>
</staticText>
</band>
</columnFooter>
JRXML模板可以包含零個或多個<columnFooter>元素，模板中<columnFooter>元素的數量必需和列數相同。
<pageFooter>
此元素定義頁尾，它在報表每一頁的末尾處列印。
<pageFooter>
<band height="20">
<staticText>
<reportElement x="0" y="5" width="200" height="20"/>
<text>
<![CDATA[Page Footer]]>
</text>
</staticText>
</band>
</pageFooter>
JRXML模板可以包含零個或一個<pageFooter>元素。
<lastPageFooter>
此元素定義的資料顯示在最後一頁的頁尾，取代<pageFooter>元素的頁尾定義。
<lastPageFooter>
<band height="20">
<staticText>
<reportElement x="0" y="5" width="200" height="20"/>
<text>
<![CDATA[Last Page Footer]]>
</text>
</staticText>
</band>
</lastPageFooter>
JRXML模板可以包含零個或一個<lastPageFooter>元素。
<summary>
它僅在報表末尾列印一次。
<summary>
<band height="20">
<staticText>
<reportElement x="0" y="5" width="200" height="20"/>
<text>
<![CDATA[Summary]]>
</text>
</staticText>
</band>
</summary>
JRXML模板可以包含零個或一個<summary>元素。
和<detail>元素一樣，前面討論的其它的每個元素也都包含一個單獨的<band>元素作為其子元素。