Documents for Excel, Java Edition Documentation
Features / Barcodes / EAN-13
In This Topic
    EAN-13
    In This Topic

    EAN-13 barcode makes use of numeric characters (twelve numbers) and a check digit. This barcode accepts only twelve numbers as a string to calculate a check digit (CheckSum) and adds it to the thirteenth position. The check digit is an additional digit that can be used to verify that the barcode has been scanned accurately. When the CheckSum property is set to True, the check digit is automatically added. This is mainly used in supermarkets and other retail businesses.

    The below image displays EAN-13 barcode in a PDF document.

    EAN-13 barcode

    Formula definition

    You can set EAN-13 barcode in a worksheet using the following formula:

    =BC_EAN13(value, color, backgroundColor, showLabel, labelPosition, addOn, addOnLabelPosition, fontFamily, fontStyle, fontWeight, fontTextDecoration, fontTextAlign, fontSize, quietZoneLeft, quietZoneRight, quietZoneTop, quietZoneBottom)

    Note: The 'labelPosition' parameter can only be set to top or bottom. This holds true for all the barcodes that support 'labelPosition' parameter in GcExcel.

    Parameter

    Name Description
    value Specifies that the value length must be 12 or 13.
    color A color that represents the barcode color. The default value is 'rgb(0,0,0)'.
    backgroundColor A color that represents the barcode backgroundcolor. The default value is 'rgb(255, 255, 255)'
    showLabel Specifies whether to show label text when the barcode has label.
    labelPosition ​A value that represents the label position when the label is shown.
    addOn ​A string that represents the add text of QRCode. Specifies that  value length must be 2 or 5.
    addOnLabelPosition The position to add the text when text is shown.
    fontFamily A string that represents the label text fontFamily. The default value is 'sans-serif'.
    fontStyle A string that represents the label text fontStyle. The default value is 'normal'.
    fontWeight A string that represents the label text fontWeight. The default value is 'normal'.
    fontTextDecoration A string that represents the label text fontTextDecoration. The default value is 'none'.
    fontTextAlign A string that represents the label text fontTextAlign. The default value is 'center'.
    fontSize A string that represents the label text fontSize. The default value is '12px'.
    quietZoneLeft A value that represents the size of left quiet zone.
    quietZoneRight A value that represents the size of right quiet zone.
    quietZoneTop A value that represents the size of top quiet zone.
    quietZoneBottom A value that represents the size of bottom quiet zone.

    Using Code

    This example code sets EAN13 in the worksheet.

    Java
    Copy Code
    // Create a new workbook
    Workbook workbook = new Workbook();
    // Set worksheet layout and data
    IWorksheet worksheet = workbook.getWorksheets().get(0);
    worksheet.getRange("B:C").setColumnWidth(15);
    worksheet.getRange("D:G").setColumnWidth(20);
    worksheet.getRange("4:7").setRowHeight(60);
    worksheet.getRange("A:A").setColumnWidth(5);
    worksheet.getRange("B2").setValue("EAN-13");
    worksheet.getRange("B2:F2").setMergeCells(true);
    worksheet.getRange("B3:G3").setValue(new Object[][] {
            { "Name", "Number", "Default", "Change addOn", "Change addOnLabelPosition", "Explain" } });
    worksheet.getRange("B4:C7").setHorizontalAlignment(HorizontalAlignment.Center);
    worksheet.getRange("B4:C7").setVerticalAlignment(VerticalAlignment.Center);
    worksheet.getRange("B2:F3").setHorizontalAlignment(HorizontalAlignment.Center);
    worksheet.getRange("B2:F3").setVerticalAlignment(VerticalAlignment.Center);
    worksheet.getRange("B4:C6").setValue(new Object[][] { { "Medicine", "692031229621" },
            { "Pen", "6945091701532" }, { "value length is 13", "8142486545683" } });
    worksheet.getRange("G6")
            .setValue("No EAN-13 generated, because the last digit is check-sum digit and it is invalid");
    worksheet.getRange("G6").getFont().setColor(Color.GetRed());
    worksheet.getRange("B4:C6").setWrapText(true);
    worksheet.getRange("G6").setWrapText(true);
    worksheet.getPageSetup().setOrientation(PageOrientation.Landscape);
    worksheet.getPageSetup().setPrintGridlines(true);
    // Set formula
    for (int i = 4; i < 7; i++) {
        worksheet.getRange("D" + i).setFormula("=BC_EAN13" + "(C" + i + ")");
        worksheet.getRange("E" + i).setFormula("=BC_EAN13" + "(C" + i + ",,,,,22)");
        worksheet.getRange("F" + i).setFormula("=BC_EAN13" + "(C" + i + ",,,,,22,\"bottom\")");
    }
    
    // Save to an pdf file
    workbook.save("EAN13.pdf");