ECC200 - Data Matrix

• Jan 12, 2021
• 3 minutes to read

Data Matrix is a two-dimensional matrix barcode. It consists of black and white “cells” arranged in a rectangular pattern. The barcode can encode textual and numeric data.

Refer to the following article for more details: Data Matrix.

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 DataMatrix (an object of the DataMatrixGenerator type).

   

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

Specific Properties

• XRBarCode.AutoModule/BarCodeControl.AutoModule

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

• CompactionMode

  Gets or sets whether text or binary mode should be used to encode the barcode’s data.

• MatrixSize

  Gets or sets the bar code matrix size.

Runtime Example

The following code creates the ECC200 - 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.

Form1.cs

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

    // Set the bar code's type to DataMatrix.
    barCode.Symbology = new DataMatrixGenerator();

    // Adjust the bar code's main properties.
    barCode.Text = BarCodeText;
    barCode.Width = 400;
    barCode.Height = 150;

    // If the AutoModule property is set to false, uncomment the next line.
    barCode.AutoModule = true;
    //barcode.Module = 3;

    // Adjust the properties specific to the bar code type.
    ((DataMatrixGenerator)barCode.Symbology).CompactionMode = DataMatrixCompactionMode.Text;
    ((DataMatrixGenerator)barCode.Symbology).MatrixSize = DataMatrixSize.MatrixAuto;

    return barCode;
}

Form1.vb

Imports System
Imports System.Collections.Generic
Imports System.Drawing.Printing
Imports System.Windows.Forms
Imports DevExpress.XtraPrinting.BarCode
Imports DevExpress.XtraReports.UI
' ...
Public Function CreateDataMatrixBarCode(ByVal BarCodeText As String) As XRBarCode
    ' Create a bar code control.
    Dim barCode As New XRBarCode()

    ' Set the bar code's type to DataMatrix.
    barCode.Symbology = New DataMatrixGenerator()

    ' Adjust the bar code's main properties.
    barCode.Text = BarCodeText
    barCode.Width = 400
    barCode.Height = 150

    ' If the AutoModule property is set to false, uncomment the next line.
    barCode.AutoModule = True
    'barcode.Module = 3;

    ' Adjust the properties specific to the bar code type.
    CType(barCode.Symbology, DataMatrixGenerator).CompactionMode = DataMatrixCompactionMode.Text
    CType(barCode.Symbology, DataMatrixGenerator).MatrixSize = DataMatrixSize.MatrixAuto

    Return barCode
End Function

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

C#

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

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

VB.NET

Imports System.Drawing.Printing
' ...

Private Sub XtraReport1_BeforePrint(ByVal sender As Object, ByVal e As PrintEventArgs)
    Me.Detail.Controls.Add(CreateDataMatrixBarCode("012345678"))
End Sub