跳转到主要内容
Visual Components 在 Windows 版 FRE 中实现。
ImageViewer 对象是一个 ActiveX 控件,可用于查看和编辑图像及其上的块。图像通过 FRPage 属性连接到 Image Viewer。 Image Viewer 组件如下所示: ImageViewer 您可以通过组件的属性修改其外观。例如,可以通过 Toolbar 属性向工具栏添加按钮或从中移除按钮,也可以通过 PopupMenu 属性修改组件的上下文菜单。有关详细信息,请参阅 自定义 可视组件 的上下文菜单和工具栏 有关图像查看和编辑的信息通过专门的传出接口提供。这些接口包括 IImageViewerEvents (用于 C++) 以及 dispinterface DIImageViewerEvents (用于 Visual Basic) 。 需要注意的是,Visual Basic 用户无须关心事件接口实现的细节,因为该开发平台提供了便捷的处理方式。此对象可在 Visual Basic 中声明为 WithEvents。 对于 C++ 用户,这意味着它支持 IConnectionPointContainer 接口。要接收通知事件,C++ 用户应创建一个派生自 IImageViewerEvents 接口的对象,然后通过标准 COM 方式,在该对象与 ImageViewer 对象中实现的事件源之间建立连接。 Image Viewer 组件可以连接到 Component Synchronizer 组件。在这种情况下,Image Viewer 中的所有事件都会自动传递给连接到 Synchronizer 的其他组件,整个应用程序将同步运行。

属性

指定用于块和图像编辑的当前活动工具。

指定 Image Viewer 是否滚动浏览文档的所有页面。如果此属性为 FALSE,Image Viewer 仅滚动浏览当前选定的页面。

默认值为 TRUE。

指定 Image Viewer 的底部窗格是否启用。如果此属性为 FALSE,则底部窗格不会显示。

默认值为 TRUE。

指定 Image Viewer 的标题窗格是否启用。如果此属性为 FALSE,则标题窗格不会显示。

默认值为 TRUE。

指定 Image Viewer 的上下文菜单是否启用。如果此属性为 FALSE,则上下文菜单将始终不显示。

默认值为 TRUE。

,read-only

提供对 Image Viewer 中可用命令的访问。请参阅Image Viewer 中的可用命令列表

指定与 Image Viewer 关联的文档页面。

指定在识别过程中是否在图像上高亮显示已识别的片段。通过此属性可以实时查看识别进度。

默认值为 TRUE。

指定 Image Viewer 是否处于锁定状态。

在以下情况下,此属性非常有用:

  • 通过 FineReader Engine API (而非 Visual Components) 调用分析、识别、合成或导出操作,或
  • 应用程序接收到某些事件的通知 (例如,来自对象) ,并在这些事件处理程序中处理来自 Visual Components 的 Windows 消息。

在这种情况下,建议在执行分析、识别、合成或导出操作之前将此属性设置为 TRUE,并在操作完成后将其设置为 FALSE。这样可以防止文档在 Image Viewer 中被意外修改。

默认值为 FALSE。

,只读

提供对上下文菜单设置的访问。

指定文档的默认处理参数。如果直接从 Image Viewer 调用分析、识别和合成流程,则使用这些参数。

如果 Image Viewer 已连接到 Component Synchronizer,请使用IComponentSynchronizer::ProcessingParams属性更改处理所用的参数。如果通过 Image Viewer 的属性更改处理参数,可能会发生错误。

提供对在 Image Editor 对话框中所选页面索引集合的访问。

指定包含 Image Viewer 设置文件的文件夹路径。其他 Visual Components 具有相同的属性。每个 Visual Component 应使用各自独立的设置文件夹。

此属性的值由 ABBYY FineReader Engine 存储用户特定数据的文件夹路径及其子文件夹名称构成。默认情况下,存储用户特定数据的文件夹为FineReader Engine 数据文件夹。可在 FineReader Engine 初始化期间更改该文件夹。子文件夹的默认名称为任意 GUID。若要更改子文件夹名称,应在设计时于 Visual Studio 的组件属性中指定新名称。如果尝试在运行时指定该属性的值,此值将被忽略。

如果在设计时将组件添加到 Visual Studio 的窗体中,属性值将以默认值自动定义,或以自定义值手动定义。两种情况下,值均在设计时确定。如果由于某种原因属性值未在设计时定义 (例如,在运行时动态生成组件) ,则每次初始化组件时,组件都会创建一个新的设置文件夹。为避免文件夹持续增多,应在组件反初始化后删除已创建的设置文件夹。在这种情况下,只能使用组件的默认设置,且无法在会话之间保存设置。

指定 Image Viewer 组件的标题。

默认值为 “Image”。

,只读

提供对工具栏设置的访问。

以百分比指定图像的缩放比例。此属性也可设置为常量之一。

默认值为 ST_BestFit,表示自动选择最佳适配比例。

,只读

以像素为单位存储可见文档区域的坐标。坐标相对于文档图像。

,只读

返回客户端区域的窗口句柄。

存储缩放区域矩形的坐标 (以像素为单位) 。坐标相对于文档图像。

指定是否在图像上用虚线矩形标记缩放区域。

默认值为 TRUE。

方法

名称描述
CenterOnDocumentPoint滚动图像视图,使指定点位于视图中心。
DocumentToScreen将文档图像上指定点的坐标转换为屏幕坐标。
GetSelectedBlocksIndices返回已选块的索引集合。
GetSelectedCells返回指定表格块中所选单元格的外接矩形。
Print打印图像。
ScreenToDocument将指定点的屏幕坐标转换为文档图像上的坐标。
SetSelectedBlocksIndices设置块选区。
SetSelectedCells设置指定表格块中的选定单元格。
ShowDocumentArea滚动图像视图,使具有指定坐标的文档区域尽可能显示出来。
UpdateOptions更新在 Image Viewer 的“选项”对话框中指定的设置。如果这些选项已在其他 可视组件 中更改,您可能需要调用此方法,以将 Image Viewer 的选项更新为当前状态。

示例

以下代码示例中使用了此组件:VisualComponents

另请参阅

IImageViewerEvents IComponentSynchronizer::ImageViewer 创建带图形用户界面的应用程序 自定义可视组件的上下文菜单和工具栏 使用属性