Table of Contents. Part I Introduction 3 Part II Installation 3. Part III How to Distribute It? 3 Part IV Office 2007 &

Transcription

1 Contents 1 Table of Contents Foreword 0 Part I Introduction 3 Part II Installation 3 1 Trial Version Full Version... 3 Part III How to Distribute It? 3 Part IV Office 2007 & Word... 4 Run Setup... 4 Create Single Barcode... 5 Create Multiple... Barcodes 6 Mail Merge Excel Change Settings Create Multiple... Barcodes 16 3 Access Part V Office 2000 & Word Run Setup Create Single... Barcode 23 Create Multiple... Barcodes 23 Mail Merge Excel Change Settings Create Multiple... Barcodes 28 3 Access Part VI Reference Guide 32 1 Properties BackColor Property BarColor Property BorderStyle Property CorrectionLevel... Property 32 Data Property HandleTilde Property ImageData Property Mode Property ModuleSize Property Orientation Property PreferredFormat... Property 35 1

2 2 MW6 Aztec ActiveX Manual 2 Methods CopyToClipboard... Method 36 GetActualRC Method GetActualSize... Method 37 GetPatternData... Method 37 Render Method SaveAsBMP Method SaveAsWMF Method SetSize Method SetStructuredAppend... Method 40 Part VII License 40 Index 0

3 Introduction 3 1 Introduction MW6 Aztec ActiveX is a powerful ATL-based control for handling Aztec 2D barcode and can be used in any ActiveX-compliant environment such as Word, Access, Excel, VB.NET, C#.NET, Visual Basic, Visual C++, Visual FoxPro, Delphi or C++ Builder. Aztec is designed to pack a lot of information in a very small space, it is capable of encoding 1914 bytes, 3067 alphanumeric characters, or 3832 numeric digits. 2 Installation 2.1 Trial Version 1. UnZip MW6Aztec.ZIP, run the setup.exe to install Aztec ActiveX. 2. The trial version Aztec ActiveX appends "MW6 Demo" to the string encoded with Aztec barcode. 2.2 Full Version 1. Uninstall the trial version Aztec ActiveX if applicable. 2. UnZip full version Aztec ActiveX.zip file and run the setup.exe to install the full version Aztec ActiveX. 3 How to Distribute It? If you want to redistribute the Aztec ActiveX as part of your application, please follow the instructions below: 1) For 32-bit version Windows OS, put Aztec.dll into the windows 32-bit system folder (e.g. "c:\windows \system32" or "c:\winnt\system32") on the target machine and run "regsvr32 Aztec.dll" to register it. 2) For 64-bit version Windows OS, put Aztec.dll into the SysWOW64 folder (e.g. "c:\windows \SysWOW64") on the target machine, and run the following commands to register it: cd c:\windows\syswow64 regsvr32 Aztec.dll 3) If you want to use Aztec ActiveX in 64-bit version Office Word, Excel or Access, put 64-bit version Aztec_x64.dll into "c:\windows\system32" folder, and run the following commands to register it: cd c:\windows\system32 regsvr32 Aztec_x64.dll 4) For Windows Vista or above, you need to use an elevated Command Prompt to run regsvr32.exe command, click "Start" > "All Programs" > "Accessories", right-click "Command Prompt", and then click "Run as administrator".

4 4 MW6 Aztec ActiveX Manual 4 Office 2007 & Word Run Setup 1. Click on "Add-Ins", then click on "Setup". 2. Choose a few appropriate values for Aztec configurations, click on "Apply" button to allow the changes to take effect.

5 Office 2007 & Create Single Barcode 1. Enter a few strings line by line and highlight them. 2. Click on "Page Layout", change Spacing "Before" and "After" to Click on "Add-Ins", the click on "Convert Selection" to create an Aztec barcode.

6 6 MW6 Aztec ActiveX Manual Create Multiple Barcodes 1. Enter a few string sections, surround those sections which will be converted to Aztec barcodes with the "<" and ">" characters.

7 Office 2007 & Click on "Page Layout", change Spacing "Before" and "After" to Click on "Add-Ins", then click on "Convert All" to create Aztec barcodes for the string sections surrounded with the "<" and ">" characters.

8 8 MW6 Aztec ActiveX Manual Mail Merge 1. Click on "Mailings", then click on "Start Mail Merge". A drop-down list appears as shown below, select the last option "Step by Step Mail Merge Wizard".

9 Office 2007 & Select a document type and click on "Next: Starting document". 3. Click on "Start from a template", then click on the link "Select template", choose a template, click on "Next: Select recipients".

10 10 MW6 Aztec ActiveX Manual 4. Select "Use an existing list" and click on "Browser" link, choose "MW6_Aztec_ActiveX.accdb" database as an existing list, click "Next: Write your letter". 5. Surround the section which will be converted to Aztec barcode with the "<" and ">" characters and highlight it.

11 Office 2007 & Click on "Page Layout", change Spacing "Before" and "After" to Click on "Next: Preview your letters", then click on "Next: Complete the merge".

12 12 MW6 Aztec ActiveX Manual 8. Click on "Edit individual letters", this opens "Merge to New Document" dialog, click on "All" and then click on "OK" button. 9. Click on "Add-Ins", then click on "Convert All" to create Aztec barcodes.

13 Office 2007 & Excel Change Settings 1. In Excel, open MW6_Aztec_ActiveX.xlsm. 2. If you see "Security Warning, Macros have been disabled", click on "Options" to open "Microsoft Office Security Options" dialog, toggle on "Enable this content" check box.

14 14 MW6 Aztec ActiveX Manual 3. Click on "Developers" > "Macros", select "MW6_Aztec_ActiveX_Setup".

15 4. Click on "Run". Office 2007 &

16 16 MW6 Aztec ActiveX Manual 5. Choose a few appropriate values for Aztec configurations, click on "Apply" button to allow the changes to take effect, "Column Offset" and "Row Offset" are used to specify Aztec barcode position relative to the position of the cell which contains the regular string Create Multiple Barcodes 1. Select a few cells. 2. Click on "Developers" > "Macros", select "MW6_Aztec_ActiveX_ConvertSelection".

17 3. Click on "Run" to create Aztec barcodes for the selected cells. Office 2007 &

18 18 MW6 Aztec ActiveX Manual 4.3 Access 1. Open MW6_Aztec_ActiveX.accdb, select "Sample Aztec ActiveX Report". 2. If you see "Security Warning, Certain content in the database has been disabled", click on "Options" to open "Microsoft Office Security Options" dialog, toggle on "Enable this content" check box. 3. Click on "Design View", click on "Insert ActiveX Control ", choose "MW6Actec Class" to insert it into the report.

19 Office 2007 & Change its properties to meet your application requirements, our Aztec ActiveX supports the data binding so you can bind a field in a database to the control and generate Aztec barcodes for each data record automatically, there's an arrow on the right side of the "Control Source" property, click on the arrow, a list opens with all the fields, select the field you want for the control.

20 20 MW6 Aztec ActiveX Manual 5. If you do not want to use the data binding feature, you can customize "Private Sub Detail_Format (Cancel As Integer, FormatCount As Integer)" to create Aztec barcodes dynamically. 6. Click on "Preview" to view Aztec barcodes.

21 Office 2007 & Office 2000 & Word Run Setup 1. Open up Word, click on "Setup". If you keep getting the error message "The macro cannot be found or has been disabled because of...", download Office 2000 or 2003 Service Pack 3 from Microsoft website and install it to fix this issue. Or simply click "Tools" > "Macro" > "Macros", select "MW6_Aztec_ActiveX_Setup" and run it.

22 22 MW6 Aztec ActiveX Manual 2. Choose appropriate values for Aztec configurations, click on "Apply" button to allow the changes to take effect.

23 Office 2000 & Create Single Barcode 1. Enter a few strings line by line and highlight them. 2. Click on "Convert Selection" to create an Aztec barcode Create Multiple Barcodes 1. Enter a few string sections, surround those sections which will be converted to Aztec barcodes with the "<" and ">" characters.

24 24 MW6 Aztec ActiveX Manual 2. Click on "Convert All" to create Aztec barcodes for the string sections surrounded with "<" and ">" characters.

25 Office 2000 & Mail Merge 1. In Mail Merge, choose MW6_Aztec_ActiveX.mdb as the data source, surround the string sections which will be converted to Aztec barcode with the "<" and ">" characters. 2. Click on "Merge..."

26 26 MW6 Aztec ActiveX Manual 3. Click on "Convert All" to create Aztec barcodes for the string sections surrounded with the "<" and ">" characters. 5.2 Excel Change Settings 1. In Excel, open MW6_Aztec_ActiveX.XLS. 2. Click on "Tools" > "Macro" > "Macros", select "MW6_Aztec_ActiveX_Setup". 3. Click on "Run".

27 Office 2000 & Choose appropriate values for Aztec configurations, click on "Apply" button to allow the changes to take effect, "Column Offset" and "Row Offset" are used to specify Aztec barcode position relative to the position of the cell which contains the regular string.

28 28 MW6 Aztec ActiveX Manual Create Multiple Barcodes 1. Select a few cells. 2. Click on "Tools" > "Macro" > "Macros", select "MW6_Aztec_ActiveX_ConvertSelection". 3. Click on "Run" to create Aztec barcodes for the selected cells.

29 Office 2000 &

30 30 MW6 Aztec ActiveX Manual 5.3 Access 1. Open MW6_Aztec_ActiveX.mdb, select "Sample Aztec ActiveX Report". 2. Click on "Design", insert MW6 Aztec ActiveX control into the report. 3. Change its properties to meet your application requirements, our Aztec ActiveX supports the data binding so you can bind a field in a database to the control and generate Aztec barcodes for each data record automatically, there's an arrow on the right side of the "Control Source" property, click on the arrow, a list opens with all the fields, select the field you want for the control.

31 Office 2000 & If you do not want to use the data binding feature, you can customize "Private Sub Detail_Print (Cancel As Integer, PrintCount As Integer)" to create Aztec barcodes dynamically. 4. Click on "Preview" to view Aztec barcodes.

32 32 MW6 Aztec ActiveX Manual 6 Reference Guide 6.1 Properties BackColor Property Gets or sets the background color of the Aztec barcode. Property Data Type OLE_COLOR Remarks The default value is white color BarColor Property Gets or sets the color of the Aztec barcode and text. Property Data Type OLE_COLOR Remarks The default value is black color BorderStyle Property Gets or sets the style of the border rectangle. Property Data Type short Remarks The default value is 0, this property can be one of the following values: Value Description 0 No Border 1 Dash Border 2 Solid Border CorrectionLevel Property Gets or sets the percentage of errors which can be recovered.

33 Reference Guide 33 Property Data Type short Remarks The recommended value is 23 percent, the valid value should be between 5 percent and 95 percent Data Property Gets or sets the message to encode with Aztec barcode ActiveX. Property Data Type BSTR Remarks The default value is "12" HandleTilde Property Gets or sets a boolean flag indicating whether to process the tilde character "~" or not. Property Data Type VARIANT_BOOL Remarks If this property is set to TRUE, non-printable characters can be passed to Aztec ActiveX by using the tilde character, "~dnnn" represents the ASCII character encoded by the 3 digits NNN, for example, "~d010" represents the character LF (line feed) ImageData Property Gets WMF format data stream of the Aztec barcode. Property Data Type IPictureDisp* Mode Property Gets or sets the encoding mode of the Aztec barcode. Property Data Type short

34 34 MW6 Aztec ActiveX Manual Remarks This parameter can be one of the following values: Value Description 0 Auto mode for mainly encoding ASCII characters (0-127) 1 Binary mode for mainly encoding bytes of data ModuleSize Property Gets or sets the size (width/height) of the square-shaped module. Property Data Type float Remarks The default value is 0.07, internally our Aztec ActiveX control converts the module size from centimeters to pixels based on the device resolution, round up or round down float pixel value to the nearest integer. The centimeter to pixel conversion formula is : size_in_pixels = size_in_centimeters * device_resolution / 2.54 For example, if you render barcode on computer screen and the screen resolution is 96dpi. (1) Set ModuleSize property to 0.04, size_in_pixels = 0.04 * 96 / 2.54 = , round up to 2, so actual module size is 2 pixels. (2) Set ModuleSize property to 0.06, size_in_pixels = 0.06 * 96 / 2.54 = , round down to 2, so actual module size is 2 pixels. (3) Set ModuleSize property to 0.07, size_in_pixels = 0.07 * 96 / 2.54 = , round up to 3, so actual module size is 3 pixels. Different ModuleSize property values might end up with same module size in pixels due to performing rounding operations Orientation Property Gets or sets the orientation of the Aztec barcode. Property Data Type short Remarks The default value is 0, this property can be one of the following values:

35 Reference Guide 35 Value Description 0 0 degree 1 90 degrees degrees degrees PreferredFormat Property Gets or sets the format of the Aztec barcode. Property Data Type short Remarks The default value is 0, this property can be one of the following values. Value Description Capacity (in digits) Capacity (in alphanumeric characters) Capacity (in bytes) 0 Auto format 1 15 X 15 compact format X X 19 compact format X X 23 compact format X X 27 compact format X X X X X X X X X X X X X X X X X X X X X X X X X

36 36 MW6 Aztec ActiveX Manual X X X X If you set PreferredFormat to 0 (Auto format), our Aztec ActiveX control will automatically choose an appropriate format with enough data capacity to encode the string. If you set PreferredFormat to other values and the data capacity of the selected format is not big enough to encode the string, our Aztec ActiveX control will also automatically choose an appropriate format with bigger data capacity to encode the string. 6.2 Methods CopyToClipboard Method Copies the Aztec barcode image into the system clipboard. void CopyToClipboard(); Remarks Before you call this method, use GetActualSize() method to obtain the actual size of the Aztec barcode and use SetSize() method to set image size by adding surrounding white space around the Aztec barcode. See Also GetActualSize() Method SetSize() Method GetActualRC Method Gets the actual numbers of rows and columns for the Aztec barcode. void GetActualRC(short *ActualRows, short *ActualCols); Parameters ActualRows A pointer to the variable that receives the final number of rows for the Aztec barcode. ActualCols A pointer to the variable that receives the final number of columns for the Aztec barcode. Remarks If you set PreferredFormat to 0 (Auto format), Aztec ActiveX control will automatically choose an appropriate format with enough data capacity to encode the string, use this method to retrieve the information about the final numbers of rows and columns.

37 Reference Guide 37 If you set PreferredFormat to other values and the data capacity of the selected format is not big enough to encode the string, Aztec ActiveX control will also automatically choose an appropriate format with bigger data capacity to encode the string, so the final numbers of rows and columns might not be equal to the numbers of rows and columns specified by the PreferredFormat property GetActualSize Method Gets the actual size of the Aztec barcode which is rendered onto either computer screen or other devices such as printers. void GetActualSize(VARIANT_BOOL ScreenIsTarget, long TargetHDC, long *ActualWidth, long *ActualHeight); Parameters ScreenIsTarget Indicates whether barcode is rendered onto computer screen or not. TargetHDC Device context on which to render the Aztec barcode, if the parameter ScreenIsTarget is set to TRUE, set this parameter to NULL. ActualWidth A pointer to the variable that receives the width of the Aztec barcode (in pixels). ActualHeight A pointer to the variable that receives the height of the Aztec barcode (in pixels) GetPatternData Method Gets the Aztec barcode pattern matrix data. void GetPatternData(short *Buffer, long *Size, short *Rows, short *Columns, VARIANT_BOOL *Result); Parameters Buffer Size Pointer to a buffer that receives the character stream ('1's and '0's) storing the Aztec barcode pattern matrix data row by row from the top left matrix corner, '1' indicates the black module and '0' indicates the white module. If the method fails and the variable pointed to by Size returns the required buffer size, in 16-bit integers. [in/out] On input, specifies the size, in 16-bit integers, of the Buffer. On output, receives the size, in 16-bit integers, of the Aztec barcode pattern matrix ('1's and '0's).

38 38 MW6 Aztec ActiveX Manual Rows Columns Result A pointer to the variable that receives the number of the rows for the pattern matrix. A pointer to the variable that receives the number of the columns for the pattern matrix.. If the method succeeds, the value of the variable pointed to by Result is VARIANT_TRUE, otherwise the value is VARIANT_FALSE. Remarks You can use this method to obtain the Aztec barcode pattern matrix data and render the Aztec barcode onto any device such as the printer, only Data, HandleTilde, Mode and PreferredFormat properties affect the pattern matrix data output. Based on the Orientation property value, rotate the pattern matrix accordingly before you render the Aztec barcode onto a device Render Method Renders the Aztec barcode onto the device such as computer screen or printers. void Render(long hdc, int x, int y); Parameters hdc Device context on which to render the Aztec barcode. x The x coordinate, in pixels, of the top left corner of the Aztec barcode. y The y coordinate, in pixels, of the top left corner of the Aztec barcode SaveAsBMP Method Saves the Aztec barcode image as a BMP file. void SaveAsBMP(BSTR FileName); Parameters FileName A string that contains the name of the file to which to save BMP format barcode image.

39 Reference Guide 39 Remarks Before you call this method, use GetActualSize() method to obtain the actual size of the Aztec barcode and use SetSize() method to set image size by adding surrounding white space around the Aztec barcode. See Also GetActualSize() Method SetSize() Method SaveAsWMF Method Saves the Aztec barcode image as a WMF file. void SaveAsWMF(BSTR FileName); Parameters FileName A string that contains the name of the file to which to save WMF format barcode image. Remarks Before you call this method, use GetActualSize() method to obtain the actual size of the Aztec barcode and use SetSize() method to set image size by adding surrounding white space around the Aztec barcode. See Also GetActualSize() Method SetSize() Method SetSize Method Sets the size of the image which contains the Aztec barcode. void SetSize(int Width, int Height); Parameters Width The width, in pixels, of the image. Height The height, in pixels, of the image. Remarks First call GetActualSize() method to obtain the actual size of the Aztec barcode, then use this method

40 40 MW6 Aztec ActiveX Manual to set image size by adding surrounding white space around the Aztec barcode. See Also GetActualSize() Method SetStructuredAppend Method Specifies which symbol this is in a sequence and the total number of symbols in the sequence. void SetStructuredAppend(VARIANT_BOOL AllowSA, short SymbolID, short SymbolCount); Parameters AllowSA Indicates whether the structured append is allowed in the current Aztec barcode, if this is FALSE, the parameters SymbolID and SymbolCount are irrelevant. SymbolID Specifies which symbol this is in a sequence, the parameter must be between 1 and SymbolCount. SymbolCount Specifies the total number of symbols in the sequence, the maximum value is 26, which means that up to 26 symbols can be linked together using the structured append protocol. Remarks Don't call this method if you don't need the structured append feature. 7 License License agreement This License Agreement ("LA") is the legal agreement between you and MW6 Technologies, Inc. ("MW6") for the font, and any electronic documentation ("Package"). By using, copying or installing the Package, you agree to be bound by the terms of this LA. If you don't agree to the terms in this LA, immediately remove unused Package. 1. License * The Single User License allows the use of the software on ONE computer by ONE person in your organization. * The Site License allows the use of the software at exactly 1 physical site by up to 10,000 users in your organization. * The Single Developer License allows 1 developer in your organization the royalty-free distribution (up to 10,000 users) of the software to the third parties, each individual developer requires a separate Single Developer License as long as he or she needs access to MW6's product(s) and document(s).

41 License 41 * The 2 Developer License allows 2 developers in your organization the royalty-free distribution (up to 10,000 users) of the software to the third parties. * The 3 Developer License allows 3 developers in your organization the royalty-free distribution (up to 10,000 users) of the software to the third parties. * The 4 Developer License allows 4 developers in your organization the royalty-free distribution (up to 10,000 users) of the software to the third parties. * The 5 Developer License allows 5 developers in your organization the royalty-free distribution (up to 10,000 users) of the software to the third parties. * The Unlimited Developer License allows unlimited number of developers in your organization the royalty-free distribution (unlimited number of users) of the software to the third parties. 2. User Disclaimer The software is provided "as is" without warrant of any kind, either expressed or implied, including, but not limited to, the implied warranties of merchantability, fitness for a particular purpose, or noninfringement. MW6 assumes no liability for damages, direct or consequential, which may result from the use of the software. Further, MW6 assumes no liability for losses caused by misuse or abuse of the software. This responsibility rests solely with the end user. 3. Copyright The software and any electronic documentation are the proprietary products of MW6 and are protected by copyright and other intellectual property laws.