扫描识别工具Dynamic Web TWAIN使用教程：属性/方法/事件介绍

2019独角兽企业重金招聘Python工程师标准>>>

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等。

1 2 3

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

方法

方法用于调用Dynamic Web TWAIN对象的内置函数，如AcquireImage、SaveAsJPEG、Rotate等。语法非常简单：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18

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

事件

当达到某个触发点时触发事件。例如，OnMouseClick鼠标点击事件等。与属性和方法相比，事件是有点难度的。在这里我们再多谈一下。

处理事件

添加一个事件监听器

要添加事件监听器，可以使用内置方法RegisterEvent。请参考下面的示例代码：

1 2 3 4 5 6 7 8 9 10 11 12 13

<script type="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的事件监听器。另外，你可以写这样的代码：

1 2 3 4 5 6 7 8 9 10

<script type="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事件为例：

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

 

当您创建相应的JavaScript函数（AKA，事件侦听器）时，可以包含参数并在运行时进行检索。

1 2 3

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

或者

1 2 3

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

 

特殊事件 -“OnWebTwainReady”
在所有的内置事件中，有一个特殊事件“OnWebTwainReady”。基本上这个事件在Dynamic Web TWAIN对象被初始化并准备好使用的时候触发。正如您在本文前面看到的那样，推荐使用它的方法是：

1 2 3 4 5 6 7

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

或者

1 2 3 4 5

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

本次教程到此结束，希望能对Dynamic Web TWAIN的用户带来帮助，接下来还会有更多的相关教程，敬请期待！

转载于:https://my.oschina.net/u/3279502/blog/1581707