Matrix 2 of 5

  • 2 minutes to read

Matrix 2 of 5 is a linear one-dimensional self-checking barcode that can encode only numerical data. The barcode is used primarily for warehouse sorting, photo finishing, and airline ticket marking.

Barcode - Matrix 2 of 5

Refer to the following article for more information: Matrix 2 of 5.

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

  3. Specify common bar code properties and properties specific to Matrix 2 of 5.

Specific Properties

  • CalcCheckSum

    Gets or sets whether to calculate a checksum for the bar code.

  • WideNarrowRatio

    Gets or sets the density of a bar code’s bars.

Runtime Example

The following code creates the Matrix 2 of 5 barcode and specifies its properties.

NOTE

The complete sample project is available in the following repository: https://github.com/DevExpress-Examples/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 CreateMatrix2of5BarCode(string BarCodeText) {
    // Create a bar code control.
    XRBarCode barCode = new XRBarCode();

    // Set the bar code's type to Matrix 2 of 5.
    barCode.Symbology = new Matrix2of5Generator();

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

    // Adjust the properties specific to the bar code type.
    ((Matrix2of5Generator)barCode.Symbology).CalcCheckSum = false;
    ((Matrix2of5Generator)barCode.Symbology).WideNarrowRatio = 3;

    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(CreateMatrix2of5BarCode("012345678"));
}