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事件 
用户接口卸载后触发。