![]() ![]() |
The MasterPage element is an abstract element that defines the basic properties of a page. The derived element, SimpleMasterPage, provides content that appears on the page. The master page implicitly defines a content area. In a single-column report, the content area is the area inside the margins.
The MasterPage element derives from ReportElement, but some of the attributes inherited from ReportElement have a special meaning. The Name property provides the name of the master page and is required. The page name must be unique within the design. Page name is used to create a page sequence, and to associate master pages with report elements.
Since a master page cannot extend another master page, the extends property is ignored.
All property dimensions, such as header and footer and the margins, are expressed in physical units. They do not support pixels or relative units, such as percent, em, or ex.
comments, customXml, extends, name, userProperties
None
The following sections describe the properties of the MasterPage element.
The amount of white space at the margins of each page.
The height of the page footer. This property is ignored in HTML output.
The height of the page header. This property is ignored in HTML output.
The height of a custom-sized page. This is a required property if the page type is Custom. This property only applies for custom page sizing.
The amount of white space at the left margin of each page.
The page orientation. The allowable values for this property are Portrait, Landscape and Auto. Auto is the default. The orientation property is ignored if pageType is set to Custom.
The following table itemizes the choices for this property.
The amount of white space at the right margin of each page.
Name of the style applied to this item. Master pages provide many style properties. The style properties are defined in the ROM Styles Specification. Except for the MasterPage element, all elements inherit their style properties from one of the following three places:
When you set a value for this property, that value overrides any inherited or shared style values.
The amount of white space at the top of each page.
The page size. The default is US Letter for the US locale and A4 for the rest of the world. BIRT sets the default when a new page is created in BIRT Report Designer. Every page must have a page type.
The following table itemizes the choices for the property.
The width of a page. This property is only used for a custom page size.
![]() ![]() |