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

Properties A-M

 
AztecPctECC Property Comment Property
Aztec Symbol Type Property CommentOnTop Property
AztecTotalLayers Property FontSize Property
BackColor, ForeColor, TextColor Properties I2of5OptionalCheckDigit Property
BarHeight Property MatrixModuleSize Property
BarWidthReduction Property MaxiCodeClass Property
BearerBars Property MaxiCodeMode Property
CodaBarOptionalCheckDigit Property MaxiCountryCode Property
Code39OptionalCheckDigit Property MaxiZipCode Property
Code39StartStopChars Property Message Property
CommentAlignment Property  
   

AztecPctECC Property

Returns or sets the percentage of total symbol area to use for error checking and correction in normal Aztec Symbols.

Syntax

object.AztecPctECC [= value]

The AztecPctECC Property syntax has these parts:

Part

Description

object

A TALBarCode object.

value

A numeric expression that evaluates to a number between 0 and 99.

(Default = 0)

Remarks

This property is ignored for anything other than Normal Aztec symbols.

See the AztecSymbolType Property for a description of the different Aztec symbol types.

If you specify a value of Zero for the AztecPctECC property, all Aztec bar code symbols will be generated using a default error correction of approximately 23% of the symbol area.

See Also

Aztec Code Symbology Description

[Back to Top]

AztecSymbolType Property

Returns or sets the type of Aztec bar code symbol to generate.

Syntax

object.AztecPctECC [= value]

The AztecPctECC Property syntax has these parts:

Part

Description

object

A TALBarCode object.

value

A numeric expression that evaluates to a number between 0 and 2 as described in the settings below.

Settings

The settings for value are:

Constant

Setting

Description

bcNormal

0

Normal Aztec symbols (Default)

bcFullRange

1

Full Range symbols

bcCompact

2

Compact symbols

Remarks

Normal Aztec symbols are the same as Full Range symbols except for the way that you specify the amount of error checking and correction to use. With Normal symbols, you specify a percentage of error correction overhead through the AztecPctECC property. With Full Range and Compact symbols you specify the total number of data layers to use in the symbol and any left over space, after the message is encoded, is used for error correction.

Full Range symbols may have from 1 to 32 data layers and Compact symbols may have from 1 to 4 data layers. The number of data layers for Full Range and Compact symbols is specified using the AztecTotalLayers property.

See Also

Aztec Code Symbology Description

[Back to Top]

AztecTotalLayers Property

Returns or sets the total number of data layers in a Compact of Full Range Aztec bar code symbol.

Syntax

object.AztecTotalLayers [= value]

The AztecTotalLayers Property syntax has these parts:

Part

Description

object

A TALBarCode object.

value

A numeric expression that evaluates to a number between 1 and 32.

(Default = 32)

Remarks

The AztecTotalLayers property is only valid when the AztecSymbolType property is set to produce either Full Range or Compact Aztec symbols. Full Range symbols may have from 1 to 32 data layers and Compact symbols may have from 1 to 4 data layers. Setting the Total Number of data layers is equivalent to setting the exact size of the Aztec Symbol. If you choose a number of data layers that is more than is necessary to encode a particular message, the remaining data layers will be used for error correction data.

See Also

Aztec Code Symbology Description

[Back to Top]

BackColor, ForeColor, TextColor Property

BackColor returns or sets the background color of a bar code.

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

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

Syntax

object.BackColor [= color]

object.ForeColor [= color]

object.TextColor [= color]

The BackColor, ForeColor and TextColor property syntax has these parts:

Part

Description

object

An object expression that evaluates to a TAL bar code object

color

A value or constant that determines the background, foreground or text colors of a TAL Bar Code control object, as an RGB value.

Remarks

The BackColor property is ignored if the BackStyle property setting is 0 (Transparent).

The default BackColor is White (&HFFFFFF) and, the default ForeColor and TextColor is Black (0). 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).

Note: It is entirely possible to choose color combinations that render a bar code symbol unreadable. Although two colors may appear to the human eye to have a high contrast between them, a bar code reader may not be able to determine any difference at all between the two colors. Solid black bars on a solid white background always produces the best results. If you must use colors other than black on white, a good rule of thumb is to select solid foreground colors with a luminescence value no greater than 60 and select solid background colors with a luminescence value no less than 180. Because most laser bar code readers use a red laser beam, colors toward the red end of the spectrum should be avoided as the foreground color.

See Also

How To Produce Readable Bar Codes

[Back to Top]

BarHeight Property

Returns or sets a value for the height of the bars in a TAL Bar Code control.

Syntax

object.BarHeight [= number]

The BarHeight 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 of the bars in units of mils (.001 inches)

Remarks

The BarHeight property specifies only the height of the bars in all linear bar code symbologies. The default value for the BarHeight property is 1000 (1 inch).

The overall height of the bar code will depend on whether the human text is included in the symbol a well as if a comment is included.

[Back to Top]

BarWidthReduction Property

Returns or sets a percentage value for the reduction or gain of the width of the bars in a TAL Bar Code control.

Syntax

object.BarWidthReduction [= number]

The BarWidthReduction property syntax has these parts:

Part

Description

object

An object expression that evaluates to a TAL bar code object

number

A numeric expression 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).

For example, specifying a value of 50 causes the width of all bars in a bar code to be reduced by 50 percent.

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 TAL Bar Code 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 NarrowBarWidth that you choose for your bar codes. For example if you specify a BarWidthReduction value of 25 and your NarrowBarWidth 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 Bar Width Reduction 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.

[Back to Top]

BearerBars Property

Returns or sets a value that determines whether to include bearer bars around a bar code produced by the TAL Bar Code control.

Syntax

object.BearerBars [= boolean]

The BearerBars 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 bearer bars abound all bar code symbols.

Remarks

The purpose of bearer bars is to equalize the pressure exerted by a printing plate over the entire surface of the symbol. Bearer bars also enhance the reading reliability of a bar code by reduction of the probability of misreads or short scans which may occur when a skewed scanning beam enters or exits the symbol through the top or bottom edge of the bar code. When the scanner path leaves the symbol either through the top or bottom, it crosses the bearer bar, thereby resulting in an invalid start/stop code. Only the symbologies: Code 39, Code 93, Interleaved 2 of 5, CodaBar and Code 128 support bearer bars. This option is ignored by all other symbologies.

[Back to Top]

CodaBarOptionalCheckDigit Property

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

Syntax

object.CodaBarOptionalCheckDigit [= boolean]

The CodaBarOptionalCheckDigit 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 CodaBar bar code symbols.

Remarks

The optional check digit for the CodaBar bar code symbology is rarely used. If the CodaBarOptionalCheckDigit property is set to True, a check digit will be calculated using the modulo 16 sum of the values of all characters in the CodaBar bar code message. The check digit is then appended to the original message before the bar code is produced.

[Back to Top]

Code39OptionalCheckDigit Property

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

Syntax

object.Code39OptionalCheckDigit [= boolean]

The Code39OptionalCheckDigit 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 Code 39 bar code symbols.

Remarks

If the Code39OptionalCheckDigit property is set to True, a check digit will be calculated using the modulo 43 sum of the values of all characters in the Code 39 bar code message. The check digit is then appended to the original message before the bar code is produced.

[Back to Top]

Code39StartStopChars Property

Returns or sets a value that determines whether to display the start and stop characters in the human readable message in all Code 39 bar codes produced by the TAL Bar Code control.

Syntax

object.Code39StartStopChars [= boolean]

The Code39StartStopChars 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 display the start and stop characters in the human readable message in all Code 39 bar code symbols.

Remarks

The start and stop characters in a Code 39 bar code symbol are represented by asterisks at the beginning and end of every Code 39 bar code. Start and stop characters are always included in the actual bar code symbol for all Code 39 bar codes however they are not normally displayed in the human readable message that is printed with the bar code. If the Code39StartStopChars property is set to True, the asterisks are displayed at either end of the human readable message displayed with the bar code symbol.

Note: You do not need to enter the start and stop characters (asterisks) in the Message property for Code 39 bar codes because they are automatically included.

[Back to Top]

Comment Property

Returns or sets a string for the human readable comment printed with a bar code symbol produced by a TAL Bar Code control.

Syntax

object.Comment [= string]

The Comment property syntax has these parts:

Part

Description

object

An object expression that evaluates to a TAL bar code object

string

A string expression specifying the comment text. The maximum length of the comment string is 100 characters.

See Also

The CommentAlignment Property

The CommentOnTop Property

[Back to Top]

CommentAlignment Property

Returns or sets a value indicating how to align the human readable comment printed with a bar code symbol produced by a TAL Bar Code control.

Syntax

object.CommentAlignment [= number]

The CommentAlignment property syntax has these parts:

Part

Description

object

An object expression that evaluates to a TAL bar code object

number

A numeric expression specifying how the comment text is aligned, as described in Settings.

Settings

The settings for number are:

Constant

Setting

Description

bcLeftAlign

0

Left Alignment (Default) Align the comment with the left edge of the bar code symbol.

bcCenterAlign

1

Center Alignment Align the comment with the center of the bar code symbol.

bcRightAlign

2

Right Alignment Align the comment with the right edge of the bar code symbol.

See Also

The Comment Property

The CommentOnTop Property

[Back to Top]

CommentOnTop Property

Returns or sets a value that determines whether to display the comment line above all bar codes produced by the TAL Bar Code control.

Syntax

object.CommentOnTop [= boolean]

The CommentOnTop 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 display the human readable comment above all bar code symbols.

Remarks

The default value for the CommentOnTop property is True. Setting this property to False causes the comment to be displayed below the bar code symbol.

See Also

The Comment Property

The CommentAlignment Property

[Back to Top]

FontSize Property

Returns or sets the size of the font to be used for text displayed in a control.

Note The FontSize property is included for use with the CommonDialog control and for compatibility with earlier versions of Visual Basic. For additional functionality, use the new Font object properties.

Syntax

object.FontSize [= points]

The FontSize property syntax has these parts:

Part

Description

object

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

points

A numeric expression specifying the font size to use, in points, for all human readable text in a bar code symbol.

Remarks

Use this property to format text in the font size you want. The default is determined by the system. To change the default, specify the size of the font in points.

The maximum value for FontSize is 2160 points.

Note Fonts available with Visual Basic vary depending on your system configuration, display devices, and printing devices. Font-related properties can be set only to values for which fonts exist.

In general, you should change the FontName property before you set size and style attributes with the FontSize, FontBold, FontItalic, FontStrikethru, and FontUnderline properties. However, when you set TrueType fonts to smaller than 8 points, you should set the point size with the FontSize property, then set the FontName property, and then set the size again with the FontSize property. The Microsoft Windows operating environment uses a different font for TrueType fonts that are smaller than 8 points.

[Back to Top]

I2of5OptionalCheckDigit Property

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

Syntax

object.I2of5OptionalCheckDigit [= boolean]

The I2of5OptionalCheckDigit 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 Interleaved 2 of 5 (ITF) bar code symbols.

Remarks

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

See Also

Interleaved 2 of 5 Symbology Description

[Back to Top]

MatrixModuleSize Property

Returns or sets a value for the height and width of the modules in all matrix style (Aztec Code and Data Matrix) bar code symbols produced by a TAL Bar Code control.

Syntax

object.MatrixModuleSize [= number]

The MatrixModuleSize 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 and width in mils (.001 inches) of the modules in all matrix style (Aztec Code and Data Matrix) bar code symbols. The value for number may range between 1 and 100. (default = 20)

Remarks

Two dimensional matrix style symbologies are designed around an array of square dots or "modules". The MatrixModuleSize property sets the size of these modules and therefore determines the overall height and with of a matrix style bar code symbol. Most matrix style bar code symbologies specify that you select a module size between 10 and 60 mils with the preferred size of 20 mils.

[Back to Top]

MaxiCodeClass Property

Returns or sets a value for the service class when generating structured carrier messages to be encoded in a MaxiCode bar code symbol produced by a TAL Bar Code control.

Syntax

object.MaxiCodeClass [= number]

The MaxiCodeClass 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 service class when generating structured carrier messages to be encoded in a MaxiCode bar code symbol

Remarks

The Class is used in Mode 2 and Mode 3 MaxiCode symbols to identify the service class for a structured carrier message. This parameter is encoded in the Primary message in the symbol.

See Also

MaxiCode Symbology Description

[Back to Top]

MaxiCodeMode Property

Returns or sets a value for the Mode for all Maxicode bar code symbols produced by a TAL Bar Code control.

Syntax

object.MaxiCodeMode [= number]

The MaxiCodeMode 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 Mode for all Maxicode bar code symbols, as described in Settings. (default = 2)

 

Settings

The settings for value are:

Constant

Value

Description

bcUS_Carrier

2

Structured carrier mode for shipments within the US (default)

bcIntl_Carrier

3

Structured carrier mode for shipments outside the US

bcStandard_Symbol

4

Standard MaxiCode mode for general purpose (i.e. not for shipping applications)

bcReader_Program

6

Reader programming mode

Remarks

The current MaxiCode symbology specification supports 5 modes numbered 2 through 6.

Modes 2 and 3 are reserved for structured carrier messages for use by carriers in the transportation industry. Mode 4 is designed for use as a "Standard Bar Code" where the ZipCode, Country Code and the Service Class parameters are not used and only the data in the Message property is encoded in the bar code symbol. Mode 5 is similar to Mode 4 except that Mode 5 uses a higher level of error correction. The TAL Bar Code control does not support Mode 5 in the current release of the control. Mode 6 is reserved for "Reader Programming" purposes and it is up to the bar code reader manufacturer to determine how to interpret Mode 6 messages.

See Also

MaxiCode Symbology Description

[Back to Top]

MaxiCountryCode Property

Returns or sets a value representing the country used in Mode 2 or Mode 3 MaxiCode bar code symbols produced by a TAL Bar Code control.

Syntax

object.MaxiCountryCode [= number]

The MaxiCountryCode 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 country code for a MaxiCode bar code symbol.

Remarks

The Country Code is used in Mode 2 and Mode 3 symbols to identify the destination country for a structured carrier message. This parameter is encoded in the Primary message in the symbol.

See Also

MaxiCode Symbology Description

[Back to Top]

MaxiZipCode Property

Returns or sets a value for the height and width of the modules in all matrix style (Aztec Code and Data Matrix) bar code symbols produced by a TAL Bar Code control.

Syntax

object.MaxiZipCode [= string]

The MaxiZipCode property syntax has these parts:

Part

Description

object

An object expression that evaluates to a TAL bar code object

string

A string expression specifying the postal code to be encoded in a MaxiCode mode 2 or mode 3 bar code symbol.

Remarks

When generating Mode 2 or Mode 3 MaxiCode symbols, a postal code must be supplied that will be encoded in the primary message within the symbol. Mode 2 should be used when generating a structured carrier message for shipments within the USA therefore the MaxiZipCode property must consist of either a 5 or 9 digit postal ZIP Code (i.e. 5 or 9 numeric digits).

Mode 3 should be used when generating a structured carrier message for shipments outside the United States. In Mode 3, the MaxiZipCode property must consist of a valid postal code containing up to 6 AlphaNumeric characters. The MaxiZipCode property is encoded in the Primary message in the symbol.

See Also

MaxiCode Symbology Description

[Back to Top]

Message Property

Returns or sets a string for the message to be encoded in a bar code symbol produced by a TAL Bar Code control.

Syntax

object.Message [= string]

The Message property syntax has these parts:

Part

Description

object

An object expression that evaluates to a TAL bar code object

string

A string expression specifying the message text.

Remarks

Different symbologies allow different sets of characters to be encoded. For example UPC, EAN, PostNET and Interleaved 2 of 5 can only encode numeric digits (0-9) and CodaBar can only encode numeric digits and the alpha characters A,B,C and D. If you pass a message that contains illegal characters for a particular symbology, the TAL Bar Code control will raise a "BarCodeError" event and no bar code will be generated.

Note: When specifying UPC A, UPC E, EAN 8, EAN 13 and BookLand bar code messages, to include a 2 or 5 digit supplemental message, append the 2 or 5 digit supplemental message to the main message with a comma between them.

See Also

Bar Code Symbology Descriptions and Rules

[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.