iReport使用的说明.doc

iReport 一、介绍 iReport是一个100%使用Java语言编写，支持跨浏览器、支持套打、支持所有有效的数据源的，拖拽式的,所见即所得的报表编辑器，报表可转换为PDF HTML EXCEL等格式，在以后的HSU中将使用此工具进行打印格式的编辑。 二、打印过程流程图 三、iReport的使用 3.1、首界面 当你在iReport中新建一个jrxml文件时，显示界面如下： 1.界面的左侧是导航窗口，会显示文件中可包含的各种字段、参数和Band; 2.中间是编辑区，可以将左侧new的字段参数等拖拽到编辑区进行操作，编辑区的每部分大小可以直接拖拽； 3.界面右侧上半部分是组织面板，可以通过组织面板来添加二维码等小工具。下半部分是属性栏，对应左侧导航栏中每一个部分的属性，可以在次修改每一部分的对应属性。 3.2、栏(Bands) iReport把一个报表划分成七个主要的bands和一个名为backgroup的band(一共是八个bands)，每当我们添加一个group时就会有两个新的band添加到报表当中：group footer bands和group header bands。 把鼠标移到bands的边上我们可以鼠标拖拉的方式改变band的大小以此来适配band里的内容。 报表被垂直分成若干个部分，每一个部分我们叫它“band”。每一个band都有自己的特性，在报表生成的时候有些会打印一次，有些会打印多次。如下图。 接下来我们就对每一种类型的band分别进行介绍。 Title Band：title 段只在整个报表的第一页的最上面部分显示，除了第一页，不管报表中有多少个页面也不会再出现Title band 中的内容。就是报表的标题。 pageHeader Band：pageHeader 段中的内容将会在整个报表中的每一个页面中都会出现，显示的位置在页面的上部。如果是报表的第一页，pageHeader 中的内容将显示在Title Band 下面，除了第一页以外的其他所有页面中，pageHeader 中的内容将显示在页面的最上端，即页眉。 pageFooter Band：显示在所在页面的最下端，即页脚。 Detail Band：报表内容段，在这个Band 中设计报表中需要重复出现的内容，Detail 段中的内容每页都会出现。 columnHeader Band：针对Detail Band 的表头段，一般情况下在这个段中画报表的表头。 columnFooter Band：针对Detail Band 的表尾段。 Summary Band：表格的合计段，出现在整个报表的最后一页中???Detail band 的后面，一般用来统计报表中某一个或某几个字段的合计值。 lastPageFooter：内容将会出现在报表的最后一页的最后部分。 各个Band放置如下： 3.3、字段、参数和变量 3.2.1、Fields 在Fields标签页中，我们可以右键点击添加Fields按钮来创建一个新的Field。在右侧属性中你可以修改他的name和Field Class。Fields新建之后会有两部分组成，一部分相当于表格的列名是文本形式，可以修改为对应的汉字列名，另一部分是相应的变量名，用于与传入的值相对应。 Fields多用于在Detial栏中标识每个字段，与传入的DataStore中的每个字段相对应。 Fields name: Fields的名称，我们可以在表达式中通过下面的方法来引用一个Fields: $V{fields name} 3.2.2、Parameters Parameters通常是用来在打印的时候从程序里传值到报表里。也就是说parameters通常的是起参数传递的作用。他们可以被用在一些特定的场合(比如应用中SQL 查询的条件),如report中任何一个需要从外部传入的变量等(如一个Image对象所包括的char或报表title的字符串)。 和使用Fields一样,parameters也需要在创建的时候定义它的数据类型。parameters的数据类型是标准的java的Object。 在ireport中，Parameters的机制是允许用户通过应用程序传递参数致报表当中。在jasperreort中的某个对象中的expression可以通过下面的语法来访问一个当前ireport中存在的parameter: $P{parameter name}。 如果应用程序没有为报表中定义的parameter赋值，那么parameter将会取我们在定义它的时候设置的default value的值。parameters是一个Java Object,所以如果它的类型是Object类型，我们在其default value里写下面的表达式就是错误的: 0