Share via


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.

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.

See Also

Concepts

Designing for Image Output

Other Resources

Report Definition Language

Help and Information

Getting SQL Server 2005 Assistance