漢王簽批控件接口說(shuō)明文檔v2

1、漢王筆跡簽名控件接口說(shuō)明文檔v2.2控件使用平臺(tái)操作系統(tǒng)平臺(tái)Wi ndows XP, Windows Vista， Windows 72支持軟件平臺(tái)（1）瀏覽器：IE瀏覽器V2.0至目前IE的最高版本（V10.0）采用IE內(nèi)核的瀏覽器注：360、搜狗、傲游等瀏覽器，均是雙核瀏覽器，即兼容模式下為支持IE內(nèi)核模式，此時(shí) 支持控件的加載。極速模式下為采用了 Chromium內(nèi)核，此種模式下不支持加載控件。當(dāng)用戶(hù)瀏覽簽批控件所在的頁(yè)面時(shí)，請(qǐng)將以上瀏覽器的模式切換至兼容模式，否則控件 無(wú)法正常工作。（2）支持com組件調(diào)用的應(yīng)用程序中13控件功能控件為瀏覽器的子窗口（故不能創(chuàng)建透明的簽名窗口）,可在窗

2、 口內(nèi)實(shí)現(xiàn)帶壓感的原筆跡手寫(xiě)簽字。提供接口支持筆形（壓力筆/鋼筆）、筆寬（共5級(jí)）、筆顏色、窗口邊框?qū)挾燃邦伾⒋翱趦?nèi)部 始化和卸載控制，支持獲取簽字筆跡的bmp/jpg/png/gif圖片格式的背景顏色的設(shè)置，支持一次性清除所有筆跡，支持對(duì)手寫(xiě)模塊的初base64數(shù)據(jù)流。14控件界面上圖是簽批控件HWPenSign.ocx界面圖，此控件是ActiveX控件， 可以嵌入到網(wǎng)頁(yè)中使用。此控件可以提供用戶(hù)定制開(kāi)發(fā)，額外收取軟件 開(kāi)發(fā)費(fèi)用?？丶涌谧ⅲ簽楸ＷC圖像不失真，PC端控件顯示窗口與設(shè)備窗口長(zhǎng)寬比應(yīng)一致。因此，建議對(duì)于設(shè)備ESP370,設(shè)置控件窗口長(zhǎng)寬比為8:3o對(duì)于設(shè)備ESP560,設(shè)置控

3、件窗口長(zhǎng)寬比為5:3o2.1函數(shù)返回值錯(cuò)誤碼HW_eO k0HW_eDev i ceNotFound -1HW_eFa i IedLoadModuIe -2HW_eFa i IedIn i tModuIe -3HW_eWronglmageForma t-4HW_eNoS i gnData -5HW_eInvaIi dInput -6 成功未找到對(duì)應(yīng)的漢王手 寫(xiě)設(shè)備手寫(xiě)模塊加載失敗 手寫(xiě)模塊初始化失敗不支 持的圖片格式?jīng)]有簽名數(shù) 據(jù)無(wú)效輸入?yún)?shù)其它返回值，參見(jiàn)windows(WinError.h頭文件中定義)常見(jiàn)錯(cuò)誤碼含義。2.2基本接口1. LONG HWInitialize (void)函數(shù)

4、功能：手寫(xiě)模塊初始化參數(shù)說(shuō)明：返回值見(jiàn)2.12. LONG HWFinalize (void)函數(shù)功能：手寫(xiě)模塊卸載參數(shù)說(shuō)明：無(wú)3. LONG HWCIearPenSign (void)函數(shù)功能：清除筆跡4. LONG HWSetPenMode(LONG flag)函數(shù)功 能：設(shè)置筆模型flag :0 -毛筆（默認(rèn)）參數(shù)說(shuō)1 -鋼筆5. LONGHWSetPenWidth(LONG penWidth)函數(shù)功 能：設(shè)置筆寬penWidth :筆寬，提供1-5個(gè)級(jí)別的設(shè)置，默認(rèn)為3級(jí)6. LONGHWSetPenColor (OLE COLOR color)函數(shù)功 能：設(shè)置筆的顏色（默認(rèn)顏色為0x

5、000000 ） color :顏色，格式為RGB7. LONGHWSetBkColor (OLE COLOR color)函數(shù)功能：設(shè)置簽名區(qū)域背景顏色參數(shù)說(shuō)明：color :顏色，無(wú)背景圖片時(shí)設(shè)置，默認(rèn)為白色8. LONG HWSetCtIFrame (LONG I inewidth, OLE_COLOR color)函數(shù)功 能：設(shè)置邊框?qū)挾群皖伾獻(xiàn) inewidth :邊框?qū)挾龋?為無(wú)邊框。參數(shù)說(shuō)Color :邊框顏色9. LONG HWSetFi I ePath (VAR I ANT &path)函數(shù)功能：設(shè)置簽名圖像的保存路徑，確保輸入路徑的目標(biāo)文件夾存在，若不存在，控件不創(chuàng)建。參數(shù)

6、說(shuō)明：path：路徑，支持圖像格式為bmp, jpg , png, gif注：win7 / vista存在寫(xiě)文件權(quán)限問(wèn)題，因此不支持將保存路徑設(shè)置為該操作系統(tǒng)盤(pán)盤(pán)符 下。10. LONG HWSaveFi le (void)函數(shù)功能：保存文件參數(shù)說(shuō)明：仮回値見(jiàn)2. 111. BSTR HWGetBase64Stream（LONG flag）函數(shù)功能：獲取簽字區(qū)域圖像的base64流參數(shù)說(shuō)明：flag :0- bmp圖像類(lèi)型1 -jpg2 -png3 -gif飯冋值：答字圖像對(duì)應(yīng)的hase64魏揺濟(jì)12. LONG HWSwitchMonitor (LONG mode, LONG ctlapp)

7、函數(shù)功能：參數(shù)說(shuō)明：顯示器模式切換(鏡像&擴(kuò)展)mode： 0 -漢王簽批控件切換到擴(kuò)展 屏顯示1 -漢王簽批控件在主顯示器顯示ctlapp: 0 -保留，取值為0注：此接口僅適用于漢王手寫(xiě)液晶屏。13. LONG HWSetExtWndHandle(LONG hWndHandle)函數(shù)功能：傳遞與控件通信的窗口句柄值hWndHandIe:口句柄值14. LONG HWLoadImage (VARIANT SpathBackImage)函數(shù)功能：給控件手寫(xiě)區(qū)域添加背景圖片參數(shù)說(shuō)明：pathBackImage -背景圖片路徑，當(dāng)背景圖片大小與控件手寫(xiě)區(qū)域大小不一致時(shí)，背景圖片將被進(jìn)行拉伸或縮放:

8、石冋彳古.m 91注：此接口僅適用于獲取整個(gè)簽字區(qū)域圖像版本的控件。15. LONG HWLoadBase64Stream(VAR I ANT Sstream)函數(shù)功能：給控件手寫(xiě)區(qū)域添加背景圖片參數(shù)說(shuō)明：stream背景圖片的Base64數(shù)據(jù)流返回值：見(jiàn)2. 1。注：此接口僅適用于獲取整個(gè)簽字區(qū)域圖像版本的控件。16. LONG HWIsNeedSave(void)函數(shù)功能：是否有需要保存的筆跡參數(shù)說(shuō)明：無(wú)返回值：0無(wú)筆跡有筆跡17. void HWSetSignArea(LONG width, LONG height)函數(shù)功能：設(shè)置待獲取的簽字圖像大小參數(shù)說(shuō)明：width簽字圖像的寬度He

9、ight簽字圖像的高度 注：此接口僅支持無(wú)窗口版本的控件。23簽名動(dòng)作的自動(dòng)觸發(fā) 2. 3.1簽名板仁回調(diào)觸發(fā) 簽名板的簽名界面上帶有重簽”和F角認(rèn)按鈕，用戶(hù) 簽名完成后，點(diǎn)擊 按鈕的動(dòng)作，漢王簽名控件可以捕獲。（一）應(yīng)用系統(tǒng)的HTML頁(yè)面通過(guò)JS代碼引用漢王的簽名板控件（Act i veX） o（二）應(yīng)用系統(tǒng)通過(guò)調(diào)用漢王控件接口函數(shù)HWInitialize開(kāi)始簽 名；（三）客戶(hù)簽名完成，點(diǎn)擊簽名界面下按鈕進(jìn)行重簽、確認(rèn)動(dòng)作；（四）ActiveX控件監(jiān)聽(tīng)到客戶(hù)的動(dòng)作，調(diào)用應(yīng)用系統(tǒng)HTML頁(yè)面上 的JS函數(shù)；（五）應(yīng)用系統(tǒng)調(diào)用漢王控件接口函數(shù)HWFinalize結(jié)束簽名?？丶ˋctiveX ）

10、與HTML頁(yè)面上的回調(diào)函數(shù)存在以下對(duì)應(yīng)關(guān)系：1 ） “確定”按鈕 調(diào)用HTML頁(yè)面上的“ signComplete55函數(shù)2）“重簽”按鈕 調(diào)用HTML頁(yè)面上的signRestar函t數(shù)客戶(hù)可以根據(jù)需要自行實(shí)現(xiàn)上述“ s i gnComp I ete和” ” signRestar函t數(shù)乃,完成 簽名動(dòng)作的自動(dòng)觸發(fā)機(jī)制（如Demo, html 頁(yè)面所示在signCompIete函數(shù)里調(diào)用HWGetBase64Stream接口獲取簽 名圖片。）。應(yīng)用系統(tǒng)也可以不采用這種觸發(fā)機(jī) 制，而通過(guò)手動(dòng)的方 式去獲取用戶(hù)的簽名圖像，此時(shí)在應(yīng)用系統(tǒng)的HTML頁(yè)面中不實(shí)現(xiàn)“ signCompIete 和乃 55

11、signRestar 函 t 數(shù)乃即可。2、窗口消息觸發(fā) 約定：當(dāng)用戶(hù)點(diǎn)擊簽名板上的取消、確定按鈕時(shí)， 控件會(huì)往往以下窗口句柄發(fā)送簽名取消或完成的消息（調(diào)用 HWSetExtWndHandle接口傳進(jìn)來(lái)的窗口句柄）用戶(hù)可在程序中響應(yīng)對(duì)應(yīng) 的消息即可。消息定義如下：HW_SIGN_COMPELETE 0x7ffeHW SIGN CLEAR 0x7ffd2.3.2手寫(xiě)液晶屏1 V回調(diào)觸發(fā)手寫(xiě)液晶屏的左側(cè)有4個(gè)按鍵，當(dāng)用戶(hù)觸發(fā)按鍵時(shí)，控件可以捕 獲并回調(diào)頁(yè)面函數(shù)。具體步驟。（-）應(yīng)用系統(tǒng)的HTML頁(yè)面通過(guò)JS代碼引用漢王的簽名板控件 （ActiveX） o （二）應(yīng)用系統(tǒng)通過(guò)調(diào)用漢王控件接口函數(shù)HW

12、Initialize開(kāi)始簽名；（三）客戶(hù)觸發(fā)手寫(xiě)液晶屏左側(cè)按鍵；（四）ActiveX控件監(jiān)聽(tīng)到客戶(hù)的動(dòng)作，調(diào)用應(yīng)用系統(tǒng)HTML頁(yè)面上的 JS函數(shù)；（五）應(yīng)用系統(tǒng)調(diào)用漢王控件接口函數(shù)HWFinalize結(jié)束簽 名?？丶?Act i veX )與HTML頁(yè)面上的回調(diào)函數(shù)存在以下對(duì)應(yīng)關(guān)系:1）“確認(rèn)“ 按鈕2）“取消”調(diào)用HTML頁(yè)面上的“ Conf i rm_Event 55函數(shù)。 調(diào)用HTML頁(yè)面上的“ Cance I_Event函數(shù)。調(diào)用HTML頁(yè)面上的u PrePage_Even55 t函數(shù)。 調(diào)用HTML頁(yè)面上的“ NextPage_Event55函數(shù)客戶(hù)可以根據(jù)需要自行實(shí) 現(xiàn)上述“ Conf i rm_Event 、“ CanceI_Event、“ PrePage_Even，5 t uNextPage_Event，5 函數(shù)，實(shí)現(xiàn)自動(dòng)飾發(fā)機(jī)制（如Demo, html頁(yè)面所示依次在各不回調(diào)函數(shù)審給 出彈框提示）。2、窗口消息觸發(fā)約定：當(dāng)用戶(hù)點(diǎn)擊簽名板上的取消、確定按鈕時(shí)，控件會(huì)往往以下窗 口句柄發(fā)送 簽名取消或完成的消息（調(diào)用HWSetExtWndHandle