加载保存

方法
FileExists() LoadDibFromClipboard()
LoadImage() LoadImageEx()
LoadImageFromBase64Binary() SaveAllAsMultiPageTIFF()
SaveAllAsPDF() SaveAsBMP()
SaveAsJPEG() SaveAsPDF()
SaveAsPNG() SaveAsTIFF()
SaveSelectedImagesAsMultiPagePDF() SaveSelectedImagesAsMultiPageTIFF()
SaveSelectedImagesToBase64Binary() ShowFileDialog()
属性
IfShowFileDialog
事件
OnGetFilePath OnPostLoad

示例代码

以下代码示例演示如何使用上述API执行加载和保存。

var imagedata;
DWObject.SelectedImagesCount = 1;
DWObject.SetSelectedImageIndex(0,0);
DWObject.GetSelectedImagesSize(EnumDWT_ImageType.IT_JPG);
imagedata = DWObject.SaveSelectedImagesToBase64Binary();
DWObject.LoadImageFromBase64Binary(imagedata, EnumDWT_ImageType.IT_JPG, function(){
    console.log('success');
    },function(){
    console.log('failure');
});

方法

FileExists()
检查本地磁盘上是否存在某个文件。
语法 .FileExists(fileName);
参数 string fileName:要检查的文件的绝对路径。
返回值 Boolean
示例代码
DWObject.FileExists("C:\\DWT\\WebTWAIN.jpg");
使用说明
版本信息 v9.0+
LoadDibFromClipboard()
将DIB图像从系统剪贴板加载到Dynamic Web TWAIN中。
语法 .LoadDibFromClipboard([optionalAsyncSuccessFunc, optionalAsyncFailureFunc]);
参数 以下两个参数是可选的。 如果存在任何一个或两者都存在,则该方法是异步的,否则它是同步的。
<OnSuccess function> optional optionalAsyncSuccessFunc:成功加载文件时触发的回调函数。
<OnFailure function> optional optionalAsyncFailureFunc:无法加载文件时触发的回调函数。
返回值 Boolean
仅在同步使用时有效。
示例代码
使用说明
版本信息 所有版本
LoadImage()
将本地图像加载到Dynamic Web TWAIN中。
语法 .LoadImage(fileName, [optionalAsyncSuccessFunc, optionalAsyncFailureFunc]);
参数 string fileName:要打开的图片的绝对路径(包含文件名)。
以下两个参数是可选的。 如果存在任何一个或两者都存在,则该方法是异步的,否则它是同步的。
<OnSuccess function> optional optionalAsyncSuccessFunc:成功加载文件时触发的回调函数。
<OnFailure function> optional optionalAsyncFailureFunc:无法加载文件时触发的回调函数。
返回值 Boolean
仅在同步使用时有效。
示例代码
DWObject.LoadImage("C:\\DWT.jpg");
使用说明 Dynamic Web TWAIN根据fileName的扩展名来处理图像格式。
版本信息 所有版本
LoadImageEx()
将本地图像加载到Dynamic Web TWAIN中。
语法 .LoadImageEx(fileName, imageType, [optionalAsyncSuccessFunc, optionalAsyncFailureFunc]);
参数 string fileName:用于打开文件的绝对路径。
EnumDWT_ImageType (int) imageType:图像的格式。
以下两个参数是可选的。 如果存在任何一个或两者都存在,则该方法是异步的,否则它是同步的。
<OnSuccess function> optional optionalAsyncSuccessFunc:成功加载文件时触发的回调函数。
<OnFailure function> optional optionalAsyncFailureFunc:无法加载文件时触发的回调函数。
返回值 Boolean
仅在同步使用时有效。
示例代码
DWObject.IfShowFileDialog = true;
DWObject.LoadImageEx("", EnumDWT_ImageType.IT_ALL);
使用说明 如果要通过显示“打开文件”对话框来加载/打开图像,可以将IfShowFileDialog设置为true。
版本信息 所有版本
LoadImageFromBase64Binary()
从base64字符串加载图像。
语法 .LoadImageFromBase64Binary(imageData, imageType, [optionalAsyncSuccessFunc, optionalAsyncFailureFunc]);
参数 string imageData:base64字符串。
EnumDWT_ImageType (int) imageType:图像的格式。
以下两个参数是可选的。 如果存在任何一个或两者都存在,则该方法是异步的,否则它是同步的。
<OnSuccess function> optional optionalAsyncSuccessFunc:操作成功时触发的回调函数。
<OnFailure function> optional optionalAsyncFailureFunc:操作失败时触发的回调函数。
返回值 Boolean
示例代码
var imagedata;
DWObject.SelectedImagesCount = 1;
DWObject.SetSelectedImageIndex(0,0);
DWObject.GetSelectedImagesSize(EnumDWT_ImageType.IT_JPG);
imagedata = DWObject.SaveSelectedImagesToBase64Binary();
DWObject.LoadImageFromBase64Binary(imagedata, EnumDWT_ImageType.IT_JPG, function(){
    console.log('success');
    },function(){
    console.log('failure');
});
使用说明
版本信息 v6.2+
SaveAllAsMultiPageTIFF()
将Dynamic Web TWAIN缓冲区中所有图像保存为多页TIFF文件。
语法 .SaveAllAsMultiPageTIFF(fileName, [optionalAsyncSuccessFunc, optionalAsyncFailureFunc]);
参数 string fileName:保存文件的绝对路径。
以下两个参数是可选的。 如果存在任何一个或两者都存在,则该方法是异步的,否则它是同步的。
<OnSuccess function> optional optionalAsyncSuccessFunc:成功保存文件时触发回调函数。
<OnFailure function> optional optionalAsyncFailureFunc:无法保存文件时触发的回调函数。
返回值 Boolean
仅在同步使用时有效。
示例代码
DWObject.SaveAllAsMultiPageTIFF("C:\\DWT.tiff");
使用说明 多页TIFF编码是Dynamic Web TWAIN的内置功能,不需要额外的dll。 如果要通过显示“保存文件”对话框来保存图像,可以将IfShowFileDialog设置为true。
版本信息 所有版本
SaveAllAsPDF()
将Dynamic Web TWAIN缓冲区中所有图像保存为多页PDF文件。
语法 .SaveAllAsPDF(fileName, [optionalAsyncSuccessFunc, optionalAsyncFailureFunc]);
参数 string fileName : 保存文件的绝对路径。
以下两个参数是可选的。 如果存在任何一个或两者都存在,则该方法是异步的,否则它是同步的。
<OnSuccess function> optional optionalAsyncSuccessFunc:成功保存文件时触发回调函数。
<OnFailure function> optional optionalAsyncFailureFunc:无法保存文件时触发的回调函数。
返回值 Boolean
仅在同步使用时有效。
示例代码
DWObject.SaveAllAsPDF("C:\\DWT.pdf");
使用说明 多页PDF编码是Dynamic Web TWAIN的内置功能,不需要额外的dll。 如果要通过显示“保存文件”对话框来保存图像,可以将IfShowFileDialog设置为true。
版本信息 所有版本
SaveAsBMP()
将Dynamic Web TWAIN缓冲区中的指定索引的图像保存为BMP文件。
语法 .SaveAsBMP(fileName, sImageIndex, [optionalAsyncSuccessFunc, optionalAsyncFailureFunc]);
参数 string fileName :客户端计算机上保存文件的绝对路径。
short sImageIndex :缓冲区中图像的索引。该索引从0开始。
以下两个参数是可选的。如果存在任何一个或两者都存在,则该方法是异步的,否则它是同步的。
<OnSuccess function> optional optionalAsyncSuccessFunc:成功保存文件时触发回调函数。
<OnFailure function> optional optionalAsyncFailureFunc:无法保存文件时触发的回调函数。
返回值 Boolean
仅在同步使用时有效。
示例代码
//Callback functions for async APIs
function OnSuccess() {
    console.log('successful');
}
function OnFailure(errorCode, errorString) {            
    alert(errorString);
}
function btn_SaveOnClick() {
    if (DWObject.HowManyImagesInBuffer == 0){
        alert("No images in buffer.");
        return;                
    }
    DWObject.SaveAsBMP("D:\\test.bmp", 0, OnSuccess, OnFailure);
}
使用说明 如果要通过显示“保存文件”对话框来保存图像,可以将IfShowFileDialog设置为true。
版本信息 所有版本
SaveAsJPEG()
将Dynamic Web TWAIN缓冲区中的指定索引的图像保存为JPEG文件。
语法 .SaveAsJPEG(fileName, sImageIndex, [optionalAsyncSuccessFunc, optionalAsyncFailureFunc]);
参数 string fileName :客户端计算机上保存文件的绝对路径。
short sImageIndex :缓冲区中图像的索引。该索引从0开始。
以下两个参数是可选的。 如果存在任何一个或两者都存在,则该方法是异步的,否则它是同步的。
<OnSuccess function> optional optionalAsyncSuccessFunc:成功保存文件时触发回调函数。
<OnFailure function> optional optionalAsyncFailureFunc:无法保存文件时触发的回调函数。
返回值 Boolean
仅在同步使用时有效。
示例代码
//Callback functions for async APIs
function OnSuccess() {
    console.log('successful');
}
function OnFailure(errorCode, errorString) {            
        alert(errorString);
}
function btn_SaveOnClick() {
    if (DWObject.HowManyImagesInBuffer == 0){
        alert("No images in buffer.");
        return;                
    }
    DWObject.SaveAsJPEG("D:\\test.jpg", 0, OnSuccess, OnFailure);
}
使用说明 如果要通过显示“保存文件”对话框来保存图像,可以将IfShowFileDialog设置为true。
版本信息 所有版本
SaveAsPDF()
将Dynamic Web TWAIN缓冲区中的指定索引的图像保存为PDF文件。
语法 .SaveAsPDF(fileName, sImageIndex, [optionalAsyncSuccessFunc, optionalAsyncFailureFunc]);
参数 string fileName : 客户端计算机上保存文件的绝对路径。
short sImageIndex : 缓冲区中图像的索引。该索引从0开始。
以下两个参数是可选的。如果存在任何一个或两者都存在,则该方法是异步的,否则它是同步的。
<OnSuccess function> optional optionalAsyncSuccessFunc:成功保存文件时触发回调函数。
<OnFailure function> optional optionalAsyncFailureFunc:无法保存文件时触发的回调函数。
返回值 Boolean
仅在同步使用时有效。
示例代码
//Callback functions for async APIs
function OnSuccess() {
    console.log('successful');
}
function OnFailure(errorCode, errorString) {            
    alert(errorString);
}
function btn_SaveOnClick() {
    if (DWObject.HowManyImagesInBuffer == 0){
        alert("No images in buffer.");
        return;                
    }
    DWObject.SaveAsPDF("D:\\test.pdf", 0, OnSuccess, OnFailure);
}
使用说明 如果要通过显示“保存文件”对话框来保存图像,可以将IfShowFileDialog设置为true。
版本信息 所有版本
SaveAsPNG()
将Dynamic Web TWAIN缓冲区中的指定索引的图像保存为PNG文件。
语法 .SaveAsPNG(fileName, sImageIndex, [optionalAsyncSuccessFunc, optionalAsyncFailureFunc]);
参数 string fileName : 客户端计算机上保存文件的绝对路径。
short sImageIndex : 缓冲区中图像的索引。该索引从0开始。
以下两个参数是可选的。如果存在任何一个或两者都存在,则该方法是异步的,否则它是同步的。
<OnSuccess function> optional optionalAsyncSuccessFunc:成功保存文件时触发回调函数。
<OnFailure function> optional optionalAsyncFailureFunc:无法保存文件时触发的回调函数。
返回值 Boolean
仅在同步使用时有效。
示例代码
//Callback functions for async APIs
function OnSuccess() {
    console.log('successful');
}
function OnFailure(errorCode, errorString) {            
    alert(errorString);
}        
function btn_SaveOnClick() {
    if (DWObject.HowManyImagesInBuffer == 0){
        alert("No images in buffer.");
        return;                
    }            
    DWObject.SaveAsPNG("D:\\test.png", 0, OnSuccess, OnFailure);
}
使用说明 如果要通过显示“保存文件”对话框来保存图像,可以将IfShowFileDialog设置为true。
版本信息 所有版本
SaveAsTIFF()
将Dynamic Web TWAIN缓冲区中的指定索引的图像保存为TIFF文件。
语法 .SaveAsTIFF(fileName, sImageIndex, [optionalAsyncSuccessFunc, optionalAsyncFailureFunc]);
参数 string fileName : 客户端计算机上保存文件的绝对路径。
short sImageIndex : 缓冲区中图像的索引。该索引从0开始。
以下两个参数是可选的。如果存在任何一个或两者都存在,则该方法是异步的,否则它是同步的。
<OnSuccess function> optional optionalAsyncSuccessFunc:成功保存文件时触发回调函数。
<OnFailure function> optional optionalAsyncFailureFunc:无法保存文件时触发的回调函数。
返回值 Boolean
仅在同步使用时有效。
示例代码
//Callback functions for async APIs
function OnSuccess() {
    console.log('successful');
}
function OnFailure(errorCode, errorString) {            
    alert(errorString);
}
function btn_SaveOnClick() {
    if (DWObject.HowManyImagesInBuffer == 0){
        alert("No images in buffer.");
        return;                
    }
    DWObject.SaveAsTIFF("D:\\test.tif", 0, OnSuccess, OnFailure);
}
使用说明 如果要通过显示“保存文件”对话框来保存图像,可以将IfShowFileDialog设置为true。
版本信息 所有版本
SaveSelectedImagesAsMultiPagePDF()
将Dynamic Web TWAIN缓冲区中所有被选择的图像保存为多页PDF文件。
语法 .SaveSelectedImagesAsMultiPagePDF(fileName, [optionalAsyncSuccessFunc, optionalAsyncFailureFunc]);
参数 string fileName : 客户端计算机上保存文件的绝对路径。
以下两个参数是可选的。如果存在任何一个或两者都存在,则该方法是异步的,否则它是同步的。
<OnSuccess function> optional optionalAsyncSuccessFunc:成功保存文件时触发回调函数。
<OnFailure function> optional optionalAsyncFailureFunc:无法保存文件时触发的回调函数。
返回值 Boolean
仅在同步使用时有效。
示例代码
DWObject.SelectedImagesCount = 1;
DWObject.SetSelectedImageIndex(0,0);
DWObject.SaveSelectedImagesAsMultiPagePDF("C:\\DWT.pdf");
使用说明 多页PDF编码是Dynamic Web TWAIN的内置功能,不需要额外的dll。 如果要通过显示“保存文件”对话框来保存图像,可以将IfShowFileDialog设置为true。
版本信息 v6.0+
SaveSelectedImagesAsMultiPageTIFF()
将Dynamic Web TWAIN缓冲区中所有被选择的图像保存为多页TIFF文件。
语法 .SaveSelectedImagesAsMultiPagePDF(fileName, [optionalAsyncSuccessFunc, optionalAsyncFailureFunc]);
参数 string fileName : 保存文件的绝对路径。
以下两个参数是可选的。 如果存在任何一个或两者都存在,则该方法是异步的,否则它是同步的。
<OnSuccess function> optional optionalAsyncSuccessFunc:成功保存文件时触发回调函数。
<OnFailure function> optional optionalAsyncFailureFunc:无法保存文件时触发的回调函数。
返回值 Boolean
仅在同步使用时有效。
示例代码
DWObject.SelectedImagesCount = 1;
DWObject.SetSelectedImageIndex(0,0);
DWObject.SaveSelectedImagesAsMultiPageTIFF("C:\\DWT.tiff");
使用说明 多页TIFF编码是Dynamic Web TWAIN的内置功能,不需要额外的dll。 如果要通过显示“保存文件”对话框来保存图像,可以将IfShowFileDialog设置为true。
版本信息 v6.0+
SaveSelectedImagesToBase64Binary()
将缓冲区中的选定图像保存为base64字符串。
语法 .SaveSelectedImagesToBase64Binary();
参数
返回值 string
得到的结果字符串是纯base64字符串,没有额外信息。 例如,
"/9j/4AAQSkZJRgABA...".
如果您要使用该base64字符串,则需要添加额外的信息,例
data:image/png;base64,"/9j/4AAQSkZJRgABA...".
示例代码
var imagedata;
DWObject.SelectedImagesCount = 1;
DWObject.SetSelectedImageIndex(0, 0);
DWObject.GetSelectedImagesSize(EnumDWT_ImageType.IT_JPG);
imagedata = DWObject.SaveSelectedImagesToBase64Binary();
newImage.src = "data:image/png;base64," + imagedata;
使用说明 请在调用此方法之前调用GetSelectedImagesSize以指定目标格式。 默认值为IT_JPG,它不支持黑白图像。
版本信息 v6.2+
ShowFileDialog()
显示系统的保存文件对话框或打开文件对话框。
语法 .ShowFileDialog(bSave, filter, filterIndex, defaultExtension, initialDir, allowMultiSelect, overwritePrompt, flags);
参数 bool bsave:true - 显示保存文件对话框,false - 显示打开文件对话框。
string filter:筛选名称指定筛选模式(例如,“JPG | *.jpg”)。要指定多个筛选模式,请使用分号分隔模式(例如,“JPG, PNG and TIF | *.jpg;*.png;*.tif”,对于macOS设置为“JPG, PNG, TIF”)。模式字符串可以是带有星号(*)的有效文件扩展名的组合。不要在模式字符串中包含空格。要显示所有文件,请使用字符串“All Files | *.*”。
int filterIndex:确定我们设置的筛选字符串的索引,换句话说,筛选字符串应出现在对话框的筛选下拉框中。默认情况下,它为0,您无需更改它。此参数不适用于macOS。
string defaultExtension:定义文件名的默认扩展名。仅在保存图像时有用。如果此成员为NULL并且用户无法键入扩展名,则不会附加扩展名。
string initialDir:初始目录。用于选择在不同平台上变化的初始目录的算法。
bool allowMultiSelect:true - 允许多个选择,false - 仅允许单个文件选择。
bool overwritePrompt:true - 如果文件已存在且名称相同,则用户需要在覆盖现有文件之前进行确认,false - 如果文件已存在且名称相同,则将覆盖该文件而无需用户进一步确认。
int flags:如果此参数等于0,则将使用自定义设置启动程序。否则它将使用默认标志启动,这意味着allowMultiSelectoverwritePrompt将不起作用。
返回值 Boolean
示例代码
DWObject.RegisterEvent('OnGetFilePath', function(bSave, filesCount, index, path, filename){
    alert(" fileCount: " +  filesCount + " index: " +  index + " path: " +  path + "\\" +  filename);
});
//In macOS
var result = DWObject.ShowFileDialog(false, "TIF,TIFF,JPG,JPEF,PNG,PDF", 0, "", "", true, false, 0);
//In Windows
var result = DWObject.ShowFileDialog(false, "TIF,TIFF,JPG,JPEF,PNG,PDF", 0, "", "", true, true, 0)
alert(result);
使用说明 对于Mac Edition,该方法的执行方式不同。
即使失败,此方法也会触发OnGetFilePath事件。如果选择了多个文件,则会多次调用该事件。
版本信息 v8.0+

属性

IfShowFileDialog
保存扫描图像或从本地目录加载图像时,返回或设置是否显示打开/保存文件对话框。
类型 Boolean
访问权限 Get Set
使用说明 加载图片时,该属性仅适用于LoadImageEx()方法。
版本信息 v6.2+

事件

OnGetFilePath
当从操作系统返回文件路径时会触发此事件,这在调用ShowFileDialog方法或在IfShowFileDialog设置为true的情况下
调用LoadImageEx方法时发生。
语法 .RegisterEvent('OnGetFilePath',function(bSave, filesCount, index, path, filename){...});
参数
  • Boolean bSave:true - 显示保存文件对话框,false - 显示打开文件对话框。
  • Number filesCount:选择了多少个文件。 0表示未选择任何文件或用户已关闭/取消。
  • Number index:当前所选文件的索引。以0为基础,-1表示未选择任何文件。
  • String path:当前所选文件的父路径,不包括“\\”。如果方法ShowFileDialog失败,则返回ShowFileDialog
    方法中设置的初始目录路径。
  • String filename:当前文件名。
示例代码
DWObject.RegisterEvent('OnGetFilePath', function(bSave, filesCount, index, path, filename){
    alert("bSave:" + bSave + " fileCount: " +  filesCount + " index: " +  index + " path: " +  path + 
    "\\" +  filename);
});
使用说明  
版本信息 v8.0+
OnPostLoad
当本地目录中的图像文件已加载到控件中时,将触发此事件。
语法 .RegisterEvent('OnPostLoad',function(path, name, type){...});
参数
  • String path:加载图像的本地路径。 例如,C:\Users\[username]\Downloads\
  • String name:加载图像的名称。 例如,image1.jpg
  • EnumDWT_ImageType type:图像格式。
示例代码
DWObject.RegisterEvent('OnPostLoad', function(path, name, type) {
    alert(path + '\\' + name);
});
使用说明 如果加载了多个图像文件,则每加载一个图像都会触发一次此事件。
版本信息 v6.3+

results matching ""

    No results matching ""