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

属性

指定 Text Editor 的底部窗格是否启用。若此属性为 FALSE,则底部窗格不会显示。

默认值为 TRUE。

指定 Text Editor 的标题窗格是否启用。若此属性为 FALSE,则标题窗格不会显示。

默认值为 TRUE。

指定 Text Editor 的上下文菜单是否启用。若此属性为 FALSE,则上下文菜单将始终不显示。

默认值为 TRUE。

,read-only

提供对 Text Editor 中可用命令的访问权限。请参阅Text Editor 中的可用命令列表

指定光标在页面上的位置。

表示与 Text Editor 关联的文档页面。

指定是否在 Text Editor 中保留文本和背景颜色。

此属性的默认值为 TRUE。

指定 Text Editor 是否处于锁定状态。

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

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

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

默认值为 FALSE。

指定文档的查看模式。

默认值为 TEM_ExactCopy。

,read-only

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

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

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

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

指定是否在 Text Editor 中显示图片。

默认情况下,此属性的值为 TRUE。

指定是否在 Text Editor 中显示页眉页脚。

默认情况下,此属性的值为 TRUE。

指定文档的默认合成参数。当 Text Editor 需要执行文档合成时 (某些编辑操作可能导致文档逻辑结构出现错误,进而触发此操作) ,将使用这些参数。

如果 Text Editor 已连接到 Component Synchronizer,请使用IComponentSynchronizer::ProcessingParams属性更改用于文档合成的参数。若通过 Text Editor 的属性更改这些参数,可能会导致错误。

,只读

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

指定 Text Editor 组件的标题。

默认值为 “Text”。

,只读

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

指定文本页面的缩放比例 (以百分比为单位) 。此属性也可设置为常量之一。

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

,read-only

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

,只读

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

方法

名称描述
ActivateOn激活指定块中的某个位置,并将其滚动到可视区域中。
CenterOnDocumentPoint滚动文本视图,使文档上的指定点位于视图中心。
DocumentToScreen将文档图像上指定点的坐标转换为屏幕坐标。
GetSelection返回选区的起始和结束光标位置。
Print打印识别出的文本。
SetSelection在页面上设置文本选区。
ScreenToDocument将指定点的屏幕坐标转换为文档图像上的坐标。
ShowBlock将指定块滚动到可视区域中 (尽可能完整显示) 。仅当 Text Editor 在 TEM_ExactCopy 模式下使用时,此方法才有意义。
ShowDocumentArea滚动文本视图,使具有指定坐标的文档区域可见 (尽可能完整显示) 。
UpdateOptions更新 Text Editor 的“选项”对话框中指定的设置。如果这些选项已在其他某个Visual Component中更改,则可能需要调用此方法,以将 Text Editor 的选项更新到当前状态。

示例

此组件用于以下代码示例:VisualComponents

另请参阅

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