Intelligent Mail

• Aug 01, 2018
• 2 minutes to read

Short Description

The Intelligent Mail (IM) code is a 65-bar code for use on mail in the United States. This bar code is intended to provide greater information and functionality than its predecessors POSTNET and PLANET.

The Intelligent Mail bar code has also been referred to as One Code Solution and 4-State Customer bar code abbreviated 4CB, 4-CB or USPS4CB.

Bar Code Properties

The type of a bar code control’s Symbology property is IntelligentMailGenerator.

The following properties are specific to the Intelligent Mail type.

• XRBarCode.AutoModule/BarCodeControl.AutoModule

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

Examples

The following code creates an Intelligent Mail bar code and specifies its main properties.

Note

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

    // Set the bar code's type to Intelligent Mail.
    barCode.Symbology = new IntelligentMailGenerator();

    // Adjust the bar code's main properties.
    barCode.Text = BarCodeText;
    barCode.ShowText = true;
    barCode.WidthF = 300f;
    barCode.HeightF = 50f;

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

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

    ' Set the bar code's type to Intelligent Mail.
    barCode.Symbology = New IntelligentMailGenerator()

    ' Adjust the bar code's main properties.
    barCode.Text = BarCodeText
    barCode.ShowText = True
    barCode.WidthF = 300F
    barCode.HeightF = 50F

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

    Return barCode
End Function

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

C#

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

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

VB.NET

Imports System.Drawing.Printing
' ...

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