| Tip: Bookmark this page with Ctrl-D (Win) or Apple-D (Mac) | Main • Products • Know How / FAQ • Download • Store • Contact |
DISCONTINUED PRODUCT. PLEASE REFER TO OUR NEW .NET BARCODE LIBRARY AND CONTROL.
Manual - Forms Control Datamatrix - Reference
Properties| Name | Type | Comment |
| dataToEncode | String |
Data to encode in the barcode. String can have up to 3,000 characters. The capacity of Datamatrix is (roughly) as follows:
Alphanumeric data: max c. 2,300 characters; binary data (8 bits): max c. 1,500 characters; numeric data: max c. 3,000
characters.
To encode non-printable charaters, e.g. a TAB, use the tilde, followed by the ASCII code, left padded with "0" to three digits. E.g. to encode a TAB, write "~009". To encode a tilde, write "~0126". Note: When encoding non-printable characters or those with an ASCII code above 128 (e.g. german umlauts or french accented characters) make sure your scanner can actually read and transmit such data - this is not a given, especially if the scanner emulates a keyboard, e.g. via a wedge or USB. In some cases you will have to resort to using a serial scanner. Default: "Datamatrix" |
| moduleSize | Float |
Length of one side a single (square) module in mm.
The smallest acceptable value depends on the print resolution, the smallest usable value will be around 0.25 mm. Default: 1.0 mm |
| symbolRows | Int |
Number of rows of the generated bit pattern, only useful in connection with the bitpattern routine, see below. Read-only property.
Default: 0 |
| symbolCols | Int |
Number of columns of the generated bit pattern, only useful in connection with the bitpattern routine, see below. Read-only property.
Default: 0 |
| marginX | Float |
Left and right margin of the barcode. Should not be under 5 mm.
Default: 5 mm. |
| marginY | Float |
Top and bottom margin of the barcode. Should not be under 5 mm.
Default: 5 mm. |
Methods
| Name | Parameter | Comment |
| createCode | Float dpi |
Creates a barcode, returns a Bitmap with the code. The dpi parameter determines the output resolution, e.g. 300 for 300 dpi.
The actual dimensions of the barcode (and, hence, the returned bitmap) are determined from the moduleSize and the encoded data.
Returns: Bitmap |
| bitpattern_datamatrix | String data |
Creates the actual bitpattern of a Datamatrix barcode in form of a one dimensional array. Use the symbolRows and symbolCols
properties to iterate through the array. Modules are set to '1' in the array, spaces are set to '0'.
Will also perform the tilde-substitution as described above. See the description of the C# sample for an example.
Returns: char [] - Note: Returns an empty array when in demo mode. |
| resetToDefaults | void |
Resets all properties to the defaults as described in this document.
Returns: void |
| unlock | String user String key |
Unlock the control and remove the restrictions of the demo. See the supplied sample projects for an example.
Returns: Boolean - True: Successfully unlocked; False: Error. |
Data binding
The dataToEncode property of the control is data-bindable. To bind the property at design time, select the control and hit F4 to display the properties; scroll down to DataBindings.
Select Advanced and click the "..." button to open the Advanced Binding Dialog:
Locate the dataToEncode property in the list and open the Binding drop-down to select an existing data source or to create a new datasource.
Of course it's also possible to data bind the property at runtime.