Kodak图像扫描控件的属性、事件、方法

Kodak图像扫描控件的属性、事件、方法
1． Kodak图像扫描控件的属性
（1）DestImageControl属性
字符型。该属性连接图像扫描控件到一个图像编辑控件，允许在扫描完毕后查看图像。
（2）FileType属性
数值型。返回或设置图像扫描后建立的图像类型，属性值如表4-43所示。
表4-43 FileType属性值
属性值 说明
1-Kodak Image Document (TIFF) TIFF文件
2-Fax Viewer Document (AWD) AWD文件，适用于Windows98，XP下会引发OLE错误
3- 3-Bitmap Image (BMP) BMP位图文件
（3）Image属性
字符型。返回或设置要扫描图像的名称。例如，你指定了属性值为“C:/TEMP/Img”，扫描图像后会自动在“C:/TEMP”目录下建立类似Img00001.xxx、Img00002.xxx命名方式的文件，其中“xxx”为图像格式后缀“TIF”或“BMP”等。
（4）MultiPage属性
逻辑型。返回或设置是否一个或多个图像页被扫描进一个图像文件中。缺省值为.F.，扫描单个图像页到一个图像文件中；为.T.时可以将多个图像页放置到一个图像文件中。
该属性需要结合Page、PageCount和PageOption属性一起使用。
（5）Page属性
数值型。返回或设置一个扫描会话的起始页。
通过该属性设置当前图像的页号。如果要追加到一个文件中，需要将页号设置为0，同时，PageOption属性应当设置为2（在现有文件中附加页）；如果要插入一个或多个页，需要将页号设置在要插入页的前面。
（6）PageCount属性
数值型。返回或设置每个图像文件的页数目。
（7）PageOption属性
数值型。返回或设置扫描完毕后页的添加方式。属性值如表4-44所示。
表4-44 PageOption属性值
属性值 说明
0-Create New File 创建新文件
1-Prompt To Create New File 提示创建新文件
2- Append Pages 在现有文件中追加页
3-Insert Pages 在现有文件中插入页
4- Overwrite Pages 覆盖现有文件中的页
5- Prompt To Overwrite Pages 提示覆盖现有文件中的页
6- Overwrite All Pages 覆盖所有页（覆盖文件）
（8）ScanTo属性
数值型。返回或设置图像扫描的结果。属性值如表4-45所示。
表4-45 ScanTo属性值
属性值 说明
0-Display Only 只显示
1-Display and File 显示并归档
2- File Only 只归档
3- Display and Use File Template 显示并使用文件模板
4-Use File Template Only 只使用文件模板
5-Fax Only 只传真
如果设置属性值为1、2或5，需要一个文件名称；如果属性值为3或4，需要一个文件模板，该模板通过Image属性设置。
（9）Scroll属性
逻辑型。设置扫描完成后滚动显示图像。该属性在ScanTo属性的0、1、3模式下有效。
（10）ShowSetupBeforeScan属性
逻辑型。该属性用来设置在开始扫描前是否显示扫描仪的用户设置窗口。
（11）StatusCode 属性
数值型。用来返回最近的错误状态码，0表示没有错误。
（12）StopScanBox属性
逻辑型。该属性用来设置在停止一个扫描会话时是否显示一个对话框窗口。缺省值为.F.，不显示。
（13）Zoom属性
数值型。返回或设置扫描页的显示比例。
2． Kodak图像扫描控件的方法
（1）CloseScanner方法
该方法通过卸载驱动程序来关闭一个扫描仪。
当一个扫描仪或应用程序发生错误时，再次访问前关闭扫描仪以避免可能存在的问题。
（2）GetCompressionPreference方法
返回通过ShowScanPreference方法或SetPageTypeCompressionOpts方法设置的扫描压缩首选项。返回值如表4-46所示。
表4-46 图像压缩选项
设置值 说明
0 （缺省）最佳显示质量
1 显示质量好且文件尽可能小
2 最小的文件大小
3 字定义设置
（3）GetPageTypeCompressionInfo方法
该方法通过指定图像类型来返回压缩信息。如：
nCompression=Thisform.OleScan1.GetPageTypeCompressionInfo(imagetype)
其中OleScan1为Kodak图像扫描控件，imagetype为图像类型参数，可用的图像类型见表4-47；nCompression为返回的压缩信息值，可能的返回值如表4-48所示。
表4-47 图像类型参数
设置值 说明
1 黑白
2 16级灰度
3 256级灰度
4 256色
5 24位真彩色
6 16色
表4-48 GetPageTypeCompressionInfo方法返回的压缩信息
返回值 说明
0 无压缩信息
4096 组3（1D）已修改的霍夫曼编码
0 组3（1D）已修改的反转位顺序霍夫曼编码
6400 组3（1D）传真
2304 组3（1D）反转位顺序传真
4608 组4（2D）传真
512 组4（2D）反转位顺序传真
0 TIFF Packbits (无压缩信息)
0 LZW (无压缩信息)
11610 JPEG 低分辨率，低压缩
7740 JPEG 低分辨率，中等压缩
3870 JPEG 低分辨率，高压缩
27994 JPEG 中等分辨率，低压缩
24124 JPEG 中等分辨率，中等压缩
20254 JPEG 中等分辨率，高压缩
-21158 JPEG 高分辨率，低压缩
-25028 JPEG高分辨率，中等压缩
-28898 JPEG高分辨率，高压缩
（4）GetPageTypeCompressionType方法
该方法通过指定图像类型来返回压缩类型。如：
nCompression=Thisform.OleScan1.GetPageTypeCompressionType(imagetype)
其中的imagetype为图像类型参数，可用的图像类型请参考表4-47；nCompression为返回的压缩信息值，可能的返回值如表4-49所示。
表4-49 GetPageTypeCompressionType方法返回的压缩信息
返回值 说明
0 无压缩
1 CCITT 组3（1D）
2 CCITT 组4（2D）
4 TIFF Packbits
8 JPEG
21 LZW
（5）OpenScanner方法
通过加载驱动程序打开扫描仪。
（6）ResetScanner方法
重置扫描仪的硬件和软件。
（7）ScannerAvailable方法
检查TWAIN-兼容扫描仪是否可用。如果返回值为.T.，表示可用。
（8）SetPageTypeCompressionOpts方法
设置所有基于图像类型的压缩信息，该方法可以接收4个参数：comppref、imagetype、comptype和compinfo。如：
Thisform.OleScan1. SetPageTypeCompressionOpts(comppref,imagetype,comptype, compinfo)
comppref可用的参数值参考表4-46；imagetype可用的参数值参考4-47；comptype可用的参数值参考表4-48；compinfo可用的参数值参考表4-49。
（9）ShowScanNew方法
该方法用来显示扫描新图对话框，来改变选项进行扫描。该方法可以接收一个逻辑型参数，如：
Thisform.OleScan1. ShowScanNew(.T.)
.T.表示显示一个模式对话框，.F.表示显示非模式对话框。
（10）ShowScanPage方法
该方法用来显示扫描页面对话框，来改变选项进行扫描。该方法可以接收一个逻辑型参数，如：
Thisform.Olecontrol1.ShowScanPage(.T.)
.T.表示显示一个模式对话框，.F.表示显示非模式对话框。
（11）ShowScanPreferences方法
该方法用来显示扫描压缩选项对话框。
（12）ShowSelectScanner方法
该方法用来显示一个选择扫描仪对话框。
（13）StartScan方法
开始扫描。如果扫描仪是关闭的，该方法将打开扫描仪并在扫描完毕后重新关闭。
（14）StopScan方法
停止扫描。
3． Kodak图像扫描控件的事件
（1）PageDone事件
该事件在一个页扫描完毕后触发。该事件可以接收到一个pagenumber值，该值为刚扫描的页的页号。
（2）ScanDone事件
该事件在扫描操作完成后触发。
（3）ScanStarted事件
该事件在第一个图像页传送到控件前发生。
（4）ScanUIDone事件
用户接口卸载后触发。