Properties Print E-mail

BarCode ActiveX Properties



BarText Property
This is the data that is to be encoded in the barcode.

Syntax
object.BarText [ = sBarCode ]
Possible Values
sBarCodeString that specifies or receives the barcode.

The property is read/write.
Remarks
If you connect the control to a control source, then the source will override this field.



BarType Property
Returns or sets a value indicating the type of bar code symbol (symbology) to be generated by a BarCode-ActiveX control object.

Syntax
object.BarType [ = eBarType ]
Possible Values
eBarTypeValue that specifies or receives the barcode type

ValueConstantDescription
0Interl25Interleaved 2 of 5
1Industr25Industrial 2 of 5
2Code39Code 39
3Code39ExtCode39 Extended
4Code11Code 11
5CodabarCodabar
6MSIMSI
7Code128Code 128
8EANAdd2EAN Addon-2
9EANAdd5EAN Addon-5
10EAN8EAN-8
11EAN13EAN-13
12EAN14EAN-14
13UPCAUPC-A
14UPCEUPC-E
15UCCEAN128UCC/EAN 128
16SSCC18SSCC-18
17PostNetPostNet
18PlaNetPlaNet
19Code93Code 93
20Code93ExtCode 93 Extended
21ITF14ITF 14

The property is read/write.



Code128CharSet Property
Returns or sets the Code 128 character set.

Syntax
object.Code128CharSet [ = eCode128CharSet ]
Possible Values
eCode128CharSetValue that specifies or receives the Code 128 character set

ValueConstantDescription
0C128AutoThe most optimal character set or their combination is selected. Thanks to changing character sets, the most optimal barcode size is achieved.
1C128ASet A
2C128BSet B
3C128CSet C

The property is read/write.



BarAlign Property
Returns or sets a barcode alignment.

Syntax
object.BarAlign [ = eBarAlign ]
Possible Values
eBarAlignValue that specifies or receives the barcode alignment

ValueConstantDescription
0BarLeftleft
1BarRightright
2BarCentercenter

The property is read/write.



ShowText Property
Returns or sets a value that determines whether to print the human readable text version of a barcode message.

Syntax
object.ShowText [ = bShowText ]
Possible Values
bShowTextBoolean that specifies or receives whether to show the human readable text
true - show

The property is read/write.



TextBottomTop Property
Returns or sets a value that determines whether to print the human readable text above all bar codes produced by the BarCode control.

Syntax
object.TextBottomTop [ = bTextBottomTop ]
Possible Values
bTextBottomTopBoolean that specifies or receives the TextBottomTop property
If the value is True then the text is printed below the bar code symbol.

The property is read/write.



TextAlign Property
Returns or sets a value indicating how to align the human readable text.

Syntax
object.TextAlign [ = eTextAlign ]
Possible Values
eTextAlignValue that specifies or receives text alignment

ValueConstantDescription
0LeftAlign the text with the left edge of the bar code symbol.
1RightAlign the text with the right edge of the bar code symbol.
2CenterAlign the text with the center of the bar code symbol.
3FullAlign the text with the full size of the barcode symbol.
4EAN1EAN1 alignment
5EAN2EAN2 alignment
6EAN3EAN3 alignment

The property is read/write.
Remarks
The EAN1, EAN2 and EAN3 values are only valid for EAN and UPC symbologies.



TxtEANFull Property
Returns or sets the value indicating whether to extend human readable text in an EAN type barcode or not.

Syntax
object.TxtEANFull [ = bTxtEANFull ]
Possible Values
bTxtEANFullBoolean that specifies or receives the TxtEANFull property

The property is read/write.



TextColor Property
Returns or sets the color of all human readable text in a bar code.

Syntax
object.TextColor [ = sColor ]
Possible Values
sColorValue that specifies or receives the text color

The property is read/write.



CalcCheck Property
Returns or sets a value that determines whether to calculate an optional check digit in the human readable portion of a bar code symbol.

Syntax
object.CalcCheck [ = bCalcCheck ]
Possible Values
bCalcCheckBoolean that specifies or receives CalcCheck property

The property is read/write.
Remarks
This option is only valid for symbologies that support an optional check digit.



ShowCheck Property
Returns or sets a value that determines whether to include an optional check digit in the human readable portion of a bar code symbol.

Syntax
object.ShowCheck [ = bShowCheck ]
Possible Values
bShowCheckBoolean that specifies or receives the ShowCheck property

The property is read/write.
Remarks
This option is only valid for symbologies that support an optional check digit.



ShowStSt Property
Returns or sets a value that determines whether to show start/stop symbol in the human readable portion of a bar code symbol.

Syntax
object.ShowStSt [ = bShowStSt ]
Possible Values
bShowStStBoolean that specifies or receives the start/stop property

The property is read/write.
Remarks
This option is only valid for symbologies that support a start/stop symbols.



ShowQuietZone Property
Returns or sets a value that determines whether to include quiet zones at either end of all linear bar code symbols.

Syntax
object.ShowQuietZone [ = bShowQuietZone ]
Possible Values
bShowQuietZoneBoolean that specifies or receives the ShowQuietZone property

The property is read/write.
Remarks
Quiet Zones are small areas of blank space at either end of a bar code image. This space helps to insure that a bar code reader will be able to correctly determine the true beginning and end of a bar code symbol. Most bar code symbology specifications require quiet zones therefore it is highly recommended that you enable this option.



ShowGuard Property
Returns or sets a value that determines whether to show the guard bars.

Syntax
object.ShowGuard [ = bShowGuard ]
Possible Values
bShowGuardBoolean that specifies or receives ShowGuard property

The property is read/write.
Remarks
This option is only valid for EAN and UPC symbologies.



Orientation Property
Returns or sets the orientation of the barcode.

Syntax
object.Orientation [ = eOrientation ]
Possible Values
OrientationValue that specifies or receives the orientation of the barcode.
Valid values are 0, 90, 180 and 270

The property is read/write.



ForeColor Property
Returns or sets the foreground color of all bars in a bar code object.

Syntax
object.ForeColor [ = sColor ]
Possible Values
sColorValue that specifies or receives the background color

The property is read/write.



BackColor Property
Returns or sets the background color of a bar code.

Syntax
object.BackColor [ = sColor ]
Possible Values
sColorValue that specifies or receives the background color

The property is read/write.
Remarks
The BackColor property is ignored if the Transparent property setting is true.

The valid range for a normal RGB color is 0 to 16,777,215 (&HFFFFFF). The high byte of a number in this range equals 0; the lower 3 bytes, from least to most significant byte, determine the amount of red, green, and blue, respectively. The red, green, and blue components are each represented by a number between 0 and 255 (&HFF).




Transparent Property
Returns or sets a value indicating whether the background of a BarCode control is transparent or opaque.

Syntax
object.Transparent [ = bTransparent ]
Possible Values
bTransparentBoolean that specifies or receives the Transparent property
If the value is False then the the control's BackColor property setting fills the control and obscures any color or graphics behind it.

The property is read/write.



Font Property
Returns or sets a Font object.

Syntax
object.Font [ = fFont ]
Possible Values
fFontFont that specifies or receives the Font object

The property is read/write.
Remarks
Use the Font property of an object to identify a specific Font object whose properties you want to use.



Wide2NarrowRatio Property
Returns or sets the width ratio between the wide and narrow bars in the Code 39, Interleaved 2 of 5, Industrial 2 of 5, Codabar, MSI, ITF 14 and Code 11.

Syntax
object.Wide2NarrowRatio [ = fWide2NarrowRatio ]
Possible Values
fWide2NarrowRatioDouble that specifies or receives the Wide2NarrowRatio property

The property is read/write.



NonPrintingToTxt Property
Returns or sets the value indicating whether nonprintable chars should be converted into their text representation.
For instance, if a barcode has the hexadecimal char 00h in it, in the human readable text this character will be replaced with "NULL", 0Dh will be replaced with "CR", etc.
If this property is set to False and there are nonprintable chars, such chars will be just skipped.
This property makes sense only for barcodes that can encode the full ASCII char set, e.g. Code 39 Extended or Code 93 Extended.
For example:

BarText = "Hello ~0Dworld"
BarType = Code93Ext
NonPrintingToTxt = True
Human readable text will be - "Hello <CR>world"

if NonPrintingToTxt = False then Human readable text will be - "Hello world"


Syntax
object.NonPrintingToTxt [ = bNonPrintingToTxt ]
Possible Values
bNonPrintingToTxtBoolean that specifies or receives the NonPrintingToTxt property

The property is read/write.



JPEGQuality Property
Returns or sets the value indicating the image quality in the JPEG format.
This property makes sense only if the SaveToImageFile method is used and the barcode is saved to a JPEG file.

Syntax
object.JPEGQuality [ = lJPEGQuality ]
Possible Values
lJPEGQualityLong that specifies or receives the JPEGQuality property
The value of this property must be within the range of 0..100, where 100 is the highest quality.

The property is read/write.



IsBarTextOk Property
Returns the value indicating whether the BarText property is set correctly.

Syntax
object.IsBarTextOk
Possible Values
bIsBarTextOkBoolean that receives the IsBarTextOk property

The property is read only.



IsBarSizeOk Property
Returns the value indicating whether the barcode size is specified correctly.

Syntax
object.IsBarSizeOk
Possible Values
bIsBarSizeOkBoolean that receives the IsBarSizeOk property

The property is read only.



MinBarcodeWidth Property
Returns the value indicating the smallest possible barcode width with its current properties. This value is always returned in pixels.
Mind that this property does not depend on the barcode оrientation and determines the barcode width perpendicular to the bars.

For example:
Barcode minimal width

Syntax
object.MinBarcodeWidth
Possible Values
lMinBarcodeWidthLong that receives the MinBarcodeWidth property

The property is read only.
Remarks
Be careful because this method returns exactly the smallest possible barcode width in pixels, i.e. the narrowest bar will have the width of 1 pixel (see x-dimension). If you print a barcode with such width on a high-resolution printer, a scanner may fail to read it.
That is why you’d better use the GetBarcodeWidth method to determine the barcode width.



BarWidthReduction Property
Returns or sets a percentage value for the reduction or gain of the width of the bars in a BarCode-ActiveX control.

Syntax
object.BarWidthReduction [ = lBarWidthReduction ]
Possible Values
lBarWidthReductionA Long value specifying either a positive or a negative percentage to reduce or increase the width of all bars in a bar code.
The value for number may range between 99 (reduction) and -99 (gain).

The property is read/write.
Remarks
The BarWidthReduction property allows you to set a Reduction or Gain factor ranging from 99 (% reduction) to -99 (% gain). The default value for the BarWidthReduction parameter is zero. Specifying a non-zero value for the BarWidthReduction parameter causes the BarCode-ActiveX control to reduce or enlarge the width of all solid bars in a bar code. Bar Width Reduction is often necessary to compensate for ink spread when generating bar codes that will be used in wet ink printing processes (i.e. printing presses).
The percentage that you specify is based on the narrow bar width (x-dimension) that you choose for your bar codes. For example if you specify a BarWidthReduction value of 25 and your narrow bar width (x-dimension) is set at 10 mils, the width of all bars in your bar codes will be reduced by 2.5 mils (25% of 10 mils = 2.5 mils). Bar width gain is typically used when printing on glass or other surfaces that cause ink to bead up or shrink as it dries. To specify bar width gain instead of reduction, use a negative percentage value. An error event is generated if you specify a BarWidthReduction value greater than 99 or less than -99.

The amount of BarWidthReduction to use depends on a number of factors including the type of paper that the bar codes will be printed on, the type of ink that is being used and the speed and plate pressure of the printing press. Typical values for this property range from 5 to 25 percent however it is recommended that you consult with your printer about the best value to choose.



 

Copyright (c) 1999-2013, VBC Software. All rights reserved.
All trademarks mentioned are the property of their respective owners