掃描識別工具Dynamic Web TWAIN使用教程：屬性/方法/事件介紹

Dynamic Web TWAIN是一個專爲Web應用程序設計的TWAIN掃描識別控件。你只需在TWAIN接口寫幾行代碼，就可以用兼容TWAIN的掃描儀掃描文檔或從數碼相機/採集卡中獲取圖像。
本文爲你介紹Dynamic Web TWAIN中屬性/方法/事件的具體操作代碼，歡迎收藏。

 

Dynamic Web TWAIN最新版免費下載>>>

 

當正確實施後，Dynamic Web TWAIN將在頁面加載後自動初始化。一旦初始化，你就可以像堆任何正常的JS對象一樣控制它。您可以參考我們的在線API文檔來查看Dynamic Web TWAIN的所有內置屬性、方法和事件。

 

這裏有三種使用Dynamic Web TWAIN的方法：

屬性

屬性用於在運行時從Dynamic Web TWAIN中獲取或設置特定的值，例如Resolution、Duplex、IfShowUI等。

/* Property */
/* Scan pages in 200 DPI */
DWObject.Resolution = 200;

方法

方法用於調用Dynamic Web TWAIN對象的內置函數，如AcquireImage、SaveAsJPEG、Rotate等。語法非常簡單：

// Method
   
///
<summary> /// Rotates the image of a specified index in buffer by a specified angle.
  /// </summary>
///
<paramname="sImageIndex"type="short"data-filtered="filtered">
specifies the index of image in buffer. The index is 0-based.
 
///
<paramname="fAngle"type="float"data-filtered="filtered">
specifies the angle.
///
<paramname="bKeepSize"type="bool"data-filtered="filtered">
specifies whether to keep the original size
///
<returnstype="bool"data-filtered="filtered"></returns>
DWObject.Rotate(0, 45, false); // rotate the 1st image in the buffer by 45 degrees

事件

當達到某個觸發點時觸發事件。例如，OnMouseClick鼠標點擊事件等。與屬性和方法相比，事件是有點難度的。在這裏我們再多談一下。

 

處理事件

添加一個事件監聽器

 

要添加事件監聽器，可以使用內置方法RegisterEvent。請參考下面的示例代碼：

<scripttype="text/javascript"data-filtered="filtered">
Dynamsoft.WebTwainEnv.RegisterEvent('OnWebTwainReady', Dynamsoft_OnReady);
var DWObject;
/* OnWebTwainReady event fires as soon as Dynamic Web TWAIN is initialized and ready to be used. It is the best place to add event listeners */
function Dynamsoft_OnReady() {
   DWObject = Dynamsoft.WebTwainEnv.GetWebTwain('dwtcontrolContainer');
   DWObject.RegisterEvent("OnPostTransfer", Dynamsoft_OnPostTransfer);
}
function Dynamsoft_OnPostTransfer() {
   /* This event OnPostTransfer will be triggered after a transfer ends. */
   /* your code goes here*/
}
</script>

 

在上面的代碼中，我們添加了JavaScript函數Dynamsoft_OnPostTransfer()作爲事件OnPostTransfer的事件監聽器。另外，你可以寫這樣的代碼：

<scripttype="text/javascript"data-filtered="filtered">
Dynamsoft.WebTwainEnv.RegisterEvent('OnWebTwainReady', Dynamsoft_OnReady);
var DWObject;
function Dynamsoft_OnReady() {
   DWObject = Dynamsoft.WebTwainEnv.GetWebTwain('dwtcontrolContainer');
   DWObject.RegisterEvent("OnPostTransfer", function() {
    /* your code goes here*/
   });
}
</script> 

有參數的事件

一些事件具有參數。以OnMouseClick事件爲例：

/* sImageIndex is the index of the image you clicked on*/
OnMouseClick(short sImageIndex)

 

當您創建相應的JavaScript函數（AKA，事件偵聽器）時，可以包含參數並在運行時進行檢索。

function DynamicWebTwain_OnMouseClick(index) {
    CurrentImage.value = index + 1;
}

或者

DWObject.RegisterEvent("OnPostTransfer", function(index) {
    CurrentImage.value = index + 1;
});

特殊事件 -“OnWebTwainReady”
在所有的內置事件中，有一個特殊事件“OnWebTwainReady”。基本上這個事件在Dynamic Web TWAIN對象被初始化並準備好使用的時候觸發。正如您在本文前面看到的那樣，推薦使用它的方法是：

<scripttype="text/javascript"data-filtered="filtered">
Dynamsoft.WebTwainEnv.RegisterEvent('OnWebTwainReady', Dynamsoft_OnReady);
var DWObject;
function Dynamsoft_OnReady() {
   DWObject = Dynamsoft.WebTwainEnv.GetWebTwain('dwtcontrolContainer');
}
</script>

或者

<scripttype="text/javascript"data-filtered="filtered">
   Dynamsoft.WebTwainEnv.RegisterEvent('OnWebTwainReady', function() {
     DWObject = Dynamsoft.WebTwainEnv.GetWebTwain('dwtcontrolContainer');
   });
</script>

本次教程到此結束，希望能對Dynamic Web TWAIN的用戶帶來幫助，接下來還會有更多的相關教程，敬請期待！