Menu

DataMatrix ActiveX Properties

DataMatrix BarCode ActiveX Properties



DataToEncode Property
Returns or sets the data that is to be encoded in the barcode.

Syntax
object.DataToEncode [ = sDataToEncode ]
Possible Values
DataToEncodeString that specifies or receives the barcode data.

The property is read/write.
Control characters and use of the tilde
To insert special characters, the "~" character is used. Below you can see available values of special characters.
  • ~1: Represents the character FNC1. When FNC1 appears in the first position (or in the fifth position of the first symbol of a Structured Append), it will indicate that the data conforms to the UCC/EAN Application Identifier standard format.
  • ~2: Not allowed.
  • ~3: This character are only allowed in the first position of the symbol. It indicates that the data contains commands for the barcode reader.
  • ~4: Not allowed.
  • ~5 and ~6: These characters are only allowed in the first position of the symbol. If ~5 is used the header [)> ascii30 ascii05 ascii29 will be transmitted by the barcode reader before the data in the symbol and the trailer ascii30 ascii04 will be transmitted after the data. If a ~6 is used , the header [)> ascii30 ascii05 ascii29 will be transmitted by the reader before the data and the trailer ascii30 ascii04 will be transmitted afterwards.
  • ~7NNNNNN: Specifies the Extended Channel to be used, where NNNNNN is a value between and 000000 - 999999. For example: ~7000010 means Extended Channel 10. An Extended Channel Interpretation (ECI) is used to change from the default interpretation used to encode data. This mechanism enables characters from other character sets (e.g. Arabic, Cyrillic, Greek, Hebrew) and other data interpretations or industry-specific requirements to be represented. The ECI can only be used with readers enabled to transmit the symbology identifiers.
  • ~xNN: Represents the hexadecimal value of NN, for example, if there is a combination of "~xA7", it will be replaced with the hexadecimal value of A7.
  • ~~: Represents the "~" character. This combination can be used to assign its usual value to the "~" character, thus, "~~1" does not mean FNC1, but two characters "~" and "1".
  • ~R: Represents the carriage return character.
  • ~N: Represents the new line character.



PreferredFormat Property
Returns or sets the the preferred format of the DataMatrix barcode. See for more detail here.

Syntax
object.PreferredFormat [ = ePreferredFormat ]
Possible Values
ePreferredFormatValue that specifies or receives the preferred format.

ValueConstantDescription
0fAutoThe format is selected automatically, i.e. the minimal available matrix allowing to encode the data is selected.
1f10x1010x10
2f12x1212x12
3f14x1414x14
4f16x1616x16
5f18x1818x18
6f20x2020x20
7f22x2222x22
8f24x2424x24
9f26x2626x26
10f32x3232x32
11f36x3636x36
12f40x4040x40
13f44x4444x44
14f48x4848x48
15f52x5252x52
16f64x6464x64
17f72x7272x72
18f80x8080x80
19f88x8888x88
20f96x9696x96
21f104x104104x104
22f120x120120x120
23f132x132132x132
24f144x144144x144
25f8x188x18
26f8x328x32
27f12x2612x26
28f12x3612x36
29f16x3616x36
30f16x4816x48

The property is read/write.



EncodingMode Property
Returns or sets the encoding mode of the DataMatrix barcode. See for more detail here.

Syntax
object.EncodingMode [ = eEncodingMode ]
Possible Values
eEncodingModeValue that specifies or receives the encoding mode of the DataMatrix barcode

ValueConstantDescription
0eAutoAuto
1eASCIIASCII
2eC40C40
3eTEXTTEXT
4eBASE256BASE256
5eEDIFACTEDIFACT
6eANSIX12ANSI X12

The property is read/write.



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.



Transparent Property
Returns or sets a value indicating whether the background of a DataMtrix 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.



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




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.



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

Syntax
object.QuietZone [ = bQuietZone ]
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.



AlignH Property
Returns or sets a horizontal barcode alignment.

Syntax
object.AlignH [ = eAlignH ]
Possible Values
eAlignHValue that specifies or receives the horizontal barcode alignment

ValueConstantDescription
0hLeftleft
1hCentercenter
2hRightright

The property is read/write.



AlignV Property
Returns or sets a vertical barcode alignment.

Syntax
object.AlignV [ = eAlignV ]
Possible Values
eAlignVValue that specifies or receives the vertical barcode alignment

ValueConstantDescription
0vToptop
1vCentercenter
2vBottombottom

The property is read/write.



Picture Property
Returns or sets a barcode picture object.

Syntax
object.Picture [ = Picture ]
Possible Values
picturespecifies or receives the barcode picture object

The property is read/write.



StructuredAppend Property
Returns or sets a value that determines whether to enable the structured append.

Syntax
object.StructuredAppend [ = bStructuredAppend ]
Possible Values
bStructuredAppendBoolean that specifies or receives the StructuredAppend property

The property is read/write.
Remarks
Structured append allows files of data to be represented in up to 16 Data Matrix symbols. The original data can be correctly reconstructed regardless of the order in which the symbols are scanned.



StructuredAppendPos Property
Returns or sets a value that determines the matrix position in the structured append.

Syntax
object.StructuredAppendPos [ = iStructuredAppendPos ]
Possible Values
iStructuredAppendPosInteger that specifies or receives the StructuredAppendPos property

The property is read/write.
Remarks
This value indicates the position of the datamatrix symbol within the set (up to 16) of ECC 200 symbols in the Structured Append format.



StructuredAppendTotal Property
Returns or sets a value that determines the total number of the symbols to be concatenated in the Structured Append format.

Syntax
object.StructuredAppendTotal [ = iStructuredAppendTotal ]
Possible Values
iStructuredAppendTotalInteger that specifies or receives the StructuredAppendTotal property

The property is read/write.



StructuredAppendID Property
Returns or sets a value that determines the Structured Append identification.

Syntax
object.StructuredAppendID [ = iStructuredAppendID ]
Possible Values
iStructuredAppendIDInteger that specifies or receives the StructuredAppendID property

The property is read/write.
Remarks
The purpose of the Structured Append identification is to increase the probability that only logically linked symbols are processed as part of the same message.



QuietZoneSize Property
Returns or sets a value that determines the quiet zone size. QuietZoneSize is measured in modules. Module is a single cell in a matrix symbology used to encode one bit of data.

Syntax
object.QuietZoneSize [ = iQuietZoneSize ]
Possible Values
iQuietZoneSizeInteger that specifies or receives the QuietZoneSize property

The property is read/write.
Remarks
This property does not make sense if the QuietZone property is equal to False. The minimum size of a quiet zone set by the standard ISO/IEC 16022:2000 is one module.



IsDataToEncodeOk Property
Returns the value indicating whether the DataToEncode property is set correctly.

Syntax
object.IsDataToEncodeOk
Possible Values
bIsDataToEncodeOkBoolean that receives the IsDataToEncodeOk property

The property is read only.



IsMatrixSizeOk Property
Returns the value indicating whether the matrix size is specified correctly.

Syntax
object.IsMatrixSizeOk
Possible Values
bIsMatrixSizeOkBoolean that receives the IsMatrixSizeOk property

The property is read only.



MatrixFormat Property
Returns the actual format in which the matrix is encoded. This property can be useful if PreferredFormat=Auto. In this case, only the MatrixFormat property can give you the actual format of the matrix that was used in the Auto mode.

Syntax
object.MatrixFormat [ = eMatrixFormat ]
Possible Values
eMatrixFormatInteger that specifies or receives the MatrixFormat property

The property is read only.