Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
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
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Original file line number Diff line number Diff line change
Expand Up @@ -10,13 +10,13 @@ The following tools allow you to control report element size, location, alignmen

The Report Designer provides horizontal and vertical rulers to help you determine report elements' size and location.

![](../../../../images/eurd-win-designer-rulers.png)
![WinForms Report Designer - Horizontal and Vertical Rulers](../../../../images/eurd-win-designer-rulers.png)

* **Layout Toolbar**

Use the **Layout Toolbar** commands to align report controls.

![](../../../../images/eurd-win-toolbar-layout-tab.png)
![WinForms Report Designer - Layout Toolbar](../../../../images/eurd-win-toolbar-layout-tab.png)

* **Snapping**

Expand All @@ -26,35 +26,35 @@ The following tools allow you to control report element size, location, alignmen

The design surface displays a visual grid that allows you to determine elements' size and location in a report. Use the **Snap Grid Size** and **Snap Grid Step Count** properties to customize the grid's settings.

![](../../../../images/eurd-win-snap-grid-size.png)
![WinForms Report Designer - Snap Grid Size property](../../../../images/eurd-win-snap-grid-size.png)

To hide the grid, disable the **Grid Lines** option in the toolbar's **View** tab or disable a report's **Draw the Grid** property.

![](../../../../images/eurd-win-toolbar-show-grid-lines.png)
![WinForms Report Designer - Show Grid Lines option in the View toolbar tab](../../../../images/eurd-win-toolbar-show-grid-lines.png)

A report control is aligned to the nearest grid cell when moved with the mouse or ARROW keys.
A report control is aligned to the nearest grid cell when moved with the mouse or <kbd>Arrow</kbd> keys.

You can use the **Align to Grid** toolbar button or context menu item to align the selected controls to the grid cells.

![](../../../../images/eurd-win-align-to-grid-context-menu-item.png)
![WinForms Report Designer - Align to Grid context menu item](../../../../images/eurd-win-align-to-grid-context-menu-item.png)

You can temporarily ignore snapping when you move and resize controls:
* hold down ALT if you move or resize controls using the mouse;
* hold down CTRL if you move or resize controls using the keyboard.
* hold down <kbd>Alt</kbd> if you move or resize controls using the mouse;

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* hold down <kbd>Alt</kbd> if you move or resize controls using the mouse;
* Hold down <kbd>Alt</kbd> if you move or resize controls using the mouse;

* hold down <kbd>Ctrl</kbd> if you move or resize controls using the keyboard.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* hold down <kbd>Ctrl</kbd> if you move or resize controls using the keyboard.
* Hold down <kbd>Ctrl</kbd> if you move or resize controls using the keyboard.


* **Snap Lines**

The Report Designer displays snap lines when you move or resize report controls. These lines appear around the report controls and indicate the distance to other report elements (controls and bands).

![](../../../../images/eurd-win-move-control-with-snap-lines.png)
![WinForms Report Designer - Snap lines displayed while moving a report control](../../../../images/eurd-win-move-control-with-snap-lines.png)

When you use the ARROW keys to move a report control or press SHIFT+ARROW to resize the control, it is aligned to the nearest report element in that direction based on snap lines.
When you use the <kbd>Arrow</kbd> keys to move a report control or press <kbd>Shift</kbd>+<kbd>Arrow</kbd> to resize the control, it is aligned to the nearest report element in that direction based on snap lines.

A report control's **Snap Line Margin** property and a band's or panel's **Snap Line Padding** property allows you to maintain a uniform distance between elements in a report.
A report control's **Snap Line Margin** property and a band's or panel's **Snap Line Padding** property allow you to maintain a uniform distance between elements in a report.

![](../../../../images/eurd-win-snap-line-margin-and-padding.png)
![WinForms Report Designer - Snap Line Margin and Padding properties](../../../../images/eurd-win-snap-line-margin-and-padding.png)

To avoid snapping controls, do the following:
* hold down ALT if you move or resize controls using the mouse;
* hold down CTRL if you move or resize controls using the keyboard.
To avoid snapping controls, do the following:
* hold down <kbd>Alt</kbd> if you move or resize controls using the mouse;

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* hold down <kbd>Alt</kbd> if you move or resize controls using the mouse;
* Hold down <kbd>Alt</kbd> if you move or resize controls using the mouse;

* hold down <kbd>Ctrl</kbd> if you move or resize controls using the keyboard.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* hold down <kbd>Ctrl</kbd> if you move or resize controls using the keyboard.
* Hold down <kbd>Ctrl</kbd> if you move or resize controls using the keyboard.


Original file line number Diff line number Diff line change
Expand Up @@ -4,29 +4,39 @@ author: Anna Gubareva
---
# Move and Resize Report Elements

## Move Report Elements

You can use the mouse or keyboard to move a report control to a new location.

![](../../../../images/eurd-win-move-report-control.png)
![WinForms Report Designer - Move a Report Control](../../../../images/eurd-win-move-report-control.png)

You can [select multiple controls](select-report-elements-and-access-their-settings.md) and move them in the same way as individual report controls.

![](../../../../images/eurd-win-move-multiple-report-controls.png)
![WinForms Report Designer - Move Multiple Report Controls](../../../../images/eurd-win-move-multiple-report-controls.png)

You can also use the [Report Explorer](../../report-designer-tools/ui-panels/report-explorer.md) to move a control to other bands (except the **Detail Report Band**), or into a **Panel** or **Table Cell** control. Select a control and drag it within the Report Explorer. The drop targets are highlighted when you drag the control over them.

You can also use the [Report Explorer](../../report-designer-tools/ui-panels/report-explorer.md) to move a control. You can move controls to other bands (except the **DetailReport** band), or into a **Panel** or **TableCell** controls. Select a control and drag it (either within the Report Explorer or to the design surface). The drop targets are highlighted when you drag the control over them.
![WinForms Report Designer - Move Controls in Report Explorer](../../../../images/eurd-win-move-controls.gif)

![design-time-move-controls](../../../../images/eurd-win-move-controls.gif)
You can also use the Report Explorer to move table cells inside a table.

> [!NOTE]
> You can drag the TableOfContents control only to the **ReportHeader** and **ReportFooter** bands.
> You can drag the **Table Of Contents** only to the **Report Header Band** and **Report Footer Band**.

## Resize Report Elements

Select a control and then drag a rectangle drawn on its edge or corner to resize it. Press <kbd>Shift</kbd> and drag a corner anchor to resize a control and preserve its aspect ratio.

![WinForms Report Designer - Resize a Report Control](../../../../images/eurd-win-resize-report-control.png)

Dimension notations appear when you resize a control. They indicate the control's width and height in report units:

To resize a control, select it and then drag a rectangle drawn on its edge or corner. Press `Shift` and drag a corner anchor to resize a report control and preserve its aspect ratio.
![WinForms Report Designer - Dimension Notations](../../../../images/eurd-win-dimension-notations.png)

![](../../../../images/eurd-win-resize-report-control.png)
s
Drag a band's header strip to resize the band.

![](../../../../images/eurd-win-resize-report-band.png)
![WinForms Report Designer - Resize a Report Band](../../../../images/eurd-win-resize-report-band.png)

You can also press SHIFT+ARROW or CTRL+SHIFT+ARROW to resize a selected element.
You can also press <kbd>Shift</kbd>+<kbd>Arrow</kbd> or <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Arrow</kbd> to resize a selected element.

See [Arrange Report Controls](arrange-report-controls.md) for information about tools that help you align report controls to each other and layout edges.
48 changes: 23 additions & 25 deletions eud-for-devexpress-reports/reporting-for-web/document-viewer.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,49 +3,47 @@ title: Document Viewer
author: Anna Gubareva
legacyId: 117358
---

# Document Viewer

The Web Document Viewer displays an interactive preview of a document generated from a report that is designed in the DevExpress Reporting platform. The Document Viewer allows the user to view, print, and export the report document.
The Web Document Viewer displays an interactive preview of a document generated from a report. The Document Viewer allows users to view, print, and export the report document.

The Viewer toolbar contains commands to navigate, print, and export the document. The **Tab Panel** on the right provides access to the **Parameters Panel** to specify report parameters, the **Export Options Panel** to configure format-specific export settings, the **Search Panel** to search for text in the document, and the **Document Map Panel** to navigate bookmarks.

The Viewer has a toolbar with commands that allows you to view, navigate, print and export the document. The Viewr's side panel has tabs that open the **Parameters** panel to specify report parameters, the **Export Options** panel to specify export settings for different formats, the **Search** panel for text search in the document, and the **Document Map** that allows you to navigate the bookmarks in the document.
![Web Document Viewer - Interface Elements](./images/web-document-viewer-overview.png)

![web-document-viewer](./images/img126958.png)
Refer to the following topics for details on how to use the Web Document Viewer:

&nbsp;
## View and Navigate

**View and Navigate**
* [Navigate Between Pages](document-viewer/viewing-and-navigating/navigate-between-pages.md)
* [Navigate Using Bookmarks](document-viewer/viewing-and-navigating/navigate-using-bookmarks.md)
* [Search for a Specific Text](document-viewer/viewing-and-navigating/search-for-a-specific-text.md)
* [Switch Multipage Mode](document-viewer/viewing-and-navigating/switch-display-mode.md)
* [Zoom](document-viewer/viewing-and-navigating/zooming.md)

&nbsp;
## Interactivity

**Interactivity**
* [Edit Content](document-viewer/content-editing.md)

&nbsp;

**Parameters**
## Parameters

* [Specify Parameter Values](document-viewer/passing-parameter-values.md)

&nbsp;

**Print**
* [Print the Document](document-viewer/printing.md)
## Print a Document

* [Print a Document](document-viewer/printing.md)

&nbsp;
## Export a Document

**Export**
* [Export a Document](document-viewer/exporting/export-a-document.md)
* [CSV-Specific Export Options](document-viewer/exporting/csv-specific-export-options.md)
* [HTML-Specific Export Options](document-viewer/exporting/html-specific-export-options.md)
* [Image-Specific Export Options](document-viewer/exporting/image-specific-export-options.md)
* [MHT-Specific Export Options](document-viewer/exporting/mht-specific-export-options.md)
* [PDF-Specific Export Options](document-viewer/exporting/pdf-specific-export-options.md)
* [RTF-Specific Export Options](document-viewer/exporting/rtf-specific-export-options.md)
* [Text-Specific Export Options](document-viewer/exporting/text-specific-export-options.md)
* [XLS-Specific Export Options](document-viewer/exporting/xls-specific-export-options.md)
* [XLSX-Specific Export Options](document-viewer/exporting/xlsx-specific-export-options.md)
* [Export a Document](document-viewer/exporting/export-a-document.md)
* [CSV Export Options](document-viewer/exporting/csv-specific-export-options.md)
* [HTML Export Options](document-viewer/exporting/html-specific-export-options.md)
* [Image Export Options](document-viewer/exporting/image-specific-export-options.md)
* [MHT Export Options](document-viewer/exporting/mht-specific-export-options.md)
* [PDF Export Options](document-viewer/exporting/pdf-specific-export-options.md)
* [RTF Export Options](document-viewer/exporting/rtf-specific-export-options.md)
* [Text Export Options](document-viewer/exporting/text-specific-export-options.md)
* [XLS Export Options](document-viewer/exporting/xls-specific-export-options.md)
* [XLSX Export Options](document-viewer/exporting/xlsx-specific-export-options.md)
Original file line number Diff line number Diff line change
@@ -1,17 +1,14 @@
---
title: Content Editing
title: Edit Content
author: Anna Gubareva
legacyId: 118015
---
# Content Editing
A report may contain elements with editable fields, and you can edit field values in the Document Viewer.

![eud-web-report-editing-fields-button](../images/img126947.png)
# Edit Content

**Highlight Editing Fields**
A report may contain elements with editable fields, and you can edit field values in the Document Viewer.

To highlight all editable fields in the document, click the **Highlight Editing Fields** button on the toolbar. This button is disabled if there are no such fields in the document.

When you click an editable field, the appropriate editor is invoked. You can edit text in labels and table cells, and switch check box states. For image elements, you can change pictures, specify size mode and alighnment.
![Web Document Viewer - Highlight Editing Fields](../images/img126947.png)

![eud-web-print-preview-content-editing](../images/img126953.png)
When you click an editable field, the Document Viewer opens the appropriate editor. You can edit text in labels and table cells, and switch check box states. For image elements, you can change pictures and specify size mode and alignment.
Original file line number Diff line number Diff line change
Expand Up @@ -4,24 +4,26 @@ author: Anna Gubareva
legacyId: 115376
---
# CSV Export Options
Before [exporting a document](export-a-document.md) to CSV format, you can specify CSV-specific options in the **Export Options** panel.

![EUD_HTML5DV_CsvExportOptions](../../images/img121798.png)
Before you [export a document](export-a-document.md) to CSV format, you can specify CSV-specific options in the **Export Options** panel.

![Web Document Viewer - CSV Export Options panel](../../images/img121798.png)

* **Encoding**

Specifies the encoding of the text-based file to which a report is exported.
Specifies the encoding of the exported text file.
* **Text Export Mode**

Specifies whether to use the formatting of data fields in the bound data source for cells in the exported document. If this option is set to **Text**, all data fields are exported to the CSV file as strings with the corresponding formatting embedded into those strings. If the option is set to **Value**, all formatting will be lost in the resulting document.
Specifies whether to use the formatting of data fields in the bound data source for cells in the exported document. If this option is set to **Text**, all data fields are exported to the CSV file as strings with the corresponding formatting embedded into those strings. If the option is set to **Value**, all formatting is lost in the resulting document.
* **Quote Strings with Separators**

Specifies whether strings with separators should be placed in quotation marks in the exported document.
Specifies whether to place strings with separators in quotation marks in the exported document.
* **Separator**

Specifies a symbol used to separate text elements (comma by default).

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Specifies a symbol used to separate text elements (comma by default).
Specifies a symbol used to separate text elements (the default symbol is a comma).

* **Skip Empty Rows**

Specifies whether to include empty rows into the resulting file.
Specifies whether to include empty rows in the resulting file.
* **Skip Empty Columns**

Specifies whether to include empty columns into the resulting file.
Specifies whether to include empty columns in the resulting file.
Original file line number Diff line number Diff line change
Expand Up @@ -4,26 +4,28 @@ author: Anna Gubareva
legacyId: 118919
---
# DOCX Export Options
Before [exporting a document](export-a-document.md) to DOCX format, you can specify DOCX-specific options in the **Export Options** panel.

![web-report-designer](../../images/img129100.png)
Before you [export a document](export-a-document.md) to DOCX format, you can specify DOCX-specific options in the **Export Options** panel.

![Web Document Viewer - DOCX Export Options panel](../../images/img129100.png)

* **Export Mode**

Specifies how a document is exported to DOCX. The following modes are available.
* The **Single file** mode allows export of a document to a single file without dividing it into pages.
* The **Single file page-by-page** mode allows export of a document to a single file divided into pages. In this mode, the **Page range** option is available.
* The **Single file** mode allows you to export a document to a single file without dividing it into pages.
* The **Single file page-by-page** mode allows you to export a document to a single file divided into pages. In this mode, the **Page range** option is available.

* **Page Range**

Specifies a range of pages which will be included in the resulting file. Use commas to separate page numbers. Use hyphens to set page ranges.
Specifies a range of pages to include in the resulting file. Use commas to separate page numbers. Use hyphens to set page ranges.

* **Table Layout**

The table-based layout is the default layout for reports exported in **Single File** mode. You can also use the **Table Layout** option to enable this layout for reports exported in **Single File Page By Page** mode. When you export a report to **DOCX** with the table-based layout, a table with merged cells is created to mimic the original layout of the report's controls.

* **Keep Row Height**

This option is enabled if you enable the **Table Layout** option. If you edit content inside the table after the export, the table cells grow to fit the new content size. Thus, the resulting document can differ from the initial document in **Print Preview**. To avoid this effect, enable the **Keep Row Height** option. If the option is set to **false** (the default value), row heights are not fixed. If you add a new line of text to a cell, the line increases the cell's row height.
This option is enabled if you enable the **Table Layout** option. If you edit content inside the table after the export, the table cells grow to fit the new content size. As a result, the resulting document can differ from the initial document in **Print Preview**. To avoid this effect, enable the **Keep Row Height** option. If the option is set to **false** (the default value), row heights are not fixed. If you add a new line of text to a cell, the line increases the cell's row height.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If "effect" refers to the difference between the initial document and the resulting document, can we change "To avoid this effect" to "To prevent this discrepancy"?


* **Rasterize Images**

Expand All @@ -39,9 +41,10 @@ Before [exporting a document](export-a-document.md) to DOCX format, you can spec
Specifies whether to include page breaks in the exported DOCX file.
* **Export Watermarks**

Specifies whether the exported document should include watermarks (if they exist).
Specifies whether to include watermarks in the exported document (if any).

## Document Options
The **Document Options** complex property contains options which specify the **Document Properties** of the created DOCX file. Click the complex property's header to access its nested options.

![EUD_HTML5DV_DocxDocumentOptions](../../images/img1218031.png)
The **Document Options** complex property contains options that specify the **Document Properties** of the created DOCX file. Click the complex property's header to access its nested options.

![DOCX Document Options panel](../../images/img1218031.png)
Loading
Loading