Web版控件示例文档-下载-牛牛截图控件浏览器版调用说明.doc

牛牛截图控件浏览器版调用说明 牛牛截图控件浏览器版调用说明 1 1. 接口初始化接口 2 2. 参数初始化接口 2 3. 启动截图接口 7 4. 截图完成后向浏览器通知的事件 8 5. 其他接口 9 6. 调用示例 10  本说明文档旨在对截图控件的浏览器控件进行说明，指导调用者顺利的将截图控件集成进第三方网页中，使第三方网页也能拥有完美的牛牛截图功能。 牛牛截图网页演示页面请访问：/testcapture.htm 写在前面的话：牛牛截图控件目前支持的功能比较丰富，接口比较丰富，但能保证基本功能的接口并不复杂，在查看文档时，请自行根据自己的需求查看相应的接口；添加水印、获取剪贴板中的图片属于高级功能，如果不需要，这部分可以忽略。 提醒：牛牛截图的核心的调用代码已经全部封装在了niuniucapture.js中，一般情况下，你不需要修改只文件内容，只需要引用，并且自己另外写JS来与UI集成即可，具体见示例(capturewrapper.js)。 牛牛截图控件浏览器版能在目前所有的主流浏览器上正常工作，以下的接口说明适用于所有浏览器，并且提供相应的Javascript调用示例。控件主要有三个接口：InitCapture，InitParam以及Capture，这些接口均是暴露给浏览器的Javascript调用,具体可以参考调用WebNiuniuCapturedemo_source.zip，接口的具体描述如下： 接口初始化接口 int InitCapture (const char* szAuth); 此接口函数用于初始化截图控件的授权信息，默认的授权码为：niuniu。 参数说明： 参数名 参数类型 参数说明 备注 szAuth 字符串 接口调用的授权码 默认的授权码为：niuniu 参数初始化接口 int InitParam (int flag, unsigned long flagvalue); 此接口函数用于初始化截图各个状态下的界面的显示效果，如果不调用，则以默认值处理。 参数说明： 参数名 参数类型 参数说明 备注 flag int 要设置的参数项 此处对应的枚举ExtendFlagTypeEnum的整形值 flagvalue unsigned long 设置的参数值 根据不同的枚举来设置不同的值 枚举定义如下: typedef enum ExtendFlagTypeEnum { emPensize = 1, // emDrawType, // emTrackColor, // emEditBorderColor, // emTransparent, // emWindowAware, emDetectSubWindowRect, emSetSaveName, emSetMagnifierBkColor, //设置放大镜的背景色，不设置则透明 emSetMagnifierLogoText, //设置放大镜上的LOGO字符，可提示快捷键，如：牛牛截图(CTRL + SHIFT + A) emSetPreCaptureWindowTitle, //设置网页上截图时弹出窗口的标题 emSetPreCaptureWindowTransparent=18,//设置预截图窗口的透明度 emSetWatermarkPictureType=20, //设置水印的类型 emSetWatermarkPicturePath, //设置水印的路径 emSetWatermarkTextType, //设置水印文字的类型 emSetWatermarkTextValue, //设置水印文字 emSetMosaicType, //设置马赛克的样式 emSetTooltipText, //设置工具栏图标的TOOLTIP及完成按钮的文字 }; 枚举项的说明如下： 枚举参数名 枚举对应数值 参数值说明 备注 emPensize 1 设置画笔大小emDrawType 2 设置是腾讯风格还是360风格emTrackColor 3 Track及自动识别的边框的颜色RGB(255, 0, 0) emEditBorderColor 4 文本输入框的边框颜色RGB(0, 174, 255) emTransparent 5 工具栏的透明度emWindowAware 6 设置是否禁用随着DPI放大，flagvalue传递任意值均可 浏览器中建议不要调用 emDetectSubWindowRect 7 是否自动检测子窗口，暂时无用emSetSaveName 8 设置保存时的文件名称