c#
VB
c++
引用▼
表明这是否DocumentViewerText应该在需要的时候自动解析的文本页面。
DocumentViewerText包含许多操作要求的文本页面(s)被解析。这是通过调用来完成的DocumentPage.GetText页面的方法。
GetText使用SVG解析文本页面或OCR和可能是一个缓慢的操作。因此,当它被称为DocumentViewerText,结果DocumentPageText对象内部存储和重用时是必要的。
当用户设置一个新的LEADDocument在主题是使用SetDocument,保存的DocumentPageText对象是discared但观众不会开始解析任何页面的文本直到是必要的。
的AutoGetText控制当一个操作需要的文本页面尚未获得。
例如,用户调用SetDocument用一个全新的文档,然后调用SelectAll选择所有文本的页面。这需要遍历所有的页面和解析相应的文本DocumentPageText对象。
此时,观众没有任何DocumentPageText对象保存,需要调用GetText是真正的,然后查看器将调用GetDocumentPageText从内部获得的循环DocumentPageText为每个页面并将其存储在内部对象。当所有的页面已经被解析,可以更新选中的文本,结果视图中突出显示。
下次SelectAll被调用时,观众将执行相同的操作,但这一次使用吗DocumentPageText从之前的操作,将获得并保存调用GetDocumentPageText。
当一个操作等找到被调用时,它执行类似的操作吗SelectAll。然而,这种方法只需要当前页面的文本工作,因此,检查DocumentPageText只有这个页面存在,如果没有,电话GetDocumentPageText得到下一个页面的文本只有在需要的时候。
大部分的业务DocumentViewerText在同样的方式工作,首先,引擎尝试使用DocumentPageText对象从之前的操作,如果它不存在,它调用GetDocumentPageText解析原始文档的文本并将其保存在内部下使用。
GetDocumentPageText获取文本使用DocumentPage.GetText。这可能是一个缓慢的操作,特别是如果使用OCR。因此,的价值AutoGetText是假默认情况下自动解析文本并不是观众,除非指示。
AutoGetText可以根据应用程序和一起吗HasAnyDocumentPageText和HasDocumentPageText和操作事件可以用来执行在任何想要的场景。
如果需要整个文档的文本,应用程序不能没有这个函数,然后调用GetAllDocumentPageText后的文档集。这将循环通过所有的页面和调用GetDocumentPageText为每一个。该方法不返回到所有DocumentPageText对象是获得和存储。之后,使用任何DocumentViewerText方法将即时和及时和原始文档不是用于此目的。
另一个选择是使用GetDocumentPageText在一个循环中(丢弃结果)的力量DocumentViewerText获得和存储DocumentPageText对象。这允许应用程序从一个专门的线程调用这个方法例如并允许用户中止操作之间的循环迭代。
在这种模式下,设置AutoGetText来真正的。现在,当调用DocumentViewerText方法要求DocumentPageText对象,GetDocumentPageText将自动获得解析页面。
这种方法的缺点是,一个操作SelectAll第一次可能要花费大量的时间叫做尤其是文档有大量的页面或OCR用于解析文本。因此,操作事件应该被用来显示一个繁忙的对话框,允许用户中止操作。
GetDocumentPageText通过检查,如果工作DocumentPageText对象为页面之前获得的,如果是这样,它将返回这个对象。否则,它将调用DocumentPage.GetText。但在调用这个方法之前,操作事件触发DocumentViewerOperation.GetText。应用程序可以显示一个繁忙的对话框,当这个事件发生时向用户显示的操作需要一些时间来完成。
另外,应用程序可以使用HasAnyDocumentPageText和HasDocumentPageText根据需要调用方法前检查操作是否可能需要时间来完成(缓慢)。如果确定操作缓慢,那么应用程序可以显示忙对话框之前调用的方法,然后调用异步操作。
在这种模式下,应用程序使用HasAnyDocumentPageText和HasDocumentPageText来确定所需的文本对象将即时获得和操作,如果是这样,它将继续下去。否则会警告用户操作可能是缓慢而提示继续或取消。如果用户选择继续GetDocumentPageText叫做获取和解析文本之前手动调用实际的操作。
演示LEADTOOLS文档查看器可以使用的文本自动和手动的方法。演示包含一个菜单项,可以跳之间的两种模式,改变了应用程序调用文本的方式操作。请参考示例的源代码完整的例子。