截图控件

最新推荐文章于 2024-07-04 17:12:45 发布

uudoccom

最新推荐文章于 2024-07-04 17:12:45 发布

阅读量2.9k

点赞数

文章标签：优道在线屏幕截图控件

本文链接：https://blog.csdn.net/uudoccom/article/details/9332393

版权

优道在线屏幕截图控件使用帮助

功能概述

优道在线屏幕截图控件（UUDoc Screen Capture Control）是一款基于WEB的在线屏幕截图产品，支持嵌入到IE、FireFox、Chrome、Opera等各类浏览器当中在线使用。用户对电脑屏幕进行截图后可以将截取到的图片保存到指定的服务器上。截图时控件能对窗口进行智能识别，可以实现对整个屏幕、程序窗口和固定区域的截图。在图形截取后自带有工具条实现对图片的在线标注功能，可以在截取的图形上绘制矩形、椭圆、箭头及输入文字，并可在线或离线保存截取的图片。

控件使用简单、兼容性强，适合在OA系统、信息管理和发布系统、网站后台、邮箱、在线协作工具等应用中使用，支持嵌入到各类WEB网页编辑器当中。这个控件我们完全免费提供，没有进行任何功能和版权的限制，您可以无限使用在您现有的产品当中。如果您有特别的需求或者需要进行OEM定制，也可以与我们进行联系。

运行环境

服务器端：支持Windows和Linux操作系统，支持任何的服务器编程语言，例如asp,asp.net,php,java,python,ruby等

控件客户端支持的操作系统：WindowsXP/2003/2008/Vista/Win7/Win8

支持32位及64位操作系统和浏览器

支持嵌入到基于ActiveX技术的IE浏览器和使用NPAPI技术的非IE浏览器中

网页中嵌入控件

您可以参考我们提供的演示文件在网页中嵌入优道在线屏幕截图控件：

控件的PlogId为:UdCapture.Control

控件的ClassId为:0FAE6655-7C34-4DEE-9620-CD7ED969B3F2

控件的ContentType为: application/udcapture-plugin

   
    <object id="udCapture" width="0" height="0"
         classid="CLSID:0FAE6655-7C34-4DEE-9620-CD7ED969B3F2"
         codebase="axUdCapture32.msi#version=1,0,0,0">
         <param name="PostUrl" value="SaveFile.aspx" />

 
         <embed id="udCapturePlugin" width="0" height="0"
            type="application/udcapture-plugin" PostUrl="SaveFile.aspx"
            OnBeforeCapture="f_onBeforeCapture" OnCaptureCanceled="f_onCaptureCanceled"
            OnCaptureCompleted="f_onCaptureCompleted" OnBeforeUpload="f_onBeforeUpload"
            OnUploadCompleted="f_onUploadCompleted" OnUploadFailed="f_onUploadFailed">
         </embed>
    </object>

其中axUdCapture32.msi为控件的32位安装程序，axUdCapture64.msi为控件的64位安装程序，安装后控件支持IE访问；npUdCapture.msi为NPAPI版的安装程序，安装后支持FireFox、Chrome、Safari等使用NPAPI标准的非IE浏览器使用。

判断控件是否安装：


    <script type="text/javascript"> 
        var ctl;
        var UDCAPTURE_VERSION = "1.0.0";//当前最新的控件版本号

        //版本比较，检查是否安装了新版本
        function f_hasNewVer(instVer)
        {
            var newVer = UDCAPTURE_VERSION.split(".");
            var curVer = instVer.split(".");
            if(parseInt(newVer[0]) > parseInt(curVer[0]))
                return true;
            if(parseInt(newVer[0]) == parseInt(curVer[0])
              && parseInt(newVer[1]) > parseInt(curVer[1]))
                return true;
            if(parseInt(newVer[0]) == parseInt(curVer[0]) 
              && parseInt(newVer[1]) == parseInt(curVer[1])
              && parseInt(newVer[2]) > parseInt(curVer[2]))
                return true;
            return false;
        }
        //初始化加载
        function f_onload() {
            if(window.ActiveXObject)//IE
            {
                var axobj = null;                
                var setupFile = "Setup/axUdCapture32.msi";
                //64位浏览器安装文件
                if(window.navigator.platform == "Win64"
                   || window.navigator.cpuClass == "x64")
                    setupFile = "Setup/axUdCapture64.msi";

                try{
                    axobj = new ActiveXObject('UdCapture.Control'); 
                }catch(e){}
                if(axobj) {
                    if(f_hasNewVer(axobj.GetVersion())){                    
                        document.getElementById("ctlDiv").innerHTML = "<a href='" + setupFile 
                         + "' class='inst'>优道在线屏幕截图控件有新版本v" + UDCAPTURE_VERSION 
                         + "，点这里升级安装...</a>";
                    }
                    else{
                        ctl = document.getElementById("udCaptureCtl");
                    }
                }
                else{
                    document.getElementById("ctlDiv").innerHTML = "<a href='" + setupFile
                         + "' class='inst'>您尚未安装优道在线屏幕截图控件，点这里进行安装...</a>";
                }
                
            }
            else
            {
                //NOT IE
                var setupFile = "Setup/npUdCapture.msi";
                if (navigator.plugins && navigator.plugins.length > 0)
                {
                    var plugin = navigator.plugins["UdCapture Plugin"];
                    if(plugin){
                        ctl = document.getElementById("udCapturePlugin");
                        if(f_hasNewVer(ctl.GetVersion())){
                            document.getElementById("ctlDiv").innerHTML = "<a href='" + setupFile
                               + "' target='_blank' class='inst'>优道在线屏幕截图插件有新版本v"
                               + UDCAPTURE_VERSION + "，点这里升级安装...</a>";
                        }
                    }
                    else{
                        document.getElementById("ctlDiv").innerHTML = "<a href='" + setupFile
                          + "' target='_blank' class='inst'>您尚未安装优道在线屏幕截图插件，点这里进行安装...</a>";
                    }     
                }   
                else
                    document.getElementById("ctlDiv").innerHTML = "当前浏览器不支持插件";        
            }
        }
    </script>

属性的设置示例：

   
    <script type="text/javascript">
        //设置提交的参数
        function f_setPostParams() {
            ctl.PostParams = "name=cn&age=32"
        }
    </script>

方法的调用示例


    <script type="text/javascript"> 
        //启动截图窗口
        function f_capture() {
            ctl.StartCapture();
        }
    </script>

事件的捕捉示例，兼容所有浏览器：


    <script type="text/javascript" event="f_onUploadCompleted(responseText)"
        for="udCaptureCtl">  
        f_onUploadCompleted(responseText);
    </script>

    <script type="text/javascript">  
        function f_onUploadCompleted(responseText){
	    document.getElementById("info").innerHTML = "图片上传成功：<img src=\""
            + responseText + "\">";
	}
    </script>

控件属性

属性名称	类型	属性说明
License	字符	获取或设置控件的注册码信息
PostUrl	字符	获取或设置图片提交上传的URL，如果未设置则不上传服务器，仅本地截图
FileField	字符	获取或设置文件上传的域，默认值为：UploadFile，相当于<input type="file" name="UploadFile">
FileName	字符	获取或设置截图后保存文件的名称及上传文件的名称，默认值为：SnapScreen.png
PostParams	字符	获取或设置以共同提交的POST参数，以“&”进行分隔，例如：name=cn&age=32
WebCodePage	数字	获取或设置使用的代码页号，非UTF8编码时使用。
IsUtf8Url	布尔	获取或设置是否使用UTF8编码进行Url提交请求，否则按指定代码页进行编码
IsUtf8Data	布尔	获取或设置是否使用UTF8编码格式输出响应内容，否则按指定代码页进行编码。

控件方法

方法名称	参数说明	方法说明
void StartCapture()	无	启动截图窗口进行屏幕截图
void StopCapture()	无	停止截图或图片上传操作
string GetVersion()	无	获取控件的当前版本号

控件事件

事件名称	参数说明	事件说明
OnBeforeCapture()	无	在屏幕截图之前触发该事件
OnCaptureCompleted(string fileName)	截图完成后保存在本地路径的图片文件名	屏幕截图完成时触发该事件
OnCaptureCanceled()	无	截图操作被取消时触发该事件
OnBeforeUpload(string fileName,long fileSize)	fileName：上传的图片文件名；fileSize：上传的图片文件字节大小	在截图完成之后开始上传到服务器之前触发该事件
OnUploadCompleted(string responseText)	responseText：服务器端返回的文本响应内容。	图片上传到服务器之后触发该事件
OnUploadFailed(int errorCode)	errorCode：错误代码，0、正常；1、不支持的网络协议；2、连接服务器错误；3、发送服务器请求出错	上传到服务器的过程出错时触发该事件