Barcode ActiveX Manual Barcode Generation in Access, VB, on the Web, and more Information in this document is subject to change without notice and does not represent a commitment on the part of TAL Technologies, Inc. The software described in this document is furnished under a license agreement. The software may be used or copied only in accordance with the terms of this agreement. No part of this manual may be reproduced or transmitted in any form or by any means, electronic or mechanical, including photocopying and recording, for any purpose without the express written consent of TAL Technologies Inc. TAL Technologies, Inc. 2101 Brandywine Street, Suite 102, Philadelphia PA 19130 ● 215-496-0222 ● www.taltech.com © 1994 – 2015 ● All Rights Reserved ● Revision 2e ● Last Updated 08/18/2015 Table of Contents Table of Contents ........................................................................................................................... 1 Introduction ................................................................................................................................... 4 License Agreement ........................................................................................................................ 5 Distributing the ActiveX Control .................................................................................................. 7 Desktop Application ....................................................................................................................... 7 Web Application ............................................................................................................................ 8 Properties of the ActiveX Control ............................................................................................... 10 AutoSize Property ........................................................................................................................ 10 AztecPctECC Property .................................................................................................................. 11 AztecSymbolType Property ......................................................................................................... 12 AztecTotalLayers Property .......................................................................................................... 13 BackColor, ForeColor, TextColor Property .................................................................................. 14 BackStyle Property ....................................................................................................................... 15 BarHeight Property ...................................................................................................................... 16 BarWidthReduction Property ...................................................................................................... 17 BearerBars Property .................................................................................................................... 18 BitsPerPixel Property ................................................................................................................... 19 BMPCompression Property ......................................................................................................... 20 CodaBarOptionalCheckDigit Property ........................................................................................ 21 Code39OptionalCheckDigit Property .......................................................................................... 22 Code39StartStopChars Property .................................................................................................. 23 Comment Property ....................................................................................................................... 24 CommentAlignment Property ..................................................................................................... 25 CommentOnTop Property ........................................................................................................... 26 DataBindings Property ................................................................................................................ 27 DataField Property ....................................................................................................................... 28 DataMatrixECC Property ............................................................................................................. 29 DataMatrixFormatID Property .................................................................................................... 30 DataMatrixTildeCodes Property .................................................................................................. 31 DataSource Property .................................................................................................................... 33 Font Property ............................................................................................................................... 34 FontName Property ..................................................................................................................... 35 FontSize Property ........................................................................................................................ 36 FontBold, FontItalic, FontStrikethru, FontUnderline Properties ............................................... 37 GIFCompression Property ........................................................................................................... 38 I2of5OptionalCheckDigit Property .............................................................................................. 39 JPEGQuality Property .................................................................................................................. 40 LZWUnlockKey Property ............................................................................................................. 41 MatrixModuleSize Property ........................................................................................................ 42 MaxiCodeClass Property .............................................................................................................. 43 MaxiCodeMode Property ............................................................................................................. 44 MaxiCountryCode Property ......................................................................................................... 45 MaxiSymbolNum and MaxiNumSymbols Properties ................................................................. 46 Barcode ActiveX Manual Table of Contents • Page 1 of 110 MaxiZipCode Property ................................................................................................................. 47 Message Property ......................................................................................................................... 48 NarrowBarWidth Property.......................................................................................................... 49 NarrowToWideRatio Property .................................................................................................... 50 PDFAspectRatio Property ............................................................................................................ 51 PDFMaxCols Property .................................................................................................................. 52 PDFMaxRows Property ................................................................................................................ 53 PDFModuleHeight Property ........................................................................................................ 54 PDFModuleWidth Property ......................................................................................................... 55 PDFPctOverhead Property ........................................................................................................... 56 PDFSecurityLevel Property ......................................................................................................... 57 PDFTruncatedSymbol Property .................................................................................................. 58 PNGFilter Property ...................................................................................................................... 59 PNGInterlace Property................................................................................................................. 60 QuietZones Property .................................................................................................................... 61 RasterImageResolution Property ................................................................................................ 62 Rotation Property......................................................................................................................... 63 ShowCheckDigit Property ............................................................................................................ 64 ShowHRText Property ................................................................................................................. 65 Symbology Property .................................................................................................................... 66 TextOnTop Property .................................................................................................................... 67 TiffCompression Property ........................................................................................................... 68 TGACompression Property .......................................................................................................... 69 UccEanOptionalCheckDigit Property .......................................................................................... 70 Methods of the ActiveX Control ................................................................................................... 71 Refresh Method ............................................................................................................................ 71 SaveBarCode Method ................................................................................................................... 72 Events of the ActiveX Control ...................................................................................................... 74 BarCodeError Event ..................................................................................................................... 75 Articles and Tips ........................................................................................................................... 76 Introduction to Barcode Technology .......................................................................................... 76 How a Barcode Reader Works..................................................................................................... 77 Barcode Graphic Formats ............................................................................................................ 78 Raster Graphics ..................................................................................................................... 78 Fonts...................................................................................................................................... 79 Vector Graphics .................................................................................................................... 79 Barcode Dimensions .................................................................................................................... 81 Linear (1D) ............................................................................................................................ 81 Matrix (2D) ............................................................................................................................ 82 How to Produce Readable Barcodes ........................................................................................... 83 Symbology Descriptions and Rules.............................................................................................. 84 Code 39 ......................................................................................................................................... 85 UPC-A, UPC-E, and UPC Supplementals ....................................................................................... 88 EAN-8 / EAN-13, and EAN Supplementals ................................................................................... 89 BookLand ..................................................................................................................................... 90 Code 93 ......................................................................................................................................... 91 Barcode ActiveX Manual Table of Contents • Page 2 of 110 CodaBar ........................................................................................................................................ 92 Interleaved 2 OF 5 (ITF) ............................................................................................................... 93 Code 128 ....................................................................................................................................... 94 GS1-128 (Formally EAN/UCC 128) ................................................................................................ 95 MSI (Modified Plessey)................................................................................................................. 96 POSTNET ...................................................................................................................................... 97 PDF417.......................................................................................................................................... 98 Aztec Code .................................................................................................................................. 101 Data Matrix ................................................................................................................................ 102 MaxiCode .................................................................................................................................... 106 GS1 DataBar (Formally RSS-14) ................................................................................................. 108 Manual Revisions ........................................................................................................................ 110 Barcode ActiveX Manual Table of Contents • Page 3 of 110 Introduction Congratulations! You have purchased the most powerful and most versatile barcode programming tool available for Microsoft Windows. Barcode ActiveX has all the features necessary to easily add professional quality barcodes to your own Windows applications including database, product packaging, document tracking, postal bar coding and special purpose barcode labeling applications. Not only is Barcode ActiveX powerful, it is also extremely easy to use and will work flawlessly with any Windows application that can host ActiveX controls including MS Word, Access, Visual Basic, Excel, PowerPoint, C++, etc.. The "Plus" version of the control can even be used on a web server to generate barcode graphics as GIF, JPEG or PNG files dynamically using CGI/Perl code or Active Server Pages. This makes it the perfect tool for producing browser as well as platform independent Internet based barcode applications. Barcode ActiveX supports all commonly used barcode symbologies and it allows complete control over all features of each individual symbology including: precise control over all barcode dimensions, full selection for the foreground, background and text colors, symbol rotation in 90 degree increments and complete font selection for the human readable text above or below a barcode symbol. Barcode ActiveX is also a data bound control which allows you to easily incorporate it into database reporting and labeling applications. In addition to all of the traditional 1 dimensional barcode symbologies like Code 39, UPC, EAN, Code 128, PostNET, Codabar, Bookland, HIBC and Interleaved 2 of 5, Barcode ActiveX also supports the newest two dimensional barcodes including PDF417, Aztec Code, Data Matrix and Maxicode, making it the most advanced barcode development tool available on the market today. Unlike other products that create low quality bitmaps or use fonts to produce a barcode symbol, the Barcode ActiveX control draws itself using high resolution Windows Metafile (vector) graphics that are completely device independent, fully scalable, and will print to the highest resolution of any printer supported by Windows. No knowledge of the printer resolution is required in advance, the graphics that are produced are extremely precise and require minimal system resources, and all barcodes will display and print lightning fast. In addition to Windows Metafile vector style graphics, the "Plus" version of the control is also capable of saving barcode images to disk in all major graphic file formats including GIF, JPEG, PNG, TIF, EPS, BMP, WMF, TGA and PCX. If you are a developer and plan to distribute the control with your application, you will be happy to know that the total uncompressed size of all the files that you need to distribute with your application is less than 500Kb. The compressed size is typically less than 200Kb. In fact, only four small files are required to provide complete support for all of the different types of barcodes. The control was authored using the Microsoft Active Template Library (ATL) therefore there are no runtime dependencies or additional files that need to be included when you distribute the control with your application. You simply cannot obtain a higher quality barcode in the Windows environment than those produced by Barcode ActiveX. Barcode ActiveX Manual Introduction • Page 4 of 110 License Agreement I. GRANT OF LICENSE TAL Technologies, Inc. grants you the right to use one copy of the enclosed software program (the SOFTWARE) on a single terminal connected to a single computer (i.e., with a single CPU). You may not network the SOFTWARE or otherwise use it on more than one computer or computer terminal at the same time. II. LICENSE TO DISTRIBUTE BARCODE ACTIVEX. Depending on the license purchased, you have a royalty free right to distribute up to twenty five (25) or ten thousand (10,000) copies of the unmodified ActiveX control (TalBarCd.OCX) and its supporting dynamic link libraries (.DLL files) with your own application programs provided you adhere to the following terms: a. You must not distribute the license file TALBC.LIC or the help file TALBC.HLP (modified or unmodified). (The license file is used by Barcode ActiveX when working in a program development environment and it is not required for use of the control in a compiled application.) b. Any product that you create using the TAL barcode DLLs must not compete with Barcode ActiveX in any way; e.g.; Your product must not be a software development tool (.EXE, .DLL, .VBX, .OCX, OLE Object, etc.) intended for distribution to other software developers or system integrators. You may not extend access to the OCX properties, methods or events either directly or indirectly. c. If you distribute any application that uses any of Barcode ActiveX or the DLL files, a valid copyright notice must be provided within the user documentation and/or start-up screen of your application that specifies TAL Technologies, Inc. as the legal copyright owner, e.g., "All barcode technology provided in this product is copyrighted by TAL Technologies, Inc." d. Distribution of Barcode ActiveX in any quantity exceeding ten thousand units is subject to additional license fees which are due and payable to TAL Technologies, Inc. A Product Distribution Disclosure form must be filed quarterly for any product developed and distributed in quantities over and above 10,000 units. A disclosure form is available from TAL Technologies, Inc. upon request. e. You must register your ownership of this product with TAL Technologies, Inc. in order to activate your distribution rights. III. COPYRIGHT The SOFTWARE is owned by TAL Technologies, Inc. and is protected by United States copyright laws and treaties. Therefore, you must treat the SOFTWARE like any other copyrighted material (e.g., a book or musical recording) except that you may either (a) make one copy of the SOFTWARE solely for backup or archival purposes, or (b) transfer the SOFTWARE to a single hard disk provided you keep the original solely for backup or archival purposes. You may not copy the user’s manual accompanying the SOFTWARE. Barcode ActiveX Manual License Agreement • Page 5 of 110 IV. OTHER RESTRICTIONS You may not rent or lease the SOFTWARE, but you may transfer the SOFTWARE and accompanying written materials on a permanent basis provided you retain no copies and the recipient agrees to the terms of this Agreement. You may not reverse engineer, decompile, or disassemble the SOFTWARE. If SOFTWARE is an update, any transfer must include the update and all prior versions. V. DISCLAIMER No Warranty of any kind on the SOFTWARE is expressed or implied. In no event shall TAL Technologies, Inc. or its suppliers be liable for any damages whatsoever (including, without limitation, damages for loss of business profit, business interruption, loss of business information or other pecuniary loss) arising out of the use of or inability to use this product. Should you have any questions concerning this agreement, or wish to contact TAL Technologies, Inc. for any reason please use the following address and contact details: TAL Technologies, Inc. Address 2101 Brandywine Street Suite 102 Philadelphia, PA 19130 Phone (215)-496-0222 Fax (215)-496-0322 Email [email protected] Website http://www.taltech.com/ Barcode ActiveX Manual License Agreement • Page 6 of 110 Distributing the ActiveX Control The Barcode ActiveX control can be distributed either as part of a desktop application or a web application. Desktop Application When you develop a desktop application that incorporates Barcode ActiveX, you must adhere to the following installation guidelines in order for your application to function correctly. Files that may be distributed The following files should be installed along with your application into the specified locations: File Path Notes TALBC.DLL Windows\System Required TALBARCD.OCX Windows\System or your Required and must be registered into the user’s system application’s path registry by your installation program. See Notes below. TALBCMX.DLL Windows\System Required for 2D Maxicode barcodes TALBCDMX.DLL Windows\System Required for 2D Data Matrix barcodes TALRSS14.DLL Windows\System Required for RSS14 barcodes Note: If you purchased Barcode ActiveX Linear, the files "TALDMX.DLL", "TALMX.DLL" and “TALRSS14.DLL will not be included with the package. These files are only included with the Plus version. Most application installation packages including the Visual Basic Application Setup Wizard, InstallShield, etc. will automatically register OCX files that are included as part of an application installation package therefore in most cases you will not have to explicitly register the OCX from your installation program. The Wise Install Builder is one exception to this. With the Wise Install system you must specifically set parameters that tell the Wise installation system to register the OCX. This is done by displaying the Details for the OCX file after you add it to your installation and then choosing the "Self Register OCX…" option. To register or unregister the OCX manually you can use the REGSVR32.EXE program that is provided with Windows using the following syntax: REGSVR32 pathname\TALBARCD.OCX (to register the OCX) REGSVR32 /u pathname\TALBARCD.OCX (to un-register the OCX) where pathname is the directory path where you have installed the TALBARCD.OCX file. Barcode ActiveX Manual Distributing the ActiveX Control • Page 7 of 110 Files that may not be distributed None of the other files provided with Barcode ActiveX may be distributed with your application including the files: TALBC.HLP, TALBC.LIC or any of the sample applications that are provided with the package. Distribution of any of these files or disclosing their content is a violation of the license agreement for this product. Web Application Barcode ActiveX is shipped with a CAB file that you can use for installing the control over the Internet. If you are developing a web page that will contain Barcode ActiveX, you may copy the included CAB file to your web server and reference it in your HTML code so that when a user visits a page that contains the ActiveX Control, their browser will automatically download and install the control on their system. The included CAB file contains only the files that you are legally allowed to distribute and it has also been digitally signed by TAL Technologies using Microsoft Authenticode technology. The Authenticode digital signature provides your end users with a guarantee that the control is safe to use on their system. The included CAB file will also install a special license file named TALBC.LPK that will allow the properties of the control to be modified using VB or Java Script code in your HTML document. The following sample object tags show how to insert Barcode ActiveX into an HTML document. The first object points to the LPK (license pack) file that must be installed on the users system in their Windows folder. This tag should appear before the object tag for the control and only needs to be included in the HTML code once, even if you have multiple tags referencing the actual control. Barcode ActiveX will not be scriptable in Internet Explorer without the LPK file installed in the users system. The LPK file is installed automatically from the Internet CAB file. The second object tag below is for the actual control. The name of the control is set using the "ID=" setting and the "CODEBASE=" setting points to a web URL or a file path where the CAB file for the control can be found. If the control is not installed in the users system, then their browser will automatically download the control from the specified URL and install it. After the control has been installed, it will not be downloaded again if they visit any web page that references the control. To place a Barcode ActiveX Control in an HTML document you add the following object tags to your document where you want a barcode to appear. <object WIDTH="5" HEIGHT="5" align="" CLASSID="CLSID:5220cb21-c88d-11cf-b347-00aa00a28331"> <param name="LPKPath" value="Talbc.lpk"> </object> <object ID="TALBarCd1" WIDTH="259" HEIGHT="109" align="center" CLASSID="CLSID:C917E12F-9757- 11D2-85DB-F01851C10000" CODEBASE="http://www.YourWebSite.com/talbcocx.cab"> <param name="QuietZones" value="-1"> </object> The "param name" tag in the above object tag demonstrates how to pre-set property values for the control when it first appears in the users browser. The code above sets the "QuietZones property of the barcode control to True (-1). To set properties of Barcode ActiveX after it appears in the Barcode ActiveX Manual Distributing the ActiveX Control • Page 8 of 110 users browser, you could use VBScript or JavaScript code similar to the following line: TALBarCd1.message="1234567890" Refer to the Internet Explorer HTML Sample document that is provided with Barcode ActiveX for a more detailed example of how to script the control in a web page. Barcode ActiveX Manual Distributing the ActiveX Control • Page 9 of 110