Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

add missing features #221

Merged
merged 2 commits into from
Oct 3, 2024
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
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.

natakazakova marked this conversation as resolved.
Show resolved Hide resolved
![Set AccessibleRole in Property Grid](~/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:

natakazakova marked this conversation as resolved.
Show resolved Hide resolved
![Exported report in the screen reader](~/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.

natakazakova marked this conversation as resolved.
Show resolved Hide resolved
![Set AccessibleRole in Property Grid](~/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:

natakazakova marked this conversation as resolved.
Show resolved Hide resolved
![Exported report in the screen reader](~/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**:

natakazakova marked this conversation as resolved.
Show resolved Hide resolved
![Set AccessibleRole in Property Grid](~/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:

natakazakova marked this conversation as resolved.
Show resolved Hide resolved
![Exported report in the screen reader](~/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:

natakazakova marked this conversation as resolved.
Show resolved Hide resolved
![Set AccessibleRole in Property Grid](~/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:

natakazakova marked this conversation as resolved.
Show resolved Hide resolved
![Exported report in the screen reader](~/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](../../../../images/carryover-scheme.png)
natakazakova marked this conversation as resolved.
Show resolved Hide resolved

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.

![](../../../../images/xrlabel-in-repetitive-bands.png)
natakazakova marked this conversation as resolved.
Show resolved Hide resolved

2. Bind the `XRLabel` controls to the following expression:

`sumCarryoverSum([Amount])`

This allows DevExpress Reports to display the balance on each page.

![](../../../../images/display-transactions-for-a-user-account.png)
natakazakova marked this conversation as resolved.
Show resolved Hide resolved
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](../../../../images/xrcontrol-invoke-the-expression-editor.png)
natakazakova marked this conversation as resolved.
Show resolved Hide resolved

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](../../../../images/specify-expression-in-the-expression-editor.png)
natakazakova marked this conversation as resolved.
Show resolved Hide resolved

## See the Result

Run the application. Constant lines show average product prices in each category.

![Result](../../../../images/average-price-example.png)
natakazakova marked this conversation as resolved.
Show resolved Hide resolved
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
Loading