Implementing Full Page Background Image Rendering in Reports
Environment
| Product | Reporting |
Description
I need to ensure the background image always covers the entire page of my report. Currently, a second page appears due to large text, but it only displays the background image up to the last line of the text. The same issue occurs when exporting the report to PDF, where the background image ends at the text content instead of covering the full page. I want the second page to match the size of the first page and fully display the background image.
This knowledge base article also answers the following questions:
- How to render a complete background image in PDF reports?
- How to ensure full page rendering for reports with varying content?
- How to use Watermarks and PageSettings in Telerik Reporting?
Solution
To ensure the background image covers the entire page, use one of the following approaches:
- Use Watermarks instead of setting the background image in the Style property of the Report or its Detail section. Watermarks are part of the PageSettings and are drawn on the entire page, ensuring the background appears fully even on pages with minimal data.
- Alternatively, set the
PageSettings > Style > Background Imageproperty. This will render the image on the entire page.
Both above settings are respected only in hard pagination formats like PrintPreview or PDF.
This means that in Interactive View Mode of the Report Viewer (see Interactive and Print Layouts), the background image/watermark won't be visible. To overcome this, you may switch the viewMode of your Viewer to PRINT_PREVIEW. The PageSettings, including Watermarks and Background Image, are respected in this mode.