Skip to content

Commit 7b8b488

Browse files
github-actions[bot]KB Bottodorarabadzhiev
authored
Added new kb article full-page-rendering-background-image-reports (#1766)
* Added new kb article full-page-rendering-background-image-reports * Update full-page-rendering-background-image-reports.md --------- Co-authored-by: KB Bot <[email protected]> Co-authored-by: Todor Arabadzhiev <[email protected]>
1 parent 7d96f8b commit 7b8b488

File tree

1 file changed

+47
-0
lines changed

1 file changed

+47
-0
lines changed
Lines changed: 47 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,47 @@
1+
---
2+
title: Implementing Full Page Background Image Rendering in Reports
3+
description: Learn how to ensure full-page rendering in reports, including complete background images, regardless of content size.
4+
type: how-to
5+
page_title: Ensuring Full Page Background Image Display in Reports
6+
meta_title: Ensuring Full Page Background Image Display in Reports
7+
slug: full-page-rendering-background-image-reports
8+
tags: reporting, page-rendering, background-image, pdf, print-preview
9+
res_type: kb
10+
ticketid: 1694156
11+
---
12+
13+
## Environment
14+
15+
<table>
16+
<tbody>
17+
<tr>
18+
<td> Product </td>
19+
<td> Reporting </td>
20+
</tr>
21+
</tbody>
22+
</table>
23+
24+
## Description
25+
26+
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.
27+
28+
This knowledge base article also answers the following questions:
29+
- How to render a complete background image in PDF reports?
30+
- How to ensure full page rendering for reports with varying content?
31+
- How to use Watermarks and PageSettings in Telerik Reporting?
32+
33+
## Solution
34+
35+
To ensure the background image covers the entire page, use one of the following approaches:
36+
37+
* Use [Watermarks]({%slug telerikreporting/designing-reports/rendering-and-paging/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.
38+
* Alternatively, set the `PageSettings > Style > Background Image` property. This will render the image on the entire page.
39+
40+
Both above settings are respected only in hard pagination formats like PrintPreview or PDF.
41+
42+
This means that in Interactive View Mode of the Report Viewer (see [Interactive and Print Layouts]({%slug telerikreporting/using-reports-in-applications/display-reports-in-applications/interactive-vs.-print-layout%})), 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.
43+
44+
## See Also
45+
46+
* [Watermarks Documentation]({%slug telerikreporting/designing-reports/rendering-and-paging/watermarks%})
47+
* [Styling Report Items Documentation]({%slug telerikreporting/designing-reports/styling-reports/styling-report-items%})

0 commit comments

Comments
 (0)