Теги верхнего и нижнего колонтитулов

Можно определить верхний и нижний колонтитулы в шаблоне отчета с помощью тегов fp:header и fp:footer.
Теги верхнего и нижнего колонтитулов имеют подобные функции, и оба тега используют атрибут высоты: Наборы верхних и нижних колонтитулов должны совпадать. Например, если есть fp:header со значением страницы равным left, должен быть fp:footer с таким же значением страницы.

Теги верхнего колонтитула

Если тегов fp:header нет в шаблоне, верхний колонтитул не показывается в отчете. Верхний колонтитул представляет собой таблицу с набором ячеек. Число тегов верхнего колонтитула должно быть кратно числу столбцов. Если в атрибуте cols указано три столбца, число тегов в fp:header должно быть 3, 6, 9, 12 и т. д.
Тег fp:header определяет ячейку в верхнем колонтитуле:
  • fp:cell или fp: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: Набор текстов. Текст может быть обычным или stringParam с type="template/runtime/never/fetch". Этот тег является единственным тегом 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 Необязательный атрибут тег стиля верхнего колонтитула в ячейке. Значение по умолчанию: Обычный. Все теги fp*cell
scalepercent Необязательный атрибут масштабирования изображения. По умолчанию используется значение 100. Для того чтобы изображение имело наилучшее качество, создайте его приблизительно в пять раз больше предполагаемого размера. Затем уменьшите масштаб изображения до предполагаемого размера. Качество изображений на бумаге часто бывает выше, чем на мониторе. Для стандартного размера экрана scalepercent="100". fp:imagecell
Тег fp:*cell имеет следующие теги.
Табл. 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 применяются следующие правила:
  • Для первой страницы используется 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>

Комментарии