TextLanguage-Objekt (ITextLanguage-Schnittstelle)

Dieses Objekt beschreibt die Erkennungssprache eines Textes. Die Textsprache besteht im Allgemeinen aus einer Menge von Basissprachen oder aus den Sprachen eines einzelnen Wortes. Der Zugriff auf die Sammlung der Basissprachen eines Textes erfolgt über die Eigenschaft BaseLanguages. Außerdem stellt dieses Objekt Methoden für den Zugriff auf verschiedene Attribute der Textsprache bereit, z. B. auf ihren internen Namen, Gruppen von Buchstabensätzen usw. Das TextLanguage-Objekt ist ein persistentes Objekt. Das bedeutet, dass der aktuelle Zustand des Objekts in persistentem Speicher gespeichert werden kann. Später kann das Objekt wiederhergestellt werden, indem sein Zustand aus dem persistenten Speicher gelesen wird. Die folgenden Methoden ermöglichen die Persistenz des Objekts: Linux: SaveToFile und LoadFromFile Windows SaveToFile, LoadFromFile, SaveToMemory und LoadFromMemory.

Eigenschaften


	,nur lesbar	Gibt das Engine-Objekt zurück.

		Speichert den internen Namen der Textsprache. Da der interne Name zur Identifizierung der Sprache verwendet werden kann, sollte er eindeutig sein. Nach der Erstellung eines neuen Objekts vom Typ TextLanguage enthält diese Eigenschaft eine leere Zeichenfolge. Sie können ihr einen eindeutigen Wert zuweisen, um Ihre Textsprache von anderen zu unterscheiden. Standardmäßig enthält diese Eigenschaft eine leere Zeichenfolge.
		Legt zusätzliche Buchstabensätze für die Textsprache fest.
	, nur lesbar	Gibt den vollständigen Buchstabensatz zurück, der für die Erkennung mit dieser TextLanguage verwendet wird, und kombiniert dabei alle Buchstabensätze der Basissprachen sowie zusätzliche Buchstabensätze.
	,nur lesbar	Gibt einen Verweis auf die Sammlung der Basissprachen der aktuellen Textsprache zurück. Diese Sammlung ist stets vorhanden, enthält jedoch standardmäßig keine Elemente.
	,nur lesbar	Gibt einen Verweis auf die Sammlung der Sperr-Wörterbücher zurück.

		Gibt die Textkategorie an, für die die aktuelle Textsprache ausgelegt ist. Standardmäßig enthält diese Eigenschaft den Wert TC_Unknown, was bedeutet, dass die Textsprache für die Erkennung aller Texttypen verwendet werden kann.
		Ermöglicht die Verknüpfung beliebiger benutzerdefinierter Informationen mit einem Objekt vom Typ TextLanguage.

Methoden

Name	Beschreibung
CopyFrom	Initialisiert die Eigenschaften des aktuellen Objekts mit den Werten entsprechender Eigenschaften eines anderen Objekts.
LoadFromFile	Stellt den Objektinhalt aus einer Datei auf dem Datenträger wieder her.
LoadFromMemory Hinweis: Nur unter Windows.	Stellt den Objektinhalt aus dem globalen Speicher wieder her.
SaveToFile	Speichert den Objektinhalt in einer Datei auf dem Datenträger.
SaveToMemory Hinweis: Nur unter Windows.	Speichert den Objektinhalt im globalen Speicher.

Objektdiagramm

Ausgabeparameter

Dieses Objekt ist der Ausgabeparameter der Methoden CreateTextLanguage und CreateCompoundTextLanguage des Objekts LanguageDatabase.

Beispiele

C#-Code

FREngine.IEngine engine;
// Neues TextLanguage-Objekt erstellen
FREngine.ILanguageDatabase languageDatabase = Engine.CreateLanguageDatabase();
FREngine.ITextLanguage textLanguage = languageDatabase.CreateTextLanguage();
// Alle Attribute aus der vordefinierten englischen Sprache kopieren
FREngine.ITextLanguage englishLanguage = Engine.PredefinedLanguages.Find( "English" ).TextLanguage;
textLanguage.CopyFrom( englishLanguage );
textLanguage.InternalName = "SampleTextLanguage";
// Einige Attribute ändern, der Sprache ein Wörterbuch zuweisen
...
// Die Sprache für die Erkennung verwenden
FREngine.IDocumentProcessingParams documentProcessingParams = Engine.CreateDocumentProcessingParams();
documentProcessingParams.PageProcessingParams.RecognizerParams.TextLanguage = textLanguage;
document.Process( documentProcessingParams );