汉王签批控件接口说明文档 v2.2

《汉王签批控件接口说明文档 v2.2》由会员上传分享，免费在线阅读，更多相关内容在应用文档-天天文库。

1、汉王笔迹签名控件接口说明文档v2.2控件使用平台1.1操作系统平台WindowsXP，WindowsVista，Windows71.2支持软件平台（1）浏览器：IE浏览器V2.0至目前IE的最高版本（V10.0）采用IE内核的浏览器注：360、搜狗、傲游等浏览器，均是双核浏览器，即兼容模式下为支持IE内核模式，此时支持控件的加载。极速模式下为采用了Chromium内核，此种模式下不支持加载控件。        当用户浏览签批控件所在的页面时，请将以上浏览器的模式切换至兼容模式，否则控件无法正常工作。（2）支持c

2、om组件调用的应用程序中1.3控件功能控件为浏览器的子窗口（故不能创建透明的签名窗口），可在窗口内实现带压感的原笔迹手写签字。提供接口支持笔形(压力笔/钢笔)、笔宽（共5级）、笔颜色、窗口边框宽度及颜色、窗口内部背景颜色的设置，支持一次性清除所有笔迹，支持对手写模块的初始化和卸载控制，支持获取签字笔迹的bmp/jpg/png/gif图片格式的base64数据流。1.4控件界面上图是签批控件HWPenSign.ocx界面图，此控件是ActiveX控件，可以嵌入到网页中使用。此控件可以提供用户定制开发，额外收取软件

3、开发费用。控件接口注：为保证图像不失真，PC端控件显示窗口与设备窗口长宽比应一致。因此，建议对于设备ESP370，设置控件窗口长宽比为8:3。对于设备ESP560，设置控件窗口长宽比为5:3。2.1函数返回值错误码HW_eOk0成功HW_eDeviceNotFound-1未找到对应的汉王手写设备HW_eFailedLoadModule-2手写模块加载失败HW_eFailedInitModule-3手写模块初始化失败HW_eWrongImageFormat-4不支持的图片格式HW_eNoSignData-5没有签

4、名数据HW_eInvalidInput-6无效输入参数其它返回值，参见windows（WinError.h头文件中定义）常见错误码含义。2.2基本接口1.LONGHWInitialize(void)函数功能：手写模块初始化参数说明：返回值见2.12.LONGHWFinalize(void)函数功能：手写模块卸载参数说明：无3.LONGHWClearPenSign(void)函数功能：清除笔迹1.LONGHWSetPenMode(LONGflag)函数功能：设置笔模型参数说明：flag：0->毛笔（默认）1->钢

5、笔2.LONGHWSetPenWidth(LONGpenWidth)函数功能：设置笔宽参数说明：penWidth：笔宽，提供1-5个级别的设置，默认为3级3.LONGHWSetPenColor(OLE_COLORcolor)函数功能：设置笔的颜色（默认颜色为0x000000）参数说明：color：颜色，格式为RGB4.LONGHWSetBkColor(OLE_COLORcolor)函数功能：设置签名区域背景颜色参数说明：color：颜色，无背景图片时设置,默认为白色5.LONGHWSetCtlFrame(LON

6、Glinewidth,OLE_COLORcolor)函数功能：设置边框宽度和颜色参数说明：linewidth：边框宽度，0为无边框。Color：边框颜色6.LONGHWSetFilePath(VARIANT&path)函数功能：设置签名图像的保存路径，确保输入路径的目标文件夹存在，若不存在，控件不创建。参数说明：path：路径，支持图像格式为bmp，jpg，png，gif注：win7/vista存在写文件权限问题，因此不支持将保存路径设置为该操作系统盘盘符下。7.LONGHWSaveFile(void)函数功能

7、：保存文件参数说明：返回值见2.11.BSTRHWGetBase64Stream(LONGflag)函数功能：获取签字区域图像的base64流参数说明：flag：0->bmp图像类型1->jpg2->png3->gif返回值：签字图像对应的base64数据流2.LONGHWSwitchMonitor(LONGmode,LONGctlapp)函数功能：显示器模式切换（镜像&扩展）参数说明：mode：0–>汉王签批控件切换到扩展屏显示1->汉王签批控件在主显示器显示ctlapp:0->保留，取值为0注：此接口仅适用

8、于汉王手写液晶屏。3.LONGHWSetExtWndHandle(LONGhWndHandle)函数功能：传递与控件通信的窗口句柄值参数说明：hWndHandle：窗口句柄值4.LONGHWLoadImage(VARIANT&pathBackImage)函数功能：給控件手写区域添加背景图片参数说明：pathBackImage–>背景图片路径，当背景图片大小与控件手写区域大小不一致时，背