页眉和页脚标记

您可以使用 fp:headerfp:footer 标记定义报告模板中的页眉和页脚。
页眉和页脚标记具有相似的功能,这两种标记都使用高度属性: 页眉集和页脚集必须匹配。例如,如果将 fp:header 的页面值设置为左侧,那么也必须将 fp:footer 的页面值设置为左侧。

页眉标记

如果模板中没有 fp:header 标记,那么报告中将不显示页眉。页眉是包含一组单元格的表。页眉标记的数目必须是列数的倍数。如果 cols 指定有三列,那么 fp:header 的标记数必须为 3、6、9、12 等。
每个 fp:header 标记定义页眉中的一个单元格:
  • fp:cellfp:textcell:包含简单文本。以下标记可以创建一个包含文本“Hello world”的单元格:<fp:textcell>Hello world</fp:textcell>
  • fp:imagecell:包含一幅图像。该图像是从文件中读取的,该文件必须位于 .../Program Files/Focal Point/tool/images 文件夹中。图像可以采用 GIF 或 JPG 格式;例如 <fp:imagecell filename="myimage.jpg" />。如果 fp:imagecell 标记位于页眉的第一行或第一列,那么可能无法正确显示。
  • fp:complexcell:包含多个文本。文本可以是纯文本,也可以是类型为“template/runtime/never/fetch”的 stringParam。 该标记是唯一一个拥有自有标记的 fp:*cell 标记。有关该标记的更多信息,请参阅 fp:complexcell 标记表。

fp:*cell 标记具有以下属性:

表 1. 页眉标记的属性
名称 描述 适用标记
filename 必需属性,用于指定包含图像的文件的名称。 fp:imagecell
align 可选属性,用于确定水平对齐方式(左对齐、右对齐或居中)。缺省值为左对齐。 fp:textcell 和 fp:complexcell
border 可选属性,用于确定单元格的边框。总边框值为各边框值之和。缺省值为 0。
例如,某一单元格的边框具有以下值:
  • 上:1
  • 下:2
  • 左:4
  • 右:8
要绘制上边框、左边框和右边框,请将边框值设置为 1+4+8=13:border="13"
所有 fp*cell 标记
colspan 可选属性,用于确定单元格占用的表列数。当使用 colspan 属性时,有关所需单元格数的信息不正确。 例如,colspan="2" 将被当作两个单元格。缺省值为 1。 所有 fp*cell 标记
headingstyle 可选属性,用于确定单元格中使用的标题样式。缺省值为 Normal。 所有 fp*cell 标记
scalepercent 可选属性,用于确定图像的缩放比例。缺省值为 100。要创建质量最好的图像,请创建约比期望大小大五倍的图像。然后,将该图像缩小到期望大小。图像在纸张上的显示质量通常要优于在屏幕上的显示质量。对于标准屏幕大小,scalepercent="100"。 fp:imagecell
fp:complexcell 标记具有以下标记。
表 2. fp:complexcell 标记
名称 描述
fp:newline 插入一个换行符
fp:stringParam

fp:intParam

fp:checkboxParam

插入评估 fp:*Param 标记所得的纯文本
fp:text 插入纯文本

页眉属性

页眉标记具有两个必需属性和两个可选属性。
表 3. fp:header 的属性
属性 描述
cols 必需属性,用于确定列数和列大小。例如,要创建一个共有三列的表(其中的第三列要大于另两列),请输入 cols="30,30,40"
height 必需属性,用于确定页眉的高度。该属性仅影响 PDF 报告。例如,要指定高度为 3 厘米,请输入 height="100"
page 可选属性,用于确定要使用该页眉的页面。该属性具有以下可能值:
  • all:所有页面都使用该页眉(缺省值)
  • first:只有第一页使用该页眉
  • left:所有左侧页面都使用该页眉
  • right:所有右侧页面都使用该页眉
以下规则用于设置页面属性:
  • 对于第一页,请使用 page="first"。否则,请使用 page="right"page="all"。 如果这些页面都不存在,请勿使用页眉。
  • 对于左侧页面,请使用 page="left"。否则,请使用 page="all"。 如果这些页面都不存在,请勿使用页眉。
  • 对于右侧页面,请使用 page="right"(第一页除外)。 否则,请使用 page="all"。如果这些页面都不存在,请勿使用页眉。
缺省值为 all
percentwidth 可选属性,会影响表页眉的宽度。缺省值为 100。
以下页眉是在 PDF 文档中使用样本 fp:header 标记生成的。
<fp:header cols="16,47,63,23,24" height="70" percentwidth="123">
		<fp:cell border="0" headingstyle="NormalMiddle"></fp:cell>
		<fp:cell border="0" headingstyle="NormalMiddle"></fp:cell>
		<fp:cell border="2" headingstyle="NormalMiddle"></fp:cell>
		<fp:cell border="2" headingstyle="NormalMiddle"></fp:cell>
		<fp:cell border="2" headingstyle="NormalMiddle"></fp:cell>
		<fp:cell border="0" headingstyle="NormalMini"></fp:cell>
		<fp:imagecell align="center" colspan="1" border="8"
            filename="logo.jpg" scalepercent="12" 
            style="NormalMini" />
    <fp:complexcell border="15">
            <fp:text style="NormalMiniLeft"> Uppgjord -</fp:text>
            <fp:textstyle="NormalMiniLeftItalic">Prepared</fp:text>
            <fp:newline style="Normal" /><fp:text style="Normal"> </fp:text>
            <fp:stringparam name="Uppgjord" descr="Uppgjord" changeable="runtime" id="1" defaultvalue="" />
    </fp:complexcell>
    <fp:complexcell border="15">
            <fp:text style="NormalMini"> Datum -</fp:text>
                <fp:textstyle="NormalMiniItalic">Date</fp:text>
                <fp:newline style="Normal" /><fp:text style="Normal"> </fp:text>
                <fp:stringparam name="currentdate" descr="Datum" changeable="fetch" id="2" defaultvalue=""/>
		</fp:complexcell>
		<fp:complexcell border="15">
							<fp:text style="NormalMini"> Sida -</fp:text>
							<fp:textstyle="NormalMiniItalic">Page</fp:text>
							<fp:newline style="Normal" /><fp:text style="Normal"> </fp:text>
							<fp:intParam name="pageno" descr="Sidnummer" changeable="fetch" defaultvalue="" id="3"/>
							<fp:	text>(</fp:text>
							<fp:intParam name="numpages" descr="Antal sidor"changeable="fetch" defaultvalue="" id="4"/>
							<fp:text>)</fp:text>
		</fp:complexcell>
							<fp:cell border="0" headingstyle="NormalMini"></fp:cell>
							<fp:complexcell border="8" headingstyle="NormalMiddle"align="left">
							<fp:text style="NormalMiddle">Stockholm</fp:text>
							<fp:newline />
							<fp:text style="NormalMiddle">Sweden</fp:text>
		</fp:complexcell>
		<fp:complexcell border="15">
							<fp:text style="NormalMiniLeft"> Godkänd -</fp:text><fp:textstyle="NormalMiniLeftItalic">Approved</fp:text>
							<fp:newline style="Normal" />
						 	<fp:text style="Normal"> </fp:text>
							<fp:stringparam name="Godkänd"descr="Godkänd av" changeable="runtime" id="5" defaultvalue=""/>
		</fp:complexcell>
		<fp:complexcell border="15">
							<fp:text style="NormalMini"> Dok nr -</fp:text>
							<fp:text style="NormalMiniItalic">DocNo</fp:text>
							<fp:newline style="Normal" />
							<fp:text style="Normal"> </fp:text>
							<fp:stringparam name="Dok Nr" descr="Dokumentnummer" changeable="runtime" id="6" defaultvalue="" />
							</fp:complexcell>
							<fp:complexcell border="15">
							<fp:text style="NormalMini"> Revision -</fp:text>
							<fp:textstyle="NormalMiniItalic">Revision</fp:text>
							<fp:newline style="Normal" />
							<fp:text style="Normal"> </fp:text>
							<fp:stringparam name="Revision" descr="Revision" changeable="runtime" id="7" defaultvalue=""/>
		</fp:complexcell>
							<fp:cell border="0" headingstyle="Normal"></fp:cell>
							<fp:cell border="0" headingstyle="Normal"></fp:cell>
							<fp:cell border="1" headingstyle="Normal"></fp:cell>
							<fp:cell border="1" headingstyle="Normal"></fp:cell>
							<fp:cell border="1" headingstyle="Normal"></fp:cell>
</fp:header>

反馈