flag german flag uk flag us Tip: Bookmark this page with Ctrl-D (Win) or Apple-D (Mac) MainProductsKnow How / FAQDownloadStoreContact



DISCONTINUED PRODUCT. PLEASE REFER TO OUR NEW .NET BARCODE LIBRARY AND CONTROL.

Manual - Forms Control Code EAN / ISBN - Reference

Properties

Name Type Comment
dataToEncode String Data to encode in the barcode, for EAN 8 / 13 all numeric with digits 0-9, for ISBN 10 / 13 numeric including all hyphens.

The control uses this string to auto-discriminate the required barcode type:

7 or 8 digits: Code EAN 8, ex. "1234567"
10 digits w/ hyphens: Code ISBN 10, ex. "1-123-12345-X"
13 digits w/ hyphens: Code ISBN 13, ex. "978-1-123-12345-8"
13 digits, starting with "978" or "979": Code ISBN 13, ex. "9781123123458"
12 or 13 digits: Code EAN 13, ex. "401234567890"

Default: "401234567890"
 
addon String Data to encode in the addon (or satellite) barcode of an ISBN. Must be 5 digits, e.g. "12345". Ignored for barcode types other than ISBN.

Default: ""
 
priceText String Text (usually pricing) to put above the addon (or satellite) barcode of an ISBN. Max. 10 characters, e.g. "$ 29.95 US". Ignored for barcode types other than ISBN. Will also be ignored if no addon was set (property addon empty string).

Default: ""
 
moduleWidth Float Width of the smallest bar (= module) in mm.

Should be in the allowed range for Code EAN: 0.33 equals 100%, actual value can range from 82% to 200%. This property is ignored if safeMode is set to true.

Default: 0.33 mm
 
moduleHeight Float Height of the barcode in mm.

Should be between 8 and 52 mm. This property is ignored if safeMode is set to true

Default: 26 mm
 
safeMode Boolean False: uses moduleWidth and -Height to determine size of barcode

True: ignores moduleWidth and -Height, creates a standard compliant, SC 2 (= 100%) sized barcode. Recommended for most applications.

Default: true
 
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 moduleHeight, moduleWidth (or safeMode property) and the encoded data.

Returns: Bitmap
 
bitpattern_ean13 String data Creates the actual bitpattern of a Code EAN 13 barcode in form of an array. Bars are set to '1' in the array, spaces are set to '0'. See the description of the C# sample for an example. Data must be 13 numeric characters, else an empty array will be returned.

Returns: char [] - Note: Returns an empty array when in demo mode.
 
bitpattern_ean8 String data Creates the actual bitpattern of a Code EAN 8 barcode in form of an array. Bars are set to '1' in the array, spaces are set to '0'. See the description of the C# sample for an example. Data must be 8 numeric characters, else an empty array will be returned.

Returns: char [] - Note: Returns an empty array when in demo mode.
 
bitpattern_addon String data Creates the actual bitpattern of a 5-digit addon barcode in form of an array. Bars are set to '1' in the array, spaces are set to '0'. Data must be 5 numeric characters, else an empty array will be returned.

Returns: char [] - Note: Returns an empty array when in demo mode.
 
checksum_ean13 String data Returns the check digit for an EAN 13 code. Data must be 12 numeric characters. To create a bitpattern, append the check digit as a character to your data, then call the respective bitpattern function.

Returns: int
 
checksum_ean8 String data Returns the check digit for an EAN 8 code. Data must be 7 numeric characters. To create a bitpattern, append the check digit as a character to your data, then call the respective bitpattern function.

Returns: int.
 
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, addon and priceText properties of the control are data-bindable. To bind properties at design time, select the control and hit F4 to display the properties; scroll down to DataBindings.

screenshot fc2

Select Advanced and click the "..." button to open the Advanced Binding Dialog:

screenshot fc2

Locate the properties 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 properties at runtime.