diff --git a/reporting-for-desktop/articles/report-designer/report-designer-for-winforms/add-extra-information/add-watermarks-to-a-report.md b/reporting-for-desktop/articles/report-designer/report-designer-for-winforms/add-extra-information/add-watermarks-to-a-report.md index 62cfc1686f..ee7c96a5a0 100644 --- a/reporting-for-desktop/articles/report-designer/report-designer-for-winforms/add-extra-information/add-watermarks-to-a-report.md +++ b/reporting-for-desktop/articles/report-designer/report-designer-for-winforms/add-extra-information/add-watermarks-to-a-report.md @@ -3,34 +3,132 @@ title: Add Watermarks to a Report --- # Add Watermarks to a Report -This tutorial describes how to add watermarks to a report and use preprinted forms. +DevExpress Reporting allows you to display text and picture watermarks on report pages. You can also specify an expression that assigns different watermarks to pages. + +* How to add watermarks. + +* How to specify watermark settings. + +* How to use pre-printed forms. ![eurd-win-add-watermarks-result](../../../../images/eurd-win-add-watermarks-result.png) ## Add a Watermark to a Report -To add a watermark to a report, do the following. -1. Switch to the [toolbar](../report-designer-tools/toolbar.md)'s **Page** page and press **Watermark**. +Switch to the [toolbar](../report-designer-tools/toolbar.md)'s **Page** page and press **Watermark**. - ![eurd-win-add-watermarks-use-toolbox](../../../../images/eurd-win-add-watermarks-use-toolbox.png) -2. In the invoked **Watermark** dialog, select either the **Text Watermark** or **Picture Watermark** tab, depending on the type of watermark you wish to add. - - For a text watermark, specify the text, direction and font options. - - ![eurd-win-watermark-editor](../../../../images/eurd-win-watermark-editor.png) +![eurd-win-add-watermarks-use-toolbox](../../../../images/eurd-win-add-watermarks-use-toolbox.png) + +In the invoked **Watermark** dialog, select either the **Text Watermark** or **Picture Watermark** tab, depending on the type of watermark you wish to add. + +## Specify Text Watermark Settings + +Specify the following settings: - For a picture watermark, you need to specify an image. To do this, click the ellipsis button for the **Load image** option. +![eurd-win-watermark-editor](../../../../images/eurd-win-watermark-editor.png) - ![eurd-win-watermark-editor-picture](../../../../images/eurd-win-watermark-editor-picture.png) +* Text + + The watermark’s text. + +* Direction + + The incline of the watermark’s text. + +* Font + + The font of the watermark’s text. + +* Color + + The foreground color of the watermark’s text. + +* Size + + The size of the watermark’s text. + +* Bold + + Formats the watermark’s text as bold. + +* Italic + + Formats the watermark’s text as italic. + +* Position + + Specifies whether a watermark should be printed behind or in front of page content. + +* Transparency + + The transparency of the watermark’s text. + +* Id + + The unique identifier of a watermark used to specify the watermark in the WatermarkId property (See the Manage Watermark Collection section for details). + +* Page Range + + The range of pages which contain a watermark. + +Click **OK** to add a watermark to the watermark collection. The added watermark is automatically displayed in the report in Preview mode. + +> [!NOTE] +> A report can display only one watermark on a report page. + +## Specify Picture Watermark Settings + +Specify an image. Click the **Load image** option’s **Browse** button. + +![eurd-win-watermark-editor-picture](../../../../images/eurd-win-watermark-editor-picture.png) - In the invoked **Select Picture** dialog, select the file containing the image that you wish to use as a watermark and click **Open**. Next, specify the size mode and alignment options for the picture. +In the invoked **Select Picture** dialog, select the file containing the image that you wish to use as a watermark and click **Open**. - Additionally, for both textual and picture watermarks, you can adjust the transparency, position (in front of or behind the document content), and the page range in which the watermark will be printed. +![eud-select-picture-dialog](../../../../images/eud-select-picture-dialog.png) + +Specify the following picture options: + +![eud-specify-picture-watermark-settings](../../../../images/eud-specify-picture-watermark-settings.png) + +* Size Mode + + The mode in which a picture watermark is displayed. + +* Tiling + + Specifies whether a picture watermark should be tiled. + +* Horizontal Alignment - > [!NOTE] - > The **Transparency** property is unavailable when you specify an SVG image. + Specifies the horizontal alignment of the watermark. + +* Vertical Alignment + + Specifies the vertical alignment of the watermark. + +* Position + + Specifies whether a watermark should be printed behind or in front of page content. + +* Transparency + + The transparency of the watermark’s image. The **Transparency** property is unavailable when you specify an SVG image. + +* Id + + The unique identifier of a watermark used to specify the watermark in the WatermarkId property (See the Manage Watermark Collection section for details). + +* Page Range + + The range of pages which contain a watermark. + +> [!NOTE] +> A report can display only one watermark on a report page. + +Click **OK** to add a watermark to the watermark collection. The added watermark is automatically displayed in the report in Preview mode. + +### Supply a Preprinted Form -## Supply a Preprinted Form You can use a picture watermark as a template, to display an image of the preprinted form on the report's body at design time. To display a watermark at design time, switch to the [toolbar](../report-designer-tools/toolbar.md)'s **View** page and activate **Watermark**. @@ -43,4 +141,71 @@ The following image illustrates a report with a watermark shown at design-time t Place report controls on the report's body according to the layout of the preprinted form. -![eurd-win-add-a-template-watermark-result](../../../../images/eurd-win-add-a-template-watermark-result.png) \ No newline at end of file +![eurd-win-add-a-template-watermark-result](../../../../images/eurd-win-add-a-template-watermark-result.png) + +### Supported Image Formats + +A picture watermark supports the following formats: + +* BMP +* JPG / JPEG / JPE / JFIF +* GIF +* TIF / TIFF +* PNG +* ICO +* DIB +* RLE +* EMF / WMF +* SVG + +## Combine Text and a Picture in One Watermark + +You can display both text and a picture in one watermark. + +For example, create a watermark and specify its text and picture settings. + +Set position of the text to In front: + +![Position In front](../../../../images/infront-text-position.png) + +Set position of the picture to Behind: + +![Position Behind](../../../../images/behind-image-position.png) + +As a result, the image is displayed behind the table, while the text is in front of the content: + +![Display text and image watermarks in one page](../../../../images/watermark-text-infront-image-behind.png) + +## Display a Specific Watermark in a Report + +**Watermark Id** allows you to specify a watermark from the collection to display in the report. This property has a priority over the watermark’s **Page Range** property. + +Create two watermarks in the Watermarks collection editor. + +![Create two watermarks](../../../../images/add-watermarks-in-the-collection-editor.png) + +Set Watermark Id to Watermark2 (the Id option's value) + +![Display the second watermark in the collection](../../../../images/propery-grid-watermark-id.png) + +The image below shows the result. + +![Display specific watermark](../../../../images/display-specific-watermark-example.png) + +## Display Watermarks According to the Specified Condition + +Bind **Watermark Id** to an expression to apply watermarks stored in the collection to specific report pages. + +Create the “First page watermark”, “Even page watermark”, and “Odd page watermark” watermarks with the following settings: + +![Create three watermarks](../../../../images/bind-watermarks-to-expression--ui.png) + +Specify the expression in the report’s WatermarkId property: + +`Iif([Arguments.PageIndex]=0,'Watermark_0',Iif([Arguments.PageIndex]%2=0,'Watermark_1','Watermark_2'))` + +![Specify the binding expression](../../../../images/specify-watermark-expression-in-the-expression-editor.png) + +The image below shows the result. + +![Display different watermarks](../../../../images/watermarks-expression-example.png) \ No newline at end of file diff --git a/reporting-for-desktop/articles/report-designer/report-designer-for-winforms/provide-interactivity.md b/reporting-for-desktop/articles/report-designer/report-designer-for-winforms/provide-interactivity.md index 03621579ae..da053dfaaf 100644 --- a/reporting-for-desktop/articles/report-designer/report-designer-for-winforms/provide-interactivity.md +++ b/reporting-for-desktop/articles/report-designer/report-designer-for-winforms/provide-interactivity.md @@ -6,5 +6,6 @@ title: Provide Interactivity The documents in this section provide information on the interactive features that enable report customization in Print Preview. * [Create Drill-Down Reports](provide-interactivity/create-drill-down-reports.md) +* [Create Drill-Through Reports](provide-interactivity/create-drill-through-reports.md) * [Sort a Report in Print Preview](provide-interactivity/sort-a-report-in-print-preview.md) * [Content Editing in Print Preview](provide-interactivity/edit-content-in-print-preview.md) diff --git a/reporting-for-desktop/articles/report-designer/report-designer-for-winforms/provide-interactivity/create-drill-through-reports.md b/reporting-for-desktop/articles/report-designer/report-designer-for-winforms/provide-interactivity/create-drill-through-reports.md new file mode 100644 index 0000000000..39351f3f4c --- /dev/null +++ b/reporting-for-desktop/articles/report-designer/report-designer-for-winforms/provide-interactivity/create-drill-through-reports.md @@ -0,0 +1,53 @@ +--- +title: Create Drill-Through Reports +--- +# Create Drill-Through Reports + +Follow this tutorial to create a _drill-through report_ (a user can click a Category entry to invoke a detail report with Products). This report type keeps the original report compact while still allowing access to more detailed information. + +The tutorial involves two main steps: + +- Add a master-detail relationship between "Categories" and "Products" reports within one project. +- Use detail report parameters to filter records based on the selected category. + +![Drill-Through report](../../../../images/drill-through-result.png) + +## Add a Master-Detail Relationship between Reports + +Define a master-detail relationship between _Category_ and _Product_ reports within a single project: + +- Select the XRControl's element (**Table Cell** in this example) in the main report. +- Set its **Action** property to **NavigateToReportAction**. +- Assign the **ReportSource** property to a detail report instance. + +![Specify the Navigate to Report action](../../../../images/specify-navigate-to-report-action.png) + +If you switch to **Preview**, you can click on a _Category_ value in the table. The **Preview** window navigates to the detail report that contains all _Product_ entries. The next step explains how to filter this list. + +![Drill-Through report preview](../../../../images/detail-report-navigation.png) + +A Breadcrumb control automatically appears below the Document Viewer toolbar and allows you to navigate back to the original report. + +![Breadcrumb navigation](../../../../images/breadcrumb-control-navigation.png) + +## Specify Parameter Binding to Display Required Data + +You can specify parameters during detail report navigation. Use the **Parameter Bindings** property to limit displayed records (such as products) to a selected category. + +To invoke the **Parameter Binding Collection Editor**, click the ellipsis button in the **Parameter Bindings** property. Within this editor, click the **Sync** button to automatically obtain detail report parameters and set **Binding** to the data field or parameter of the original report. + +![Parameter Binding Collection Editor](../../../../images/parameter-binding-editor.png) + +Set **Binding** to the _CategoryID_ field. + +![Specify Parameter Binding](../../../../images/specify-binding.png) + +Set the following filter string in the detail report to display product records for the selected category. + +![Set filter string](../../../../images/set-filter-string.png) + +## Result + +Switch to **Preview** and click on a category entry in the master report. The **Preview** navigates to the detail report that displays only products related to the selected category. + +![Drill-Through report](../../../../images/drill-through-result.png) \ No newline at end of file diff --git a/reporting-for-desktop/articles/report-designer/report-designer-for-winforms/use-expressions/functions-in-expressions.md b/reporting-for-desktop/articles/report-designer/report-designer-for-winforms/use-expressions/functions-in-expressions.md index e8cb611341..ee21d5ba0d 100644 --- a/reporting-for-desktop/articles/report-designer/report-designer-for-winforms/use-expressions/functions-in-expressions.md +++ b/reporting-for-desktop/articles/report-designer/report-designer-for-winforms/use-expressions/functions-in-expressions.md @@ -13,6 +13,7 @@ This topic lists the functions that you can use in an [expression](expressions-o | Avg(Value) | Evaluates the average of the values in the collection. | [Products].Avg([UnitPrice]) | | Count() | Returns the number of objects in a collection. | [Products].Count() | | Exists() | Determines whether the object exists in the collection. | [Categories][[CategoryID] == 7].Exists() | +| Join() | Concatenates all Expression values in the _Collection_ based on the specified _Condition_ (optional) into a single string separated by the specified _Separator_ (optional). If you do not specify a _Separator_, the function uses a comma.
The function has the following overloads:
`[Collection][Condition].Join(Expression)`
`[Collection][Condition].Join(Expression, Separator)`| The following expression concatenates _CompanyName_ field values within a report grouped by the _CategoryID_ field into a single string separated by a semicolon:
`[][[CategoryID] == [^.CategoryID]].Join([CompanyName], ';')`| | Max(Value) | Returns the maximum expression value in a collection. | [Products].Max([UnitPrice]) | | Min(Value) | Returns the minimum expression value in a collection. | [Products].Min([UnitPrice]) | | Single() | Returns an object if it is the only element in a collection. | [Accounts].Single() is not null | diff --git a/reporting-for-desktop/articles/report-designer/report-designer-for-wpf/creating-reports/adding-details-about-a-report/create-or-modify-watermarks-of-a-report.md b/reporting-for-desktop/articles/report-designer/report-designer-for-wpf/creating-reports/adding-details-about-a-report/create-or-modify-watermarks-of-a-report.md index fa737e6bfc..a85b16de66 100644 --- a/reporting-for-desktop/articles/report-designer/report-designer-for-wpf/creating-reports/adding-details-about-a-report/create-or-modify-watermarks-of-a-report.md +++ b/reporting-for-desktop/articles/report-designer/report-designer-for-wpf/creating-reports/adding-details-about-a-report/create-or-modify-watermarks-of-a-report.md @@ -1,28 +1,152 @@ --- title: Create or Modify Watermarks of a Report -author: Anna Gubareva legacyId: 116390 --- # Create or Modify Watermarks of a Report -This document describes how to add a text _watermark_ in a report, or turn a picture into a report's _background_. Note that watermarks are visible only in the [Preview](../../document-preview.md) mode. - -To create a new watermark in a report (or to modify the existing one), do the following. -1. Right-click the report, and in the invoked context menu, click the **Watermark...** link. - - ![EUD_WpfReportDesigner_Watermark_1](../../../../../images/img123768.png) -2. In the **Text Watermark** tab of the invoked **Watermark** dialog, enter the watermark's text and specify the required properties such as the **Direction**, **Transparency**, **Color**, etc. - - ![EUD_WpfReportDesigner_Watermark_2](../../../../../images/img123769.png) -3. Then, switch to the **Picture Watermark** tab to load the image to be used as a watermark. To do this, click the ellipsis button for the **Image** property. In the invoked dialog, select the file containing the image that you wish to load and click **Open**. - - ![EUD_WpfReportDesigner_Watermark_3](../../../../../images/img123770.png) -4. Next, define the picture's properties, such as the **Size mode**, **Alignment** , **Transparency**, etc. - - ![EUD_WpfReportDesigner_Watermark_4](../../../../../images/img123771.png) -5. In addition, you can select a watermark position behind or in front of the document, and specify the page range in which the watermark will be printed. - - As you can see, it is possible to use both textual and image watermarks simultaneously. - -The report with watermark is now ready. Switch to the [Print Preview](../../document-preview.md) tab and view the result. - -![EUD_WpfReportDesigner_Watermark_Result](../../../../../images/img123772.png) \ No newline at end of file + +DevExpress Reporting allows you to display text and picture watermarks on report pages. You can also specify an expression that assigns different watermarks to pages. + +* How to add watermarks. + +* How to specify watermark settings. + +* How to use pre-printed forms. + +## Add a Watermark to a Report + +Right-click the report, and in the invoked context menu, click the **Watermark...** link. In the invoked **Watermarks** dialog, add a new watermark and click either the **Text Watermark** or **Picture Watermark** tab, depending on the type of watermark you wish to add. + +## Specify Text Watermark Settings + +Specify the following settings: + +![EUD_WpfReportDesigner_Watermark_2](../../../../../images/img123769.png) + +* Text + + The watermark’s text. + +* Direction + + The incline of the watermark’s text. + +* Font + + The font of the watermark’s text. + +* Color + + The foreground color of the watermark’s text. + +* Size + + The size of the watermark’s text. + +* Bold + + Formats the watermark’s text as bold. + +* Italic + + Formats the watermark’s text as italic. + +* Position + + Specifies whether a watermark should be printed behind or in front of page content. + +* Transparency + + The transparency of the watermark’s text. + +* Id + + The unique identifier of a watermark used to specify the watermark in the WatermarkId property (See the Manage Watermark Collection section for details). + +* Page Range + + The range of pages which contain a watermark. + +Click **OK** to add a watermark to the watermark collection. The added watermark is automatically displayed in the report in Preview mode. + +> [!NOTE] +> A report can display only one watermark on a report page. + +## Specify Picture Watermark Settings + +Specify an image. Click the **Load image** option’s **Image** button. + +In the invoked **Select Picture** dialog, select the file containing the image that you wish to use as a watermark and click **Open**. + +Specify the following picture options: + +![EUD_WpfReportDesigner_Watermark_3](../../../../../images/img123770.png) + +* Size Mode + + The mode in which a picture watermark is displayed. + +* Tiling + + Specifies whether a picture watermark should be tiled. + +* Horizontal Alignment + + Specifies the horizontal alignment of the watermark. + +* Vertical Alignment + + Specifies the vertical alignment of the watermark. + +* Position + + Specifies whether a watermark should be printed behind or in front of page content. + +* Transparency + + The transparency of the watermark’s image. The **Transparency** property is unavailable when you specify an SVG image. + +* Id + + The unique identifier of a watermark used to specify the watermark in the WatermarkId property (See the Manage Watermark Collection section for details). + +* Page Range + + The range of pages which contain a watermark. + +Click **OK** to add a watermark to the watermark collection. The added watermark is automatically displayed in the report in Preview mode. + +> [!NOTE] +> A report can display only one watermark on a report page. + +## Combine Text and a Picture in One Watermark + +You can display both text and a picture in one watermark. + +For example, create a watermark and specify its text and picture settings. Set position of the text to In front and the position of the picture to Behind. + +As a result, in [Preview](../../document-preview.md) mode the image is displayed behind the table, while the text is in front of the content: + +![EUD_WpfReportDesigner_Watermark_Result](../../../../../images/img123772.png) + +## Display a Specific Watermark in a Report + +The report's **Watermark Id** property allows you to specify a watermark from the collection to display in the report by the watermark's unique identifier (the Id option's value of the watermark). This property has a priority over the watermark’s **Page Range** property. + +## Display Watermarks According to the Specified Condition + +Bind **Watermark Id** to an expression to apply watermarks stored in the collection to specific report pages. + +Create the “First page watermark”, “Even page watermark”, and “Odd page watermark” watermarks with the following settings: + +![Create three watermarks](../../../../../images/wpf-bind-watermarks-to-expression--ui.png) + +Specify the expression in the report’s **Watermark Id** property: + +`Iif([Arguments.PageIndex]=0,'Watermark1',Iif([Arguments.PageIndex]%2=0,'Watermark2','Watermark3'))` + +![Specify the binding expression](../../../../../images/wpf-specify-watermark-expression-in-the-expression-editor.png) + +The image below shows the result. + +![Display different watermarks](../../../../../images/wpf-watermarks-expression-example.png) + diff --git a/reporting-for-desktop/images/img123768.png b/reporting-for-desktop/images/.png similarity index 100% rename from reporting-for-desktop/images/img123768.png rename to reporting-for-desktop/images/.png diff --git a/reporting-for-desktop/images/add-watermarks-in-the-collection-editor.png b/reporting-for-desktop/images/add-watermarks-in-the-collection-editor.png new file mode 100644 index 0000000000..2bfe9c91f5 Binary files /dev/null and b/reporting-for-desktop/images/add-watermarks-in-the-collection-editor.png differ diff --git a/reporting-for-desktop/images/behind-image-position.png b/reporting-for-desktop/images/behind-image-position.png new file mode 100644 index 0000000000..1dd5805c5e Binary files /dev/null and b/reporting-for-desktop/images/behind-image-position.png differ diff --git a/reporting-for-desktop/images/bind-watermarks-to-expression--ui.png b/reporting-for-desktop/images/bind-watermarks-to-expression--ui.png new file mode 100644 index 0000000000..84ace8855f Binary files /dev/null and b/reporting-for-desktop/images/bind-watermarks-to-expression--ui.png differ diff --git a/reporting-for-desktop/images/breadcrumb-control-navigation.png b/reporting-for-desktop/images/breadcrumb-control-navigation.png new file mode 100644 index 0000000000..cdf4269f0c Binary files /dev/null and b/reporting-for-desktop/images/breadcrumb-control-navigation.png differ diff --git a/reporting-for-desktop/images/detail-report-navigation.png b/reporting-for-desktop/images/detail-report-navigation.png new file mode 100644 index 0000000000..45f3ecd26d Binary files /dev/null and b/reporting-for-desktop/images/detail-report-navigation.png differ diff --git a/reporting-for-desktop/images/display-specific-watermark-example.png b/reporting-for-desktop/images/display-specific-watermark-example.png new file mode 100644 index 0000000000..57a9b6b70f Binary files /dev/null and b/reporting-for-desktop/images/display-specific-watermark-example.png differ diff --git a/reporting-for-desktop/images/drill-through-result.png b/reporting-for-desktop/images/drill-through-result.png new file mode 100644 index 0000000000..79536712df Binary files /dev/null and b/reporting-for-desktop/images/drill-through-result.png differ diff --git a/reporting-for-desktop/images/eud-select-picture-dialog.png b/reporting-for-desktop/images/eud-select-picture-dialog.png new file mode 100644 index 0000000000..ddae9ca7f8 Binary files /dev/null and b/reporting-for-desktop/images/eud-select-picture-dialog.png differ diff --git a/reporting-for-desktop/images/eud-specify-picture-watermark-settings.png b/reporting-for-desktop/images/eud-specify-picture-watermark-settings.png new file mode 100644 index 0000000000..c6e0cb319b Binary files /dev/null and b/reporting-for-desktop/images/eud-specify-picture-watermark-settings.png differ diff --git a/reporting-for-desktop/images/eurd-win-watermark-editor-picture.png b/reporting-for-desktop/images/eurd-win-watermark-editor-picture.png index 4df05cc8df..a42150f380 100644 Binary files a/reporting-for-desktop/images/eurd-win-watermark-editor-picture.png and b/reporting-for-desktop/images/eurd-win-watermark-editor-picture.png differ diff --git a/reporting-for-desktop/images/eurd-win-watermark-editor.png b/reporting-for-desktop/images/eurd-win-watermark-editor.png index 3e75bb5aed..59420f2cf0 100644 Binary files a/reporting-for-desktop/images/eurd-win-watermark-editor.png and b/reporting-for-desktop/images/eurd-win-watermark-editor.png differ diff --git a/reporting-for-desktop/images/img123769.png b/reporting-for-desktop/images/img123769.png index 55a5910aec..3a288b7651 100644 Binary files a/reporting-for-desktop/images/img123769.png and b/reporting-for-desktop/images/img123769.png differ diff --git a/reporting-for-desktop/images/img123770.png b/reporting-for-desktop/images/img123770.png index b04ce47ca6..d1144164e1 100644 Binary files a/reporting-for-desktop/images/img123770.png and b/reporting-for-desktop/images/img123770.png differ diff --git a/reporting-for-desktop/images/img123771.png b/reporting-for-desktop/images/img123771.png deleted file mode 100644 index cd82670203..0000000000 Binary files a/reporting-for-desktop/images/img123771.png and /dev/null differ diff --git a/reporting-for-desktop/images/img123772.png b/reporting-for-desktop/images/img123772.png index 96b5322e3f..bf9a54432d 100644 Binary files a/reporting-for-desktop/images/img123772.png and b/reporting-for-desktop/images/img123772.png differ diff --git a/reporting-for-desktop/images/infront-text-position.png b/reporting-for-desktop/images/infront-text-position.png new file mode 100644 index 0000000000..688393edb2 Binary files /dev/null and b/reporting-for-desktop/images/infront-text-position.png differ diff --git a/reporting-for-desktop/images/parameter-binding-editor.png b/reporting-for-desktop/images/parameter-binding-editor.png new file mode 100644 index 0000000000..6553a5be72 Binary files /dev/null and b/reporting-for-desktop/images/parameter-binding-editor.png differ diff --git a/reporting-for-desktop/images/propery-grid-watermark-id.png b/reporting-for-desktop/images/propery-grid-watermark-id.png new file mode 100644 index 0000000000..8e68fc2aea Binary files /dev/null and b/reporting-for-desktop/images/propery-grid-watermark-id.png differ diff --git a/reporting-for-desktop/images/set-filter-string.png b/reporting-for-desktop/images/set-filter-string.png new file mode 100644 index 0000000000..ceba9f4de1 Binary files /dev/null and b/reporting-for-desktop/images/set-filter-string.png differ diff --git a/reporting-for-desktop/images/specify-binding.png b/reporting-for-desktop/images/specify-binding.png new file mode 100644 index 0000000000..1dc52c211d Binary files /dev/null and b/reporting-for-desktop/images/specify-binding.png differ diff --git a/reporting-for-desktop/images/specify-navigate-to-report-action.png b/reporting-for-desktop/images/specify-navigate-to-report-action.png new file mode 100644 index 0000000000..bf4ecaf5e0 Binary files /dev/null and b/reporting-for-desktop/images/specify-navigate-to-report-action.png differ diff --git a/reporting-for-desktop/images/specify-watermark-expression-in-the-expression-editor.png b/reporting-for-desktop/images/specify-watermark-expression-in-the-expression-editor.png new file mode 100644 index 0000000000..dd6ac4cf5f Binary files /dev/null and b/reporting-for-desktop/images/specify-watermark-expression-in-the-expression-editor.png differ diff --git a/reporting-for-desktop/images/watermark-text-infront-image-behind.png b/reporting-for-desktop/images/watermark-text-infront-image-behind.png new file mode 100644 index 0000000000..6a52497a0e Binary files /dev/null and b/reporting-for-desktop/images/watermark-text-infront-image-behind.png differ diff --git a/reporting-for-desktop/images/watermarks-expression-example.png b/reporting-for-desktop/images/watermarks-expression-example.png new file mode 100644 index 0000000000..9cc46cf6a0 Binary files /dev/null and b/reporting-for-desktop/images/watermarks-expression-example.png differ diff --git a/reporting-for-desktop/images/wpf-bind-watermarks-to-expression--ui.png b/reporting-for-desktop/images/wpf-bind-watermarks-to-expression--ui.png new file mode 100644 index 0000000000..da96583387 Binary files /dev/null and b/reporting-for-desktop/images/wpf-bind-watermarks-to-expression--ui.png differ diff --git a/reporting-for-desktop/images/wpf-specify-watermark-expression-in-the-expression-editor.png b/reporting-for-desktop/images/wpf-specify-watermark-expression-in-the-expression-editor.png new file mode 100644 index 0000000000..e305a13f20 Binary files /dev/null and b/reporting-for-desktop/images/wpf-specify-watermark-expression-in-the-expression-editor.png differ diff --git a/reporting-for-desktop/images/wpf-watermarks-expression-example.png b/reporting-for-desktop/images/wpf-watermarks-expression-example.png new file mode 100644 index 0000000000..4bd8aeec24 Binary files /dev/null and b/reporting-for-desktop/images/wpf-watermarks-expression-example.png differ diff --git a/reporting-for-desktop/toc.yml b/reporting-for-desktop/toc.yml index 9a47229cd1..30685148f8 100644 --- a/reporting-for-desktop/toc.yml +++ b/reporting-for-desktop/toc.yml @@ -404,6 +404,8 @@ items: - name: Create Drill-Down Reports href: articles/report-designer/report-designer-for-winforms/provide-interactivity/create-drill-down-reports.md + - name: Create Drill-Through Reports + href: articles/report-designer/report-designer-for-winforms/provide-interactivity/create-drill-through-reports.md - name: Sort a Report in Print Preview href: articles/report-designer/report-designer-for-winforms/provide-interactivity/sort-a-report-in-print-preview.md - name: Edit Content in Print Preview diff --git a/reporting-for-web/articles/report-designer/add-extra-information/add-watermarks-to-a-report.md b/reporting-for-web/articles/report-designer/add-extra-information/add-watermarks-to-a-report.md index ffff8d4792..29fa64266d 100644 --- a/reporting-for-web/articles/report-designer/add-extra-information/add-watermarks-to-a-report.md +++ b/reporting-for-web/articles/report-designer/add-extra-information/add-watermarks-to-a-report.md @@ -1,38 +1,118 @@ --- title: Add Watermarks to a Report -author: Anna Vekhina --- # Add Watermarks to a Report -This tutorial describes how to add watermarks to a report and use preprinted forms. +DevExpress Reporting allows you to display text and picture watermarks on report pages. You can also specify an expression that assigns different watermarks to pages. + +This tutorial includes information about the following tasks: + +* How to add watermarks. + +* How to specify watermark settings. + +* How to use pre-printed forms. ![](../../../images/eurd-web-add-watermarks-result.png) ## Add a Watermark to a Report -To add a watermark to a report, do the following. - -1. Switch to the [Properties](../report-designer-tools/ui-panels/properties-panel.md) panel and expand the **Watermark** node in the **Appearance** category. - - ![](../../../images/eurd-web-add-watermarks-properties-panel.png) - -2. In the **Watermark** node, specify the **Text** or **Image** property, depending on the type of watermark you wish to add. - - For a text watermark, specify the text, direction and font options. - - ![](../../../images/eurd-web-watermark-text.png) - - For a picture watermark, you need to specify an image. To do this, click the ellipsis button for the **Image** property. - - ![](../../../images/eurd-web-watermark-image.png) - - In the invoked dialog, select the file containing the image that you wish to use as a watermark and click **Open**. Next, specify the size mode and alignment options for the picture. - - Additionally, for both textual and picture watermarks, you can adjust the transparency, position (in front of or behind the document content), and the page range in which the watermark will be printed. - - > [!NOTE] - > The **Transparency** property is unavailable when you specify an SVG image. + +Switch to the [Properties](../report-designer-tools/ui-panels/properties-panel.md) panel and expand the **Watermark** node in the **Appearance** category. Click the Add button to create a watermark. + +![](../../../images/eurd-web-add-watermarks-properties-panel.png) + +Specify watermark options, depending on the type of watermark you wish to add. + +### Specify Text Watermark Settings + +* Watermark Id + + The unique identifier of a watermark used to specify the watermark in the WatermarkId property (See the Manage Watermark Collection section for details). + +* Font Name + + The font of the watermark’s text. + +* Size + + The size of the watermark’s text. + +* Unit + + Specifies text measurement system. + +* Bold + + Formats the watermark’s text as bold. + +* Italic + + Formats the watermark’s text as italic. + +* Foreground Color + + The foreground color of the watermark’s text. + +* Text + + The watermark’s text. + +* Text Transparency + + The transparency of the watermark’s text. + +* Text Direction + + The incline of the watermark’s text. + +* Text Position + + Specifies whether a watermark should be printed behind or in front of page content. + +* Page Range + + The range of pages which contain a watermark. + +The added watermark is automatically displayed in the report in Preview mode. + +### Specify Picture Watermark Settings + +* Watermark Id + + The unique identifier of a watermark used to specify the watermark in the WatermarkId property (See the Manage Watermark Collection section for details). + +* Image Source + + Specifies the image that you wish to use as a watermark. + +* Image Position + + Specifies whether a watermark should be printed behind or in front of page content. + +* Image Transparency + + The transparency of the watermark’s image. The **Transparency** property is unavailable when you specify an SVG image. + +* Image View Mode + + The mode in which a picture watermark is displayed. + +* Image Tiling + + Specifies whether a picture watermark should be tiled. + +* Image Alignment + + Specifies the horizontal or vertical alignment of the watermark. + +* Page Range + + The range of pages which contain a watermark. + +The added watermark is automatically displayed in the report in Preview mode. ## Supply a Preprinted Form + You can use a picture watermark as a template, to display an image of the preprinted form on the report's body at design time. To display a watermark at design time, expand the **Design** category and enable the **Draw the Watermark** property. @@ -45,4 +125,46 @@ The following image illustrates a report with a watermark shown at design time t Place report controls on the report's body according to the layout of the preprinted form. -![](../../../images/eurd-web-add-a-template-watermark-result.png) \ No newline at end of file +![](../../../images/eurd-web-add-a-template-watermark-result.png) + +## Supported Image Formats + +A picture watermark supports the following formats: + +* BMP +* JPG / JPEG / JPE / JFIF +* GIF +* TIF / TIFF +* PNG +* ICO +* DIB +* RLE +* EMF / WMF +* SVG + +## Combine Text and a Picture in One Watermark + +You can display both text and a picture in one Watermark. Use the **Text Position** and **Image Position** options of the watermark to specify whether the text and picture should be displayed behind or in front of page content. + +For example, create a watermark and specify its text and picture settings. Set position of the text to **InFront** and position of the picture to **Behind**: + +As a result, the image is displayed behind the table, while the text is in front of the content: + +![](../../../images/eurd-web-watermark-text.png) + +## Display Watermarks According to the Specified Condition + +Bind the report's **Watermark Id** options to an expression to apply watermarks stored in the collection to specific report pages. This option allows you to apply a specific watermark to a page based on the **Watermark Id** or expression binding. + +![](../../../images/web-eud-watermark-id-option.png) + +For example, the following expression adds the created “First page watermark”, “Even page watermark”, and “Odd page watermark” watermarks to the first, odd, and even pages of a report: + +`Iif([Arguments.PageIndex]=0,'watermark1',Iif([Arguments.PageIndex]%2=0,'watermark2','watermark3'))` + +![](../../../images/eurd-web-watermark-image.png) + + + + + diff --git a/reporting-for-web/articles/report-designer/provide-interactivity.md b/reporting-for-web/articles/report-designer/provide-interactivity.md index bb9576dd7e..500619c1e2 100644 --- a/reporting-for-web/articles/report-designer/provide-interactivity.md +++ b/reporting-for-web/articles/report-designer/provide-interactivity.md @@ -7,5 +7,6 @@ author: Anna Vekhina The documents in this section provide information on the interactive features that enable report customization in Print Preview. * [Create Drill-Down Reports](provide-interactivity/create-drill-down-reports.md) +* [Create Drill-Through Reports](provide-interactivity/create-drill-through-reports.md) * [Sort a Report in Print Preview](provide-interactivity/sort-a-report-in-print-preview.md) * [Edit Content in Print Preview](provide-interactivity/edit-content-in-print-preview.md) diff --git a/reporting-for-web/articles/report-designer/provide-interactivity/create-drill-through-reports.md b/reporting-for-web/articles/report-designer/provide-interactivity/create-drill-through-reports.md new file mode 100644 index 0000000000..e7cff870d9 --- /dev/null +++ b/reporting-for-web/articles/report-designer/provide-interactivity/create-drill-through-reports.md @@ -0,0 +1,51 @@ +--- +title: Create Drill-Through Reports +--- +# Create Drill-Through Reports + +Follow this tutorial to create a _drill-through report_ (a user can click a Category entry to invoke a detail report with Products). This report type keeps the original report compact while still allowing access to more detailed information. + +The tutorial involves two main steps: + +- Add a master-detail relationship between "Categories" and "Products" reports within one project. +- Use detail report parameters to filter records based on the selected category. + +## Add a Master-Detail Relationship between Reports + +Define a master-detail relationship between _Category_ and _Product_ reports within a single project: + +- Select the XRControl's element (**Table Cell** in this example) in the main report. +- Set its **Action** property to **Navigate to Report**. +- Assign the **Report Source URL** property to a detail report instance. + +![Specify the Navigate to Report action](../../../images/web-specify-navigate-to-report-action.png) + +If you switch to **Preview**, you can click on a _Category_ value in the table. The **Preview** window navigates to the detail report that contains all _Product_ entries. The next step explains how to filter this list. + +![Drill-Through report preview](../../../images/web-detail-report-navigation.png) + +You can click "Categories Report" below the Document Viewer toolbar and navigate back to the original report. + +![Breadcrumb navigation](../../../images/web-breadcrumb-control-navigation.png) + +## Specify Parameter Binding to Display Required Data + +You can specify parameters during detail report navigation. Use the **Parameter Bindings** property to limit displayed records (such as products) to a selected category. + +Click the **Parameter Bindings** property and select the detail report parameter. Set **Binding** to the data field or parameter of the original report. In this example, **Binding** is set to the _CategoryID_ field. + +![Specify Parameter Binding](../../../images/web-specify-binding.png) + +Set the following filter string in the detail report to display product records for the selected category. + +![Set filter string](../../../images/web-set-filter-string.png) + +## Result + +Switch to **Preview** and click on a category entry in the master report. The **Preview** navigates to the detail report that displays only products related to the selected category. + +![Drill-Through report](../../../images/web-drill-through-result.png) + + + + diff --git a/reporting-for-web/articles/report-designer/use-expressions/functions-in-expressions.md b/reporting-for-web/articles/report-designer/use-expressions/functions-in-expressions.md index 5774fd9277..a08f828f15 100644 --- a/reporting-for-web/articles/report-designer/use-expressions/functions-in-expressions.md +++ b/reporting-for-web/articles/report-designer/use-expressions/functions-in-expressions.md @@ -13,6 +13,7 @@ This topic lists the functions that you can use in an [expression](expressions-o | Avg(Value) | Evaluates the average of the values in the collection. | [Products].Avg([UnitPrice]) | | Count() | Returns the number of objects in a collection. | [Products].Count() | | Exists() | Determines whether the object exists in the collection. | [Categories][[CategoryID] == 7].Exists() | +| Join() | Concatenates all Expression values in the _Collection_ based on the specified _Condition_ (optional) into a single string separated by the specified _Separator_ (optional). If you do not specify a _Separator_, the function uses a comma.
The function has the following overloads:
`[Collection][Condition].Join(Expression)`
`[Collection][Condition].Join(Expression, Separator)`| The following expression concatenates _CompanyName_ field values within a report grouped by the _CategoryID_ field into a single string separated by a semicolon: `[][[CategoryID] == [^.CategoryID]].Join([CompanyName], ';')`| | Max(Value) | Returns the maximum expression value in a collection. | [Products].Max([UnitPrice]) | | Min(Value) | Returns the minimum expression value in a collection. | [Products].Min([UnitPrice]) | | Single() | Returns an object if it is the only element in a collection. | [Accounts].Single() is not null | diff --git a/reporting-for-web/images/eurd-web-add-watermarks-properties-panel.png b/reporting-for-web/images/eurd-web-add-watermarks-properties-panel.png index 786b0bf071..75bdf85e6f 100644 Binary files a/reporting-for-web/images/eurd-web-add-watermarks-properties-panel.png and b/reporting-for-web/images/eurd-web-add-watermarks-properties-panel.png differ diff --git a/reporting-for-web/images/eurd-web-watermark-image.png b/reporting-for-web/images/eurd-web-watermark-image.png index 2a729f1031..536fc711bd 100644 Binary files a/reporting-for-web/images/eurd-web-watermark-image.png and b/reporting-for-web/images/eurd-web-watermark-image.png differ diff --git a/reporting-for-web/images/eurd-web-watermark-text.png b/reporting-for-web/images/eurd-web-watermark-text.png index 618ce063d0..5572f945dd 100644 Binary files a/reporting-for-web/images/eurd-web-watermark-text.png and b/reporting-for-web/images/eurd-web-watermark-text.png differ diff --git a/reporting-for-web/images/web-breadcrumb-control-navigation.png b/reporting-for-web/images/web-breadcrumb-control-navigation.png new file mode 100644 index 0000000000..d943509e0e Binary files /dev/null and b/reporting-for-web/images/web-breadcrumb-control-navigation.png differ diff --git a/reporting-for-web/images/web-detail-report-navigation.png b/reporting-for-web/images/web-detail-report-navigation.png new file mode 100644 index 0000000000..2e4c40beb5 Binary files /dev/null and b/reporting-for-web/images/web-detail-report-navigation.png differ diff --git a/reporting-for-web/images/web-drill-through-result.png b/reporting-for-web/images/web-drill-through-result.png new file mode 100644 index 0000000000..090a3272b5 Binary files /dev/null and b/reporting-for-web/images/web-drill-through-result.png differ diff --git a/reporting-for-web/images/web-eud-watermark-id-option.png b/reporting-for-web/images/web-eud-watermark-id-option.png new file mode 100644 index 0000000000..e8f624908a Binary files /dev/null and b/reporting-for-web/images/web-eud-watermark-id-option.png differ diff --git a/reporting-for-web/images/web-set-filter-string.png b/reporting-for-web/images/web-set-filter-string.png new file mode 100644 index 0000000000..45c4ebaac4 Binary files /dev/null and b/reporting-for-web/images/web-set-filter-string.png differ diff --git a/reporting-for-web/images/web-specify-binding.png b/reporting-for-web/images/web-specify-binding.png new file mode 100644 index 0000000000..b9f0a17c50 Binary files /dev/null and b/reporting-for-web/images/web-specify-binding.png differ diff --git a/reporting-for-web/images/web-specify-navigate-to-report-action.png b/reporting-for-web/images/web-specify-navigate-to-report-action.png new file mode 100644 index 0000000000..f374499ff3 Binary files /dev/null and b/reporting-for-web/images/web-specify-navigate-to-report-action.png differ diff --git a/reporting-for-web/toc.yml b/reporting-for-web/toc.yml index a31c410efb..25c5d8f98f 100644 --- a/reporting-for-web/toc.yml +++ b/reporting-for-web/toc.yml @@ -408,6 +408,8 @@ items: - name: Create Drill-Down Reports href: articles/report-designer/provide-interactivity/create-drill-down-reports.md + - name: Create Drill-Through Reports + href: articles/report-designer/provide-interactivity/create-drill-through-reports.md - name: Sort a Report in Print Preview href: articles/report-designer/provide-interactivity/sort-a-report-in-print-preview.md - name: Edit Content in Print Preview