Report Items in Image Rendering
The Image rendering extension renders the layout of report items and data as a static image. How each item is rendered varies depending on the report item.
ReportItems
The items within the ReportItems element are rendered as described later in this topic. For each report item, the Name and Label sub-elements are ignored. The Top, Left, Height, Width, and ZIndex sub-elements determine how items are placed on the page. For more information about positioning, see Designing for Image Output.
Textbox
A text box is rendered as wrapped text inside of a rectangle. The following table describes how elements in the Textbox RDL element are rendered by the Image rendering extension.
| RDL element | Renders as |
|---|---|
Value |
Text with appropriate style properties. |
CanGrow |
If CanGrow is True, the text box expands vertically to fit the text. If CanGrow is False, the text is clipped. |
CanShrink |
If CanShrink is True, and the height of the text is smaller than the height of the text box, the text box is shrunk to fit. |
HideDuplicates |
The text in the text box is not rendered if the data is the same as the preceding record. The text is shown if it is in the first text box on the page. |
Image
The following table describes how elements in the Image RDL element are rendered by the Image rendering extension.
| RDL element | Renders as |
|---|---|
Value |
If the value of the Source RDL element is External, the image is retrieved from this URL and rendered. Otherwise, the image is retrieved from image data and rendered. If the image cannot be retrieved, a red X image is displayed. |
Sizing |
The appearance of the image is determined by the Sizing RDL element. If the value of Sizing is Clip, the image is sized to match the output resolution, and then is clipped at the specified height and width. If the value is Fit, the image is sized to the specified height and width. If the value is FitProportional, the image is sized to the specified height or width, keeping the original proportion of the image. If the value is AutoSize, the image is sized to match the output resolution, ignoring height and width. |
Line
The Line element is rendered with all the appropriate style properties.
Rectangle
The Rectangle element is rendered with all the appropriate style properties. The contents are drawn inside the rectangle, and the rectangle grows to accommodate its contents.
Subreport
A subreport is rendered by the Image rendering extension. Page breaks within a subreport are rendered as though the subreport were a rectangle. If the subreport does not run, an error displays in place of the subreport.
BackgroundImage
Repeated background images are repeated within the containing item. Images are cropped at the edge of the containing item. Background images are drawn under the items in the container.
BorderStyle
Borders are drawn around an item as specified in the Top, Right, Left, and Bottom elements for the various border properties. The size of the spacing for dotted and dashed spacing is the same regardless of resolution.
When borders are drawn, half of the border is drawn inside the item, and half is drawn outside an item. For example, a text box with a border width of 4 pixels will display with 2 pixels of the border inside the text box and 2 pixels of the border outside the text box.
Fonts
Because the report is rendered on the server, the fonts used in the report must also reside on the server. If the font does not exist on the server, the GenericSerif GDI+ font is used. If the value for the FontWeight element is 700, 800, 900, Bold, or Bolder, the font is rendered as bold.
Padding
Text is positioned within a report item based on the values of the PaddingLeft, PaddingRight, PaddingTop, and PaddingBottom elements. The space for the padding begins at the edges of the box, not counting borders. If the padding is less than half the border width, the border overlaps the text.
TextDecoration
In the TextDecoration element, a value of Underline displays as a line beneath the text. A value of LineThrough displays as a strikeout. Overline is not supported.