MzPDF Toolkit Tutorial

This tutorial will explain how to create a PDF with 3 pages, each containing a 1x1 inch rectangle using C#.

1. Open Visual Studio 2005.
2. Create a new project (Visual C#, Windows Application).
3. Open Form1.cs.
4. After using System.Windows.Forms;, add using MZDocument;.
5. Add the following inside the Form1 class:

                                const double page_width_inch = 8.5;
                                const double page_height_inch = 11;

6. Add the following function:

                                public void GeneratePDF()
                                {
                                }

7. Now, we will do some work inside this function. Define PdfOptions class and fill it with PDF options:

                                
                                    PdfOptions pdfOptions = new PdfOptions();
                                    pdfOptions.Title = "Rectangle docment";
                                    pdfOptions.Subject = "Inch rectangle";
                                    pdfOptions.Author = "Auther - me";
                                    pdfOptions.Keywords = "Keywords ...";

                                    pdfOptions.Pdfcompress = true;
                                    pdfOptions.Jpgcompress = true;

                                    pdfOptions.PdfGenerateImage = true;
                                    pdfOptions.PdfGenerateText = true;
                                    pdfOptions.PdfGenerateGraphics = true;

                                    pdfOptions.PdfShowToolbar = true;
                                    pdfOptions.PdfShowMenuBar = true;
                                    pdfOptions.PdfShowWindowUI = true;

                                    pdfOptions.PageNo = 2; // open PDF in page 2
                                    pdfOptions.Version = PdfVersion.OneDotThree; //version 1.3
                                    pdfOptions.Magnification = PdfMagnification.Custom;
                                    pdfOptions.CustomMag = 50;
                                    pdfOptions.PageMode = PdfPageMode.Thumbs;
                                    pdfOptions.PageLayout = PdfPageLayout.TwoLColumn;
                                

8. Now define MZDocument class as follows:

MZDocument.Document doc = new Document();

9. Add a progress function:

doc.Progress += new EventHandler<ProgressEventArgs>(Progress2);

10. Create the document:

                                doc.CreateDocument();

                                    // create 3 pages so we need a for loop
                                    for(int i = 1; i <= 3; i++)
                                    {
                                        // define PDF Info
                                        MZDocument.PageInfo pageInfo = new PageInfo();
                                    
                                        // Start the page. with 8.5 by 11 inch.
                                        doc.StartPage(Document.LastPage, page_width_inch, page_height_inch, pageInfo, 0);
                                    
                                        // Calculate 1 inch rectangle.
                                        Rectangle rectangle = new Rectangle((int)(1 * pageInfo.xDPI), (int)(1 * pageInfo.yDPI), (int)(1 * pageInfo.xDPI), (int)(1 * pageInfo.yDPI));
                                    
                                        // Create black pen
                                        Pen pen = new Pen(Color.Black);
                                    
                                        // Draw the rectangle on the PDF DC
                                        pageInfo.PageGraphics.DrawRectangle(pen, rectangle);
                                    
                                        // Close this page
                                        doc.EndCurrentPage();
                                    }

                                    // Close the document.
                                    doc.CloseDocument();

                                    // Generate PDF
                                    doc.GeneratePDF("c:\\RectanglePDF.pdf", pdfOptions);

                                    // After finishing everything delete this document
                                    doc.DeleteDocument();

11. Add a progress event function:

                            public void Progress2(object sender, ProgressEventArgs e)
                            {
                                int currentPage = e.CurrentPageProgress;
                                int total = e.CurrentPage * 100 / e.TotalPage;
                            
                                String str = String.Format("Page : {0} of {1} ", e.CurrentPage, e.TotalPage);
                            
                                Application.DoEvents();
                            
                                // use the following condition if you want to interrupt the operation.
                                if (false)
                                    e.Cancel = true;
                                else
                                    e.Cancel = false;
                            }

12. Go to Refrences and add MZDocument.dll for Win32 or for x64.
13. Add a new menu item to generate PDF, then double-click on it to create its function. Inside this function, add the following code:

GeneratePDF();

14. Run your application and click the menu item you created in step 13. Then go to C:\ drive, and you will find RectanglePDF.pdf document was created with the options that you've already chosen above.

Note: For x64 project, you need to first create a new x64 project configuration from the configuration manager.