C#实现的ActiveX截图打印控件

 C#开发ActiveX控件参考资料：

　　http://www.cnblogs.com/zhf/archive/2009/03/02/1401299.html

　　http://www.cnblogs.com/homer/archive/2005/01/08/88780.html

 

C#开发ActiveX的详细介绍见以上两篇文章，我只补充这两篇文章未说明的。

1.实现脚本调用ActiveX方法，必需将方法定义到一个接口中（该接口使用一个唯一的GUID，不能与ActiveX控件的GUID相同），然后在ActiveX方法即控件类中实现该接口中的方法。

2.在ActiveX中使用WebBrowser控件，不可直接从工具箱中拖出该控件使用，只需声明一个WebBrowser对象，在需要使用的时候实例化即可。不然在ActiveX中无法正常使用，即使在本地测试的时候没有问题，在页面中使用你会发现WebBrowser对象已经被释放。

3.在Windows 7下，必需以管理员权限运行VS，设置的COM自动注册才能顺利完成。

 

以我的代码为例：

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Drawing;
using System.Data;
using System.Text;
using System.Windows.Forms;
using System.Runtime.InteropServices;

namespace EstatePrintMapActiveX
{
    //控件类，GUID可以在工具中生成，此处的GUID即为页面中引用控件时使用的CLASSID
    //ComVisible(true)设置是否自动注册控件，设置项目属性中的“生成”项下的“为COM互操作注册”为勾选实现在本地自动注册（windows7需要以管理员运行该项目）
    [Guid("1161E5A8-B698-4e57-8B56-B5B06B69FF4D"), ProgId("EstatePrintMapActiveX.UserControl1"),
    ClassInterface(ClassInterfaceType.None), ComVisible(true)]
    public partial class UserControl1 : UserControl, IMonitor, IObjectSafety
    {
        #region 实现IObjectSafety 成员

        public void GetInterfacceSafyOptions(int riid, out int pdwSupportedOptions, out int pdwEnabledOptions)
        {
            pdwSupportedOptions = 1;
            pdwEnabledOptions = 2;
        }

        public void SetInterfaceSafetyOptions(int riid, int dwOptionsSetMask, int dwEnabledOptions)
        {
            throw new NotImplementedException();
        }

        #endregion

        System.Windows.Forms.WebBrowser webBrowser;

        bool isDetailPrint = false;//默认打印多张
        string stringUrl;//需要打印的页面的URL

        public UserControl1()
        {
            InitializeComponent();
        }

        //供JS调用的方法（必需在IMonitor接口中定义，接口名可自定）
        public void SetUrlText(string strUrl, string pra)
        {
            if (pra == "1")//多图页面，打印多张
            {
                stringUrl = strUrl;
                btnCapture.Text = "启动楼层图打印控件";//通过脚本参数改变控件按钮文字
                SetWebBrowser();
            }
            else if (pra == "2")
            {
                stringUrl = strUrl;
                SetWebBrowser();
                isDetailPrint = true;//详细页面，打印单张
            }
            else
            {   //无平面图信息则隐藏控件
                this.Visible = false;
                this.Height = 0;
                this.Width = 0;
                Dispose(true);
            }
        }

        //声明webBrowserObj并初始化
        private void SetWebBrowser()
        {
            try
            {
                WebBrowser webBrowserObj = new WebBrowser();
                webBrowserObj.Dock = System.Windows.Forms.DockStyle.Fill;
                webBrowserObj.Location = new System.Drawing.Point(0, 0);
                webBrowserObj.MinimumSize = new System.Drawing.Size(20, 20);
                webBrowserObj.Name = "webBrowser";
                webBrowserObj.ScrollBarsEnabled = false;//不显示滚动条
                webBrowserObj.Size = new System.Drawing.Size(1050, 97);
                webBrowserObj.TabIndex = 0;
                webBrowserObj.Navigating += new System.Windows.Forms.WebBrowserNavigatingEventHandler(this.webBrowser_Navigating);//加载事件
                webBrowserObj.DocumentCompleted += new System.Windows.Forms.WebBrowserDocumentCompletedEventHandler(this.webBrowser_DocumentCompleted);//加载完成事件

                webBrowser = webBrowserObj;

                webBrowser.Navigate(stringUrl);//加载页面
            }
            catch (Exception ex)
            {
                MessageBox.Show(ex.Message);
            }
        }

        //截图方法
        private void btnCapture_Click(object sender, EventArgs e)
        {
            try
            {
                //截图
                Bitmap bmp = Snapshot.TakeSnapshot(this.webBrowser.ActiveXInstance, new Rectangle(new Point(), webBrowser.Size));

                ////生成图片的方法，imgName为图片完整路径（含文件名）
                //bmp.Save(imgName, System.Drawing.Imaging.ImageFormat.Bmp);
                //bmp.Dispose();

                Form printView = new Form1(bmp, isDetailPrint);
                printView.Show();//在弹出的Form中显示截图及“打印”、“关闭”按钮

            }
            catch (Exception ex)
            {
                MessageBox.Show(ex.Message);
            }

        }

        //加载完成记录高度和宽度、启动按钮可用
        private void webBrowser_DocumentCompleted(object sender, WebBrowserDocumentCompletedEventArgs e)
        {
            btnCapture.Enabled = true;//“启动打印控件”按钮可用

            //设置WebBrowser的Size，之后调用截图方法时要使用该Size以保证截的图为完整的
            webBrowser.Size = new Size(int.Parse(webBrowser.Document.Body.GetAttribute("scrollwidth")),
                                      int.Parse(webBrowser.Document.Body.GetAttribute("scrollHeight")));

        }

        //开始加载页面
        private void webBrowser_Navigating(object sender, WebBrowserNavigatingEventArgs e)
        {
            btnCapture.Enabled = false;//初始加载时“启动打印控件”按钮不可用
        }

    }
}

 其中脚本方法接口和安全接口定义如下: 

using System;
using System.Collections.Generic;
using System.Text;
using System.ComponentModel;
using System.Runtime.InteropServices;

namespace EstatePrintMapActiveX
{
    [Guid("8FF612BC-4386-4629-B81A-E84AD7CB7AE7"), InterfaceType(ComInterfaceType.InterfaceIsDual), ComVisible(true)]
    public interface IMonitor
    {
        void SetUrlText(string strUrl, string pra);
    }

    [Serializable, ComVisible(true)]
    public enum ObjectSafetyOptions
    {
        INTERFACESAFE_FOR_UNTRUSTED_CALLER = 0x00000001,
        INTERFACESAFE_FOR_UNTRUSTED_DATA = 0x00000002,
        INTERFACE_USES_DISPEX = 0x00000004,
        INTERFACE_USES_SECURITY_MANAGER = 0x00000008
    };

    //// MS IObjectSafety Interface definition
    //[ComImport(), Guid("CB5BDC81-93C1-11CF-8F20-00805F2CD064"), InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
    //public interface IObjectSafety
    //{
    //    [PreserveSig]
    //    long GetInterfaceSafetyOptions(ref Guid iid, out int pdwSupportedOptions, out int pdwEnabledOptions);

    //    [PreserveSig]
    //    long SetInterfaceSafetyOptions(ref Guid iid, int dwOptionSetMask, int dwEnabledOptions);
    //};

    [ComImport, Guid("CB5BDC81-93C1-11CF-8F20-00805F2CD064")]
    [InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
    public interface IObjectSafety
    {
        [PreserveSig]
        void GetInterfacceSafyOptions(
            int riid,
            out int pdwSupportedOptions,
            out int pdwEnabledOptions);

        [PreserveSig]
        void SetInterfaceSafetyOptions(
            int riid,
            int dwOptionsSetMask,
            int dwEnabledOptions);
    }


}

截图方法（引自随飞：http://chinasf.cnblogs.com）：　　

using System;
using System.Drawing;
using System.Runtime.InteropServices;
using System.Runtime.InteropServices.ComTypes;

namespace EstatePrintMapActiveX
{
    /// <summary>
    /// ActiveX 组件快照类
    /// AcitveX 必须实现 IViewObject 接口
    /// 作者:随飞
    /// http://chinasf.cnblogs.com
    /// chinasf@hotmail.com
    /// </summary>
    public static class Snapshot
    {
        /// <summary>
        /// 取快照
        /// </summary>
        /// <param name="pUnknown">Com 对象</param>
        /// <param name="bmpRect">图象大小</param>
        /// <returns></returns>
        public static Bitmap TakeSnapshot(object pUnknown, Rectangle bmpRect)
        {
            if (pUnknown == null)
                return null;

            //必须为com对象
            if (!Marshal.IsComObject(pUnknown))
                return null;

            //IViewObject 接口
            UnsafeNativeMethods.IViewObject ViewObject = null;
            IntPtr pViewObject = IntPtr.Zero;
            //内存图
            Bitmap pPicture = new Bitmap(bmpRect.Width, bmpRect.Height);
            Graphics hDrawDC = Graphics.FromImage(pPicture);
            //获取接口
            object hret = Marshal.QueryInterface(Marshal.GetIUnknownForObject(pUnknown),
                ref UnsafeNativeMethods.IID_IViewObject, out pViewObject);

            try
            {
                ViewObject = Marshal.GetTypedObjectForIUnknown(pViewObject, typeof(UnsafeNativeMethods.IViewObject)) as UnsafeNativeMethods.IViewObject;
                //调用Draw方法
                ViewObject.Draw((int)DVASPECT.DVASPECT_CONTENT,
                    -1,
                    IntPtr.Zero,
                    null,
                    IntPtr.Zero,
                    hDrawDC.GetHdc(),
                    new NativeMethods.COMRECT(bmpRect),
                    null,
                    IntPtr.Zero,
                    0);
                Marshal.Release(pViewObject);
            }
            catch (Exception ex)
            {
                Console.WriteLine(ex.Message);
                throw ex;
            }

            //释放
            hDrawDC.Dispose();
            return pPicture;
        }
    }

}

打印方法： 

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Text;
using System.Windows.Forms;

namespace EstatePrintMapActiveX
{
    public partial class Form1 : Form
    {
        int PageCount;
        int pageCountTmp;
        bool isDetailPrint = false;
        public Form1(Bitmap bmp, bool isDetailPrintPar)
        {
            InitializeComponent();

            isDetailPrint = isDetailPrintPar;

            Image imgObj = (Image)bmp;
            pictureBox1.Height = imgObj.Height;
            pictureBox1.Width = imgObj.Width;

            panel1.Width = pictureBox1.Width;
            panel1.Height = pictureBox1.Height;

            this.Width = pictureBox1.Width;
            this.Height = pictureBox1.Height;

            panel1.Visible = true;

            pictureBox1.Image = imgObj;
            PageCount = pictureBox1.Image.Height / 1500;
            pageCountTmp = PageCount;

            btn.Visible = true;
            btnClose.Visible = true;
        }

        //打印过程中调用
        private void printDocument1_PrintPage(object sender, System.Drawing.Printing.PrintPageEventArgs e)
        {
            if (!isDetailPrint)//多页
            {
                if (PageCount >= 1)
                {
                    e.HasMorePages = true;//分页设置
                    e.Graphics.DrawImage(pictureBox1.Image,
                                        new RectangleF(new Point(0, 20),
                                            new Size(1050, 1500)),
                                        new RectangleF(new Point(0, (pageCountTmp - PageCount) * 1500),
                                            new Size(1050, 1500)),
                                        GraphicsUnit.Pixel);

                    if (PageCount == 1)
                    {
                        e.HasMorePages = false;//结束分页及打印
                    }
                }
                PageCount--;//计数
            }
            else//单页
            {
                e.Graphics.DrawImage(pictureBox1.Image, new Rectangle(new Point(0, 20),
                    new Size(int.Parse(Math.Round(pictureBox1.Image.Width * 0.8).ToString()),
                            int.Parse(Math.Round(pictureBox1.Image.Height * 0.8).ToString()))));
            }
        }

        //关闭按钮事件
        private void btnClose_Click(object sender, EventArgs e)
        {
            this.Close();
            this.Dispose();
        }

        //打印按钮事件：调用打印方法
        private void btn_Click(object sender, EventArgs e)
        {
            printDocument1.Print();
            this.Visible = false;
            this.Height = 0;
            this.Width = 0;
            Dispose(true);
        }
    }
}

  

　　如果想不使用ActiveX实现客户端截图打印，而是在页面后台接收需要打印的页面URL，使用WebBrowser的DrawToBitmap方法实现截图，会遇到两个问题。

即：“GDI+中发生一般性错误”、“对COM 组件的调用返回了错误 HRESULT E_FAIL”。

　　详见我的CSDN问题贴：http://topic.csdn.net/u/20101012/18/a750440e-f472-497f-b666-d1b420ae8f7c.html。

　　另外，当你需要打印的页面中有VML图或者AJAX效果，或者在页面加载完成之后使用脚本修改过页面的效果的时候，后台方法中的Complete状态判断并不能保证截图时页面已经是最终的显示效果，所以截图效果会与页面的实践显示效果有较大差异，甚至截图为空白。

　　而使用ActiveX控件，当页面加载完时“启动控件按钮”可用，单击按钮之后触发截图方法，在客户端完成截图和打印（不生成图片且截图与页面实际显示的效果一致），同时还可可避免以上问题。

　　补充：

　　被截图的页面必需是不需要登录即可查看的页面；

　　该控件在客户端运行，需要.NET Framework的支持， 最好做成基于.NET Framework2.0，因为高版本的.NET Framework文件很大；

　　本控件的实现初衷是为了打印页面中VML实现的图，因为VML不支持web打印，且实际验证发现jQuery的区域打印即类似$("div#printAreaDiv").printArea();这样的jQuery方法打印的是整个页面，且与页面实际显示的效果有差异（页面中有AJAX或者页面加载完之后有使用脚本对页面进行过修改的情况）；

　　关于ActiveX调用脚本方法，可参考：http://www.cnblogs.com/xiaoshatian/archive/2008/09/02/1281786.html；

　　关于怎么制作安装文件，本篇文章给出的第一个链接里“5.发布”部分有详细的介绍；　 

　　控件使用示例：

HTML:

                    <div>
                        <object id="UserControlObj" name="UserControlObj" classid="clsid:1161E5A8-B698-4E57-8B56-B5B06B69FF4D"
                            width="950" height="55">
                        </object>
                    </div>

脚本：

            var strUrl = "";
            var strPar = "2";
            strUrl = window.location.href.split('=')[0].replace("RoomInfoDetail.aspx?&RM_ID", 
                        "RoomInfoPrint.aspx?rid=" + window.location.search.split('=')[1]);
            document.all.UserControlObj.SetUrlText(strUrl, strPar);

 

　　控件代码已经打包上传，下载链接：EstatePrintMapActiveX.rar

 

　　文章结尾分享一下CSDN上ActiveX控件开发的讨论帖：

　　http://topic.csdn.net/u/20101028/11/085a5e12-ab46-4de5-8860-07234638b57b.html