GS1-128 - EAN-128 (UCC)

• Feb 20, 2023
• 2 minutes to read

GS1-128 is a variable length self-checking symbololgy. GS1-128 is a subset of a more general Code 128 symbology.

Refer to the GS1-128 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 EAN128 (an object of the EAN128Generator type).

   

3. Specify common barcode properties and properties specific to EAN-128.

Specific Properties

• CharacterSet

  Gets or sets the character set type for the bar code.

• FNC1Substitute

  Gets or sets 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-128 - EAN-128 (UCC) 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 CreateGS1128BarCode(string BarCodeText) {
    // Create a bar code control.
    XRBarCode barCode = new XRBarCode();

    // Set the bar code's type to EAN 128.
    barCode.Symbology = new EAN128Generator();

    // 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.
    ((EAN128Generator)barCode.Symbology).CharacterSet = Code128Charset.CharsetB;

    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 CreateGS1128BarCode(ByVal BarCodeText As String) As XRBarCode
    ' Create a bar code control.
    Dim barCode As New XRBarCode()

    ' Set the bar code's type to EAN 128.
    barCode.Symbology = New EAN128Generator()

    ' 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.
    CType(barCode.Symbology, EAN128Generator).CharacterSet = Code128Charset.CharsetB

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

VB.NET

Imports System.Drawing.Printing
' ...

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