Data Regions in Image Rendering
The Image rendering extension renders the layout of data regions and the data contained within them as a static image. How each data region is rendered varies depending on the data region.
Matrix
The following table describes how the elements in the Matrix RDL element are rendered by the Image rendering extension.
| RDL element | Renders as |
|---|---|
KeepTogether |
If the KeepTogether property for the list is True, all cells of a matrix are kept together, unless they contain a page break. |
NoRows |
Text in place of the matrix if the matrix contains no rows. The text is rendered in a text box. Page break properties are ignored, and style properties for the matrix are applied to the text. If no text is specified in NoRows, then no matrix or text is rendered. |
PageBreakAtStart |
The matrix is displayed on a new page. |
PageBreakAtEnd |
Items below the matrix are displayed on a new page. |
Corner
Items in the corner that have a width or height of 100 percent are sized to fill the corner. Otherwise, they are clipped if they do not fit within the corner.
MatrixColumn
The contents of the MatrixColumn element are rendered inside a cell. If the width or height is 100 percent, the items in the cell are sized to fit. If they do not fit within the cell, the items within the cell are clipped. If the matrix contains a page break, column headers are repeated on each page on which the matrix appears.
MatrixRow
The contents of the MatrixRow element are rendered inside a cell. If the width or height is 100 percent, the items in the cell are sized to fit. If they do not fit within the cell, the items within the cell are clipped. If the matrix contains a page break, row headers are repeated on each page on which the matrix appears.
Subtotal
Subtotals are rendered as a text box. Styles for the matrix are applied to this text box.
MatrixCell
Items within the MatrixCell element are rendered inside a cell. Items with percentage widths or heights are sized to the cell; otherwise, the contents of the cell can increase the size of the cell.
The following table describes how the elements in the MatrixCell RDL element are rendered by the Image rendering extension.
| RDL element | Renders as |
|---|---|
Height |
Determines the minimum height of the cell. |
Width |
Determines the minimum width of the cell. |
Table
A table is rendered as a grid. If the table has borders, they are drawn around the table. The following table describes how the elements in the Table RDL element are rendered by the Image rendering extension.
| RDL element | Renders as |
|---|---|
KeepTogether |
If the KeepTogether property for the table is True, all rows of the table are kept together, unless they contain a page break. |
NoRows |
Text in place of the table if the table contains no rows. The text is rendered in a text box. Page break properties are ignored, and style properties for the table are applied to the text. If no text is specified in NoRows, no table or text is rendered. |
PageBreakAtStart |
The table is displayed on a new page. |
PageBreakAtEnd |
Items below the table are displayed on a new page. |
TableColumn
The following table describes how the elements in the TableColumn RDL element are rendered by the Image rendering extension.
| RDL element | Renders as |
|---|---|
Width |
Determines the minimum width of the column. |
Header and Footer
The table Header and Footer elements are rendered as rows of rectangles that contain the report items for the rows. The following table describes how the elements in the Header and Footer RDL elements are rendered by the Image rendering extension.
| RDL element | Renders as |
|---|---|
RepeatOnNewPage |
If the table spans multiple pages, repeats the row on each page. Page breaks within a header or footer on a new page are ignored. |
TableRow
The TableRow element is rendered as a row of rectangles that contain the report items for the row. The following table describes how the elements in the TableRow RDL element are rendered by the Image rendering extension.
| RDL element | Renders as |
|---|---|
Height |
Determines the minimum height of the row. |
TableGroup
The TableGroup element defines a group in a table. The Header element is rendered first, followed by the instances of TableRow that contain details, and finally the Footer element. If there is no room on the page for the header and one row below it, the header is moved to the next page. If there is no room on the page for the footer and one row above it, those two rows are moved to the next page.
TableCell
Items within the TableCell element are rendered inside a cell. If the contents of a cell do not fit within the cell, the contents of the cell can increase the size of the cell.
Chart
The following table describes how the elements in the Chart RDL element are rendered by the Image rendering extension.
| RDL element | Renders as |
|---|---|
KeepTogether |
A chart is always kept together. |
NoRows |
Text in place of the chart if the chart contains no rows. The text is rendered in a text box. Page break properties are ignored, and style properties for the chart are applied to the text. If no text is specified in NoRows, no chart or text is rendered. |
PageBreakAtStart |
The chart is displayed on a new page. |
PageBreakAtEnd |
Items below the chart are displayed on a new page. |
List
The following table describes how the elements in the List RDL element are rendered by the Image rendering extension.
| RDL element | Renders as |
|---|---|
KeepTogether |
If the KeepTogether property for the list is True, all repeating instances of the list are kept together, unless the list contains a page break. |
NoRows |
Text in place of the list if the list contains no rows. The text is rendered in a text box. Page break properties are ignored, and style properties for the list are applied to the text. If no text is specified in NoRows, no list or text is rendered. |
PageBreakAtStart |
The list is displayed on a new page. |
PageBreakAtEnd |
Items below the list are displayed on a new page. |
The border of the list and the items inside the list are also rendered.
Grouping
The following table describes how the elements in the Grouping RDL element are rendered by the Image rendering extension.
| RDL element | Renders as |
|---|---|
PageBreakAtStart |
The group is displayed on a new page. |
PageBreakAtEnd |
Groups and items below the group are displayed on a new page. |
RepeatWith
The item is repeated with the data region on each page that the data region appears. The position of the item is relative to the position of the data region.