Znaczniki nagłówka i stopki

Nagłówki i stopki definiuje się w szablonie raportu za pomocą znaczników fp:header i fp:footer.
Znaczniki nagłówka i stopki mają podobne funkcje i oba korzystają z atrybutu wysokości: Zestawy nagłówków i stopek muszą być zgodne. Jeśli na przykład wartość parametru page znacznika fp:header to left (do lewej), parametr page znacznika fp:footer również musi mieć wartość left (do lewej).

Znaczniki nagłówka

W przypadku braku znaczników fp:header w szablonie nagłówek nie jest wyświetlany w raporcie. Nagłówek to tabela zawierająca zestaw komórek. Liczba znaczników nagłówka musi być wielokrotnością liczby kolumn. Jeśli atrybut cols określa, że istnieją trzy kolumny, liczba znaczników fp:header musi wynosić 3, 6, 9, 12 itd.
Każdy znacznik fp:header definiuje komórkę w nagłówku:
  • fp:cell lub fp:textcell: zawiera prosty tekst. Znaczniki te mogą utworzyć komórkę zawierającą tekst Hello world: <fp:textcell>Hello world</fp:textcell>
  • fp:imagecell: Zawiera obraz. Obraz jest odczytywany z pliku, który należy umieścić w folderze .../Program Files/Focal Point/tool/images. Obrazy mogą mieć format GIF lub JPG. Na przykład: <fp:imagecell filename="moj_obraz.jpg" />. Jeśli znacznik fp:imagecell znajduje się w pierwszym wierszu lub kolumnie nagłówka, może być wyświetlany niepoprawnie.
  • fp:complexcell: Zawiera wiele tekstów. Tekst może być zwykły lub może to być wartość stringParam o typie type="template/runtime/never/fetch". Ten znacznik jest jedynym znacznikiem fp:*cell mającym własne znaczniki. Więcej informacji na temat tego znacznika zawiera tabela znaczników fp:complexcell.

Znaczniki fp:*cell mają następujące atrybuty:

Tabela 1. Atrybuty znaczników nagłówka
Nazwa Opis Odpowiedni znacznik
filename Obowiązkowy atrybut określający nazwę pliku zawierającego obraz. fp:imagecell
align Opcjonalny atrybut określający wyrównanie w poziomie: left (do lewej), right (do prawej) lub center (do środka). Wartość domyślna to left (do lewej). fp:textcell i fp:complexcell
border Opcjonalny atrybut określający krawędź komórki. Łączna wartość krawędzi jest sumą wartości każdej krawędzi. Wartością domyślną jest 0.
Na przykład krawędzie komórki mają następujące wartości:
  • Górna: 1
  • Dolna: 2
  • Lewa: 4
  • Prawa: 8
Aby narysować lewą, górną i prawą krawędź, wartość krawędzi należy ustawić na 1+4+8=13: border="13".
Wszystkie znaczniki fp*cell
colspan Opcjonalny atrybut określający liczbę kolumn tabeli, które zajmuje komórka. W przypadku użycia atrybutu colspan informacja dotycząca liczby wymaganych komórek jest niepoprawna. Na przykład wartość colspan="2" jest liczona jako dwie komórki. Wartością domyślną jest 1. Wszystkie znaczniki fp*cell
headingstyle Opcjonalny atrybut określający style nagłówka używane w komórce. Wartością domyślną jest Normal. Wszystkie znaczniki fp*cell
scalepercent Opcjonalny atrybut określający skalowanie obrazu. Wartością domyślną jest 100. Aby uzyskać obraz o najwyższej jakości, należy utworzyć obraz około pięciokrotnie większy niż zamierzony. Następnie należy go przeskalować do zamierzonej wielkości. Jakość obrazów na papierze jest często lepsza niż na ekranie. Aby uzyskać standardową wielkość na ekranie, należy ustawić wartość scalepercent="100". fp:imagecell
Znacznik fp:complexcell ma następujące znaczniki.
Tabela 2. Znaczniki fp:complexcell
Nazwa Opis
fp:newline Wstawia podział wiersza.
fp:stringParam

fp:intParam

fp:checkboxParam

Wstawia zwykły tekst będący wynikiem wartościowania znacznika fp:*Param.
fp:text Wstawia zwykły tekst.

Atrybuty nagłówka

Znaczniki nagłówka mają dwa atrybuty obowiązkowe i dwa opcjonalne.
Tabela 3. Atrybuty znacznika fp:header
Atrybut Opis
cols Obowiązkowy atrybut określający liczbę i wielkość kolumn. Na przykład aby utworzyć tabelę z trzema kolumnami, w której trzecia kolumna jest większa od pozostałych, należy wpisać wartość cols="30,30,40".
height Obowiązkowy atrybut określający wysokość nagłówka. Ten atrybut ma wpływ wyłącznie na raporty PDF. Na przykład aby określić wysokość 3 cm, wpisz wartość height="100".
page Opcjonalny atrybut określający strony, na których nagłówek jest używany. Ten atrybut może mieć następujące wartości:
  • all: nagłówek jest używany na wszystkich stronach (wartość domyślna)
  • first: nagłówek jest używany tylko na pierwszej stronie
  • left: nagłówek jest używany na wszystkich lewych stronach
  • right: nagłówek jest używany na wszystkich prawych stronach
W przypadku atrybutu page obowiązują następujące reguły:
  • Dla pierwszej strony należy użyć atrybutu page="first". W przeciwnym razie należy użyć atrybutu page="right" lub page="all". Jeśli żadna z tych stron nie istnieje, nie należy używać nagłówka.
  • Dla lewych stron należy użyć atrybutu page="left". W przeciwnym razie należy użyć atrybutu page="all". Jeśli żadna z tych stron nie istnieje, nie należy używać nagłówka.
  • Dla prawych stron należy użyć atrybutu page="right". W przeciwnym razie należy użyć atrybutu page="all". Jeśli żadna z tych stron nie istnieje, nie należy używać nagłówka.
Wartość domyślna to all.
percentwidth Opcjonalny atrybut określający szerokość nagłówka tabeli. Wartością domyślną jest 100.
Poniższy nagłówek został wygenerowany w dokumencie PDF przy użyciu przykładowego znacznika 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>

Opinia