|
|
||||||||
|
||||||||
|
|
||||||||
| Home: Products: Barcode Components: Barcode ActiveX and DLL: User Manual | ||||||||
Index:
It is important to have the ability to test printed barcodes with a
barcode scanner.
If a scanner is not available for testing purposes, IDAutomation also provides
hand-held barcode scanner kits.
| ActiveX Barcode Control Installation & Overview |
The IDAutomation ActiveX Barcode Control supports several Linear and 2D barcode symbologies without the use of fonts. They are easy-to-use, "drag and drop" graphic objects that are compatible with Windows applications that support ActiveX including Microsoft Access, Word, Excel, InfoPath, Visual Basic, C++, FrontPage and Internet Explorer web pages. IDAutomation ActiveX Barcode Controls also function as DLLs that generate, print and save WMF images.
Three basic steps must be executed to utilize the IDAutomation ActiveX Barcode Control:
| Microsoft® Word Installation |
ActiveX Barcode Controls cannot be linked to a mail-merge field in Microsoft Word. If this implementation is needed, IDAutomation suggests using barcode fonts, which may be easily linked to a mail-merge source. More information about this subject is provided in the Microsoft Word Barcode Tutorial.
| Microsoft® Access Installation |
IDAutomation ActiveX Barcode Controls work very well in Microsoft Access. When used in reports and forms, the controls may be dragged into the design area and easily connected to database fields.
Open
the report in design mode.NOTE: When distributing Access Databases, the ActiveX Barcode Control must be installed on each computer used to print barcodes. For a simpler solution, IDAutomation also offers the Native Barcode Generator for Access, which is a complete barcode generator object that stays embedded in the database.
| Microsoft® Excel Installation |
ActiveX Barcode Controls may easily be used in Microsoft Excel and may be modified by referencing a cell or via the use of VBA code. ActiveX Controls cannot be used to easily populate a column in Excel; they must be placed one at a time. If this type of implementation is needed, IDAutomation suggests using barcode fonts, which can be easily used to produce a column of barcodes.
| Microsoft® FrontPage and HTML Installation |
ActiveX Barcode Controls may be used in HTML or Microsoft FrontPage to create barcodes in dynamically generated webpages, as demonstrated in the JavaScript Example. ActiveX Controls only work with Internet Explorer and other browsers that support ActiveX. If it is determined that support for other browsers is needed, IDAutomation suggests reviewing the Internet Barcode FAQ.
To use the control in FrontPage:

To use the control in HTML:
| Microsoft® Visual Basic |
IDAutomation ActiveX Barcode Controls work well in Visual Basic 6. When Visual Basic.NET is used, IDAutomation suggests using the .NET Forms Barcode Control instead of ActiveX because it is a managed code assembly and is easier to use in .NET. To activate the ActiveX Barcode Control in a VB 6 project, perform the following:
Methods of printing from the ActiveX Barcode Control in Visual Basic include the following:
| Microsoft® Visual C++ Installation |
| Microsoft® Visual FoxPro Installation |
| Adjusting Properties |
After activating the barcode control in the application, the properties of the control may be modified by code or by right-clicking on the control and selecting the properties option.
| Properties | |||||
| IDAutomation recommends using default values for all properties, unless requirements dictate otherwise. | |||||
| Name | Default | Description | |||
| AddCheckDigit | 1 | AddCheckDigit automatically adds the check digit to the barcode if it is equal to 1. The check digit is required for all symbologies except Code 39, Industrial 2 of 5 and Codabar barcodes. | |||
| AddCheckDigitToText | 1 | AddCheckDigitToText automatically adds the check digit that is encoded in the barcode to the human readable text that is displayed if it is equal to 1. | |||
| ApplyTilde | 1 | When ApplyTilde is set to "1" in Code 128 with the Auto character set, the format ~ddd may be used to specify the ASCII code of the character to be encoded and several other tilde options are enabled. | |||
| BackColor | 16777215 | The background color of the barcode specified as a number defined by the Visual Basic Color Constant. The background color represented as an integer number from 0 (black) to 16777215 (white) obtained by combining the red, green, and blue values (each ranging from 0 to 255) to represent a color with the following formula: ((red * 1) + (green * 256) + (blue * 65,536)). | |||
| BarHeight | 1 | The height of the barcode in centimeters (CM). | |||
| BearerBarHorizontal | 0 | The width of the horizontal bearer bars as a multiple of the XDimension; valid options are 0-10. | |||
| BearerBarVertical | 0 | The width of the vertical bearer bars as a multiple of the XDimension; valid options are 0-10. | |||
| CodabarStartCharacter | A | The Start Character in the Codabar barcode. | |||
| CodabarStopCharacter | B | The Stop Character in the Codabar barcode. | |||
| Code128CharSet | 0 | The set of characters to be used in Code128. Valid values are: Auto=0, A=1, B=2 or C=3. IDAutomation recommends using Auto. | |||
| DataToEncode | na | DataToEncode is the data which is to be encoded in the barcode. If the barcode control is connected to a control source, the source will override this property. | |||
| EANUPCSupplement | 0 | EANUPCSupplement is the number of digits the UPC or EAN supplement will contain. | |||
| FixedResolutionCM | 0 | Sets the pixels per CM. This is useful when it is necessary to set the resolution of the output image. The default setting is "0" which is an automatic selection. | |||
| Font | Arial 8 Points | Used to change the font or font point size of the text interpretation or human readable text. In VB, this property may be changed in code, for example: BarCode1.Font.Size = 10 BarCode1.Font.Name = "Times New Roman" | |||
| ForeColor | 0 | The color of the foreground text and bars
in the barcode specified by the Visual Basic Color Constant. The background
color represented as an integer number from 0 (black) to 16777215 (white)
obtained by combining the red, green, and blue values (each ranging from
0 to 255) to represent a color with the following formula: ((red * 1) +
(green * 256) + (blue * 65,536)). Black = 0. |
|||
| LeftMarginCM | 0.1 | The space of the left margin in centimeters (CM). | |||
| NarrowBarWidth or NarrowBarCM |
0.03 | NarrowBarWidth is the width in centimeters of the narrow bars. This is also referred to as the X dimension. The default is 0.03 CM, which is about .012" or 12 mils. This value may need to be increased if the scanner being used cannot read barcodes with small X dimensions. | |||
| Orientation | Zero degrees | Orientation indicates the orientation of the barcode. Valid values are Zero degrees, 90 degrees, 180 degrees and 270 degrees. | |||
| Picture | image | Returns a WMF image without resolution information. | |||
| PostnetHeightShortBar | 0.125 | The size in centimeters of the short bars when using Planet and Postnet symbologies, and the tracker bar when using the Intelligent Mail (formerly OneCode). | |||
| PostnetHeightTallBar | 0.30 | The size in centimeters of the tall bars when using Intelligent Mail (formerly OneCode), Planet and Postnet symbologies. | |||
| ShowText | Yes | If ShowText is yes (the default), the human readable text will be displayed with the barcode. | |||
| SupplementToEncode | null | The 2 or 5 digit supplement to be encoded after the UPC or EAN barcodes. This property will populate automatically when the extra digits are added to the DataToEncode. | |||
| SymbologyID | 13 |
A number that selects the symbology or barcode type:
|
|||
| TopMarginCM | 0.06 | The top margin in centimeters. | |||
| UPCESystem | 0 | The encoding system to be used for UPC-E; valid values are 0 and 1. | |||
| WhiteBarIncrease | 0 | A percentage value to increase the white space between the bars to improve readability. Common values are 10, 15, 20 and 25. * | |||
| Wide2NarrowRatio | 2 | The wide to narrow ratio of symbologies that only contain narrow and wide bars such as Code 39, Interleaved 2 of 5 and MSI. Common values are 2, 2.5, 2.75 and 3. | |||
| Methods | |||||
| GetEnhWMF() | Returns an enhanced WMF image with resolution information. | ||||
| GetXPixels() | GetXPixels returns the X dimension pixels of the image after it is created. | ||||
| GetYPixels() | GetYPixels returns the Y dimension pixels of the image after it is created. | ||||
| SaveBarCode(path as String) | SaveBarCode saves a WMF file without any resolution information. | ||||
| SaveEnhWMF(path as String) | SaveEnhWMF saves a WMF file with resolution information. | ||||
| SetPixelsXY(XPixels as Long,YPixels as Long) | SetPixelsXY sets the pixels of the WMF file. | ||||
| Data Matrix Specific Properties: | |||||
| IDAutomation recommends using default values for all properties, unless requirements dictate otherwise. | |||||
| Name | Default | Description | |||
| EncodingMode | E_BASE256 | Valid Encoding Mode values are E_ASCII, E_C40, E_TEXT or E_BASE256. | |||
| MarginCM | 0.10 | The top and bottom margin in centimeters. | |||
| NarrowBarCM | 0.05 | The width in centimeters of the narrow bars; which is also referred to as the X dimension. The default is 0.05 CM which is about .02" or 20 mils. This value may need to be increased if the scanner cannot read barcodes with small X dimensions. When working with a high quality imager, this value may be decreased to obtain a higher density barcode. | |||
| PreferredFormat | -1 | Sets the preferred format represented by a number; valid values are from 0 (10X10) to 23 (144X144) and from 24 (8X18) to 29 (16X48); the default value of -1 is used for automatic formatting. | |||
| ProcessTilde | No | When set to "Yes", the tilde (~) will be processed as explained in the DataMatrix FAQ. | |||
| MaxiCode Specific Properties: | |||||
| IDAutomation recommends using default values for all properties, unless requirements dictate otherwise. | |||||
| Name | Default | Description | |||
| ApplyTilde | 1 | When set to "1," the format ~ddd may be used to specify the ASCII code of the character to be encoded as explained in the Maxicode FAQ. A setting of "0" will disable ApplyTilde. | |||
| Country | na | A 3 digit number representing the country code. Proper implementation for UPS and other transportation applications will automatically override this field. | |||
| Mode | 2 | The mode of compression and encoding used in the symbol. Modes 2 and 3 are designed for use in the transport industry. Mode 4 encodes up to 93 characters or 138 digits. Mode 5 encodes up to 77 characters and provides more error correction capabilities than mode 4. Mode 6 indicates that the symbol encodes a message used to program a reader system or scanner. | |||
| ServiceClass | na | A 3-digit number representing the service code. Proper implementation for UPS and other transportation applications will automatically override this field. | |||
| ZipCode | na | The postal code; mode 2 uses a 9 digit numeric postal code and mode 3 uses a 6 character alphanumeric postal code. Proper implementation for UPS and other transportation applications will automatically override this field. | |||
| PDF417 Specific Properties: | |||||
| IDAutomation recommends using default values for all properties, unless requirements dictate otherwise. | |||||
| Name | Default | Description | |||
| ErrorCorrectionLevel | 2 | The Reed Solomon error correction level encoded in the symbol. More error correction creates a larger symbol that can withstand more damage. | |||
| MacroPDFEnable | 0 | When set to "1," indicates that this barcode is part of a MacroPDF sequence. | |||
| MacroPDFFileID | 0 | Assigns a File ID to the MacroPDF barcode. Each barcode in the MacroPDF sequence must have the same File ID assigned to it. Valid options are 0-899. | |||
| MacroPDFSegmentIndex | 0 | The index number of each MacroPDF symbol must have a unique segment index, starting at zero and incrementing thereafter by one. | |||
| MacroPDFLastSegment | 0 | When set to "1," indicates that this is the final barcode in the MacroPDF sequence. | |||
| PDFColumns | 5 | The number of data columns in the PDF417 barcode. The default is 5 and the maximum is 30. | |||
| PDFMode | Binary | The mode of compaction used to encode data in the symbol. When set to "Text", a smaller symbol may be created. Text mode encodes all characters on the US keyboard plus returns and tabs. Binary mode encodes ASCII 1 to 254. | |||
| PDFRows | 0 | Sets the number of rows. It is recommended to leave this setting at 0, the default. | |||
| Truncated | 0 | A truncated PDF417 symbol is more area efficient than normal PDF417. When set to true, the right hand side of the PDF417 is removed or truncated. | |||
| XtoYRatio | 3 | The X multiple height of individual cells; default = 3, usually 2 to 4 times the NarrowBarCM (X). | |||
| Aztec Specific Properties: | |||||
| IDAutomation recommends using default values for all properties, unless requirements dictate otherwise. | |||||
| Name | Default | Description | |||
| ApplyTilde | False | When set to "True," the format ~d??? may be used to specify the ASCII code of the character to be encoded. Commonly used ASCII codes are ~d009 which is a tab function and ~d013 which is a return function. | |||
| MessageAppend | na | Specifies the message appended across multiple symbols. Only valid if NumberOfSymbols is greater than 1. | |||
| NumberOfSymbols | 1 | Invokes MessageAppend across # symbols | |||
| XDimensionCM | 0.06 | The width in centimeters of the narrow bars. This value may need to be increased if the scanner cannot read barcodes with small X dimensions. When working with a high quality imager, this value may be decreased to create a smaller symbol. | |||
* When used with low-resolution devices such as the display screen, changes within the WhiteBarIncrease property value may not be visible in the barcode control itself. However, the change will usually be shown when printed, if a printer with 300 dpi or greater is used. In addition, when saving the barcode as an image, WhiteSpaceIncrease can usually be seen with the SaveBarCode property, but not with the SaveEnhWMF property due to SaveEnhWMF formatting the image to the screen resolution.
| Developer Notes for Programmers |
Distribution with an Application
The file(s) to distribute after installation reside in the "WinSys" directory and begin with "IDAutomation." When distributing the ActiveX Barcode Control, it is necessary to copy it to the "System" directory of the destination PC and then register the DLL. This process may be automated with installation utilities.
IDAutomation ActiveX Barcode Controls are packaged with the Setup Generator Pro application by Gentee. Within the Setup Generator Pro application, the "Register as OCX or DLL" option must be selected for each ActiveX DLL file that is to be registered. This is an easy-to-use, yet powerful application that does not have any runtime requirements. Other setup applications are also available that register DLLs such as CreateInstall and the Windows Installer.
Multi-Threading:
Many instances of the ActiveX object within the application may be created as needed. However, the DLL does not support multi-threading and will not run as a separate process.
| Technical Support |
Free product support may be obtained by reviewing articles that are documented at the ActiveX Barcode Control Support Site and by searching the resolved public help desk issues. Priority phone, email and help desk support is also provided up to 30 days after purchase. Additional priority phone, email and help desk support may be obtained if the Priority Support and Upgrade Subscription is active.
| Related Products and Information |
|
|
|
Product Quick Links: [Barcode Fonts | Font Tools | Components | Label Software | Scanners | Printers | RFID | Product Index] |
© Copyright 2000-2008 IDAutomation.com, Inc., All Rights Reserved. Legal Notices.
|
Over 70% of Fortune 100 companies use IDAutomation products to automate their businesses. |