跳转到主要内容
Visual Components 在 Windows 版 FRE 中实现。
DocumentViewer 对象是一个 ActiveX 控件,可让您查看文档中的页面列表并监视其状态。您还可以使用组件中提供的命令保存识别后的文档,或在所选应用程序中打开该文档。文档通过 FRDocument 属性与该组件关联。 根据 Mode 属性的值,Document Viewer 组件可能如下所示:
  • 详细信息视图
提供每个文档页面的详细信息。 DocumentViewer_Details
  • 缩略图视图
以缩略图形式显示文档页面。 DocumentViewer_Thumbnails 您可以通过其属性修改组件的外观。例如,可以通过 Toolbar 属性向工具栏添加按钮或从中移除按钮,或者通过 PopupMenu 属性修改组件的上下文菜单。有关详细信息,请参阅 自定义 Visual Component 的上下文菜单和工具栏 有关文档监视的信息通过专门的传出接口提供。这些接口包括 IDocumentViewerEvents (用于 C++) 和调度接口 DIDocumentViewerEvents (用于 Visual Basic) 。 需要注意的是,Visual Basic 用户无需关心事件接口实现的细节,因为该开发平台提供了简便的处理方式。此对象可在 Visual Basic 中声明为 WithEvents。 对于 C++ 用户,这意味着该对象支持 IConnectionPointContainer 接口。要接收通知事件,C++ 用户应创建一个派生自 IDocumentViewerEvents 接口的对象,然后通过标准 COM 方法在该对象与 DocumentViewer 对象中实现的事件源之间建立连接。 Document Viewer 组件可以连接到 Component Synchronizer 组件。在这种情况下,Document Viewer 中的所有事件都会自动传递到连接到 Synchronizer 的其他组件,整个应用程序将同步运行。

属性

指定 Document Viewer 中的活动页面。如果没有活动页面,则此属性的值为 0。

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

默认值为 TRUE。

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

默认值为 TRUE。

,只读

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

指定连接到 Document Viewer 的文档。

指定 Document Viewer 的语言页面是否已启用。如果此属性为 FALSE,则不显示语言页面。

默认值为 TRUE。

指定 Document Viewer 是否已锁定。

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

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

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

默认值为 FALSE。

指定 Document Viewer 的当前模式:详细信息视图或缩略图视图。

默认模式为 DVM_Thumbnails。

,只读

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

指定文档的默认处理参数。这些 参数在分析和识别过程直接从 Document Viewer 调用时使用。

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

指定 Document Viewer 组件的标题。

默认值为 “Pages”。

,read-only

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

提供对所选页面索引集合的访问权限。

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

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

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

,只读

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

方法

名称描述
UpdateOptions更新在 Document Viewer 的“选项”对话框中指定的设置。如果这些选项已在其他可视组件中发生更改,则可能需要调用此方法,将 Document Viewer 的选项更新到当前状态。

示例

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

另请参阅

IDocumentViewerEvents IComponentSynchronizer::DocumentViewer 创建具有图形用户界面的应用程序 自定义 Visual Component 的上下文菜单和工具栏