Zum Hauptinhalt springen
visuelle Komponenten sind in FRE für Windows implementiert.
Das DocumentViewer-Objekt ist ein ActiveX-Steuerelement, mit dem Sie die Liste der Seiten im Dokument anzeigen und ihren Status überwachen können. Sie können das erkannte Dokument auch speichern oder es mithilfe der in der Komponente verfügbaren Befehle in der ausgewählten Anwendung öffnen. Ein Dokument wird über die Eigenschaft FRDocument mit der Komponente verbunden. Die visuelle Komponente Document Viewer kann je nach Wert der Eigenschaft Mode folgendermaßen aussehen:
  • Detailansicht
Bietet detaillierte Informationen zu jeder Dokumentseite. DocumentViewer_Details
  • Miniaturansicht
Zeigt Dokumentseiten als Miniaturansichten an. DocumentViewer_Thumbnails Sie können das Erscheinungsbild der Komponente über ihre Eigenschaften anpassen. So können Sie beispielsweise über die Eigenschaft Toolbar Schaltflächen zur Symbolleiste hinzufügen oder daraus entfernen oder über die Eigenschaft PopupMenu das Kontextmenü der Komponente ändern. Ausführliche Informationen finden Sie unter Anpassen des Kontextmenüs und der Symbolleiste einer visuellen Komponente. Die Informationen zur Dokumentüberwachung werden über spezielle ausgehende Schnittstellen bereitgestellt. Diese Schnittstellen sind IDocumentViewerEvents (für C++) und eine dispinterface DIDocumentViewerEvents (für Visual Basic). Es ist wichtig zu beachten, dass sich Visual-Basic-Benutzer nicht um die Details der Implementierung von Ereignisschnittstellen kümmern müssen, da diese Entwicklungsplattform einfache Möglichkeiten für deren Verarbeitung bietet. Dieses Objekt kann in Visual Basic als WithEvents deklariert werden. Für C++-Benutzer bedeutet dies, dass das Objekt die Schnittstelle IConnectionPointContainer unterstützt. Um Benachrichtigungsereignisse zu empfangen, sollte ein C++-Benutzer ein von der Schnittstelle IDocumentViewerEvents abgeleitetes Objekt erstellen und dann mit Standard-COM-Mitteln die Verbindung zwischen diesem Objekt und der im DocumentViewer-Objekt implementierten Ereignisquelle herstellen. Die visuelle Komponente Document Viewer kann mit der Komponente Component Synchronizer verbunden werden. In diesem Fall werden alle Ereignisse von Document Viewer automatisch an andere mit dem Synchronizer verbundene Komponenten übertragen, und die gesamte Anwendung arbeitet synchron.

Eigenschaften

Gibt die aktive Seite im Document Viewer an. Wenn keine aktive Seite vorhanden ist, beträgt der Wert dieser Eigenschaft 0.

Gibt an, ob der Beschriftungsbereich des Document Viewers aktiviert ist. Wenn diese Eigenschaft FALSE ist, wird der Beschriftungsbereich nicht angezeigt.

Standardmäßig ist der Wert TRUE.

Gibt an, ob das Kontextmenü des Document Viewers aktiviert ist. Wenn diese Eigenschaft FALSE ist, wird das Kontextmenü nie angezeigt.

Standardmäßig ist der Wert TRUE.

,read-only

Ermöglicht den Zugriff auf die im Document Viewer verfügbaren Befehle. Siehedie Liste der im Document Viewer verfügbaren Befehle.

Gibt das mit dem Document Viewer verbundene Dokument an.

Gibt an, ob der Sprachbereich des Document Viewers aktiviert ist. Wenn diese Eigenschaft FALSE ist, wird der Sprachbereich nicht angezeigt.

Standardmäßig ist der Wert TRUE.

Gibt an, ob der Document Viewer gesperrt ist.

Diese Eigenschaft ist in folgenden Situationen nützlich:

  • Ein Analyse-, Erkennungs-, Synthese- oder Exportvorgang wird über die FineReader Engine API aufgerufen (nicht über Visual Components), oder
  • Ihre Anwendung empfängt Benachrichtigungen über bestimmte Ereignisse (z. B. vomObjekt) und verarbeitet Windows-Nachrichten von Visual Components in diesen Ereignishandlern.

In diesem Fall empfehlen wir, diese Eigenschaft vor der Analyse, Erkennung, Synthese oder dem Export auf TRUE zu setzen und sie nach Abschluss des Vorgangs wieder auf FALSE zu setzen. Auf diese Weise kann das Dokument nicht über den Document Viewer beschädigt werden.

Standardmäßig ist der Wert FALSE.

Gibt den aktuellen Modus des Document Viewers an: Detailansicht oder Miniaturansicht.

Standardmäßig ist der Modus DVM_Thumbnails.

,read-only

Ermöglicht den Zugriff auf die Einstellungen des Kontextmenüs.

Gibt die Standard-Verarbeitungsparameter für das Dokument an. Diese parameters are used if the analysis and recognition processes are called directly from Document Viewer.

If Document Viewer is connected to Component Synchronizer, use theIComponentSynchronizer::ProcessingParamsproperty to change parameters used for processing. If you change processing parameters via the property of Document Viewer, errors may occur.

Specifies the title of the Document Viewer component.

By default, it is “Pages”.

,read-only

Provides access to the toolbar settings.

Provides access to the collection of indices of selected pages.

Specifies the path to the folder which contains files with the settings of Document Viewer. Other Visual Components have the same property. Each Visual Component should use its own folder with settings.

The value of this property is constructed from the path to the folder, in which ABBYY FineReader Engine stores user-specific data, and the name of its subfolder. By default, the folder with user-specific data is theFineReader Engine data folder. It can be changed during initialization of FineReader Engine (via thefunction, or via themethod). The default name of the subfolder is an arbitrary GUID. To change the name of the subfolder, you should specify the new name in the properties of the component in Visual Studio at design time. If you try to specify the value of the property at run time, this value is ignored.

Wenn Sie die Komponente zur Entwurfszeit in Visual Studio einem Formular hinzufügen, wird der Wert der Eigenschaft entweder automatisch mit dem Standardwert oder manuell mit einem benutzerdefinierten Wert festgelegt. In beiden Fällen wird der Wert zur Entwurfszeit definiert. Wenn der Wert der Eigenschaft aus irgendeinem Grund zur Entwurfszeit nicht definiert ist (z. B. wenn Sie die Komponente dynamisch zur Laufzeit generieren), erstellt die Komponente bei jeder Initialisierung einen neuen Ordner mit den Einstellungen. Um eine Anhäufung von Ordnern zu vermeiden, sollten Sie den erstellten Einstellungsordner nach der Deinitialisierung der Komponente löschen. In diesem Fall können Sie nur die Standardeinstellungen der Komponente verwenden und die Einstellungen nicht sitzungsübergreifend speichern.

, read-only

Returns the window handle of the client area.

Methoden

NameBeschreibung
UpdateOptionsAktualisiert die im Dialogfeld „Optionen“ von Document Viewer festgelegten Einstellungen. Möglicherweise müssen Sie diese Methode aufrufen, wenn die Optionen in einer anderen visuellen Komponente geändert wurden, um die Optionen von Document Viewer auf den aktuellen Stand zu aktualisieren.

Beispiele

Diese Komponente wird in den folgenden Codebeispielen verwendet: VisualComponents.

Siehe auch

IDocumentViewerEvents IComponentSynchronizer::DocumentViewer Erstellen einer Anwendung mit grafischer Benutzeroberfläche Anpassen des Kontextmenüs und der Symbolleiste einer visuellen Komponente