内容发布更新时间 : 2024/12/23 10:34:09星期一 下面是文章的全部内容请认真阅读。

汉王笔迹签名控件接口说明文档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 基本接口

1. LONG HWInitialize (void)

函数功能： 手写模块初始化 参数说明： 返回值见2.1

2. LONG HWFinalize (void)

函数功能： 手写模块卸载 参数说明： 无

3. LONG HWClearPenSign(void)

函数功能： 清除笔迹