Barcode Xpress for Linux v13.1 - Updated
BX_CreateParameters1D
API Reference > Barcode Component API Reference > Barcode Component Structures Reference > BX_CreateParameters1D

Specifies the parameters when creating a 1D barcode.

Declaration:

Copy Code
typedef struct tagBX_CreateParameters1D {
    _Bool CheckSum;
    long HorizontalTextGap;
    long OutsideVerticalTextOffset;
    BX_ShowTextInfo ShowText;
    long TextNotchPercent;
    long VerticalTextGap;
} BX_CreateParameters1D;

Members:

CheckSum _Bool

Specifies whether to write a checksum for barcodes the optionally use checksums.

When true, Barcode Xpress will calculate and write the checksum for barcode types that support an optional checksum digit(s).

Currently, of the supported barcode types that Barcode Xpress can write, only types Industry 2 of 5, Interleaved 2 of 5, Code 39, and Code 39 Extended allows an optional checksum. This property is ignored for other barcode types that require checksums.

Default value: false

HorizontalTextGap long

Specifies the amount of gap between the outside text and the barcode when creating a barcode.

Outside text is only written with certain barcodes where this is standard.

The barcode types that support a text notch are UPC-A, UPC-E, EAN-8 and EAN-13.

For all other types, this value is ignored.

Default value: 5 pixels

OutsideVerticalTextOffset long

Specifies the vertical offset text.

A value less than 0 will raise the outside value text above the standard value text.

A value greater than 0 will lower the outside value text below the standard value text.

Outside value text is only written for certain barcodes where this is standard.

The barcode types that support outside text are UPC-A, UPC-E, EAN-8 and EAN-13. For all other types this value is ignored.

Default value: 0 pixels

ShowText BX_ShowTextInfo

Specifies if the barcode value is written as text adjacent to the created barcode.

Default value: BX_ShowTextInfo_All

TextNotchPercent long

Specifies the notch percent of the barcode for the text value.

This property is used by supported barcodes UPC-A and EAN13. Otherwise this value is ignored.

Notch percent is only used with certain barcodes where this is standard. The barcode types that support a text notch are UPC-A, UPC-E, EAN-8 and EAN-13.

Default value: 10 percent.
Valid values: 0 - 50 percent

VerticalTextGap long

Specifies the amount of gap between the text and the barcode when creating a barcode.

This property value can be positive or negative. Positive values move the value text further away from the bottom of the bars while negative values move the text closer to the bars, even overlapping.

In the case where the value text overlaps the barcode, this may prevent the barcode from being recognized.
 Default value: 0 pixels