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

汉王笔迹签名控件接口说明文档v2.2 控件使用平台 1.1操作系统平台 Windows XP，Windows Vista，Windows 7 1.2 支持软件平台 （1）浏览器： IE浏览器V2.0至目前IE的最高版本（V10.0） 采用IE内核的浏览器 注：360、搜狗、傲游等浏览器，均是双核浏览器，即兼容模式下为支持IE内核模式，此时支持控件的加载。极速模式下为采用了Chromium内核，此种模式下不支持加载控件。 ????????当用户浏览签批控件所在的页面时，请将以上浏览器的模式切换至兼容模式，否则控件无法正常工作。 （2）支持com组件调用的应用程序中 1.3控件功能 控件为浏览器的子窗口（故不能创建透明的签名窗口），可在窗口内实现带压感的原笔迹手写签字。提供接口支持笔形(压力笔/钢笔)、笔宽（共5级）、笔颜色、窗口边框宽度及颜色、窗口内部背景颜色的设置，支持一次性清除所有笔迹，支持对手写模块的初始化和卸载控制，支持获取签字笔迹的bmp/jpg/png/gif图片格式的base64数据流。 1.4 控件界面 上图是签批控件HWPenSign.ocx界面图，此控件是ActiveX控件，可以嵌入到网页中使用。此控件可以提供用户定制开发，额外收取软件开发费用。 控件接口 注：为保证图像不失真，PC端控件显示窗口与设备窗口长宽比应一致。因此，建议对于设备ESP370，设置控件窗口长宽比为8:3。对于设备ESP560，设置控件窗口长宽比为5:3。 2.1函数返回值错误码 HW_eOk 0 成功 HW_eDeviceNotFound -1 未找到对应的汉王手写设备 HW_eFailedLoadModule -2 手写模块加载失败 HW_eFailedInitModule -3 手写模块初始化失败 HW_eWrongImageFormat -4 不支持的图片格式 HW_eNoSignData -5 没有签名数据 HW_eInvalidInput -6 无效输入参数 其它返回值，参见windows（WinError.h头文件中定义）常见错误码含义。 2.2 基本接口 LONG HWInitialize (void) 函数功能： 手写模块初始化 参数说明： 返回值见2.1 LONG HWFinalize (void) 函数功能： 手写模块卸载 参数说明： 无 LONG HWClearPenSign(void) 函数功能： 清除笔迹 LONG HWSetPenMode(LONG flag) 函数功能： 设置笔模型 参数说明： flag：0 - 毛笔（默认） 1 - 钢笔 LONG HWSetPenWidth(LONG penWidth) 函数功能： 设置笔宽 参数说明： penWidth：笔宽， 提供1-5个级别的设置，默认为3级 LONG HWSetPenColor(OLE_COLOR color) 函数功能： 设置笔的颜色（默认颜色为0x000000） 参数说明： color： 颜色，格式为RGB LONG HWSetBkColor(OLE_COLOR color) 函数功能：设置签名区域背景颜色 参数说明： color：颜色，无背景图片时设置,默认为白色 LONG HWSetCtlFrame(LONG linewidth, OLE_COLOR color) 函数功能： 设置边框宽度和颜色 参数说明： linewidth：边框宽度， 0为无边框。 Color： 边框颜色 LONG HWSetFilePath(VARIANT path) 函数功能： 设置签名图像的保存路径，确保输入路径的目标文件夹存在，若不存在，控件不创建。 参数说明： path：路径，支持图像格式为bmp，jpg，png，gif 注：win7 / vista存在写文件权限问题，因此不支持将保存路径设置为该操作系统盘盘符下。 LONG HWSaveFile(void) 函数功能： 保存文件 参数说明： 返回值见2.1 BSTR HWGetBase64Stream(LONG flag) 函数功能： 获取签字区域图像的base64流 参数说明： flag：0 - bmp 图像类型 1 - jpg 2 - png 3 - gif 返回值：签字图像对应的base64数据流 L