Zum Hauptinhalt springen
Visual Components sind in FRE für Windows implementiert.
Das ImageViewer-Objekt ist ein ActiveX-Steuerelement, mit dem Sie ein Bild und die darin enthaltenen Blöcke anzeigen und bearbeiten können. Ein Bild wird über die Eigenschaft FRPage mit Image Viewer verknüpft. Die ImageViewer-Komponente sieht folgendermaßen aus: ImageViewer Sie können das Erscheinungsbild der Komponente über ihre Eigenschaften ändern. Beispielsweise können Sie über die Eigenschaft Toolbar Schaltflächen zur Symbolleiste hinzufügen oder daraus entfernen oder über die Eigenschaft PopupMenu das Kontextmenü der Komponente anpassen. Ausführliche Informationen finden Sie unter Anpassen des Kontextmenüs und der Symbolleiste einer visuellen Komponente. Informationen zum Anzeigen und Bearbeiten des Bildes werden über spezielle ausgehende Schnittstellen bereitgestellt. Diese Schnittstellen sind IImageViewerEvents (für C++) und die dispinterface DIImageViewerEvents (für Visual Basic). Dabei ist 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 die Schnittstelle IConnectionPointContainer unterstützt wird. Um Benachrichtigungsereignisse zu empfangen, sollte ein C++-Benutzer ein Objekt erstellen, das von der Schnittstelle IImageViewerEvents abgeleitet ist, und anschließend mit den standardmäßigen COM-Mechanismen eine Verbindung zwischen diesem Objekt und der im ImageViewer-Objekt implementierten Ereignisquelle herstellen. Die ImageViewer-Komponente kann mit der Komponente Component Synchronizer verbunden werden. In diesem Fall werden alle Ereignisse in Image Viewer automatisch an andere mit dem Synchronizer verbundene Komponenten weitergeleitet, und die gesamte Anwendung arbeitet synchron.

Eigenschaften

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

Gibt an, ob Image Viewer durch alle Seiten des Dokuments scrollen soll. Wenn diese Eigenschaft FALSE ist, scrollt Image Viewer nur durch die ausgewählte Seite.

Standardmäßig ist der Wert TRUE.

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

Standardmäßig ist der Wert TRUE.

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

Standardmäßig ist der Wert TRUE.

Gibt an, ob das Kontextmenü des Image Viewer aktiviert ist. Wenn diese Eigenschaft FALSE ist, wird das Kontextmenü nicht angezeigt.

Standardmäßig ist der Wert TRUE.

,read-only

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

Gibt die mit dem Image Viewer verbundene Dokumentseite an.

Gibt an, ob erkannte Fragmente während der Erkennung im Bild hervorgehoben werden sollen. Mit dieser Eigenschaft lässt sich der Erkennungsfortschritt verfolgen.

Standardmäßig ist der Wert TRUE.

Gibt an, ob der Image 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-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 nach Abschluss des Vorgangs auf FALSE zurückzusetzen. Auf diese Weise kann das Dokument nicht über den Image Viewer beschädigt werden.

Standardmäßig ist der Wert FALSE.

,read-only

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

Legt die Standard-Verarbeitungsparameter für ein Dokument fest. Diese Parameter werden verwendet, wenn Analyse-, Erkennungs- und Syntheseprozesse direkt über den Image Viewer aufgerufen werden.

Wenn Image Viewer mit 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 Image Viewer ändern, können Fehler auftreten.

Ermöglicht den Zugriff auf die Sammlung der Indizes der im Dialogfeld Image Editor ausgewählten Seiten.

Gibt den Pfad zu dem Ordner an, der die Einstellungsdateien des Image Viewer enthält. Andere visuelle Komponenten verfügen über dieselbe Eigenschaft. Jede visuelle Komponente sollte einen eigenen Einstellungsordner verwenden.

Der Wert dieser Eigenschaft setzt sich aus dem Pfad zu dem 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. Der Standardname des Unterordners ist eine beliebige GUID. Um den Namen des Unterordners zu ändern, geben Sie den neuen Namen zur Entwurfszeit in den Eigenschaften der Komponente in Visual Studio an. Wenn Sie versuchen, den Wert der Eigenschaft zur Laufzeit anzugeben, wird dieser Wert ignoriert.

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 nicht zur Entwurfszeit definiert wird (z. B. wenn die Komponente dynamisch zur Laufzeit generiert wird), erstellt die Komponente bei jeder Initialisierung einen neuen Einstellungsordner. Um eine Vervielfältigung der Ordner zu vermeiden, sollten Sie den erstellten Einstellungsordner nach der Deinitialisierung der Komponente löschen. In diesem Fall können nur die Standardeinstellungen der Komponente verwendet werden; die Einstellungen lassen sich nicht zwischen Sitzungen speichern.

Legt den Titel der Image Viewer-Komponente fest.

Standardmäßig lautet er “Image”.

,read-only

Ermöglicht den Zugriff auf die Einstellungen der Toolbar.

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

Standardmäßig ist der Wert ST_BestFit, d. h. die optimale Anpassung wird automatisch gewählt.

,read-only

Enthält die Koordinaten des sichtbaren Dokumentbereichs in Pixeln. Die Koordinaten sind relativ zum Dokumentbild.

, nur lesbar

Gibt den Fenster-Handle des Clientbereichs zurück.

Speichert die Koordinaten des Zoom-Bereichsrechtecks in Pixeln. Die Koordinaten sind relativ zum Dokumentbild.

Gibt an, ob der Zoom-Bereich auf dem Bild mit einem gepunkteten Rechteck markiert werden soll.

Der Standardwert ist TRUE.

Methoden

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

Beispiele

Diese Komponente wird in den folgenden Codebeispielen verwendet: VisualComponents.

Siehe auch

IImageViewerEvents IComponentSynchronizer::ImageViewer Erstellen einer Anwendung mit grafischer Benutzeroberfläche Anpassen des Kontextmenüs und der Symbolleiste einer visuellen Komponente Arbeiten mit Eigenschaften