jasperReport帮助文档

目录 anchorNameExpression background band columnFooter columnHeader connectionExpression dataSourceExpression detail 默认ValueExpression elementGroup ellipse field fieldDescription font graphicElement group groupExpression groupFooter groupHeader hyperlinkAnchorExpression hyperlinkPageExpression hyperlinkReferenceExpression image imageExpression initialValueExpression line jasperReport pageFooter pageHeader parameter parameterDescription parametersMapExpression printWhenExpression property queryString rectangle reportElement reportFont staticText subreport subreportExpression subreportParameter subreportParameterExpression summary text textElement textField textFieldExpression title variable variableExpression jasperReport top 报表设计文件的根元素 包含元素：( reportFont*, parameter*, queryString?, field*, variable*, group*, background?, title?, pageHeader?, columnHeader?, detail?, columnFooter?, pageFooter?, summary? ) 属性 name 报表名 必须 columnCount 报表的列数 默认1 printOrder 报表列的填充顺序 Vertical 以列为单位填充数据 Horizontal 以行为单位填充数据 默认 Vertical pageWidth 页宽 默认595 pageHeight 页高 默认842 orientation 页打印方向 Portrait 纵向 Landscape 横向 默认Portrait whenNoDataType 允许用户定制引擎在没有数据时产生报表文档的行为。 NoPages 产生的报表没有页 BlankPage 产生的报表有一个空页 AllSectionsNoDetail 除了detail区域报表的其它区域全部产生 默认NoPages columnWidth 列宽 默认555 columnSpacing 列间距 默认0 leftMargin 页面左边空白 默认20 rightMargin 页面右边空白 默认20 topMargin 页头空白 默认30 bottomMargin 页尾空白 默认30 isTitleNewPage 指定是否每页都打印报表标题（title区域）的标志 true 每页都打印报表标题 false 报表标题只在第一页打印 默认false isSummaryNewPage 是否单独加一页打印报表的summary区域的标志 true summary区域将在报表最后新加一页打印 false 如果空间足够，summary区域将在报表最后一页里打印 默认false scriptletClass 指出该报表使用的srciptlet类。必须是 JRAbstractScriptlet的子类，如果没有指定报表默认使用JRDefaultScriptlet类 默认net.sf.jasperreports.engine.JRDefualtScriptlet property top 允许创建报表属性的键值对 包含元素 EMPTY 属性 name 报表属性名 必须 value 报表属性值 reportFont top 定义报表使用的字体。报表字体被用来作为报表中其它显示元素的默认字体 包含元素 EMPTY 属性 name 字体名 必须 isDefault 报表默认字体被用来作为报表中其它未显示定义字体的打印元素的默认字体 true false 默认false fontName 字体名 默认sansserif size 字体大小 默认10 isBold true false 默认false isItalic true false 默认false isUnderline true false 默认false isStrikeThrough true false 默认false pdfFontName PDF字体名 默认Helvetica pdfEncoding PDF 字符编码 默认CP1252 isPdfEmbedded 是否将PDF字体嵌入报表文档 true false 默认false parameter top 定义报表参数。报表参数非常有用，可以通过它将数据传递给报表表达式或者构造动态SQL查询 包含元素 ( parameterDescription?, defaultValueExpression? ) 属性 name 参数名 必须 class 参数类型 必须 isForPrompting 可选标志，用来在报表应用程序中让开发者跟踪报表参数的值 true false 默认true parameterDescription top 参数的简单文字描述，在isForPrompting为true时特别有用 包含元素 ( #PCDATA ) 属性 defaultValueExpression top 当报表应用程序没有为参数提供值时用该表达式为参数赋值 包含元素 ( #PCDATA ) 属性 queryString top SQL查询，用来执行后取得数据填充报表 包含元素 ( #PCDATA ) 属性 field top 定义报表字段，以保存报表数据源中对应列的值 包含元素 ( fieldDescription? ) 属性 name 字段名 必须 class 字段类型 java.lang.Object java.lang.Boolean java.lang.Byte java.util.Date java.sql.Timestamp java.sql.Time java.lang.Double java.lang.Float java.lang.Integer java.io.InputStream java.lang.Long java.lang.Short java.math.BigDecimal java.lang.String 默认java.lang.String fieldDescription top 字段的简单描述。当字段时数据源的扩展字段时有一段简单说明将会使定义更加明了 包含元素 ( #PCDATA ) 属性 variable top 定义报表变量。报表变量是存放关联表达式值的对象，这些表达式都是建立在报表变量和报表字段基础上的Java表达式，在填充报表的时候才进行计算。 包含元素 ( variableExpression?, initialValueExpression? ) 属性 name 变量名 必须 class 变量类型 默认java.lang.String resetType 计算过程中变量重新初始化的级别 None 不用初始化表达式初始化变量 Report 在报表开始时初始化变量一次 Page 在每页开始时初始化变量 Column 在每列开始时初始化变量 Group 在组边界开始时初始化变量。必须将resetGroup属性设置为该组名。 默认Report resetGroup 在组边界开始时初始化变量的分组名。resetType必须设置为"Group" calculation 变量完成的计算类型 Nothing 不计算 Count 统计表达式非空的次数 Sum 统计非空表达式的总和 Average 统计非空表达式的平均值 Lowest 统计最小值 Highest 统计最大值 StandardDeviation 计算表达式的标准偏差。仅用于数字 Variance 计算表达式的方差 System 系统计算（自定义计算） 默认Nothing incrementerFactoryClass 实现net.sf.jasperreports.engine.fill.JRIncrementerFactory 接口的工厂类，用来创建自动增加数值的类，自增类都必须实现net.sf.jasperreports.engine.fill.JRIncrementer 接口，并在每次变量使用后累加变量值 variableExpression top 变量关联的表达式，在运行时计算，并将计算结果赋给对应的变量 包含元素 ( #PCDATA ) 属性 initialValueExpression top 初始化变量的表达式 包含元素 ( #PCDATA ) 属性 group top 定义一个报表分组 包含元素 ( groupExpression?, groupHeader?, groupFooter? ) 属性 name 组名 必须 isStartNewColumn 标志是否分组头都显示在新的列中 true 分组头都显示在新的列中 false 如果空间足够，分组头都显示在当前列中 默认false isStartNewPage 是否在分组头处分页 true 在分组头处分页 false 不在分组头处强制分页 默认false isResetPageNumber 如果在分组头处强制分页，是否重置页码 true 在分组头处强制分页并重置页码 false 无论isStartNewPage 是什么值，都不重置页码 默认false isReprintHeaderOnEachPage 是否在每页都重新显示分组头 true 每页重新显示分组头 false 不重新显示分组头 默认false minHeightToStartNewPage 在当前列底部放置分组头的最小高度 默认0 groupExpression top 定义用来划分分组边界的表达式 包含元素 ( #PCDATA ) 属性 groupHeader top 定义分组头区域 包含元素 ( band? ) 属性 groupFooter top 定义分组尾区域 包含元素 ( band? ) 属性 background top 定义报表背景。报表背景在每页都显示并且不能延伸到下一页，背景区域中定义的元素都在每页初始化时使用并显示在最底层，所有的其它元素都显示在背景之上。报表背景允许定义水印和其它效果。 包含元素 ( band? ) 属性 title top 定义报表标题，标题在整个报表中只打印一次 包含元素 ( band? ) 属性 pageHeader top 定义页头，页头每页都显示 包含元素 ( band? ) 属性 columnHeader top 定义报表列头（列标题），列头在每列开始时打印，如果报表的columnCount属性值是1，则列头和列尾区域将被忽略 包含元素 ( band? ) 属性 detail top 定义报表数据区域，该区域将为数据源的每一条记录重复打印一次 包含元素 ( band? ) 属性 columnFooter top 定义列尾，列尾在每列结束时打印，如果报表的columnCount为1，则和列头一起被忽略 包含元素 ( band? ) 属性 pageFooter top 定义页尾，页尾显示在每页的底部 包含元素 ( band? ) 属性 summary top 定义summary（总结？）区域，它只在报表结束时打印一次 包含元素 ( band? ) 属性 band top 定义一个通用报表区域 包含元素 ( printWhenExpression?, ( line | rectangle | ellipse | image | staticText | textField | subreport | elementGroup )*) 属性 height 高度 默认0 isSplitAllowed 在区域延伸到下一页时是否可以被断开 true 分页时可以断开 false 如果区域延伸并且在当页无法显示则区域的内容全部显示到下一页，不管新页空间是否足够 默认true line top 定义一条直线 包含元素 ( reportElement, graphicElement? ) 属性 direction 直线实际上是画用报表元素（report element）定义的矩形的对角线，该属性制定画矩形的对角线。 TopDown 从矩形的左上定点开始画 BottomUp