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

汉王笔迹签名控件接口说明文档v2.1 控件使用平台 1 .1 操作系统平台 Window s XP，Window s Vista，Window s 7 1 .2 支持软件平台 （1）浏览器： IE 浏览器V2.0 至目前IE 的最高版本（V10.0） （2）支持com 组件调用的应用程序中 1 .3 控件功能 控件为浏览器的子窗口（故不能创建透明的签名窗口），可在窗口内实现带压感的原笔迹手写签字。提供接口支持笔形(压力笔/钢笔)、笔宽（共 5 级）、笔颜色、窗口边框宽度及颜色、窗口内部背景颜色的设置，支持一次性清除所有笔迹，支持对手写模块的初始化和卸载控制，支持获取签字笔迹的bmp/jpg/png/gif图片格式的base64 数据流。 1 .4 控件界面 上图是签批控件HWPenSign.ocx 界面图，此控件是Activ eX 控件，可以嵌入到网页中使用。此控件可以提供用户定制开发，额外收取软件开发费用。 控件接口 注：为保证图像不失真，PC 端控件显示窗口与设备窗口长宽比应一致。因此，建议对于设备ESP370，设置控件窗口长宽比为2:1。对于设备ESP560，设置控件窗口长宽比为4:3。 2 .1 函数返回值错误码 HW_eOk 0 成功 HW_eDeviceNotFound -1 未找到对应的汉王手写设备 HW_eFailedLoadModule -2 手写模块加载失败 HW_eFailedInitModule -3 手写模块初始化失败 HW_eWrongImageFormat -4 不支持的图片格式 HW_eNoSignData -5 没有签名数据 其它返回值，参见 w indow s（WinError.h 头文件中定义）常见错误码含义。 2 .2 基本接口 1. LONG HWInitialize (void); 函数功能： 手写模块初始化 参数说明： 返回值见 2.1 2. LONG HWFinalize (void); 函数功能： 手写模块卸载 参数说明： 无 3. LONG HWClearPenSign(void); 函数功能： 清除笔迹 4. LONG HWSetPenMode(LONG flag); 函数功能： 设置笔模型 参数说明： flag：0 -> 毛笔（默认） 1 -> 钢笔 5. LONG HWSetPenWidth(LONG penWidth); 函数功能： 设置笔宽 参数说明： penWidth：笔宽， 提供 1-5 个级别的设置，默认为3 级 6. LONG HWSetPenColor(OLE_COLOR color); 函数功能： 设置笔的颜色（默认颜色为0x000000） 参数说明： color： 颜色，格式为RGB 7. LONG HWSetBkColor(OLE_COLOR color); 函数功能：设置签名区域背景颜色 参数说明： color：颜色，无背景图片时设置,默认为白色 8. LONG HWSetCtlFrame(LONG linewidth, O...