標頭與標底標籤

您可以使用 fp:headerfp:footer 標籤來定義報告範本中的標頭與標底。
標頭標籤與標底標籤的功能類似,而且這兩個標籤都使用高度屬性: 成對的標頭與標底必須相符。例如,如果 fp:header 的頁面值設為 left,則 fp:footer 的頁面值也必須設為 left。

標頭標籤

如果範本中沒有 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:包含多個文字。這些文字可以是純文字或 type="template/runtime/never/fetch" 的 stringParam。此標籤是唯一擁有專屬標籤的 fp:*cell 標籤。如需此標籤的相關資訊,請參閱 fp:complexcell 標籤表格。

fp:*cell 標籤具有下列屬性:

表 1. 標頭標籤的屬性
名稱 說明 適用的標籤
filename 必要屬性,可指定含有影像的檔案名稱。 fp:imagecell
align 選用屬性,可決定水平對齊(left、right 或 center)。預設值是 left。 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。
此標頭是使用範例 fp:header 標籤,在 PDF 文件中產生。
<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>

建議與意見