> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# TextValidator-Objekt (ITextValidator-Schnittstelle)

> TextValidator-Objekt (ITextValidator-Schnittstelle) in ABBYY FineReader Engine Visual Components unter Windows — Das TextValidator-Objekt ist ein ActiveX-Steuerelement, mit dem Sie unsicher erkannte Zeichen in einem...

<Warning>
  Visuelle Komponenten sind in FRE für Windows implementiert.
</Warning>

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:

<img src="https://mintcdn.com/abbyy/i-EfCQVmseNiPQcp/images/fine-reader/engine/textvalidator.gif?s=bead22a36b53fc33dbacbee57e482926" alt="TextValidator" width="560" height="428" data-path="images/fine-reader/engine/textvalidator.gif" />

Für Texte mit vertikaler Schreibrichtung:

<Accordion title="Siehe Abbildung">
  <img src="https://mintcdn.com/abbyy/i-EfCQVmseNiPQcp/images/fine-reader/engine/textvalidator_cjk.gif?s=b53541ab9960e40a14f44e569aac2767" alt="TextValidator_CJK" width="559" height="427" data-path="images/fine-reader/engine/textvalidator_cjk.gif" />
</Accordion>

Um die Rechtschreibprüfung zu starten, sollten Sie entweder die Methode [Spell](/de/fine-reader/engine/visual-components-reference/textvalidator/spell-method) oder [SpellBlock](/de/fine-reader/engine/visual-components-reference/textvalidator/spellblock-method) 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](/de/fine-reader/engine/visual-components-reference/texteditor) 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](/de/fine-reader/engine/visual-components-reference/itextvalidatorevents) (für C++) und die dispinterface [DITextValidatorEvents](/de/fine-reader/engine/visual-components-reference/itextvalidatorevents) (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](/de/fine-reader/engine/visual-components-reference/supplementary-objects/componentsynchronizer) 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.

<div id="properties">
  ## Eigenschaften
</div>

<table>
  <thead>
    <tr>
      <th>
        <p>
          <strong>Name</strong>
        </p>
      </th>

      <th>
        <p>
          <strong>Typ</strong>
        </p>
      </th>

      <th>
        <p>
          <strong>Beschreibung</strong>
        </p>
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        <p>
          <strong>AddedWords</strong>

          <a name="addedwords" />
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/de/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection">
              SpellWordCollection
            </a>
          </strong>

          ,{" "}

          <a href="/de/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties#readonly_properties">
            nur lesbar
          </a>
        </p>
      </td>

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

        <Note>
          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 die{" "}

          <a href="/de/fine-reader/engine/api-reference/language-related-objects/languagedatabase#dictionaryextensionspath">
            ILanguageDatabase::DictionaryExtensionsPath
          </a>

          {" "}

          Eigenschaft angegeben wird.
        </Note>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <strong>AutoReplacedWords</strong>

          <a name="autoreplacedwords" />
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/de/fine-reader/engine/visual-components-reference/supplementary-objects/spellreplacementcollection">
              SpellReplacementCollection
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          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.
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <strong>CorrectSpaces</strong>

          <a name="correctspaces" />
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/de/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">
              VARIANT\_BOOL
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          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.
        </p>

        <p>Standardmäßig ist der Wert FALSE.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <strong>IgnoredWords</strong>

          <a name="ignoredwords" />
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/de/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection">
              SpellWordCollection
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          Stellt eine Sammlung von Wörtern dar, die während der Rechtschreibprüfung ignoriert werden sollen.
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <strong>IsSpellingInProgress</strong>

          <a name="isspellinginprogress" />
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/de/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">
              VARIANT\_BOOL
            </a>
          </strong>

          , nur lesbar
        </p>
      </td>

      <td>
        <p>Gibt an, ob die Rechtschreibprüfung gerade ausgeführt wird.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <strong>FRDocument</strong>

          <a name="frdocument" />
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/de/fine-reader/engine/api-reference/document-related-objects/frdocument">
              FRDocument
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>Stellt das mit Text Validator verbundene Dokument dar.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <strong>Locked</strong>

          <a name="locked" />
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/de/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">
              VARIANT\_BOOL
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>Gibt an, ob Text Validator gesperrt ist.</p>
        <p>Diese Eigenschaft ist in den folgenden Situationen nützlich:</p>

        <ul>
          <li>
            ein Analyse-, Erkennungs-, Synthese- oder Exportvorgang über die FineReader Engine API aufgerufen wird (nicht über Visual Components), oder
          </li>

          <li>
            Ihre Anwendung Benachrichtigungen über bestimmte Ereignisse empfängt (z. B. vom

            <strong>
              {" "}

              <a href="/de/fine-reader/engine/api-reference/document-related-objects/frdocument">
                FRDocument
              </a>

              {" "}
            </strong>

            Objekt) und Windows-Nachrichten von Visual Components in diesen Ereignishandlern verarbeitet.
          </li>
        </ul>

        <p>
          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.
        </p>

        <p>Standardmäßig ist der Wert FALSE.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <strong>ReplacedWords</strong>

          <a name="replacedwords" />
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/de/fine-reader/engine/visual-components-reference/supplementary-objects/spellreplacementcollection">
              SpellReplacementCollection
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          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.
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <strong>SettingsPath</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/de/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">
              BSTR
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          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.
        </p>

        <p>
          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 der{" "}

          <a href="/de/fine-reader/engine/distribution/distribution-windows/distribution-kit#finereader_engine_data_folder">
            FineReader Engine data folder
          </a>

          . Dieser kann während der Initialisierung von FineReader Engine geändert werden (über die{" "}

          <strong>
            <a href="/de/fine-reader/engine/api-reference/functions/initializeengine-function">
              InitializeEngine
            </a>
          </strong>

          {" "}

          function, or via the{" "}

          <strong>
            <a href="/de/fine-reader/engine/api-reference/engine-loaders/iengineloader/initializeengine-method">
              IEngineLoader::InitializeEngine
            </a>
          </strong>

          {" "}

          method). 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.
        </p>

        <p>
          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.
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <strong>StopAtCompound</strong>

          <a name="stopatcompound" />
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/de/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">
              VARIANT\_BOOL
            </a>
          </strong>
        </p>
      </td>

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

        <p>Standardmäßig ist der Wert FALSE.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <strong>StopAtGarbage</strong>

          <a name="stopatgarbage" />
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/de/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">
              VARIANT\_BOOL
            </a>
          </strong>
        </p>
      </td>

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

        <p>Standardmäßig ist der Wert FALSE.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <strong>StopAtNonDictionary</strong>

          <a name="stopatnondictionary" />
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/de/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">
              VARIANT\_BOOL
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          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{" "}
          <strong>StopAtUncertain </strong>-Eigenschaft können nicht gleichzeitig auf FALSE
          gesetzt werden.
        </p>

        <p>Standardmäßig ist der Wert TRUE.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <strong>StopAtUncertain</strong>

          <a name="stopatuncertain" />
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/de/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">
              VARIANT\_BOOL
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          Gibt an, ob Text Validator bei unsicher erkannten
          Zeichen während der Rechtschreibprüfung anhalten soll. Diese Eigenschaft und die{" "}
          <strong>StopAtNonDictionary </strong>-Eigenschaft können nicht gleichzeitig auf FALSE
          gesetzt werden.
        </p>

        <p>Standardmäßig ist der Wert TRUE.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <strong>SuggestedWords</strong>

          <a name="suggestedwords" />
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/de/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection">
              SpellWordCollection
            </a>
          </strong>

          ,{" "}

          <a href="/de/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties#readonly_properties">
            nur lesbar
          </a>
        </p>
      </td>

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

    <tr>
      <td>
        <p>
          <strong>SynthesisParamsForDocument</strong>

          <a name="synthesisparamsfordocument" />
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/de/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/synthesisparamsfordocument">
              SynthesisParamsForDocument
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          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).
        </p>

        <Note>
          Wenn Text Validator mit Component Synchronizer verbunden ist, verwenden Sie die{" "}

          <a href="/de/fine-reader/engine/visual-components-reference/supplementary-objects/componentsynchronizer#processingparams">
            IComponentSynchronizer::ProcessingParams
          </a>

          {" "}

          -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.
        </Note>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <strong>ValidatorError</strong>

          <a name="validatorerror" />
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/de/fine-reader/engine/visual-components-reference/supplementary-objects/validatorerror">
              ValidatorError
            </a>
          </strong>

          ,{" "}

          <a href="/de/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties#readonly_properties">
            nur lesbar
          </a>
        </p>
      </td>

      <td>
        <p>
          Stellt die Position eines unsicheren Zeichens oder eines unsicheren Wortes dar.
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <strong>WindowHandle</strong>

          <a name="windowhandle" />
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/de/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">
              \_\_int64
            </a>
          </strong>

          , nur lesbar
        </p>
      </td>

      <td>
        <p>Gibt das Fenster-Handle des Clientbereichs zurück.</p>
      </td>
    </tr>
  </tbody>
</table>

<div id="methods">
  ## Methoden
</div>

| Name                                                                                                   | Beschreibung                                                                                                                                                                                                                                                                   |
| ------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| [EndSpelling](/de/fine-reader/engine/visual-components-reference/textvalidator/endspelling-method)     | Beendet die Rechtschreibprüfung.                                                                                                                                                                                                                                               |
| [Spell](/de/fine-reader/engine/visual-components-reference/textvalidator/spell-method)                 | Startet die Rechtschreibprüfung an der angegebenen Position.                                                                                                                                                                                                                   |
| [SpellBlock](/de/fine-reader/engine/visual-components-reference/textvalidator/spellblock-method)       | Prüft die Rechtschreibung im angegebenen Block.                                                                                                                                                                                                                                |
| [UpdateOptions](/de/fine-reader/engine/visual-components-reference/textvalidator/updateoptions-method) | Aktualisiert 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. |

<div id="samples">
  ## Beispiele
</div>

Diese Komponente kommt in den folgenden Codebeispielen zum Einsatz: [VisualComponents](/de/fine-reader/engine/guided-tour/samples#visualcomponents).

<div id="see-also">
  ## Siehe auch
</div>

[ITextValidatorEvents](/de/fine-reader/engine/visual-components-reference/itextvalidatorevents)

[IComponentSynchronizer::TextValidator](/de/fine-reader/engine/visual-components-reference/supplementary-objects/componentsynchronizer#textvalidator)

[Erstellen einer Anwendung mit grafischer Benutzeroberfläche](/de/fine-reader/engine/guided-tour/advanced-techniques/using-gui-elements/creating-an-application-with-gui)