TALtech Logo
search
Products Support Resources Free Software
 Freebarcodes.com:

Properties N-Z

 
NarrowBarWidth Property PDFTruncatedSymbol Property
NarrowToWideRatio Property QuietZones Property
PDFAspectRatio Property RasterImageResolution Property
PDFMaxCols Property Rotation Property
PDFMaxRows Property ShowCheckDigit Property
PDFModuleHeight Property ShowHRText Property
PDFModuleWidth Property Symbology Property
PDFPctOverhead Property TextOnTop Property
PDFSecurityLevel Property UccEan128OptionalCheckDigit Property
   

NarrowBarWidth Property

Returns or sets a value for the width of the bars in all linear bar code symbols produced by a TAL Bar Code control.

Syntax

object.NarrowBarWidth [= number]

The NarrowBarWidth property syntax has these parts:

Part

Description

object

An object expression that evaluates to a TAL bar code object

number

(default = 13) A numeric expression specifying the width in mils (.001 inches) of the narrowest bar or space in a bar code. The value for number may range between 1 and 100.

Remarks

The NarrowBarWidth (expressed in integer units of .mils) specifies the width of the narrowest bar in the bar code. All other bar and space width dimensions are based on this width (referred to as the nominal X dimension). This parameter as well as the number of characters to encode, effectively determines the total width of a bar code symbol. The best choice for this dimension depends partly on the resolution of your bar code reader and also on the resolution of the printer being used to produce the bar code.

As a general rule the Narrow Bar Width should fall in a range between 10 to 30 mils and should never be less than 7.5 mils. 13 mils is the most commonly recommended value for most bar code readers. For UPC and EAN bar codes, the smallest allowable Narrow bar width is 10.4 mils.

The allowable range of values for NarrowBarWidth property in the TAL Bar Code control is 0 to 100. If you pass the value zero, the default value of 13 mils will be used.

See Also

The NarrowToWideRatio Property

Bar Code Dimensions

[Back to Top]

NarrowToWideRatio Property

Returns or sets a value for the width of the bars in all linear bar code symbols produced by a TAL Bar Code control.

Syntax

object.NarrowToWideRatio [= number]

The NarrowToWideRatio property syntax has these parts:

Part

Description

object

An object expression that evaluates to a TAL bar code object

number

(default = 2.5) A numeric expression specifying the ratio between the width of the wide and narrow bars in a bar code. The value for number may range between 2 and 3.

Remarks

The symbologies Code 39, Interleaved 2 of 5 and CodaBar consist of bars and spaces with only two element widths, Narrow and Wide Elements where the width of the wide elements is a fixed multiple of the width of the narrow elements. The specifications for these symbologies allow you to choose a Narrow to Wide Element Ratio ranging from 2.0 to 3.0.

This property is valid only for Code 39, Interleaved 2 of 5 and CodaBar and all other symbologies will ignore it. The rules for these symbologies specify that when the Narrow Bar Width is less than 20 mils, the Narrow To Wide element ratio must be 2.2 or greater. The default NarrowToWideRatio of 2.5 should be acceptable for most applications.

Note: Higher quality readers may be able to read bar codes with a narrow to wide ratio less than 2.2 no matter what the narrow element width is. Lower quality readers often need a ratio of at least 2.5. Because of the variability between readers, you should always test different ratio values and select the value that produces bar codes with the best "first pass" read rate.

See Also

The NarrowBarWidth Property

Bar Code Dimensions

[Back to Top]

PDFAspectRatio Property

Returns or sets a value for the overall height to width ratio of all PDF417 bar code symbols produced by a TAL Bar Code control.

Syntax

object.PDFAspectRatio [= number]

The PDFAspectRatio property syntax has these parts:

Part

Description

object

An object expression that evaluates to a TAL bar code object

number

A numeric expression specifying the ratio between the overall height to width of all PDF417 bar codes. The value for number may range between .01 and 1000. (default = .5)

Remarks

The PDFAspectRatio determines the overall shape of the PDF417 symbol and is defined as the overall height to width ratio. Higher values for the Aspect Ratio (greater than 1) produce tall, thin PDF417 bar codes and small values (greater than zero and less than 1) produce short, wide bar codes. A value of 1 should produce approximately square bar codes.

See Also

PDF417 Symbology Description

[Back to Top]

PDFMaxCols Property

Returns or sets a value for the maximum number of codeword columns to allow in all PDF417 bar code symbols produced by a TAL Bar Code control.

Syntax

object.PDFMaxCols [= number]

The PDFMaxCols property syntax has these parts:

Part

Description

object

An object expression that evaluates to a TAL bar code object

number

A numeric expression specifying the maximum number of codeword columns to allow in all PDF417 bar code symbols. The value for number may range between 1 and 30. (default = 30)

Remarks

The PDFMaxCols and the PDFMaxRows properties allow you to set an upper limit on the width or the height of a PDF417 bar code symbol by limiting the maximum number of codeword rows or columns in the symbol.

The PDFMaxCols property specifies the maximum number of codeword columns in a PDF symbol. The allowable range is 1 to 30. If you specify a value outside the allowable range then the default value of 30 will be used.

See Also

The PDFMaxRows Property

PDF417 Symbology Description

[Back to Top]

PDFMaxRows Property

Returns or sets a value for the maximum number of codeword rows to allow in all PDF417 bar code symbols produced by a TAL Bar Code control.

Syntax

object.PDFMaxRows [= number]

The PDFMaxRows property syntax has these parts:

Part

Description

object

An object expression that evaluates to a TAL bar code object

number

A numeric expression specifying the maximum number of codeword rows to allow in all PDF417 bar code symbols. The value for number may range between 3 and 90. (default = 90)

Remarks

The PDFMaxCols and the PDFMaxRows properties allow you to set an upper limit on the width or the height of a PDF417 bar code symbol by limiting the maximum number of codeword rows or columns in the symbol.

The PDFMaxRows property specifies the maximum number of codeword rows in a PDF symbol. The allowable range is 3 to 90. If you specify a value outside the allowable range then the default value of 90 will be used.

See Also

The PDFMaxCols Property

PDF417 Symbology Description

[Back to Top]

PDFModuleHeight Property

Returns or sets a value for the height of the smallest modules in all PDF417 bar code symbols produced by a TAL Bar Code control.

Syntax

object.PDFModuleHeight [= number]

The PDFModuleHeight property syntax has these parts:

Part

Description

object

An object expression that evaluates to a TAL bar code object

number

A numeric expression specifying the height in mils (.001 inches) of the smallest modules in a PDF417 bar code.

The value for number may range between 1 and 100. (default = 30)

Remarks

The recommended value for the Module Height is approximately three times the value for the PDFModuleWidth property however the symbol specifications allow for module heights as small as 10 mils (.25mm). This translates to 3 printer dots on a 300 DPI laser printer.

See Also

The PDFModuleWidth Property

The PDFTruncatedSymbol Property

PDF417 Symbology Description

[Back to Top]

PDFModuleWidth Property

Returns or sets a value for the width of the smallest modules in all PDF417 bar code symbols produced by a TAL Bar Code control.

Syntax

object.PDFModuleWidth [= number]

The PDFModuleWidth property syntax has these parts:

Part

Description

object

An object expression that evaluates to a TAL bar code object

number

A numeric expression specifying the width in mils (.001 inches) of the smallest modules in a PDF417 bar code.

The value for number may range between 1 and 100. (default = 10)

Remarks

The specification for PDF417 recommends that the PDFModuleWidth should fall in a range between 10 and 30 mils (.25mm to .76mm). The smallest allowable module width defined in the symbology specification is 6.56 mils (.17mm). This translates to 2 printer dots when printing to a 300 DPI laser printer. The best way to determine the ideal PDFModuleWidth for your application is to actually print out a sample bar code using several different values and try reading each one with your scanning equipment. You should choose the value that produces bar codes with the best read rate.

See Also

The PDFModuleHeight Property

The PDFTruncatedSymbol Property

PDF417 Symbology Description

[Back to Top]

PDFPctOverhead Property

Returns or sets a value for the percentage of error correction overhead to use in all PDF417 bar code symbols produced by a TAL Bar Code control.

Syntax

object.PDFPctOverhead [= number]

The PDFPctOverhead property syntax has these parts:

Part

Description

object

An object expression that evaluates to a TAL bar code object

number

A numeric expression specifying the percentage of total symbol area to use for error correction codewords.

The value for number may range between 0 and 99. (default = 10)

Remarks

The PDFPctOverhead property is valid only when the PDFSecurityLevel property is set to 9 (automatic). If you enter zero for this property, the default value of 10% will be used.

See Also

The PDFSecurityLevel Property

The PDFTruncatedSymbol Property

PDF417 Symbology Description

[Back to Top]

PDFSecurityLevel Property

Returns or sets a value for security level or Error Checking and Correction level (ECC) to use in all PDF417 bar code symbols produced by a TAL Bar Code control.

Syntax

object.PDFSecurityLevel [= number]

The PDFSecurityLevel property syntax has these parts:

Part

Description

object

An object expression that evaluates to a TAL bar code object

number

A numeric expression specifying the error correction security level to use for PDF417 bar codes.

The value for number may range between 0 and 9.

The value 9 indicates to use automatic selection of the security level based on a percentage of the total symbol area as specified in the PDFPctOverhead property.

(default = 9)

Remarks

The PDFSecurityLevel property allows you to select a PDF417 error correction level from 0 to 8 (or 9 for automatic). Each higher security level up to 8 adds additional overhead to a PDF417 symbol thereby consuming more symbol real estate. You can have the TAL Bar Code control automatically select an error correction level based on a percentage of total symbol area that you want to devote to error correction. If you select the value 9 for the PDFSecurityLevel property and also pass a percentage value (from 0 to 99%) in the PDFPctOverhead property, the control will automatically choose a value that will limit the amount of error correction overhead to the given percentage of symbol area. This mechanism is designed so that you do not waste space on redundant error correction.

See Also

The PDFPctOverhead Property

The PDFTruncatedSymbol Property

PDF417 Symbology Description

[Back to Top]

PDFTruncatedSymbol Property

Returns or sets a value that determines whether to generate the truncated version of all PDF417 bar codes produced by the TAL Bar Code control.

Syntax

object.PDFTruncatedSymbol [= boolean]

The PDFTruncatedSymbol property syntax has these parts:

Part

Description

object

An object expression that evaluates to a TAL bar code object

boolean

A boolean expression specifying whether to generate the truncated version of all PDF417 bar codes instead of the standard PDF417 symbols.

See Also

The PDFSecurityLevel Property

The PDFPctOverhead Property

PDF417 Symbology Description

[Back to Top]

QuietZones Property

Returns or sets a value that determines whether to include quiet zones at either end of all linear bar code symbols produced by the TAL Bar Code control.

Syntax

object.QuietZones [= boolean]

The QuietZones property syntax has these parts:

Part

Description

object

An object expression that evaluates to a TAL bar code object

boolean

A boolean expression specifying whether to include quiet zones at either end of all linear bar code symbols.

(default = False)

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. The width of the quiet zones will be 10 times the NarrowBarWidth value for all 1 dimensional symbols and 2 times the PDFModuleWidth value for PDF417 bar codes. Most bar code symbology specifications require quiet zones therefore it is highly recommended that you enable this option. Note: UPC, EAN and BookLand bar codes automatically include quiet zones in the symbol. Selecting this option causes the width of the quiet zones in these symbols to be twice the normal width.

[Back to Top]

RasterImageResolution Property

Returns or sets a value that determines the dot resolution (in pixels per inch) to use when saving a bar code to a disk file using any of the raster graphic file formats (GIF, JPEG (JPG), PNG, TIF, TGA and BMP).

Syntax

object.RasterImageResolution [= value]

The RasterImageResolution property syntax has these parts:

Part

Description

object

An object expression that evaluates to a TAL bar ActiveX control object

value

A numeric expression that evaluates to the value from 20 to 2540.

(Default = 300 pixels per inch)

Remarks

The RasterImageResolution property dramatically affects the quality and size of the images that are produced when you save your bar codes to a disk file. Increasing the value higher than the resolution of the printer that you will be using will provide no additional increase in the quality of the printed output and would only serve to slow down the execution speed of the file saving operation as well as increase the size of your graphic files. On the other hand, if you set this value too low, then the resolution of the saved image will not be high enough to render readable bar codes. The ideal value for this property is the resolution of your printer or an integer divisor of your printer resolution. For example, if you have a 600 DPI printer then setting the RasterImageResolution property to either 300 or 600 would produce extremely high quality bar codes.

If you set the RasterImageResolution property to a value that is too low then there will not be enough pixels in the image to render the bars and spaces in the bar code accurately and you will end up with unreadable bar codes. The default value of 300 is a good overall choice that will produce sufficiently high resolution images that save quickly and produce reasonable file sizes.

[Back to Top]

Rotation Property

Returns or sets a value indicating how much to rotate a bar code symbol produced by the TAL Bar Code control.

Syntax

object.Rotation [= value]

The Rotation property syntax has these parts:

Part

Description

object

An object expression that evaluates to a TAL Bar Code control.

value

An integer specifying the amount of rotation, as described in Settings.

Settings

The settings for value are:

Constant

Value

Description

bcZeroDegrees

0

(Default) Zero degrees i.e. no rotation.

bcClockwise_90

1

Symbol is rotated 90 degrees clockwise

bcClockwise_180

2

Symbol is rotated 180 degrees clockwise

bcClockwise_270

3

Symbol is rotated 270 degrees clockwise

[Back to Top]

ShowCheckDigit Property

Returns or sets a value that determines whether to include an optional check digit with all bar codes produced by the TAL Bar Code control that produce check digits.

Syntax

object.ShowCheckDigit [= boolean]

The ShowCheckDigit property syntax has these parts:

Part

Description

object

An object expression that evaluates to a TAL bar code object

boolean

A boolean expression specifying whether to include an optional check digit with all compatible bar code symbols.

Remarks

Normally any optional check digits are not included in the human readable portion of a bar code symbol however there are some applications where you may want to display the check digit. This option is only valid for symbologies that support an optional check digit.

Note: The optional check digit for EAN/UCC 128 will be displayed with the human readable text regardless of whether this option is selected or not.

[Back to Top]

ShowHRText Property

Returns or sets a value that determines whether to print the human readable text version of a bar code message with all linear bar codes produced by the TAL Bar Code control.

Syntax

object.ShowHRText [= boolean]

The ShowHRText property syntax has these parts:

Part

Description

object

An object expression that evaluates to a TAL bar code object

boolean

A boolean expression specifying whether to print the human readable text version of a bar code message with all linear bar code symbols. (default = True)

See Also

The Comment Property

The Message Property

[Back to Top]

Symbology Property

Returns or sets a value indicating the type of bar code symbol (symbology) to be generated by a TAL Bar Code control object.

Syntax

object.Symbology [= value]

The Symbology property syntax has these parts:

Part

Description

object

An object expression that evaluates to a TAL Bar Code control.

value

An integer specifying the type of bar code to generate, as described in Settings.

Settings

The settings for value are:

Constant

Value

Description

bcCode39

0

(Default) Normal Code 39

bcCode39_Full_ASCII

1

Full ASCII Code 39

bcCode39_HIBC

2

HIBC Code 39 (Health Industry Bar Code)

bcCodaBar

3

CodaBar

bcCode93

4

Code 93

bcCode128

5

Code 128

bcUCC_EAN_128

6

UCC/EAN 128

bcInterleaved_2of5

7

Interleaved 2 of 5 (ITF)

bcPostNET

8

PostNET

bcUPC_A

9

UPC-A

bcUPC_E

10

UPC-E

bcEAN_JAN_8

11

EAN/JAN-8

bcEAN_JAN_13

12

EAN/JAN-13

bcBookLand

13

BookLand

bcMSI_Plessey

14

MSI/Plessey

bcPDF417

15

PDF-417 (2-Dimensional Symbology)

bcAztec

16

Aztec Code (2-Dimensional Symbology)

bcDataMatrix

17

Data Matrix (2-Dimensional Symbology)

bcMaxiCode

18

MaxiCode (2-Dimensional Symbology)

See Also

Bar Code Symbology Descriptions and Rules

[Back to Top]

TextOnTop Property

Returns or sets a value that determines whether to print the human readable text above all bar codes produced by the TAL Bar Code control.

Syntax

object.TextOnTop [= boolean]

The TextOnTop property syntax has these parts:

Part

Description

object

An object expression that evaluates to a TAL bar code object

boolean

A boolean expression specifying whether to print the human readable text above all bar code symbols.

If the value is False (Default) then the text is printed below the bar code symbol.

Remarks

Normally the human readable message text is placed below the bar code symbol for all linear bar code symbologies. The two dimensional bar code symbologies (PDF417, Data Matrix, Aztec Code and MaxiCode) do not support the display of the human readable message with the bar code symbol.

See Also

The ShowHRText Property

The CommentOnTop Property

[Back to Top]

UccEan128OptionalCheckDigit Property

Returns or sets a value that determines whether to include an optional check digit with all UCC/EAN 128 bar codes produced by the TAL Bar Code control.

Syntax

object.UccEan128OptionalCheckDigit [= boolean]

The UccEan128OptionalCheckDigit property syntax has these parts:

Part

Description

object

An object expression that evaluates to a TAL bar code object

boolean

A boolean expression specifying whether to include an optional check digit with all UCC/EAN 128 bar code symbols.

Remarks

If the UccEan128OptionalCheckDigit property is set to True, a check digit will be calculated using the modulo 10 sum of the values of all characters in the UCC/EAN 128 bar code message. The check digit is then appended to the original message before the bar code is produced.

Note: The bar code message must consist of all numeric characters if the UccEan128OptionalCheckDigit property is set to True. an error event will be generated if the bar code message contains non-numeric characters.

See Also

EAN/UCC 128 Bar Code Symbology Description

[Back to Top]


TALtech Home  |  Products  |  Resources  |  Free Software  |  Support  |  Buy Now  |  Register Your Products  | 
Site Map  |  Contact TALtech  |  News
Copyright 2001, TAL Technologies, Inc. All Rights Reserved.