属性、方法和事件

默认情况下,页面加载完成后,Dynamic Web TWAIN会自动初始化。 一旦Dynamic Web TWAIN对象已初始化,您可以开始调用其方法,设置其属性等。您可以在我们的API文档里找到Dynamic Web TWAIN的所有属性,方法和事件。

属性

属性用于在运行时从Dynamic Web TWAIN对象获取或设置某个值,例如Resolution, Duplex, IfShowUI等。

DWObject.Resolution = 200; // 以200 DPI扫描

方法

方法用于调用Dynamic Web TWAIN对象的内置函数,如AcquireImageSaveAsJPEGRotate等。语法非常简单:

DWObject.Rotate(0, 45, false); // 将内存里的第一个图像旋转45度

事件

达到某些触发点时会触发事件。例如,我们有一个鼠标单击事件OnMouseClick,一个在传输一个图像结束后触发的事件OnPostTransfer等等。相比属性和方法,事件使用起来有点棘手。我们在这里再讨论一下。

处理事件

添加一个事件侦听器

要添加事件侦听器,可以使用内置方法RegisterEvent。 请参阅以下示例代码:

Dynamsoft.WebTwainEnv.RegisterEvent('OnWebTwainReady', Dynamsoft_OnReady);
var DWObject;
/* OnWebTwainReady事件将在Dynamic Web TWAIN初始化后立即触发,这里是添加事件侦听器的最佳位置。 */
function Dynamsoft_OnReady() {
    DWObject = Dynamsoft.WebTwainEnv.GetWebTwain('dwtcontrolContainer');
    DWObject.RegisterEvent("OnPostTransfer", Dynamsoft_OnPostTransfer);
}
function Dynamsoft_OnPostTransfer() {
    /* 一个图像传输结束后将触发OnPostTransfer。 */
    /* 您的代码可以写在这里。*/
}

在上面的代码中,我们添加了函数Dynamsoft_OnPostTransfer()作为OnPostTransfer的事件侦听器。或者,您也可以这样编写:

Dynamsoft.WebTwainEnv.RegisterEvent('OnWebTwainReady', Dynamsoft_OnReady);
var DWObject;
function Dynamsoft_OnReady() {
    DWObject = Dynamsoft.WebTwainEnv.GetWebTwain('dwtcontrolContainer');
    DWObject.RegisterEvent("OnPostTransfer", function () {
        /* 您的代码可以写在这里。*/
    };
}

带参数的事件

有些事件有参数。 以OnMouseClick事件为例:

OnMouseClick(Number nImageIndex) /* sImageIndex是您单击的图像的索引。*/

当您创建相应的函数(也称为事件侦听器)时,您可以带上参数并在运行时检索值。

function DynamicWebTwain_OnMouseClick(index) {
    console.log(index);
}

或者,

DWObject.RegisterEvent("OnPostTransfer", function (index) {
    console.log(index);
};

特殊事件 - OnWebTwainReady

要查看所有事件,请参阅API文档。在这些事件中,有一个叫做OnWebTwainReady的特殊事件。该事件在Dynamic Web TWAIN对象初始化成功后立即被触发。正如您在前文中所见,推荐这样用:

Dynamsoft.WebTwainEnv.RegisterEvent('OnWebTwainReady', Dynamsoft_OnReady);
var DWObject;
function Dynamsoft_OnReady() {
    DWObject = Dynamsoft.WebTwainEnv.GetWebTwain('dwtcontrolContainer');
}

或者,

Dynamsoft.WebTwainEnv.RegisterEvent('OnWebTwainReady', function () {
    DWObject = Dynamsoft.WebTwainEnv.GetWebTwain('dwtcontrolContainer');
};

results matching ""

    No results matching ""