Zum Hauptinhalt springen
Visuelle Komponenten sind in FRE für Windows implementiert.
Das ZoomViewer-Objekt ist ein ActiveX-Steuerelement, mit dem Sie eine vergrößerte Ansicht der Zeile oder des verarbeiteten Bildbereichs anzeigen können, die bzw. der gerade bearbeitet wird. Während Image Viewer die allgemeine Seitenansicht anzeigt, bietet Zoom Viewer eine einfache Möglichkeit, das Bild detaillierter zu betrachten, die Position des Bereichs anzupassen oder unsichere Zeichen mit dem vergrößerten Bild zu vergleichen. Ein Bild wird über die Eigenschaft FRPage mit Zoom Viewer verbunden. Die Zoom Viewer-Komponente sieht wie folgt aus: ZoomViewer Sie können das Erscheinungsbild der Komponente über ihre Eigenschaften ändern. So können Sie beispielsweise das Kontextmenü der Komponente über die Eigenschaft Commands anpassen. Weitere Informationen finden Sie unter Anpassen des Kontextmenüs und der Symbolleiste einer visuellen Komponente. Informationen zur Bildanzeige werden über spezielle ausgehende Schnittstellen bereitgestellt. Diese Schnittstellen sind IZoomViewerEvents (für C++) und eine dispinterface DIZoomViewerEvents (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 zu deren Verarbeitung bietet. Dieses Objekt kann in Visual Basic mit WithEvents deklariert werden. Für C++-Benutzer bedeutet dies, dass die Schnittstelle IConnectionPointContainer unterstützt wird. Um Ereignisbenachrichtigungen zu empfangen, sollte ein C++-Benutzer ein Objekt erstellen, das von der Schnittstelle IZoomViewerEvents abgeleitet ist, und dann mit den Standardmitteln von COM die Verbindung zwischen diesem Objekt und der im ZoomViewer-Objekt implementierten Ereignisquelle herstellen. Die Zoom Viewer-Komponente kann mit der Komponente Component Synchronizer verbunden werden. In diesem Fall werden alle Ereignisse in Zoom Viewer automatisch an andere mit dem Synchronizer verbundene Komponenten übertragen, und die gesamte Anwendung arbeitet synchron.

Eigenschaften

Gibt das aktive Werkzeug für die Block- und Bildbearbeitung an.

Gibt an, ob der untere Bereich des Zoom Viewers aktiviert ist. Wenn diese Eigenschaft FALSE ist, wird der untere Bereich nicht angezeigt.

Standardmäßig ist der Wert TRUE.

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

Standardmäßig ist der Wert TRUE.

,schreibgeschützt

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

Stellt die mit dem Zoom Viewer verbundene Dokumentseite dar.

Gibt an, ob der Zoom 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. vom-Objekt) und verarbeitet Windows-Meldungen 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 nach Abschluss des Vorgangs auf FALSE zu setzen. In diesem Fall kann das Dokument nicht über den Zoom Viewer beschädigt werden.

Standardmäßig ist der Wert FALSE.

Gibt die Standard-Verarbeitungsparameter für das Dokument an. Diese Parameter werden verwendet, wenn die Analyse- und Erkennungsprozesse direkt aus dem Zoom Viewer aufgerufen werden.

Wenn der Zoom Viewer mit dem Component Synchronizer verbunden ist, verwenden Sie dieIComponentSynchronizer::ProcessingParams-Eigenschaft, um die für die Verarbeitung verwendeten Parameter zu ändern. Wenn Sie Verarbeitungsparameter über die Eigenschaft des Zoom Viewers ändern, können Fehler auftreten.

Gibt den Pfad zum Ordner an, der Dateien mit den Einstellungen des Zoom Viewers enthält. Andere Visual Components haben dieselbe Eigenschaft. Jede Visual Component sollte ihren eigenen Ordner mit Einstellungen verwenden.

Der Wert dieser Eigenschaft setzt sich aus dem Pfad zum Ordner, in dem ABBYY FineReader Engine benutzerspezifische Daten speichert, und dem Namen des zugehörigen Unterordners zusammen. Standardmäßig ist der Ordner mit benutzerspezifischen Daten derFineReader Engine-Datenordner. Dieser kann während der Initialisierung von FineReader Engine geändert werden (über die-Funktion oder über die-Methode). Der Standardname des Unterordners ist eine beliebige GUID. Um den Namen des Unterordners zu ändern, geben Sie den neuen Namen in die Eigenschaften der Komponente in Visual Studio zur Entwurfszeit. Wenn Sie versuchen, den Wert der Eigenschaft zur Laufzeit festzulegen, wird dieser Wert ignoriert.

Wenn Sie die Komponente beim Entwurf zu einem Formular in Visual Studio 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. Falls der Wert der Eigenschaft aus irgendeinem Grund nicht zur Entwurfszeit definiert wird (z. B. wenn Sie die Komponente dynamisch zur Laufzeit generieren), erstellt die Komponente bei jeder Initialisierung einen neuen Ordner mit den Einstellungen. Um eine Vervielfachung der Ordner 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.

Speichert die Koordinaten des Zeichenrechtecks des aktuellen Zeichens in Pixeln. Die Koordinaten sind relativ zum Dokumentbild.

Gibt an, ob das aktuelle Zeichen mit einem gelben Rechteck markiert werden soll.

Standardmäßig ist der Wert TRUE.

Gibt den Maßstab des Bildes in Prozentpunkten an. Diese Eigenschaft kann auch auf eine derKonstanten gesetzt werden.

Standardmäßig ist der Wert ST_PixelToPixel, d. h. das Bild wird im Pixel-für-Pixel-Modus angezeigt.

,nur lesbar

Speichert die Koordinaten des sichtbaren Dokumentbereichs in Pixeln. Die Koordinaten sind relativ zum Dokumentbild.

, nur lesbar

Gibt das Fenster-Handle des Clientbereichs zurück.

Methoden

NameBeschreibung
CenterOnDocumentPointScrollt die Zoomansicht so, dass der angegebene Punkt in der Mitte der Ansicht angezeigt wird.
DocumentToScreenKonvertiert die Koordinaten des angegebenen Punkts auf dem Dokumentbild in Bildschirmkoordinaten.
GetSelectedBlocksIndicesGibt die Indizes der ausgewählten Blöcke zurück.
GetSelectedCellsGibt das umschließende Rechteck der ausgewählten Zellen im angegebenen Tabellenblock zurück.
ScreenToDocumentKonvertiert die Bildschirmkoordinaten des angegebenen Punkts in Koordinaten auf dem Dokumentbild.
SetSelectedBlocksIndicesLegt die Blockauswahl fest.
SetSelectedCellsLegt die ausgewählten Zellen des angegebenen Tabellenblocks fest.
ShowDocumentAreaScrollt die Zoomansicht so, dass der Dokumentbereich mit den angegebenen Koordinaten sichtbar wird (soweit möglich).
UpdateOptionsAktualisiert die im Dialogfeld „Options“ von Zoom 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 Zoom Viewer auf den aktuellen Stand zu aktualisieren.

Beispiele

Diese Komponente wird in folgenden Codebeispielen verwendet: VisualComponents.

Siehe auch

IZoomViewerEvents IComponentSynchronizer::ZoomViewer Erstellen einer Anwendung mit grafischer Benutzeroberfläche Anpassen von Kontextmenü und Symbolleiste einer visuellen Komponente