Skip to content

Commit

Permalink
Merge branch 'ritazakhodyaeva-mz_issues'
Browse files Browse the repository at this point in the history
  • Loading branch information
natakazakova committed Oct 3, 2024
2 parents f2ecb11 + b659f3a commit 1f0553a
Show file tree
Hide file tree
Showing 19 changed files with 122 additions and 1 deletion.
Original file line number Diff line number Diff line change
Expand Up @@ -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)
* [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 <div> 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)
Original file line number Diff line number Diff line change
Expand Up @@ -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)
Original file line number Diff line number Diff line change
@@ -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)
Original file line number Diff line number Diff line change
Expand Up @@ -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)
Original file line number Diff line number Diff line change
@@ -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)
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added reporting-for-desktop/images/carryover-scheme.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
4 changes: 4 additions & 0 deletions reporting-for-desktop/toc.yml
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand All @@ -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:
Expand Down

0 comments on commit 1f0553a

Please sign in to comment.