Zum Hauptinhalt springen
Visual Components sind in FRE für Windows implementiert.
Das TextEditor-Objekt ist ein ActiveX-Steuerelement, mit dem Sie erkannten Text auf einer Dokumentseite anzeigen und bearbeiten können. Eine Seite wird über die Eigenschaft FRPage mit der Komponente verknüpft. Die TextEditor-Komponente sieht wie folgt aus: TextEditor Sie können das Erscheinungsbild der Komponente über ihre Eigenschaften ändern. So können Sie beispielsweise über die Eigenschaft Toolbar Schaltflächen zur Symbolleiste hinzufügen oder daraus entfernen oder über die Eigenschaft Commands das Kontextmenü der Komponente anpassen. Weitere Informationen finden Sie unter Anpassen des Kontextmenüs und der Symbolleiste einer visuellen Komponente. Informationen über die Bearbeitung des erkannten Textes werden über spezielle ausgehende Schnittstellen bereitgestellt. Dabei handelt es sich um ITextEditorEvents (für C++) und um eine dispinterface, DITextEditorEvents (für Visual Basic). Es 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 mit 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 von der Schnittstelle ITextEditorEvents abgeleitetes Objekt erstellen und dann die Verbindung zwischen diesem Objekt und der im TextEditor-Objekt implementierten Ereignisquelle mit den Standardmitteln von COM einrichten. Die TextEditor-Komponente kann mit der Komponente Component Synchronizer verbunden werden. In diesem Fall werden alle Ereignisse in TextEditor automatisch an andere mit dem Synchronizer verbundene Komponenten übertragen, und die gesamte Anwendung arbeitet synchron.

Eigenschaften

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

Standardmäßig ist der Wert TRUE.

Gibt an, ob der Titelbereich des Text Editors aktiviert ist. Wenn diese Eigenschaft FALSE ist, wird der Titelbereich nicht angezeigt.

Standardmäßig ist der Wert TRUE.

Gibt an, ob das Kontextmenü des Text Editors 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 Text Editor verfügbaren Befehle. Siehedie Liste der im Text Editor verfügbaren Befehle.

Gibt die Cursorposition auf der Seite an.

Stellt die mit dem Text Editor verbundene Dokumentseite dar.

Gibt an, ob Text- und Hintergrundfarben im Text Editor beibehalten werden sollen.

Standardmäßig ist der Wert dieser Eigenschaft TRUE.

Gibt an, ob der Text Editor 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 Text Editor beschädigt werden.

Standardmäßig ist der Wert FALSE.

Gibt einen der Dokumentanzeigemodi an.

Standardmäßig ist der Wert TEM_ExactCopy.

,read-only

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

Gibt den Pfad zu dem Ordner an, der die Dateien mit den Einstellungen des Text-Editors enthält. Andere Visual Components verfügen über dieselbe Eigenschaft. Jede Visual Component sollte ihren eigenen Ordner für Einstellungen verwenden.

Der Wert dieser Eigenschaft setzt sich aus dem Pfad zu dem Ordner, in dem ABBYY FineReader Engine benutzerspezifische Daten speichert, und dem Namen seines Unterordners zusammen. Standardmäßig ist der Ordner mit den benutzerspezifischen Daten derFineReader Engine-Datenordner. Er kann bei 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, sollten Sie den neuen Namen zur Entwurfszeit in den Eigenschaften der Komponente in Visual Studio angeben. Wenn Sie versuchen, den Wert der Eigenschaft zur Laufzeit anzugeben, wird er ignoriert.

Wenn Sie die Komponente in Visual Studio zur Entwurfszeit zu einem Formular hinzufügen, wird der Wert der Eigenschaft entweder automatisch auf den Standardwert festgelegt oder manuell auf einen benutzerdefinierten Wert gesetzt. In beiden Fällen wird der Wert zur Entwurfszeit festgelegt. Wenn der Wert der Eigenschaft aus irgendeinem Grund nicht zur Entwurfszeit festgelegt wird (z. B. wenn Sie die Komponente zur Laufzeit dynamisch erzeugen), erstellt die Komponente bei jeder Initialisierung einen neuen Ordner mit Einstellungen. Um eine Ansammlung solcher 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 zwischen Sitzungen speichern.

Gibt an, ob Bilder im Text-Editor angezeigt werden sollen.

Standardmäßig ist der Wert dieser Eigenschaft TRUE.

Gibt an, ob Kolumnentitel im Text-Editor angezeigt werden sollen.

Standardmäßig ist der Wert dieser Eigenschaft TRUE.

Gibt die Standardparameter für die Dokumentensynthese an. Diese Parameter werden verwendet, wenn der Text-Editor eine Dokumentensynthese durchführen muss (dies kann vorkommen, wenn die logische Struktur eines Dokuments durch bestimmte Bearbeitungsvorgänge fehlerhaft wird).

Wenn der Text-Editor mit dem Component Synchronizer verbunden ist, verwenden Sie die EigenschaftIComponentSynchronizer::ProcessingParams, um die für die Dokumentensynthese verwendeten Parameter zu ändern. Wenn Sie diese Parameter über die Eigenschaft des Text-Editors ändern, kann es zu Fehlern kommen.

,nur lesbar

Speichert die Koordinaten des Rechtecks des aktuellen Zeichens in Pixeln. Die Koordinaten beziehen sich auf das Dokumentbild.

Gibt den Titel der Text-Editor-Komponente an.

Standardmäßig lautet er “Text”.

,nur lesbar

Ermöglicht den Zugriff auf die Einstellungen der Symbolleiste.

Gibt den Maßstab der Textseite in Prozent an. Diese Eigenschaft kann auch auf eine der-Konstanten gesetzt werden.

Standardmäßig ist der Wert ST_BestFit, was bedeutet, dass die beste Anpassung automatisch ausgewählt wird.

,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
ActivateOnAktiviert eine Position im angegebenen Block und bringt sie in den sichtbaren Bereich.
CenterOnDocumentPointScrollt die Textansicht so, dass der angegebene Punkt im Dokument in der Mitte der Ansicht angezeigt wird.
DocumentToScreenKonvertiert die Koordinaten des angegebenen Punkts im Dokumentbild in Bildschirmkoordinaten.
GetSelectionGibt die Cursorpositionen am Anfang und Ende der Auswahl zurück.
PrintDruckt den erkannten Text.
SetSelectionLegt die Textauswahl auf einer Seite fest.
ScreenToDocumentKonvertiert die Bildschirmkoordinaten des angegebenen Punkts in Koordinaten im Dokumentbild.
ShowBlockBringt den angegebenen Block in den sichtbaren Bereich (so weit wie möglich). Diese Methode ist nur sinnvoll, wenn Text Editor im Modus TEM_ExactCopy verwendet wird.
ShowDocumentAreaScrollt die Textansicht so, dass der Dokumentbereich mit den angegebenen Koordinaten sichtbar wird (so weit wie möglich).
UpdateOptionsAktualisiert die im Dialogfeld „Optionen“ von Text Editor 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 Text Editor auf den aktuellen Stand zu bringen.

Beispiele

Diese Komponente kommt in den folgenden Codebeispielen zum Einsatz: VisualComponents.

Siehe auch

ITextEditorEvents IComponentSynchronizer::TextEditor Erstellen einer Anwendung mit einer grafischen Benutzeroberfläche Anpassen des Kontextmenüs und der Symbolleiste einer visuellen Komponente