跳转到主要内容
Visual Components 在适用于 Windows 的 FRE 中实现。
ZoomViewer 对象是一个 ActiveX 控件,可让您查看当前正在编辑的行或已处理图像区域的放大图像。Image Viewer 显示页面的整体视图,而 Zoom Viewer 则便于您更细致地查看图像、调整区域位置,或将不确定字符与放大图像进行比对。图像通过 FRPage 属性连接到 Zoom Viewer。 Zoom Viewer 组件如下所示: ZoomViewer 您可以通过其属性修改该组件的外观。例如,您可以通过 Commands 属性修改组件的上下文菜单。有关详细信息,请参阅 Customizing the Context Menu and Toolbar of a Visual Component 有关图像查看的信息通过专用的传出接口提供。这些接口包括 IZoomViewerEvents (适用于 C++) 以及 dispinterface DIZoomViewerEvents (适用于 Visual Basic) 。 需要注意的是,Visual Basic 用户无需关心事件接口实现的细节,因为该开发平台提供了便捷的事件处理方式。此对象可以在 Visual Basic 中声明为 WithEvents。 对于 C++ 用户,这意味着它支持 IConnectionPointContainer 接口。要接收通知事件,C++ 用户应创建一个派生自 IZoomViewerEvents 接口的对象,然后通过标准 COM 方法,在该对象与由 ZoomViewer 对象实现的事件源之间建立连接。 Zoom Viewer 组件可以连接到 Component Synchronizer 组件。这样一来,Zoom Viewer 中的所有事件都会自动传递给连接到 Synchronizer 的其他组件,整个应用程序也将同步运行。

属性

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

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

默认值为 TRUE。

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

默认值为 TRUE。

,read-only

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

表示连接到 Zoom Viewer 的文档页面。

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

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

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

在这种情况下,建议在分析、识别、合成或导出操作之前将此属性设置为 TRUE,并在操作结束后将其设置为 FALSE。如此一来,文档便不会被 Zoom Viewer 意外修改。

默认值为 FALSE。

指定文档的默认处理参数。若直接从 Zoom Viewer 调用分析和识别流程,则使用这些参数。

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

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

此属性的值由 ABBYY FineReader Engine 存储用户特定数据的文件夹路径及其子文件夹名称共同构成。默认情况下,存储用户特定数据的文件夹为FineReader Engine 数据文件夹。可在 FineReader Engine 初始化期间 (通过函数,或通过方法) 更改该路径。子文件夹的默认名称为随机生成的 GUID。要更改子文件夹的名称,您应在 组件在 Visual Studio 中设计时的属性。如果 您尝试在运行时指定该属性的值,此值 将被忽略。

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

存储当前字符矩形的像素坐标。 坐标相对于文档图像。

指定是否以黄色矩形标记当前字符。

默认值为 TRUE。

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

默认值为 ST_PixelToPixel,表示图像以逐像素模式显示。

,只读

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

, 只读

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

方法

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

示例

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

另请参阅

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