section (Section)
The section property controls the layout of content within a parent MiniPage.
In the Properties view, this property is the Section property in the Layout category.
This attribute of a Layout Node object specifies that the content of the node should print on its parent MiniPage at the location specified by this property.
Type: Enum.
When you select a MiniPage for a page header or footer, for example, you specify where the
container should be printed on its parent MiniPage by setting the section property. The report
output prints any headers and footers that you have set, based on priorities of each of these values:
- firstPageHeader
- The page header to be printed on the first page only. If this section is defined, subsequent page headers begin printing on the second page.
- anyPageHeader
- The page header for every page, unless separate odd and even page headers are defined.
- oddPageHeader
- Specific page header to be printed on odd pages. Has precedence over anyPageHeader.
- evenPageHeader
- Specific page header to be printed on even pages. Has precedence over anyPageHeader.
- firstPageFooter
- The page footer that prints on the first page only. If this section is defined, subsequent page footers begin printing on the second page.
- anyPageFooter
- The page footer for every page, unless separate odd and even page footers are defined.
- oddPageFooter
- Specific page footer to be printed on odd pages. Has precedence over anyPageFooter.
- evenPageFooter
- Specific page footer to be printed on even pages. Has precedence over anyPageFooter.
- lastPageFooter
- A page footer that prints on the last page only. For the last page, this node takes priority over oddPageFooter, evenPageFooter, or anyPageFooter nodes. A node with this section value set must be located as the last in the sibling list.
- itemSeparator
- Prints between each sibling element, as long as there is more than one element.
If you have an anyPageHeader and a firstPageHeader, for example, the anyPageHeader content prints only on the second and subsequent pages.
Important: If you set the section property for any node, the node may not be preceded in
its sibling list in the Report Structure tree by any nodes that do not have this property
set.
A layout node with a defined section attribute is also known as a named port. A layout node without a defined section attribute is also knows as a primary port.