Skip to content

Commit

Permalink
Merge pull request #198 from DevExpress/232-update-content
Browse files Browse the repository at this point in the history
232 update
  • Loading branch information
pollyndos authored Feb 1, 2024
2 parents b359bca + c509ec0 commit 0ded857
Show file tree
Hide file tree
Showing 35 changed files with 421 additions and 8 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -36,4 +36,17 @@ You can change the type of the section break that has been inserted to start a s
![RTEPageSetupDialog_invoke](../../../images/img128736.png)
3. Change the **Section start** property on the **Layout** tab as required.

![RTEChangeSectionStart](../../../images/img121271.png)
![RTEChangeSectionStart](../../../images/img121271.png)


## Section Protection

You can protect/unprotect certain sections in your document.

In the UI, do the following to protect/unprotect sections:

1. Click **Protect Document** on the **Review** ribbon tab to open the [Document Protection](../document-protection/protect-and-unprotect-a-document.md) dialog.
2. In the invoked dialog, set the document protection type to *Filling in Forms* (allows users to fill in forms and form fields).
3. Select sections to be protected. When the section checkbox is selected, you can modify text only in form fields in this section.

![Rich Text Editor - Document Protection](../../../images/document-protection-dialog-sections.png)
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ Follow the steps below to protect a document with a password.
1. On the **Review** [tab](../text-editor-ui/ribbon-interface.md), in the **Protect** group, click the **Protect Document** button.

![RTEProtectDocumentRibbonMenu](../../../images/img121364.png)
2. Specify a protection type in the invoked **Document Protection** dialog. Select **No changes (Read-only)** to restrict all actions, **Comments** - to allow leaving comments only, **Tracked Changes** - to prevent other users from creating untracked changes.
2. Specify a protection type in the invoked **Document Protection** dialog. Select **No changes (Read-only)** to restrict all actions, **Comments** - to allow users leave comments only, **Tracked Changes** - to prevent other users from creating untracked changes, **Filling in Forms** -to allows users to fill in forms and form fields.

![DocumentProtectionTypes](../../../images/img121365_1.png)

Expand All @@ -39,6 +39,9 @@ Before [adding protection](#protect-a-document) to a document, you can specify c
5. Continue to select the document regions and give users permission to edit them.
6. After specifying all required parts, [enable protection](#protect-a-document).


You can also restrict document modifications with **Document Protection** and **Unprotect Document** dialogs. For more information, refer to the following topic: [Sections](../document-layout-and-page-setup/divide-a-document-into-sections.md).

## Remove Protection from a Document

1. On the **Review** [tab](../text-editor-ui/ribbon-interface.md), in the **Protect** group, click the **Unprotect Document** button.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@ author: Boris Zaitsev
legacyId: 8550
---
# Insert a Picture

You can insert graphics in the document, and convert it to inline or floating.

The **Rich Text Editor** supports the following graphic types:
Expand All @@ -14,10 +15,12 @@ The **Rich Text Editor** supports the following graphic types:
* Tagged Image Format (*.tif, *.tiff)
* Microsoft Enhanced Metafile (*.emf)
* Windows Metafile (*.wmf)
* Scalable Vector Graphics (*.svg)

>[!NOTE]
>SVG images are preserved as vector graphics when you export documents to Open XML formats (DOCX, DOTX, DOTM, DOCM). When exporting to non-Open XML formats, SVG images are rasterized.

To insert a picture into your document, position the caret to the desired location and on the **Insert** [tab](../text-editor-ui/ribbon-interface.md), in the **Illustrations** group, click the **Picture** button.
To insert a picture into your document, position the caret at the location, and click the **Picture** button in the **Illustrations** group of the **Insert** [tab](../text-editor-ui/ribbon-interface.md).

![RTEInsertInlinePict](../../../images/img121261.png)

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@ author: Natalya Senichkina
legacyId: 15755
---
# Insert a Picture

The **Spreadsheet** allows you to insert pictures in a worksheet.

You can insert graphics of the following type.
Expand All @@ -14,6 +15,10 @@ You can insert graphics of the following type.
* Tagged Image Format (*.tif, *.tiff)
* Microsoft Enhanced Metafile (*.emf)
* Windows Metafile (*.wmf)
* Scalable Vector Graphics (*.svg)

>[!NOTE]
>SVG images are preserved as vector graphics when you export documents to Open XML formats (XLSX, XLSM, XLTX, and XLTM). When exporting to non-Open XML formats, SVG images are rasterized.
To insert a picture, follow the instructions below.
1. On the **Insert** tab, in the **Illustrations** group, click the **Picture** button.
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified interface-elements-for-desktop/images/img121365.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified interface-elements-for-desktop/images/img121365_1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Original file line number Diff line number Diff line change
Expand Up @@ -45,4 +45,6 @@ See the following topics to learn about the supported two-dimensional barcodes:
* [GS1- Data Matrix](use-bar-codes/gs1-data-matrix.md)
* [Intelligent Mail](use-bar-codes/intelligent-mail.md)
* [PDF417](use-bar-codes/pdf417.md)
* [QR Code](use-bar-codes/qr-code.md)
* [QR Code](use-bar-codes/qr-code.md)
* [GS1 QR Code](use-bar-codes/gs1-qr-code.md)
* [EPC QR Code](use-bar-codes/epc-qr-code.md)
Original file line number Diff line number Diff line change
Expand Up @@ -35,6 +35,86 @@ The following are some additional barcode options:

* Use the **Padding** property to specify the indent between bars and the barcode's inner boundaries.

## Frames for QR Codes

For QR Codes ([QR Code](qr-code.md), [GS1 QR Code](gs1-qr-code.md), and [EPC QR Code](epc-qr-code.md)), you can use the **Frame Options** property to configure the frame around the barcode. The Corner and Rectangle frames are available for all types of QR Codes.

### Corner Frame

The corner frame looks as follows:

![](../../../../../images/qr-code-corner-frame.png)

You can specify the following properties for corner frames:

* **Frame Color**

Specifies the frame color.

* **Frame Width**

Specifies the frame width in pixels.

* **Padding**

Specifies the distance between the frame and QR code.

* **Text**

Specifies the text that displayed in the frame.

* **Text Alignment**

Specifies how the text is aligned with the frame line.

* **Text Color**

Specifies the color of the text in the frame.

* **Text Position**

Specifies how the text is positioned against the QR code.

### Rectangular Frame

The rectangular frame looks as follows:

![](../../../../../images/qr-code-rectangle-frame.png)

You can specify the following properties for corner frames:

* **Corner Radius**

Specifies rounded corners for the rectangular frame in pixels.

* **Frame Color**

Specifies the frame color.

* **Frame Width**

Specifies the frame width in pixels.

* **Padding**

Specifies the distance between the frame and QR code.

* **Text**

Specifies the text that displayed in the frame.

* **Text Alignment**

Specifies how the text is aligned with the frame line.

* **Text Color**

Specifies the color of the text in the frame.

* **Text Position**

Specifies how the text is positioned against the QR code.

## Bind to Data

You can [bind](../bind-controls-to-data.md) the bar code's **Text** property to a data field obtained from a report's data source. Click the control's smart tag, expand the **Expression** drop-down list and select the data field.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,12 @@ At present, only [export to PDF](/interface-elements-for-desktop/articles/print-

For [XLSX](/interface-elements-for-desktop/articles/print-preview/print-preview-for-winforms/exporting/xlsx-specific-export-options.md) and [XLS](/interface-elements-for-desktop/articles/print-preview/print-preview-for-winforms/exporting/xls-specific-export-options.md) export, the output resolution can be set up manually using the **Rasterization Resolution** property.

## Specify the DPI of the Device Used to Print the Bar Code

The **Target Device Dpi** property allows you to specify the DPI of the device on which you wish to print your barcode. The `XRBarCode` control automatically adjusts bar density based on this property's value.

Use the **Target Device Dpi** property to ensure that the bar code is scanned correctly on the target device. This is especially important if your printing device has a non-standard DPI setting.

## Common Issues
This document section provides solutions to the most common issues that you may encounter when creating barcodes.

Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,97 @@
---
title: EPC QR Code
author: Polina Tyureva
---
# EPC QR Code

An EPC QR Code (European Payments Council Quick Response Code) is a two-dimensional barcode used to initiate a [SEPA credit transfer (SCT)](https://www.europeanpaymentscouncil.eu/what-we-do/sepa-credit-transfer). The following guideline contains general information about this type of barcode and defines the data format for EPC QR Codes: [Quick Response Code - Guidelines to Enable the Data Capture for the Initiation of a SEPA Credit Transfer](https://www.europeanpaymentscouncil.eu/sites/default/files/kb/file/2022-09/EPC069-12%20v3.0%20Quick%20Response%20Code%20-%20Guidelines%20to%20Enable%20the%20Data%20Capture%20for%20the%20Initiation%20of%20an%20SCT_0.pdf).

![EPC QR Code Barcode](../../../../../images/barcode-epc-qr-code.png)

## Add a Bar Code to a Report

1. Drag the **Barcode** item from the report controls toolbox tab and drop it onto the report.

![](../../../../../images/drag-and-drop-barcode.png)

2. Set the control’s **Symbology** property to **EPC QR Code**.

![](../../../../../images/epc-qr-code-in-designer.png)

3. Specify [common](add-bar-codes-to-a-report.md) barcode properties and properties [specific](#specific-properties) to **EPC QR Code**.

## Specific Properties

- **Auto Module**

Gets or sets whether the Module property value should be calculated automatically based on the barcode size.

- **Version**

Gets or sets the bar code’s size.

- **Include Quiet Zone**

Gets or sets whether to add a blank space around the QR code.

- **Logo**

Specifies the image that overlays the QR code.

- **Frame Options**

Gets or sets the [frame for QR codes](add-bar-codes-to-a-report.md#frames-for-qr-codes).

## Specify the Data

EPC QR Codes require data in a specific format. For more information, refer to the following European Payments Council guideline: [Quick Response Code - Guidelines to Enable the Data Capture for the Initiation of a SEPA Credit Transfer](https://www.europeanpaymentscouncil.eu/sites/default/files/kb/file/2022-09/EPC069-12%20v3.0%20Quick%20Response%20Code%20-%20Guidelines%20to%20Enable%20the%20Data%20Capture%20for%20the%20Initiation%20of%20an%20SCT_0.pdf).

You can specify the barcode data in the following ways:

### The Text property.

Pass the data string to Text property. Each data element should be on a new line. Double-click the control to specify the content (editors in the Property grid do not support multi-line text):

![](../../../../../images/epc-qr-code-data.png)

In the image above, the following data elements are specified:

| Data Element | Value |
|----------|-------------|
| Service Tag:| BCD |
| Version: | 001 |
| Encoding: | 1 |
| Identification:| SCT |
| BIC: | BPOTBEB1 |
| Beneficiary Name: | Red Cross of Belgium |
| IBAN: | BE72000000001616 |
| Transfer Amount:| EUR1 |
| Transfer Reason:| CHAR |
| Creditor Reference: | Empty line |
| Remittance Information: | Urgency fund |
| Information: | Empty line |


This field is bindable. For more information on data binding, review the following help topic: [Bind Report Controls to Data](../bind-controls-to-data.md).

### The ConvertDataToEPC function.

Use the `ConvertDataToEPC` function from the Expression Editor to bind to the `Text` property.

You can specify the data as shown below:

```
ConvertDataToEPC('Red Cross of Belgium', 'BE72000000001616', 'BPOTBEB1','20.0', '', 'Urgency fund', 'CHAR', 'Sample EPC QR code')
```

![](../../../../../images/convert-to-epc-function.png)

You can not change the default values for Version and Encoding with this function. The default value for the Version data element is `002` and `UTF-8` for the Encoding.

## Display a “Zahlen mit Code” Frame

You can also apply a frame with the words “Zahlen mit Code” (to the right from the bottom to the top) to an EPC QR Code. The frame is used to highlight the function of the codes and to secure the identification. For more information, refer to the following Payment Services Austria (PSA) document: [Application of QR-Code for initiating of credit transfers](https://zv.psa.at/de/download/qr-code/339-qr-code-und-bcd-definition-3-en/file.html).

This frame already contains predefined settings according to the standard. To set this frame, go to Barcode Tasks → Symbology → FrameOptions, and select **Payment Services Austria Frame**.

![](../../../../../images/qr-frame-austria-design-time-options.png)
Original file line number Diff line number Diff line change
Expand Up @@ -43,3 +43,7 @@ In the [property grid](../../report-designer-tools/ui-panels/property-grid-tabbe
* **Version**

Specifies the barcode's size.

* **Frame Options**

Gets or sets the [frame for QR codes](add-bar-codes-to-a-report.md#frames-for-qr-codes).
Original file line number Diff line number Diff line change
Expand Up @@ -41,4 +41,8 @@ In the [property grid](../../report-designer-tools/ui-panels/property-grid-tabbe

* **Logo**

Specifies the image that overlays the QR code.
Specifies the image that overlays the QR code.

* **Frame Options**

Gets or sets the [frame for QR codes](add-bar-codes-to-a-report.md#frames-for-qr-codes).
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.
2 changes: 2 additions & 0 deletions reporting-for-desktop/toc.yml
Original file line number Diff line number Diff line change
Expand Up @@ -223,6 +223,8 @@
href: articles/report-designer/report-designer-for-winforms/use-report-elements/use-bar-codes/qr-code.md
- name: GS1 QR Code
href: articles/report-designer/report-designer-for-winforms/use-report-elements/use-bar-codes/gs1-qr-code.md
- name: EPC QR Code
href: articles/report-designer/report-designer-for-winforms/use-report-elements/use-bar-codes/epc-qr-code.md
- name: SSCC (Serial Shipping Container Code)
href: articles/report-designer/report-designer-for-winforms/use-report-elements/use-bar-codes/sscc.md
- name: UPC Shipping Container Symbol (ITF-14)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -44,4 +44,6 @@ See the following topics to learn about the supported two-dimensional barcodes:
* [GS1- Data Matrix](use-bar-codes/gs1-data-matrix.md)
* [Intelligent Mail](use-bar-codes/intelligent-mail.md)
* [PDF417](use-bar-codes/pdf417.md)
* [QR Code](use-bar-codes/qr-code.md)
* [QR Code](use-bar-codes/qr-code.md)
* [QR Code](use-bar-codes/gs1-qr-code.md)
* [EPC QR Code](use-bar-codes/epc-qr-code.md)
Loading

0 comments on commit 0ded857

Please sign in to comment.