Skip to main content
A newer version of this page is available. .

GS1- Data Matrix

  • 3 minutes to read

GS1 Data Matrix is a variant of the Data Matrix symbology that conforms to GS1 specifications.

barcode-data-matrix-gs1

Refer to the GS1 General Specification for more details.

Add the Bar Code to a Report

  1. Drag the XRBarCode item from the DX.20.2: Report Controls tab and drop it onto the report.

  2. Set the XRBarCode control’s Symbology property to DataMatrixGS1 (an object of the DataMatrixGS1Generator type).

  3. Specify common barcode properties and properties specific to GS1 Data Matrix.

Specific Properties

  • AutoModule

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

  • FNC1Substitute

    Specifies the symbol (or set of symbols) in the bar code’s text that will be replaced with the FNC1 functional character when the bar code’s bars are drawn.

  • HumanReadableText

    Specifies whether or not parentheses should be included in the bar code’s text.

Runtime Example

The following code creates the GS1- Data Matrix barcode and specifies its properties.

Note

The complete sample project is available in the following repository: https://github.com/DevExpress-Examples/Reporting_how-to-add-a-bar-code-to-a-report-e167.

using System;
using System.Collections.Generic;
using System.Drawing.Printing;
using System.Windows.Forms;
using DevExpress.XtraPrinting.BarCode;
using DevExpress.XtraReports.UI;
// ...
public XRBarCode CreateDataMatrixGS1BarCode(string BarCodeText) {
    // Create a bar code control.
    XRBarCode barCode = new XRBarCode();

    // Set the bar code's type to Data Matrix GS1.
    barCode.Symbology = new DataMatrixGS1Generator();

    // Adjust the bar code's main properties.
    barCode.AutoModule = true;
    barCode.Text = BarCodeText;
    barCode.ShowText = true;
    barCode.Width = 200;
    barCode.Height = 200;

    // Adjust the properties specific to the bar code type.
    // (Assigned below are the default values.)
    ((DataMatrixGS1Generator)barCode.Symbology).FNC1Substitute = "#";
    ((DataMatrixGS1Generator)barCode.Symbology).HumanReadableText = true;
    ((DataMatrixGS1Generator)barCode.Symbology).MatrixSize = DataMatrixSize.MatrixAuto;

    return barCode;
}

To add the XRBarCode to a report band, handle the report’s BeforePrint event.

using System.Drawing.Printing;
// ...

private void XtraReport1_BeforePrint(object sender, PrintEventArgs e) {
    this.Detail.Controls.Add(CreateDataMatrixGS1BarCode("012345678"));
}