漢王手寫簽批控件正式版 20130524,漢王HT1020_GAJT 電子簽批 車管所專用電腦簽字板 簽名版 手寫板,請注意此控件來源于網絡,不保證下載能成功安裝,請充分考慮潛在風險,一經下載金幣樹概不退返
控件使用平臺
1.1操作系統平臺
Windows XP,Windows Vista,Windows 71.2 支持軟件平臺
(1)瀏覽器:IE瀏覽器V2.0至目前IE的最高版本(V10.0)
(2)支持com組件調用的應用程序中
1.3控件功能
控件為瀏覽器的子窗口(故不能創建透明的簽名窗口),可在窗口內實現帶壓感的原筆跡手寫簽字。提供接口支持筆形(壓力筆/鋼筆)、筆寬(共5級)、筆顏色、窗口邊框寬度及顏色、窗口內部背景顏色的設置,支持一次性清除所有筆跡,支持對手寫模塊的初始化和卸載控制,支持獲取簽字筆跡的bmp/jpg/png/gif圖片格式的base64數據流。1.4 控件界面


上圖是簽批控件HWPenSign.ocx界面圖,此控件是ActiveX控件,可以嵌入到網頁中使用。此控件可以提供用戶定制開發,額外收取軟件開發費用。
控件接口
注:為保證圖像不失真,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 沒有簽名數據
其它返回值,參見windows(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, OLE_COLOR color);
函數功能: 設置邊框寬度和顏色
參數說明: linewidth:邊框寬度, 0為無邊框。
Color: 邊框顏色
9. LONG HWSetFilePath(VARIANT &path);
函數功能: 設置簽名圖像的保存路徑,確保輸入路徑的目標文件夾存在,若不存在,控件不創建。
參數說明: path:路徑,支持圖像格式為bmp,jpg,png,gif
注:win7 / vista存在寫文件權限問題,因此不支持將保存路徑設置為該操作系統盤盤符下。
10. LONG HWSaveFile(void);
函數功能: 保存文件
參數說明: 返回值見2.1
11. BSTR HWGetBase64Stream(LONG flag);
函數功能: 獲取簽字區域圖像的base64流
參數說明: flag:0 -> bmp 圖像類型
1 -> jpg
2 -> png
3 -> gif
返回值:簽字圖像對應的base64數據流
12. LONG HWSwitchMonitor(LONG mode, LONG ctlapp);
函數功能: 顯示器模式切換(鏡像&擴展)
參數說明: mode:0 –> 漢王簽批控件切換到擴展屏顯示
1 -> 漢王簽批控件在主顯示器顯示
ctlapp: 0 -> 保留,取值為0
注:此接口僅適用于漢王手寫液晶屏。
13. LONG HWSetExtWndHandle(LONG hWndHandle);
函數功能:傳遞與控件通信的窗口句柄值
參數說明:hWndHandle:窗口句柄值
2.3 簽名動作的自動觸發
2.3.1 簽名板
1、回調觸發簽名板的簽名界面上帶有“重簽”和“確認”按鈕,用戶簽名完成后,點擊按鈕的動作,漢王簽名控件可以捕獲。
(一) 應用系統的HTML頁面通過JS代碼引用漢王的簽名板控件(ActiveX)。
(二) 應用系統通過調用漢王控件接口函數HWInitialize開始簽名;
(三) 客戶簽名完成,點擊簽名界面下按鈕進行重簽、確認動作;
(四) ActiveX控件監聽到客戶的動作,調用應用系統HTML頁面上的JS函數;
(五) 應用系統調用漢王控件接口函數HWFinalize結束簽名。
控件(ActiveX)與HTML頁面上的回調函數存在以下對應關系:
1) “確定”按鈕 à 調用HTML頁面上的“signComplete”函數
2) “重簽”按鈕 à 調用HTML頁面上的”signRestart”函數
客戶可以根據需要自行實現上述“signComplete”和”signRestart”函數,完成簽名動作的自動觸發機制 (如Demo.html頁面所示在signComplete函數里調用HWGetBase64Stream接口獲取簽名圖片。)。應用系統也可以不采用這種觸發機制,而通過手動的方式去獲取用戶的簽名圖像,此時在應用系統的HTML頁面中不實現“signComplete”和”signRestart”函數即可。
2、窗口消息觸發
約定:當用戶點擊簽名板上的取消、確定按鈕時,控件會往往以下窗口句柄發送簽名取消或完成的消息(調用HWSetExtWndHandle接口傳進來的窗口句柄)。用戶可在程序中響應對應的消息即可。消息定義如下:
HW_SIGN_COMPELETE 0x7ffe
HW_SIGN_CLEAR 0x7ffd
2.3.2 手寫液晶屏
1、回調觸發手寫液晶屏的左側有4個按鍵,當用戶觸發按鍵時,控件可以捕獲并回調頁面函數。具體步驟。
(一) 應用系統的HTML頁面通過JS代碼引用漢王的簽名板控件(ActiveX)。
(二) 應用系統通過調用漢王控件接口函數HWInitialize開始簽名;
(三) 客戶觸發手寫液晶屏左側按鍵;
(四) ActiveX控件監聽到客戶的動作,調用應用系統HTML頁面上的JS函數;
(五) 應用系統調用漢王控件接口函數HWFinalize結束簽名。
控件(ActiveX)與HTML頁面上的回調函數存在以下對應關系:
1) “確認”按鈕 à 調用HTML頁面上的“Confirm_Event”函數。
2) “取消”按鈕 à 調用HTML頁面上的“Cancel_Event”函數。
3) “上翻”按鈕 à 調用HTML頁面上的“PrePage_Event”函數。
4) “下翻”按鈕 à 調用HTML頁面上的“NextPage_Event”函數
客戶可以根據需要自行實現上述“Confirm_Event”、“Cancel_Event”、“PrePage_Event”、“NextPage_Event”函數,實現自動觸發機制 (如Demo.html頁面所示依次在各個回調函數中給出彈框提示)。
備注
(1)接口使用方法可參考Demo.html文件。(2)由于控件為瀏覽器的一個子窗口,故不能創建透明的簽名窗口。
!!!瀏覽此頁面必看重要提醒:
本站編寫的瀏覽,閱讀,分享,使用,下載的內容及為資料編寫的說明均為有償服務(不包括其它公司資料及產品),請閱讀并認同網站申明=>>點擊此處查看,否則請立即關閉對“易家電子 ejdz.cn”的訪問。
本站所有文檔及程序附帶的說明僅提供給有專業知識的人查閱,測試。無法提供任何技術支持,也不承擔任何責任。不排除第三方做出的調整導致的失效過期。使用人應該充分考慮其風險。