Menu

DataMatrix .NET Control Properties


Barcodes.DataMatrix Namespace

DataMatrixControl Class
Barcodes.DataMatrix.dll assembly
 
DataToEncode Property
Returns or sets the data that is to be encoded in the barcode.

Syntax
object.DataToEncode [ = sDataToEncode ]
Possible Values
DataToEncode String 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.

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

The property is read/write.



EncodingMode Property
Returns or sets the encoding mode of the DataMatrix barcode.

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

The property is read/write.



Orientation Property
Returns or sets the orientation of the barcode.

Syntax
object.Orientation [ = eOrientation ]
Possible Values
Orientation Orientations Value that specifies or receives the orientation of the barcode.

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
bTransparent Boolean 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
sColor Color Value that specifies or receives the background color

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
sColor Color Value 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
bShowQuietZone Boolean 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
eAlignH HorizontalAlignment Value that specifies or receives the horizontal barcode alignment


The property is read/write.



AlignV Property
Returns or sets a vertical barcode alignment.

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


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
bStructuredAppend Boolean 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
iStructuredAppendPos Integer 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
iStructuredAppendTotal Integer 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
iStructuredAppendID Integer 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
iQuietZoneSize Integer 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
bIsDataToEncodeOk Boolean 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
bIsMatrixSizeOk Boolean 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
eMatrixFormat PreferredFormats Value that specifies or receives the MatrixFormat property

The property is read only.