Skip to content

Commit

Permalink
add info abt qr frames
Browse files Browse the repository at this point in the history
  • Loading branch information
pollyndos committed Feb 1, 2024
1 parent eeb49ee commit 1c2bf38
Show file tree
Hide file tree
Showing 14 changed files with 191 additions and 4 deletions.
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
Expand Up @@ -40,7 +40,7 @@ An EPC QR Code (European Payments Council Quick Response Code) is a two-dimensio

- **Frame Options**

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

## Specify the Data

Expand Down
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.
Original file line number Diff line number Diff line change
Expand Up @@ -33,6 +33,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 **Text** property's ellipsis button in the [Expressions](../../report-designer-tools/ui-panels/expressions-panel.md) panel. The invoked [Expression Editor](../../report-designer-tools/expression-editor.md) allows you to select a data field or construct a complex binding expression with two or more data fields.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,12 @@ At present, only [export to PDF](../../../document-viewer/exporting/pdf-specific

For [XLSX](../../../document-viewer/exporting/xlsx-specific-export-options.md) and [XLS](../../../document-viewer/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
Expand Up @@ -40,7 +40,7 @@ An EPC QR Code (European Payments Council Quick Response Code) is a two-dimensio

- **Frame Options**

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

## Specify the Data

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ author: Polina Tyureva

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

![](../../../../images/barcode-gs1-qr-code.png)
![](../../../../images/gs1-qr-code-web-report-designer.png)

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

Expand All @@ -43,4 +43,8 @@ In the [property grid](../../report-designer-tools/ui-panels/properties-panel.md
* **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 @@ -40,3 +40,6 @@ In the [property grid](../../report-designer-tools/ui-panels/properties-panel.md

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).
Binary file added reporting-for-web/images/qr-code-corner-frame.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.

0 comments on commit 1c2bf38

Please sign in to comment.