Zum Hauptinhalt springen
Visuelle Komponenten sind in FRE für Windows implementiert.
Das TextValidator-Objekt ist ein ActiveX-Steuerelement, mit dem Sie unsicher erkannte Zeichen in einem Dokument überprüfen können. Das Dokument wird über die Eigenschaft FRDocument mit der Komponente verknüpft. Die TextValidator-Komponente kann beispielsweise so aussehen: TextValidator Für Texte mit vertikaler Schreibrichtung:
TextValidator_CJK
Um die Rechtschreibprüfung zu starten, sollten Sie entweder die Methode Spell oder SpellBlock des TextValidator-Objekts aufrufen. Wenn die Rechtschreibprüfung bereits läuft, müssen Sie sie zuerst anhalten, andernfalls werden neue Aufrufe dieser Methoden ignoriert.
  • Sie können die Rechtschreibprüfung auch über die Schaltfläche Check Spelling im Text Editor starten.
  • Einige Zeichen komplexer Schriftsysteme (z. B. Chinesisch, Thai, Armenisch) werden im TextValidator möglicherweise nicht angezeigt, wenn die dort verwendete Schriftart die entsprechenden Zeichen nicht enthält. In diesem Fall können Sie im Dialogfeld Options eine andere Schriftart angeben (klicken Sie dazu im TextValidator auf Settings > Options, wechseln Sie zur Registerkarte View und wählen Sie die Schriftart in der Dropdownliste Font used to display plain text aus).
Informationen zur Rechtschreibprüfung werden über spezielle ausgehende Schnittstellen bereitgestellt. Diese Schnittstellen sind ITextValidatorEvents (für C++) und die dispinterface DITextValidatorEvents (für Visual Basic). Visual-Basic-Benutzer müssen sich nicht um die Details der Implementierung von Ereignisschnittstellen kümmern, 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 IConnectionPointContainer-Schnittstelle unterstützt wird. Um Ereignisbenachrichtigungen zu empfangen, sollte ein C++-Benutzer ein Objekt erstellen, das von der ITextValidatorEvents-Schnittstelle abgeleitet ist, und dann die Verbindung zwischen diesem Objekt und der im TextValidator-Objekt implementierten Ereignisquelle mit den Standardmitteln von COM einrichten. Die TextValidator-Komponente kann mit der Komponente Component Synchronizer verbunden werden. In diesem Fall werden alle Ereignisse im TextValidator automatisch an andere mit dem Synchronizer verbundene Komponenten weitergeleitet, und die gesamte Anwendung arbeitet synchron.

Eigenschaften

,nur lesbar

Stellt eine Sammlung von Wörtern dar, die von einem Benutzer während der Rechtschreibprüfung einem Wörterbuch hinzugefügt wurden.

Wenn während der Rechtschreibprüfung Wörter zu einem Wörterbuch hinzugefügt werden, wird das Benutzerwörterbuch in dem Ordner erstellt, der durch dieILanguageDatabase::DictionaryExtensionsPathEigenschaft angegeben wird.

Stellt eine Sammlung von Wortpaaren dar. Das erste Wort im Paar ist das Quellwort, das während der Rechtschreibprüfung automatisch ersetzt wird; das zweite Wort ist der Ersatz.

Gibt an, ob Text Validator während der Rechtschreibprüfung Leerzeichen korrigieren soll. Wenn Sie den Wert dieser Eigenschaft auf TRUE setzen, korrigiert Text Validator Leerzeichen vor oder nach Satzzeichen.

Standardmäßig ist der Wert FALSE.

Stellt eine Sammlung von Wörtern dar, die während der Rechtschreibprüfung ignoriert werden sollen.

, nur lesbar

Gibt an, ob die Rechtschreibprüfung gerade ausgeführt wird.

Stellt das mit Text Validator verbundene Dokument dar.

Gibt an, ob Text Validator gesperrt ist.

Diese Eigenschaft ist in den folgenden Situationen nützlich:

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

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. Dadurch kann das Dokument nicht durch Text Validator beschädigt werden.

Standardmäßig ist der Wert FALSE.

Stellt eine Sammlung von Wortpaaren dar. Das erste Wort im Paar ist das Quellwort, das während der Rechtschreibprüfung ersetzt wird; das zweite Wort ist der Ersatz.

Gibt den Pfad zu dem Ordner an, der die Einstellungsdateien von Text Validator enthält. Andere Visual Components verfügen über dieselbe Eigenschaft. Jede Visual Component sollte einen eigenen Ordner für ihre 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 des zugehörigen Unterordners zusammen. Standardmäßig ist der Ordner für benutzerspezifische Daten derFineReader Engine data folder. Dieser kann während der Initialisierung von FineReader Engine geändert werden (über diefunction, or via themethod). Der Standardname des Unterordners ist eine beliebige GUID. Um den Namen des Unterordners zu ändern, geben Sie den neuen Namen in den Eigenschaften der Komponente in Visual Studio zur Entwurfszeit an. Wenn Sie versuchen, den Wert der Eigenschaft zur Laufzeit anzugeben, 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. 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 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.

Gibt an, ob Text Validator bei zusammengesetzten Wörtern während der Rechtschreibprüfung anhalten soll.

Standardmäßig ist der Wert FALSE.

Gibt an, ob Text Validator bei Zeichenmüll während der Rechtschreibprüfung anhalten soll. Zeichenmüll bezeichnet eine sinnlose Zeichenkombination.

Standardmäßig ist der Wert FALSE.

Gibt an, ob Text Validator bei Wörtern anhalten soll, die während der Rechtschreibprüfung nicht im Wörterbuch gefunden werden. Diese Eigenschaft und die StopAtUncertain -Eigenschaft können nicht gleichzeitig auf FALSE gesetzt werden.

Standardmäßig ist der Wert TRUE.

Gibt an, ob Text Validator bei unsicher erkannten Zeichen während der Rechtschreibprüfung anhalten soll. Diese Eigenschaft und die StopAtNonDictionary -Eigenschaft können nicht gleichzeitig auf FALSE gesetzt werden.

Standardmäßig ist der Wert TRUE.

,nur lesbar

Stellt eine Sammlung von Wörtern dar, die zur Korrektur der Schreibweise unsicher erkannter Wörter während der Rechtschreibprüfung vorgeschlagen wurden.

Gibt die Standard-Syntheseparameter für ein Dokument an. Diese Parameter werden verwendet, wenn Text Validator eine Dokumentsynthese durchführen muss (dies kann vorkommen, wenn die logische Struktur eines Dokuments durch bestimmte Bearbeitungsvorgänge fehlerhaft wird).

Wenn Text Validator mit Component Synchronizer verbunden ist, verwenden Sie dieIComponentSynchronizer::ProcessingParams-Eigenschaft, um die für die Dokumentsynthese verwendeten Parameter zu ändern. Wenn Sie diese Parameter über die Eigenschaft von Text Validator ändern, können Fehler auftreten.

,nur lesbar

Stellt die Position eines unsicheren Zeichens oder eines unsicheren Wortes dar.

, nur lesbar

Gibt das Fenster-Handle des Clientbereichs zurück.

Methoden

NameBeschreibung
EndSpellingBeendet die Rechtschreibprüfung.
SpellStartet die Rechtschreibprüfung an der angegebenen Position.
SpellBlockPrüft die Rechtschreibung im angegebenen Block.
UpdateOptionsAktualisiert die im Dialogfeld „Options“ von TextValidator festgelegten Einstellungen. Möglicherweise müssen Sie diese Methode aufrufen, wenn die Optionen in einer anderen Visual Component geändert wurden, damit die Einstellungen auf den aktuellen Stand gebracht werden.

Beispiele

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

Siehe auch

ITextValidatorEvents IComponentSynchronizer::TextValidator Erstellen einer Anwendung mit grafischer Benutzeroberfläche