diff --git a/reporting-for-desktop/articles/report-designer/report-designer-for-winforms/preview-print-and-export-reports.md b/reporting-for-desktop/articles/report-designer/report-designer-for-winforms/preview-print-and-export-reports.md index a81219bab4..0d18727c19 100644 --- a/reporting-for-desktop/articles/report-designer/report-designer-for-winforms/preview-print-and-export-reports.md +++ b/reporting-for-desktop/articles/report-designer/report-designer-for-winforms/preview-print-and-export-reports.md @@ -34,4 +34,63 @@ The following documents describe the basics of report exporting and format-speci * [XLSX-Specific Export Options](~/interface-elements-for-desktop/articles/print-preview/print-preview-for-winforms/exporting/xlsx-specific-export-options.md) * [CSV-Specific Export Options](~/interface-elements-for-desktop/articles/print-preview/print-preview-for-winforms/exporting/csv-specific-export-options.md) * [TXT-Specific Export Options](~/interface-elements-for-desktop/articles/print-preview/print-preview-for-winforms/exporting/txt-specific-export-options.md) -* [Image-Specific Export Options](~/interface-elements-for-desktop/articles/print-preview/print-preview-for-winforms/exporting/image-specific-export-options.md) \ No newline at end of file +* [Image-Specific Export Options](~/interface-elements-for-desktop/articles/print-preview/print-preview-for-winforms/exporting/image-specific-export-options.md) + +### Export a Report to PDF with Accessible Tags (PDF/UA Compatibility) + +You can specify how Label, Table, Table Row, and Table Cell should be treated by screen readers in the exported PDF document. + +When you export a report to PDF, the report elements have no role. Assistive software commonly treats such elements as HTML
tags. Change the element’s role to one of the values listed below to help the screen reader correctly identify the element’s purpose in the exported PDF document. + +#### Define Label Accessible Role + +Set the control’s **Accessible Role** property to **Heading 1 - Heading 6** before you export a report. + +![Set AccessibleRole in Property Grid](~/reporting-for-desktop/images/label-assesible-role.png) + +In the PDF Export Options dialog, set the **PDF/UA Compatibility** property to **PDF/UA1** to conform the exported PDF document to PDF/UA specification. Then, export the report to PDF format. + +The image below shows the result. **Accessible Role** is set to **Heading 2**, and the screen reader treats **Label** as a “level two” heading in the exported document: + +![Exported report in the screen reader](~/reporting-for-desktop/images/accessible-exported-document-with-label.png) + +#### Define Table Accessible Role + +You can specify how Table should be treated by screen readers in the exported PDF document. For this, set the control's **Accessible Role** property to **Table** before you export a report. + +![Set AccessibleRole in Property Grid](~/reporting-for-desktop/images/table-assesible-role.png) + +In the PDF Export Options dialog, set the **PDF/UA Compatibility** property to **PDF/UA1** to conform the exported PDF document to PDF/UA specification. Then, export the report to PDF format. + +The image below shows the result. **Accessible Role** is set to **Table**, and the screen reader treats Table as a table in the exported document: + +![Exported report in the screen reader](~/reporting-for-desktop/images/accessible-exported-document-with-table.png) + +#### Define Table Row Accessible Role + +You can specify how Table Row should be treated by screen readers in the exported PDF document. + +Before you export a report, set the **Table**'s **Accessible Role** property to **Table** to define a control as a table. Then, specify **Table Row**'s **Accessible Role**: + +![Set AccessibleRole in Property Grid](~/reporting-for-desktop/images/table-row-assesible-role.png) + +In the PDF Export Options dialog, set the **PDF/UA Compatibility** property to **PDF/UA1** to conform the exported PDF document to PDF/UA specification. Then, export the report to PDF format. + +The image below shows the result. **Table Row**'s **Accessible Role** is set to **Table Header Row**, and the screen reader treats **Table Row** as a header row of the table in the exported document: + +![Exported report in the screen reader](~/reporting-for-desktop/images/accessible-exported-document-with-tablerow.png) + +#### Define Table Cell Accessible Role + +Before you export a report, set the **Table**'s **Accessible Role** property to **Table** to define a control as a table. Then, specify the **Table Cell**'s **Accessible Role** property: + +![Set AccessibleRole in Property Grid](~/reporting-for-desktop/images/tablecell-assesible-role.png) + +> [!NOTE] +> **Accessible Role** is not in effect for cells merged with the Cell's **Row Span** property. + +In the PDF Export Options dialog, set the **PDF/UA Compatibility** property to **PDF/UA1** to conform the exported PDF document to PDF/UA specification. Then, export the report to PDF format. + +The image below shows the result. **Table Cell**'s b is set to **Table Header Cell**, and the screen reader treats Table Cell with "Bill to:" text as a header cell in the exported document: + +![Exported report in the screen reader](~/reporting-for-desktop/images/accessible-exported-document-with-table.png) \ No newline at end of file diff --git a/reporting-for-desktop/articles/report-designer/report-designer-for-winforms/shape-report-data/calculate-summaries.md b/reporting-for-desktop/articles/report-designer/report-designer-for-winforms/shape-report-data/calculate-summaries.md index 281a18e3ab..ad8d5ac0f3 100644 --- a/reporting-for-desktop/articles/report-designer/report-designer-for-winforms/shape-report-data/calculate-summaries.md +++ b/reporting-for-desktop/articles/report-designer/report-designer-for-winforms/shape-report-data/calculate-summaries.md @@ -9,3 +9,4 @@ Topics in this section describe how to calculate summaries in a report. * [Calculate a Summary](calculate-summaries/calculate-a-summary.md) * [Calculate a Weighted Average](calculate-summaries/calculate-a-weighted-average.md) * [Calculate an Advanced Summary](calculate-summaries/calculate-an-advanced-summary.md) +* [Calculate Carried Forward/Brought Forward](calculate-summaries/calculate-carriedforward-broughtforward.md) diff --git a/reporting-for-desktop/articles/report-designer/report-designer-for-winforms/shape-report-data/calculate-summaries/calculate-carriedforward-broughtforward.md b/reporting-for-desktop/articles/report-designer/report-designer-for-winforms/shape-report-data/calculate-summaries/calculate-carriedforward-broughtforward.md new file mode 100644 index 0000000000..b28538654b --- /dev/null +++ b/reporting-for-desktop/articles/report-designer/report-designer-for-winforms/shape-report-data/calculate-summaries/calculate-carriedforward-broughtforward.md @@ -0,0 +1,31 @@ +--- +title: Calculate Carried Forward/Brought Forward +author: Margarita Zakhodyaeva +--- +# Calculate Carried Forward/Brought Forward + +## Overview + +Carried Forward/Brought Forward summaries refer to the practice of automatically transferring specific values or calculations from one reporting period or data group to another (eliminating the need for manual data entry or redundant calculations). + +As the following image illustrates, calculated running summaries are transferred from the report’s page footer to the header of the next page. Values are calculated for the group and are specified by the user. It can involve grouping by monthly expenses, or grouping by month with the cumulative balance of total expenses. + +![CarryOver Scheme](~/reporting-for-desktop/images/carryover-scheme.png) + +In Reporting controls, Carried Forward/Brought Forward summaries are represented by the `sumCarryoverSum(Expression)`. function. + +## Example: How to Display Transactions for a User Account + +The example shows how to display transactions for a user account. These transactions represent expenses for one month. Records span multiple pages and the summary displayed in the footer of the first page is repeated in the header of the subsequent page. + +1. Place the `Label` controls in group header/group footer bands. Enable group header/group footer bands’ **Repeat Every Page** option. + + ![](~/reporting-for-desktop/images/xrlabel-in-repetitive-bands.png) + +2. Bind the `XRLabel` controls to the following expression: + + `sumCarryoverSum([Amount])` + + This allows DevExpress Reports to display the balance on each page. + + ![](~/reporting-for-desktop/images/display-transactions-for-a-user-account.png) \ No newline at end of file diff --git a/reporting-for-desktop/articles/report-designer/report-designer-for-winforms/shape-report-data/specify-conditions-for-report-elements.md b/reporting-for-desktop/articles/report-designer/report-designer-for-winforms/shape-report-data/specify-conditions-for-report-elements.md index 84fb2049c3..226501888f 100644 --- a/reporting-for-desktop/articles/report-designer/report-designer-for-winforms/shape-report-data/specify-conditions-for-report-elements.md +++ b/reporting-for-desktop/articles/report-designer/report-designer-for-winforms/shape-report-data/specify-conditions-for-report-elements.md @@ -12,3 +12,4 @@ Topics in this section demonstrate how to conditionally change report data and e * [Conditionally Filter Report Data](specify-conditions-for-report-elements/conditionally-filter-report-data.md) * [Conditionally Suppress Controls](specify-conditions-for-report-elements/conditionally-supress-controls.md) * [Limit the Number of Records per Page](specify-conditions-for-report-elements/limit-the-number-of-records-per-page.md) +* [Display Average Values in Charts](specify-conditions-for-report-elements/display-average-values-in-charts.md) diff --git a/reporting-for-desktop/articles/report-designer/report-designer-for-winforms/shape-report-data/specify-conditions-for-report-elements/display-average-values-in-charts.md b/reporting-for-desktop/articles/report-designer/report-designer-for-winforms/shape-report-data/specify-conditions-for-report-elements/display-average-values-in-charts.md new file mode 100644 index 0000000000..d2571ba825 --- /dev/null +++ b/reporting-for-desktop/articles/report-designer/report-designer-for-winforms/shape-report-data/specify-conditions-for-report-elements/display-average-values-in-charts.md @@ -0,0 +1,25 @@ +--- +title: Display Average Values in Charts +author: Margarita Zakhodyaeva +--- +# Display Average Values in Charts + +The following tutorial explains how to bind a chart’s constant line to an expression that calculates the average of all displayed values. + +## Bind a Constant Line to an Expression + +Select the **Chart** control. The “f” button appears next to the selection. Click this button to invoke the Expression Editor: + +![Invoke the Expression Editor](~/reporting-for-desktop/images/xrcontrol-invoke-the-expression-editor.png) + +In the invoked editor, specify the following expression for the **Axis Value** property and click OK. + +`[CategoriesProducts].Avg([UnitPrice])` + +![Bind a constant line to an expression](~/reporting-for-desktop/images/specify-expression-in-the-expression-editor.png) + +## See the Result + +Run the application. Constant lines show average product prices in each category. + +![Result](~/reporting-for-desktop/images/average-price-example.png) \ No newline at end of file diff --git a/reporting-for-desktop/images/accessible-exported-document-with-label.png b/reporting-for-desktop/images/accessible-exported-document-with-label.png new file mode 100644 index 0000000000..f6e6152af5 Binary files /dev/null and b/reporting-for-desktop/images/accessible-exported-document-with-label.png differ diff --git a/reporting-for-desktop/images/accessible-exported-document-with-table.png b/reporting-for-desktop/images/accessible-exported-document-with-table.png new file mode 100644 index 0000000000..244513d2c4 Binary files /dev/null and b/reporting-for-desktop/images/accessible-exported-document-with-table.png differ diff --git a/reporting-for-desktop/images/accessible-exported-document-with-tablerow.png b/reporting-for-desktop/images/accessible-exported-document-with-tablerow.png new file mode 100644 index 0000000000..3c7e356835 Binary files /dev/null and b/reporting-for-desktop/images/accessible-exported-document-with-tablerow.png differ diff --git a/reporting-for-desktop/images/average-price-example.png b/reporting-for-desktop/images/average-price-example.png new file mode 100644 index 0000000000..901051adcb Binary files /dev/null and b/reporting-for-desktop/images/average-price-example.png differ diff --git a/reporting-for-desktop/images/carryover-scheme.png b/reporting-for-desktop/images/carryover-scheme.png new file mode 100644 index 0000000000..a95edd5df1 Binary files /dev/null and b/reporting-for-desktop/images/carryover-scheme.png differ diff --git a/reporting-for-desktop/images/display-transactions-for-a-user-account.png b/reporting-for-desktop/images/display-transactions-for-a-user-account.png new file mode 100644 index 0000000000..c5a23d5785 Binary files /dev/null and b/reporting-for-desktop/images/display-transactions-for-a-user-account.png differ diff --git a/reporting-for-desktop/images/label-assesible-role.png b/reporting-for-desktop/images/label-assesible-role.png new file mode 100644 index 0000000000..3b0e6139fd Binary files /dev/null and b/reporting-for-desktop/images/label-assesible-role.png differ diff --git a/reporting-for-desktop/images/specify-expression-in-the-expression-editor.png b/reporting-for-desktop/images/specify-expression-in-the-expression-editor.png new file mode 100644 index 0000000000..c330da0175 Binary files /dev/null and b/reporting-for-desktop/images/specify-expression-in-the-expression-editor.png differ diff --git a/reporting-for-desktop/images/table-assesible-role.png b/reporting-for-desktop/images/table-assesible-role.png new file mode 100644 index 0000000000..9e33c564e3 Binary files /dev/null and b/reporting-for-desktop/images/table-assesible-role.png differ diff --git a/reporting-for-desktop/images/table-row-assesible-role.png b/reporting-for-desktop/images/table-row-assesible-role.png new file mode 100644 index 0000000000..019b0915fa Binary files /dev/null and b/reporting-for-desktop/images/table-row-assesible-role.png differ diff --git a/reporting-for-desktop/images/tablecell-assesible-role.png b/reporting-for-desktop/images/tablecell-assesible-role.png new file mode 100644 index 0000000000..de093ad29a Binary files /dev/null and b/reporting-for-desktop/images/tablecell-assesible-role.png differ diff --git a/reporting-for-desktop/images/xrcontrol-invoke-the-expression-editor.png b/reporting-for-desktop/images/xrcontrol-invoke-the-expression-editor.png new file mode 100644 index 0000000000..c44eead9da Binary files /dev/null and b/reporting-for-desktop/images/xrcontrol-invoke-the-expression-editor.png differ diff --git a/reporting-for-desktop/images/xrlabel-in-repetitive-bands.png b/reporting-for-desktop/images/xrlabel-in-repetitive-bands.png new file mode 100644 index 0000000000..2b24eae640 Binary files /dev/null and b/reporting-for-desktop/images/xrlabel-in-repetitive-bands.png differ diff --git a/reporting-for-desktop/toc.yml b/reporting-for-desktop/toc.yml index 9d051afaac..22baf9a9f7 100644 --- a/reporting-for-desktop/toc.yml +++ b/reporting-for-desktop/toc.yml @@ -344,6 +344,8 @@ items: href: articles/report-designer/report-designer-for-winforms/shape-report-data/specify-conditions-for-report-elements/conditionally-supress-controls.md - name: Limit the Number of Records per Page href: articles/report-designer/report-designer-for-winforms/shape-report-data/specify-conditions-for-report-elements/limit-the-number-of-records-per-page.md + - name: Display Average Values in Charts + href: articles/report-designer/report-designer-for-winforms/shape-report-data/specify-conditions-for-report-elements/display-average-values-in-charts.md - name: Calculate Summaries href: articles/report-designer/report-designer-for-winforms/shape-report-data/calculate-summaries.md items: @@ -353,6 +355,8 @@ items: href: articles/report-designer/report-designer-for-winforms/shape-report-data/calculate-summaries/calculate-a-weighted-average.md - name: Calculate an Advanced Summary href: articles/report-designer/report-designer-for-winforms/shape-report-data/calculate-summaries/calculate-an-advanced-summary.md + - name: Calculate Carried Forward/Brought Forward + href: articles/report-designer/report-designer-for-winforms/shape-report-data/calculate-summaries/calculate-carriedforward-broughtforward.md - name: Count Elements and Values href: articles/report-designer/report-designer-for-winforms/shape-report-data/count-elements-and-values.md items: