Add Bar Codes to Reports

• Feb 15, 2024
• 2 minutes to read

This document explains how to use the XRBarCode report control.

Bar Code Options

To add a barcode to a report, drag the XRBarCode item from the DX.23.2: Report Controls Toolbox tab and drop it onto the report.

Specify the following barcode properties.

• Set a barcode type (symbology).
  Use the XRBarCode.Symbology property in the barcode control’s smart tag.

  

  Specify type-specific barcode options.

  

• Set the XRBarCode.BinaryData property to encode a byte array into a barcode. Note that you can bind the BinaryData property to a data field. For more information on data binding, review the following help topic: Bind Report Controls to Data with Binding Expressions.

• Specify the barcode’s resolution:

  • Use the XRBarCode.Module property to set a fixed bar width.
  • Enable the XRBarCode.AutoModule property to automatically calculate the bar width according to barcode dimensions.

• Specify the Text property. Note that you can bind the Text property to a data field. For more information on data binding, review the following help topic: Bind Report Controls to Data with Binding Expressions.

• Use the XRBarCode.ShowText property to hide the barcode text.
• Use the XRBarCode.BarCodeOrientation property to rotate the barcode.
• Use the XRBarCode.PaddingInfo property to specify the bar code’s padding values.

Common Errors

The following table explains how to work around errors that may occur when the barcode is used incorrectly.

Error	Solution
Control boundaries are too small for the barcode	Enable the XRBarCode.AutoModule property and/or increase barcode dimensions.
There are invalid characters in the text	Supply data that applies to barcode specification
Invalid text format	Code128 (Charset C) Modify the encoded text so that it includes an even symbol number (add zero at the beginning) or enable the AddLeadingZero property. EAN128 (Charset C) Apply the GS1 specification. IntelligentMailPackage Apply GS1 and IMpb specifications. Pdf417 Shorten text to 1726 symbols. UPCE0 / UPCE1 Apply the GS1 specification. DataBar Apply the GS1 specification.
Binary data can’t be longer than the specified number of bytes	Pdf417/QRCode with binary data Decrease the encoded data quantity (the error specifies the possible maximum).
Incompatible settings: logo size/module/error correction level	QRCode with Logo Try one of the following actions: Decrease logo size Increase the Module property’s value Modify the error correction level

To process these errors at runtime, call the XRBarCode.Validate method in the XRControl.BeforePrint event handler.