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;

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